[python-users] Sphinx

[Andi Albrecht]

2010/5/1 Jan Ulrich Hasecke <juhasecke at googlemail.com>

> Hallo Andi,
>
> Am 01.05.2010 um 06:31 schrieb Andi Albrecht:
>
> > ob es zum "Spezialisten" reicht, glaube ich nicht ganz, aber zumindest
> ein bißchen Erfahrung mit Sphinx ist vorhanden, ggfs. reicht es ja für
> Antworten auf eine Untermenge der Fragen :)
> >
>
> da du selbst Google Sphinx beigebracht hast, bin ich voller Hoffnung.
>
>
> Ich habe hier auf einem Weg, der mir völlig vermurkst erscheint, ein Layout
> zustande gebracht, das so aussieht, wie es soll. Nun würde ich das gerne
> richtig machen.
>
> in conf.py:
>
> html_theme = 'sphinxdoc'
>
> in theme.conf:
>
> [theme]
> inherit = basis
> stylesheet = plone.css
> pygments_style = none
>
> [options]
> nosidebar = false
>
> In _static ist das basic.css und mein plone.css, das vom sphinxdoc.css
> abgeleitet ist.
>
> In _build/html/_static sind dann
> basic.css
> plone.css und
> sphinxdoc.css
>
> Und im HTML wird dann alles reingeholt außer basic.css
>
>  <link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" />
>    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
> (...)
> <link rel="stylesheet"
>  href="_static/plone.css"
>    type="text/css" />
>
> Das kann ja wohl nicht die kanonisch richtige Art sein, ein Layout zu
> machen. Leider finde ich die Anleitungen zu themes in der
> Sphinx-Dokumentation sphinxisch – also kryptisch.
>

Was missfällt dir daran? Auf den ersten Blick sieht das meiner Meinung nach
ok aus. Du lässt dein Theme vom basis-Theme erben und stellst im Moment
(wenn ich das richtig lese), CSS-Dateien bereit. Die CSS-Dateien sollten in
deinem Themes-Verzeichnis idealerweise mit _t enden, also z.B. plone.css_t,
damit sie beim Erstellen der HTML-Seiten als Template-Dateien erkannt
werden. So ist es möglich z.B. in den CSS-Dateien Variablen zu benutzen, die
in der conf.py definiert werden können.


>
> Kennst du ein gutes How-to? Oder kannst du mich auf die richtige Schiene
> setzen?
>

Nein, leider kenne ich da auch keine detailliertere Dokumentation. Auch die
Entwicklungsversion der Sphinx-Doku (unter sphinx.pocoo.org/latest/) hat
außer Screenshots leider auch nicht viel mehr zu bieten, als die aktuelle.
Ich bin auch so vorgegangen, dass ich mir bei existierenden Themes
abgeschaut habe, was ich selbst verwenden wollte.


>
> (more questions to come)
>
> juh
> ________________________________________
> Diese Mail erhalten Sie ueber die Mailingliste Python-users der
> Universitaet zu Koeln
> Python-users at uni-koeln.de
> https://lists.uni-koeln.de/mailman/listinfo/python-users
>
>
-------------- nächster Teil --------------
Ein Dateianhang mit HTML-Daten wurde abgetrennt...
URL: <http://lists.uni-koeln.de/pipermail/python-users/attachments/20100503/1565f45c/attachment.html>