sphinxnotes-snippet#

Documentation Status Open Source License PyPI Package PyPI Package Downloads

Sphinx documentation snippets manager.

Introduction#

Documentations in Sphinx can be parsed into doctree (In other words, Abstract Syntax Tree), all contents of documents are parsed into node of this tree. The Extension collects snippets (doctree nodes) during the build phase of Sphinx, and provide a Command Line Tool for your accessing.

For more details, please refer to Introduction

Getting Started#

Note

We assume you already have a Sphinx documentation, if not, see Getting Started with Sphinx.

First, downloading extension from PyPI:

$ pip install sphinxnotes-snippet

Then, add the extension name to extensions configuration item in your conf.py:

extensions = [
          # …
          'sphinxnotes.snippet',
          # …
          ]

Make sure you have snippet command in your $PATH. Rebuild documentation (make build), then invoke snippet stat, the project name is expected to be seen in output.

Contents#

The Sphinx Notes Project#

This project is a developed by Shengyu Zhang, as part of The Sphinx Notes Project.

The Sphinx Notes Project