<div class="gmail_quote">2010/5/1 Jan Ulrich Hasecke <span dir="ltr"><<a href="mailto:juhasecke@googlemail.com">juhasecke@googlemail.com</a>></span><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
Hallo Andi,<br>
<br>
Am 01.05.2010 um 06:31 schrieb Andi Albrecht:<br>
<div class="im"><br>
> 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 :)<br>
><br>
<br>
</div>da du selbst Google Sphinx beigebracht hast, bin ich voller Hoffnung.<br>
<br>
<br>
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.<br>
<br>
in conf.py:<br>
<br>
html_theme = 'sphinxdoc'<br>
<br>
in theme.conf:<br>
<br>
[theme]<br>
inherit = basis<br>
stylesheet = plone.css<br>
pygments_style = none<br>
<br>
[options]<br>
nosidebar = false<br>
<br>
In _static ist das basic.css und mein plone.css, das vom sphinxdoc.css abgeleitet ist.<br>
<br>
In _build/html/_static sind dann<br>
basic.css<br>
plone.css und<br>
sphinxdoc.css<br>
<br>
Und im HTML wird dann alles reingeholt außer basic.css<br>
<br>
  <link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" /><br>
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" /><br>
(...)<br>
<link rel="stylesheet"<br>
  href="_static/plone.css"<br>
    type="text/css" /><br>
<br>
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.<br></blockquote><div><br></div><div>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.</div>
<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<br>
Kennst du ein gutes How-to? Oder kannst du mich auf die richtige Schiene setzen?<br></blockquote><div><br></div><div>Nein, leider kenne ich da auch keine detailliertere Dokumentation. Auch die Entwicklungsversion der Sphinx-Doku (unter <a href="http://sphinx.pocoo.org/latest/">sphinx.pocoo.org/latest/</a>) 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.</div>
<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<br>
(more questions to come)<br>
<font color="#888888"><br>
juh</font><br>________________________________________<br>
Diese Mail erhalten Sie ueber die Mailingliste Python-users der Universitaet zu Koeln<br>
<a href="mailto:Python-users@uni-koeln.de">Python-users@uni-koeln.de</a><br>
<a href="https://lists.uni-koeln.de/mailman/listinfo/python-users" target="_blank">https://lists.uni-koeln.de/mailman/listinfo/python-users</a><br>
<br></blockquote></div><br>