viewdoc is a Python package documentation viewer. It converts reST-formatted text to HTML and displays it in a browser window. The viewer is typically used to check a package's long description before uploading it to PyPI.
viewdoc works with Python >= 3.7 and all recent versions of setuptools.
Use pip install jarn.viewdoc
to install the viewdoc
script.
viewdoc [options] [rst-file|egg-dir]
-s style, --style=style, or --style
Select the custom style added to the HTML output.
-b browser, --browser=browser
Select the browser used for display. For a list of names see the webbrowser module.
-c config-file, --config-file=config-file
Use config-file instead of the default
~/.viewdoc
.-l, --list-styles
List available styles and exit.
-h, --help
Print the help message and exit.
-v, --version
Print the version string and exit.
--no-color
Disable output colors.
--no-browser
Print HTML to stdout.
rst-file
The reST file to view.
egg-dir
The Python package whose long description to view. Defaults to the current working directory.
viewdoc reads style information from its configuration file ~/.viewdoc
. Edit this file to add your own styles.
plain
Browser default with margins.
pypi
New PyPI style with Google Fonts.
sans
PyPI-like style without Google Fonts (the default).
Also see our Python package releaser jarn.mkrelease.