user-guide#

View page source

Extract Sphinx RST Files#

This is a sphinx wrapper that extracts RST file from source code and then runs sphinx to obtain html, tex, or pdf output files. It includes automatic processing and commands that make sphinx easier to use.

Git Repository#

https://github.com/bradbell/xrst

Versions#

Documentation for latest version

latest

Documentation for most recent stable version

stable-2024

Most recent release of this stable version

release-2024

Install Stable Version#

Features in stable-2024 were frozen at the beginning of the year and only includes bug fixed after that.

pip install xrst

Install Testing Version#

Search for xrst on test.pypi to determine the date corresponding to this version. This installs the xrst dependencies and then replaces xrst by its most recent test version:

pip install xrst
pip uninstall -y xrst
pip install --index-url https://test.pypi.org/simple/ xrst

Install From Source#

The following commands will download, test, build, and install the current version from the master branch.

git clone https://github.com/bradbell/xrst.git xrst.git
cd xrst.git
pytest -s pytest
python3 -m build --sdist
pip install dist/*

You can determine the date corresponding to a version of the source code using the following command:

grep '^version *=' pyproject.toml

Dependencies#

The following is a list of the projects that xrst depends on (and should be automatically installed by pip when you install xrst):

dependencies       = [
   'sphinx', 'toml', 'sphinx-copybutton',             # required
   'pytest',                                          # need for testing xrst
   'pyenchant', 'pyspellchecker',                     # need the one you use
   'furo', 'sphinx-rtd-theme', 'sphinx-book-theme',   # need the ones you use
]

Run Program#

Extract RST Files And Run Sphinx

Contents#