ICGC DCC - Docs

Documentation for ICGC DCC using mkdocs and GitHub Pages hosted at http://icgc-dcc.github.io/dcc-docs

Domain

A custom domain is setup on the gh-pages branch in the CNAME file:

http://docs.icgc.org

Setup

This project requires mkdocs version 0.15.3 or higher.

To install on Mac:

brew install mkdocs

Node is also required. Download the latest version from nodejs.org.

After installing node, cd into the directory containing the project and run

npm install

Content

The content of the docs are Markdown documents that may be found at docs/

:warning: Note that you must commit your changes to GitHub in order for them not to be clobbered by another user in a future deployment.

Configure

Edit mkdocs.yml

Develop

npm start

Build

npm run build

Deploy

To publish changes, run

npm run publish

It is not necessary to run the build task before publishing

NPM Notes

If errors are encountered when running npm run build|publish, try re-running

npm install

to update missing packages used by the doc deployment process.