Options for creating the Sphinx environment¶
The following options are used whenever you generate the Sphinx environment (Alt+Shift+S).
Option |
Definition |
---|---|
BodyHead |
Additional HTML added to the start of each page. |
BodyTail |
Additional HTML added to the end of each page. |
BuildPath=path |
Location where the final output will be saved (eg path/html) |
Copyright=text |
Define the copyright message that will be shown on your website footer |
CSS=css text |
Include some additional CSS |
excludeDirs=dirlist |
List of folders that Sphinx should ignore. (_html is always ignored). |
favicon=filename |
An icon file that will be used for the website’s favicon |
Language=code |
Set the Language for the Sphinx base text. See language option in www.sphinx-doc.org/en/master/usage/configuration.html |
logo=filename |
An image (best smaller than 200x200) that will appear in the navigation panel |
Navigation=top::bottom |
Control the top and bottom navbars. |
OptionOutPath OutPath=path |
Location of ghe Sphinx environment and where the generated .rst files will be saved. You need to run |
ProjectTitle=text |
Specify the title that will be shown at the top of the website |
SideBars=names |
Define the sections that will appear in your websites side bar. |
ThemeName=theme |
Set the theme. Eg sphinx_rtd_theme |
ThemeOption=option:value |
Define theme options (this option can be repeated for multiple options). |
TOCTitle=title |
Use this title for the TOC. |
UploadTarget=target |
For use with make upload, this is the rsync target |
UserStyle=text |
Define a custom style (see Custom Styles for more information.) |
UserText=key,text |
Where ‘key’ appears in the theme template, use ‘text’ instead. |
Version=version |
Specify a version number (this is displayed by some themes, eg sphinx_rtd_theme) |