Sphinx Theme Customization
Sphinx has some good themes, but customizaiton is a bit limitted.
For example, it seems to be not possible to add comments to existing sphinx_rtd_theme theme.
So, I had to figure out how to use a custome theme embedded into the project itself. Here is the process I used with sphinx_rtd_theme theme.
Steps:
- Create
_theme
directory in your projectsource
directory. - Copy
sphinx_rtd_theme
directory (it is the directory that contains theme.conf file) into_theme
directory just created.
That is it.
After I created custom theme, I modified content of footer.html
file to add
comments application mouthful to static pages.
I looked into Running Sphinx in VSTS Hosted Pipeline and it game me ideas, but I did not use the method to created integrated pipeline.