Skip to main content

Live preview your Sphinx documentation

Project description

PyPI Version Build Status

demo.gif

Installation

To install, use pip (or easy_install):

$ pip install sphinx-reload

The package installs the command-line program sphinx-reload:

$ sphinx-reload --version
v0.2.0

Getting Started

To begin live previewing your documentation, simply pass the path of your documentation’s root as a command-line argument with sphinx-reload. Here’s an example assuming your documentation’s root is under the current directory and named docs:

$ sphinx-reload docs/

sphinx-reload will open a preview in a new tab of your favorite browser and watch for changes in your documentation’s source files (e.g., any reStructuredText files under the documentation’s root).

To view further usage details, use the script’s --help option:

$ sphinx-reload --help

Project details


Download files

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

Source Distribution

sphinx-reload-0.2.0.tar.gz (3.5 kB view hashes)

Uploaded Source

Built Distribution

sphinx_reload-0.2.0-py3-none-any.whl (4.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page