SamWilsn / picklebuilder

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

README for Pickle Builder

Sphinx extension to pickle documents.

In itself, the extension is fairly straightforward -- it takes the parsed reST file from Sphinx and pickles it to a file.

Installing

Using pip

pip install picklebuilder

Usage

  • Set the builder as a extension in conf.py:

    extensions = ['picklebuilder.picklebuilder']
  • Run sphinx-build with target rpickle:

    sphinx-build -b rpickle -c . build/pickle

Further Reading

Feedback

The pickle builder is in a preliminary state. It's not (yet) widely used, so any feedback is particularly welcome.

About

License:BSD 2-Clause "Simplified" License


Languages

Language:Python 100.0%