bit-docs-website

Website that documents bit-docs.

Getting Started

Install Dependencies

npm install

Generate Website

npm run bit-docs

Preview Generated Website

http-server -a localhost -p 8080 -c-1 gh-pages

Note: The -a localhost -p 8080 are needed for the -c-1 cache control flag to work.

Now visit http://localhost:8080/

Publish Generated Website to GitHub

npm run gh-pages

Now visit https://bit-docs.github.io/bit-docs-website

All Available Commands

npm run-script

available via `npm run-script`:
  cache-bust # Shortcut to clearing out bit-docs-generate-html cache without using (slow) forceBuild.
    npm run clean-dest && rm -rf ./node_modules/bit-docs/lib/configure/node_modules/bit-docs-generate-html/site/templates ./node_modules/bit-docs/lib/configure/node_modules/bit-docs-generate-html/site/static
  clean-dest # Deletes the destination folder.
    rm -rf ${npm_package_bit_docs_dest:-./doc}
  bit-docs   # Generates the website.
    bit-docs
  gen        # Generates the website with debug output.
    bit-docs -d
  genf       # Generates the website with debug output and forceBuild.
    bit-docs -df
  gh-pages   # Publishes the website to GitHub Pages.
    gh-pages -d gh-pages
  gsd        # Shows submodule differences in git diff.
    git diff --submodule
  gsl        # Prints a log graph highlighting submodule changes.
    git log --graph --oneline -U0 --submodule | grep -E '^[*| /\]+([0-9a-f]{7} |Submodule |> |$)'
  gsu        # Fetch latest remote changes for submodules and merge them in.
    git submodule update --remote --merge
  pub        # Shortcut to publish the website to GitHub Pages.
    npm run gh-pages
  see        # Preview the generated website using the globally installed http-server.
    http-server -a localhost -p 8080 -c-1 gh-pages