api_doc

apidoc-lite

this zero-dependency package will auto-generate documentation for your npm-package with zero-config

cdn download

• https://kaizhu256.github.io/node-apidoc-lite/build..beta..travis-ci.org/app/assets.apidoc.rollup.js

documentation

apidoc

• https://kaizhu256.github.io/node-apidoc-lite/build..beta..travis-ci.org/apidoc.html

todo

• none

change since 9fe8c225

• npm publish 2017.2.27
• successful travis-ci build
• none

this package requires

• darwin or linux os

build status

git-branch :	master	beta	alpha
test-report :
coverage :
build-artifacts :

master branch

• stable branch
• HEAD should be tagged, npm-published package

beta branch

• semi-stable branch
• HEAD should be latest, npm-published package

alpha branch

• unstable branch
• HEAD is arbitrary
• commit history may be rewritten

quickstart shell example

to run this example, follow the instruction in the script below

• example.sh

# example.sh

# this shell script will auto-generate documentation for the mysql npm-package with zero-config

# instruction
    # 1. copy and paste this entire shell script into a console and press enter
    # 2. open /tmp/apidoc.html to view the auto-generated documentation

shExampleSh() {(set -e
    # npm install apidoc-lite
    npm install apidoc-lite
    # npm install mysql
    npm install mysql
    # auto-generate documentation for the mysql npm-package with zero-config
    node_modules/.bin/apidoc-lite node_modules/mysql > /tmp/apidoc.html
)}
shExampleSh

output from browser

output from shell

package.json

{
    "author": "kai zhu <[e-mail]>",
    "bin": {
        "apidoc-lite": "lib.apidoc.js"
    },
    "description": "this zero-dependency package will auto-generate documentation for your npm-package with zero-config",
    "devDependencies": {
        "electron-lite": "kaizhu256/node-electron-lite#alpha",
        "utility2": "kaizhu256/node-utility2#alpha"
    },
    "engines": {
        "node": ">=4.0"
    },
    "homepage": "https://github.com/kaizhu256/node-apidoc-lite",
    "keywords": [
        "api-doc",
        "apidoc",
        "doc",
        "documentation",
        "doxygen",
        "javadoc"
    ],
    "license": "MIT",
    "main": "lib.apidoc.js",
    "name": "apidoc-lite",
    "nameAlias": "apidoc",
    "nameOriginal": "apidoc-lite",
    "os": [
        "darwin",
        "linux"
    ],
    "repository": {
        "type": "git",
        "url": "https://github.com/kaizhu256/node-apidoc-lite.git"
    },
    "scripts": {
        "build-ci": "utility2 shReadmeBuild",
        "deploy-github": "true",
        "deploy-heroku": "true",
        "env": "env",
        "heroku-postbuild": "npm install 'kaizhu256/node-utility2#alpha' && utility2 shDeployHeroku",
        "postinstall": "if [ -f lib.apidoc.npm-scripts.sh ]; then ./lib.apidoc.npm-scripts.sh postinstall; fi",
        "publish-alias": "VERSION=$(npm info $npm_package_name version); for ALIAS in api_doc apidocs api-doctor doctor-api npm-doc npmdoc; do utility2 shNpmPublishAs . $ALIAS $VERSION; utility2 shNpmTestPublished $ALIAS || exit $?; done",
        "start": "export PORT=${PORT:-8080} && export npm_config_mode_auto_restart=1 && utility2 start",
        "test": "export PORT=$(utility2 shServerPortRandom) && utility2 test test.js",
        "test-example-js": "true",
        "test-example-sh": "utility2 shReadmeTestExampleSh",
        "test-pre": "true",
        "test-published": "utility2 shNpmTestPublished"
    },
    "version": "2017.2.27"
}

changelog of last 50 commits

internal build-script

• build.sh

# build.sh

# this shell script will run the build for this package

shBuild() {(set -e
# this function will run the main build
    # init env
    . node_modules/.bin/utility2 && shInit
    # init github-gh-pages commit-limit
    export COMMIT_LIMIT=20
    case "$CI_BRANCH" in
    alpha)
        shBuildCiDefault
        ;;
    beta)
        shBuildCiDefault
        ;;
    master)
        shBuildCiDefault
        git tag "$npm_package_version" || true
        git push "[e-mail]:$GITHUB_REPO.git" "$npm_package_version" || true
        ;;
    publish)
        printf "//registry.npmjs.org/:_authToken=$NPM_TOKEN" > "$HOME/.npmrc"
        export CI_BRANCH=alpha
        shNpmPublishAs
        shBuildCiDefault
        npm run publish-alias
        git push "[e-mail]:$GITHUB_REPO.git" publish:beta
        ;;
    esac
)}

shBuild

misc

• this package was created with utility2