Deploying demo center website on your local machine

DEPRECATED

As of 2021-08-31 we are no longer using jekyll for the site. Please see Build JupyterBook locally for current instructions.

Requirements:

• Git: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
• Ruby: https://idratherbewriting.com/documentation-theme-jekyll/mydoc_install_jekyll_on_windows.html
• Jekyll: https://idratherbewriting.com/documentation-theme-jekyll/index.html#2-install-jekyll

1. Clone the notebooks_demo repository.

   git clone https://github.com/ioos/notebooks_demos.git

2. In the webpage directory there is a reference to the ioos_jekyll_theme. However, in your clone of notebooks_demo that directory is empty. So, you will need to populate the ioos_jekyll_theme directory with the contents from ioos_jekyll_theme.

   git clone https://github.com/ioos/ioos_jekyll_theme.git

   cp -r ioos_jekyll_theme/ notebooks_demos/webpage/ioos_jekyll_theme/

3. Run jekyll in notebooks_demos/webpage

   jekyll serve --config _config.yml,_config_dev.yml --watch --verbose --incremental

   • Note this still has issues with the code gallery page. It only returns an index.

• For more information on deploying the ioos_jekyll_theme locally, see this documentation.