README.md

Quelldaten für das Git-Buch

Eine gerenderte Version findet sich auf gitbu.ch.

Pull-Requests sind willkommen; es handelt sich allerdings um ein Buch, das wiederholt professionell lektoriert wurde. Diesen Qualitäts-Standard wollen wir natürlich halten. Bevor Du also tiefgreifende Änderungen/Erweiterungen vornimmst, kontaktiere uns, damit wir entscheiden können, wie wir vorgehen. Fehlerkorrekturen oder kleine Updates sind natürlich immer gerne gesehen!

Falls Du ein DocBook-Experte und/oder Webprogrammierer bist, und denkst: Das Design könnte man ja wohl mal professionalisieren – dann gerne! Ich habe aus den Quelldateien nur schnell eine halbwegs ansehnliche Webseite zusammengestoppelt. Auch sind gegebenenfalls eine PDF- oder EPUB-Version interessant; falls Du dies übernehmen willst, gerne!

Bauen

Mac OS X

Zur Vorbereitung (mit Homebrew):

• brew install asciidoc xmlstarlet epubcheck
• xmllint fixen - nutzt dauerhaft das Homebrew Environment:
• sudo mkdir /etc/xml
• sudo ln -s /usr/local/etc/xml/catalog /etc/xml/catalog
• xmllint temporär fixen:
• export XML_CATALOG_FILES=/usr/local/etc/xml/catalog

Bauen:

• make erstellt die HTML Version.

• open git.chunked/index.html öffnet das Ergebnis im Browser.

• make epub erstellt die EPUB Version.

• open git.epub öffnet das EPUB.

Lizenz

Lizensiert unter der Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.