Metadata-Version: 2.1
Name: sphinx-reload
Version: 0.2.0
Summary: Live preview your Sphinx documentation
Home-page: https://github.com/prkumar/sphinx-reload
Author: P. Raj Kumar
Author-email: raj.pritvi.kumar@gmail.com
License: MIT
Keywords: sphinx live preview sync reload documentation
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development :: Documentation
Requires-Dist: livereload (>=2.5.1)

Sphinx-Reload
*************

|PyPI Version| |Build Status|

.. image:: 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
<http://docutils.sourceforge.net/rst.html>`__ files under the documentation's
root).

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

::

    $ sphinx-reload --help

.. |Build Status| image:: https://travis-ci.org/prkumar/sphinx-reload.svg?branch=master
   :target: https://travis-ci.org/prkumar/sphinx-reload
.. |PyPI Version| image:: https://img.shields.io/pypi/v/sphinx-reload.svg
   :target: https://pypi.python.org/pypi/sphinx-reload


