Was this page helpful?
You're viewing documentation for an unstable version of ScyllaDB Sphinx Theme. Switch to the latest stable version.
Use the command-line interface to run the following commands.
To run the following commands, you will need to have installed:
The preview command builds a local instance of the docs site so you can view the rendering in a sandbox environment on your local browser.
To preview the docs:
Build the docs.
cd docs make preview
Open http://127.0.0.1:5500/ with your preferred browser.
You can pass custom options to increase or decrease verbosity. For a list with all the available options, refer to the Sphinx documentation.
To increase verbosity, use the option
make preview SPHINXOPTS=-v
To decrease verbosity, use the option
make preview SPHINXOPTS=-Q
The multiversionpreview command generates a local instance of the docs site with all specified versions available for navigation. You can view the rendering in a sandbox environment on your local browser.
To preview multiple versions:
Build the docs.
cd docs make multiversionpreview
Open http://0.0.0.0:5500/ with your preferred browser.
For further guidance on using the multiversionpreview command, see Multiversion configuration.
make multiversion is aimed to be used by GitHub Actions CI. While documenting new features, it is not advised to run
make multiversion, but
make preview instead.
cd docs make multiversion
The previous command generates HTML docs under the
make preview operation creates content in the
_build directory. When making changes to the docs, it is helpful to delete the contents of this directory before running
cd docs make clean