Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

README.md

Documentation

The documentation is available at: https://flyvis.github.io/datamate/

Building the Documentation

Run the build docs script or follow the instructions below to build the documentation.

The documentation is built with mkdocs.

Convert examples to markdown:

Only applies to making changes to the examples.

  1. Run all notebooks inplace:
export JUPYTER_CONFIG_DIR=$(mktemp -d) # to avoid conflicts with notebook version and extensions

for notebook in ../examples/*.ipynb; do
    jupyter nbconvert --to notebook --execute "$notebook" --inplace
done
  1. Convert notebooks:
jupyter nbconvert --to notebook ../examples/*.ipynb --output-dir docs/examples/ --TagRemovePreprocessor.remove_cell_tags hide
  1. Clear all notebook outputs (optional):
jupyter nbconvert --ClearOutputPreprocessor.enabled=True --inplace ../examples/*.ipynb

Serve the docs locally

mkdocs serve

Deploy the docs to GitHub

See mkdocs user guide for more details.

mkdocs gh-deploy

or optionally specify a remote repository:

mkdocs gh-deploy --remote <remote_name>