mirror of
https://github.com/wassname/jupyter_contrib_nbextensions.git
synced 2026-07-15 01:10:55 +08:00
Using markdown makes for easier comparison with the main README.md as well, as mentioned in #776 [skip CI]
Documenting jupyter_contrib_nbextensions
Documentation for jupyter_contrib_nbextensions
is hosted on ReadTheDocs.
Build Documentation locally
-
Change directory to documentation root:
$ cd docs -
Install requirements:
$ pip install -r requirements.txt -
Build documentation using Makefile for Linux and OS X:
$ make html
or on Windows:
$ make.bat html
-
Display the documentation locally by navigating to
build/html/index.htmlin your browser:Or alternatively you may run a local server to display the docs. In Python 3:
$ python -m http.server 8000In your browser, go to
http://localhost:8000.
Developing Documentation
Helpful files and directories
sourcedirectory - source for documentationsource/conf.py- Sphinx build configuration filesource/md2rst.py- Generates rst files from readme markdown files of individual extensions