Git history with branches

Sphinx clever mit Github Pages benutzen 0 (0)

Dank Github Pages, war es noch nie so leicht wie heute eine Webseite für seine Dokumentation zu erstellen. Einfach ein neuen git branch gh-pages oder einen Ordner docs erstellen, eine index.html Datei reinziehen, und fertig ist die Webseite.
Einfach oder? Ja definitiv, aber auch effizient? Nicht wirklich. Eine Webseite lässt sich zwar schnell aufziehen, Bootstrap drauf und fertig, jedoch wird diese immer unübersichtlicher, je größer das Projekt wird. Deswegen gibt es spezielle Tools, um die Dokumenation seiner Programme effizient zu gestalten. Eines davon, besonders für Python, ist Sphinx. Aber wie benutzt man Sphinx mit GitHub Pages?

(mehr …)