Skip to main content

Sphinx builder extension to generate a 'Documentation Set' for `dash API browser`.

Project description

sphinxcontrib_dashbuilder generate a ‘Documentation Set’ intended to be used with the dash API browser from a Sphinx documentation.

You can read the ‘Documentation Set’ style document by using dash API browser.

  • For Mac OS X users: dash
  • For Windows or Linux users: Zeal

This extension has been inspired by doc2dash

Features

Implemented:

  • Generate a ‘Documentation Set’ for dash API browser.

Not Implemented yet:

Install

$ pip install sphinxcontrib-dashbuilder

If you wanto to use unrelease version, you can install from repository:

$ pip install -e hg+https://bitbucket.org/shimizukawa/sphinxcontrib-dashbuilder

Configuration

conf.py configuration values:

dash_name:(optional) name for docset explicitly. default is same as project.
dash_icon_file:(optional) PNG file path for docset icon.
dash_translator_class:
 (optional) A string with the fully-qualified name of a Dash Translator class, that is, a subclass of Sphinx’ DashTranslator, that is used to translate document trees to HTML for Dash. Default is None (use the builtin translator).

conf.py example:

extensions = ['sphinxcontrib.dashbuilder']

dash_name = 'Python_3'
dash_icon_file = '_static/python.png'

Run

run:

$ sphinx-build -b dash [source] [outdir]

and you get dash documentation set under ‘_build/dash/’ directory.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sphinxcontrib-dashbuilder, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size sphinxcontrib_dashbuilder-0.1.0-py2.py3-none-any.whl (8.2 kB) File type Wheel Python version 3.3 Upload date Hashes View
Filename, size sphinxcontrib-dashbuilder-0.1.0.zip (16.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page