Files
jupyter_contrib_nbextensions/docs
Josh Barnes add59949ce Update docs/source/install.md to reflect changes to readme
Using markdown makes for easier comparison with the main README.md as well,
as mentioned in #776
[skip CI]
2016-11-01 23:29:21 +00:00
..
2016-09-06 22:50:02 +02:00
2016-09-06 22:13:31 +02:00
2016-09-04 19:51:40 +02:00

Documenting jupyter_contrib_nbextensions

Documentation for jupyter_contrib_nbextensions is hosted on ReadTheDocs.

Build Documentation locally

  1. Change directory to documentation root:

        $ cd docs
    
  2. Install requirements:

        $ pip install -r requirements.txt
    
  3. Build documentation using Makefile for Linux and OS X:

        $ make html
    

or on Windows:

       $ make.bat html
  1. Display the documentation locally by navigating to build/html/index.html in your browser:

    Or alternatively you may run a local server to display the docs. In Python 3:

        $ python -m http.server 8000
    

    In your browser, go to http://localhost:8000.

Developing Documentation

Helpful files and directories

  • source directory - source for documentation
  • source/conf.py - Sphinx build configuration file
  • source/md2rst.py - Generates rst files from readme markdown files of individual extensions