Verwenden Sie benutzerdefinierte Thema auf ReadTheDocs

Question

Ich versuche, ein eigenes Thema von Sphinx RTD Theme geerbt zu verwenden.

Wenn ich es auf meinem lokalen Computer verwende, habe ich das gute Design. Aber wenn ich die doc-Version lese (importiert von github) gibt es kein CSS.

Habe ich etwas verpasst?

Der Repo mit dem Zweig des benutzerdefinierten Thema verwenden: https://github.com/DigitalSkills-fr/Docs/tree/custom_theme/docs

Der Doc auf RTD mit dem Zielbranche: http://digitalskills-docs.readthedocs.io/fr/custom_theme/index.html

Vielen Dank für jede Hilfe.

Answer 1

Sie sollten nur integrierte Designnamen in Ihrem conf.py angeben.

# The theme to use for HTML and HTML Help pages. See the documentation for 
# a list of builtin themes. 
#html_theme = 'default' 
html_theme = 'theme_digitalskills' 

Ihre benutzerdefinierten Eintrag löschen und wiederherstellen das Original:

html_theme = 'default' 

Angenommen, Sie die CSS-Dateien in Ihrer Branche custom_theme geändert haben, dann sollten RTD alle kopieren Sie die Dateien in der Liste der Verzeichnisse angegeben in html_static_path, überschreiben die sich im internen Thema der CSS-Dateien:

# Add any paths that contain custom static files (such as style sheets) here, 
# relative to this directory. They are copied after the builtin static files, 
# so a file named "default.css" will overwrite the builtin "default.css". 
html_static_path = ['_static']