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:

  1. Create _theme directory in your project source directory.
  2. 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.