Skip to main content

ReStructuredText viewer

Project description

A viewer for ReStructuredText documents that renders them on the fly.

Pass the name of a ReStructuredText document to restview, and it will launch a web server on localhost:random-port and open a web browser. Every time you reload the page, restview will reload the document from disk and render it. This is very convenient for previewing a document while you’re editing it.

You can also pass the name of a directory, and restview will recursively look for files that end in .txt or .rst and present you with a list.

Finally, you can make sure your Python package has valid ReStructuredText in the long_description field by using

restview -e 'python setup.py --long-description'

Changelog

1.2.1 (2010-09-12)

  • Handle spaces and other special characters in URLs (LP#616335).

  • Don’t linkify filenames inside external references (LP#634827).

1.2 (2010-08-06)

  • “SEVERE” docutils errors now display a message and unformatted file in the browser, instead of a traceback on the console.

  • New command-line option, -e COMMAND.

  • Added styles for admonitions; many other important styles are still missing.

1.1.3 (2009-10-25)

  • Spell ‘extras_require’ correctly in setup.py (LP#459840).

  • Add a MANIFEST.in for complete source distributions (LP#459845).

1.1.2 (2009-10-14)

  • Fix for ‘localhost’ name resolution error on Mac OS X.

1.1.1 (2009-07-13)

  • Launches the web server in the background.

1.1.0 (2008-08-26)

  • Accepts any number of files and directories on the command line.

1.0.1 (2008-07-26)

  • New option: –css. Accepts a filename or a HTTP/HTTPS URL.

1.0.0 (2008-07-26)

  • Bumped version number to reflect the stability.

  • Minor CSS tweaks.

0.0.5 (2007-09-29)

  • Create links to other local files referenced by name.

  • Use pygments (if available) to syntax-highlight doctest blocks.

  • Handle JPEG images.

0.0.4 (2007-09-28)

  • Remove the unstable Gtk+ version.

0.0.3 (2007-09-28)

  • Use setuptools for packaging.

0.0.2 (2007-01-21)

  • Browser-based version.

  • Command line options -l, -b (thanks to Charlie Shepherd).

  • CSS tweaks.

  • Unicode bugfix.

  • Can browse directory trees.

  • Can serve images.

0.0.1 (2005-12-06)

  • PyGtk+ version with GtkMozEmbed. Not very stable.

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

restview-1.2.1.tar.gz (9.6 kB view hashes)

Uploaded Source

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