Serves your Sphinx project and reloads pages on source changes
Project description
README
======
Automatically rebuild your Sphinx project on changes.
sphinxview is a Sphinx extension which shortens the feedback loop while working
on a Sphinx project. When used, it starts a local webserver and serves your
project so you can navigate around it. Whenever you make changes to the source
file matching the page currently displayed in the browser, the entire project
is automaticly rebuilt and your browser reloads the page when the new
build has finished.
Getting it
----------
You can install sphinxview from PyPI using pip:
$ pip install --pre sphinxview
Or you can get the source from the `GitHub repository
<https://github.com/trarbr/sphinxview>`_.
Using it
--------
Before you can use sphinxview, you must first enable it in the conf.py for
your Sphinx project. This is done by adding `sphinxview.ext` to the list
`extensions`::
# conf.py
extensions = ['sphinxview.ext']
Now you can use sphinxview to rebuild your project on changes to the source
files:
$ sphinxview /path/to/your-sphinx-project/
To see additional options, run:
$ sphinxview --help
About
-----
Sphinxview consists of three components:
`sphinxview/ext.py` is a Sphinx extension that adds `sphinxview.js` to all
HTML files built by Sphinx. To enable the extension, add `'sphinxview.ext'` to
the extensions list in your conf.py.
`sphinxview/sphinxview.js` is a piece of javascript that sends a request to the
HTTP server with name and build time of the HTML file it is embedded in.
`sphinxview/sphinxview.py` is a CLI program that starts a HTTP server and
rebuilds your project on changes to the files requested by `sphinxview.js`.
Your browser automatically refreshes when the new build is finished.
======
Automatically rebuild your Sphinx project on changes.
sphinxview is a Sphinx extension which shortens the feedback loop while working
on a Sphinx project. When used, it starts a local webserver and serves your
project so you can navigate around it. Whenever you make changes to the source
file matching the page currently displayed in the browser, the entire project
is automaticly rebuilt and your browser reloads the page when the new
build has finished.
Getting it
----------
You can install sphinxview from PyPI using pip:
$ pip install --pre sphinxview
Or you can get the source from the `GitHub repository
<https://github.com/trarbr/sphinxview>`_.
Using it
--------
Before you can use sphinxview, you must first enable it in the conf.py for
your Sphinx project. This is done by adding `sphinxview.ext` to the list
`extensions`::
# conf.py
extensions = ['sphinxview.ext']
Now you can use sphinxview to rebuild your project on changes to the source
files:
$ sphinxview /path/to/your-sphinx-project/
To see additional options, run:
$ sphinxview --help
About
-----
Sphinxview consists of three components:
`sphinxview/ext.py` is a Sphinx extension that adds `sphinxview.js` to all
HTML files built by Sphinx. To enable the extension, add `'sphinxview.ext'` to
the extensions list in your conf.py.
`sphinxview/sphinxview.js` is a piece of javascript that sends a request to the
HTTP server with name and build time of the HTML file it is embedded in.
`sphinxview/sphinxview.py` is a CLI program that starts a HTTP server and
rebuilds your project on changes to the files requested by `sphinxview.js`.
Your browser automatically refreshes when the new build is finished.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sphinxview-0.1.0b1.tar.gz
(5.1 kB
view hashes)
Built Distribution
Close
Hashes for sphinxview-0.1.0b1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f83e02768275939e1dc5bc6b2a7bd63ecd7c0fc56bb72a725ff957227d9f3674 |
|
MD5 | 563ef2865484664355f4fe23636cbc5a |
|
BLAKE2b-256 | f346c569dade04bf2466957777d813463270416f2404f8e3952cbeaa5524cb19 |