| View previous topic :: View next topic |
| Author |
Message |
Lloydz
n00b
Joined: 31 Aug 2019
Posts: 38
Location: Germany
|
 Posted: Wed Feb 09, 2022 4:18 pm Post subject: Kernel make htmldocs mit Sphinx |
 |
|
Hallo,
ich baue den Linux-Kernel aus: sys-kernel/gentoo-sources selbst. Auf einem System habe einen Webserver laufen und möchte die Kernel-Dokumentation per: erstellen und später im LAN im Web-Browser anschauen.
Der Linux-Kernel verwendet zur Dokumentationserstellung Sphinx und dem sphinx_rtd_theme. Daher habe ich die folgenden Pakete installiert:
| Code: | dev-python/sphinxcontrib-serializinghtml
dev-python/sphinxcontrib-qthelp
dev-python/sphinxcontrib-jsmath
dev-python/sphinxcontrib-htmlhelp
dev-python/sphinxcontrib-applehelp
dev-python/sphinx_rtd_theme
dev-python/sphinx |
Das erstellen der HTML-Dokumentation funktioniert ohne Probleme. Jedoch wenn ich die HTML-Seiten im Browser anschaue, fehlt das Menü links sowie das Format in der Anzeige. Genauer gesagt: die JavaScript- und CSS-Dateien sind zwar vorhanden, die Pfade stimmen und sie lassen sich einzeln im Browser abrufen. Jedoch werden sie im Browser - offensichtlich - nicht ausgeführt!?
Hat jemand Erfahrungen mit der Kernel-Dokumentations-Erstellung und Sphinx?
Eventuell habe ich ein Sphinx-Paket vergessen oder die Gentoo-Versionen sind zu alt?
Das System ist aktuell und alle Sphinx-Pakete ebenfalls, dass habe ich extra geprüft.
Behelfsweise wurde mit: | Code: | | make SPHINXOPTS=-v htmldocs |
erstellt - ohne Fehler. Eventuell eine andere Idee, was ich falsch gemacht haben könnte? |
|
| Back to top |
|
 |
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 30915
Location: here
|
| Posted: Thu Feb 10, 2022 7:12 am Post subject: |
|
|
Versuchen Sie
| Code: | | html_static_path = ['../_static'] |
und dann
| Code: | html_js_files = [
'path/start/from/_static/dir/file.js'
]
html_css_files = [
''path/start/from/_static/dir/file.css'
] |
in der Datei conf.py
_________________
Questions are guaranteed in life; Answers aren't. |
|
| Back to top |
|
|
Lloydz
n00b
Joined: 31 Aug 2019
Posts: 38
Location: Germany
|
| Posted: Thu Feb 10, 2022 3:19 pm Post subject: |
|
|
Hallo fedeliallalinea,
Dein Tipp hat mich auf folgendes gebracht:
in conf.py:
| Code: | html_context = {
'css_files': [
'_static/theme_overrides.css',
],
} |
habe ich eine Zeile hinzugefügt:
| Code: | html_context = {
'css_files': [
'_static/theme_overrides.css',
'_static/css/theme.css',
],
} |
so funktioniert es bei mir  Man sollte beachten, dass conf.py autogeneriert ist und möglicherweise wieder überschrieben wird.
Vielen Dank! |
|
| Back to top |
|
|
fedeliallalinea
Administrator
Joined: 08 Mar 2003
Posts: 30915
Location: here
|
| Posted: Thu Feb 10, 2022 3:39 pm Post subject: |
|
|
Moved from Diskussionsforum to Deutsches Forum (German).
_________________
Questions are guaranteed in life; Answers aren't. |
|
| Back to top |
|
|
|
Deutsches Forum (German)
