Mein spezieller Dank gilt an dieser Stelle denjenigen, die Fehler gefunden und vor allem mir mitgeteilt haben: Keven K., Torben L., Daniel, Jesper, R. Köbke, Gerrit, Philipp, Robert, Henrik B., Fabian B., Peter B., Michael F., Stefan S., Christoph T., Justin G., André W. und Nadja Vajkonny. Danke fürs aufmerksame Lesen!

Wer mal reinschmökern möchte, kann das gerne tun auf der Seite LaTeX-Buch Probelesen.

Die Gelegenheit habe ich außerdem dazu genutzt, die LaTeX-Buch-Website einem sanften Redesign zu unterziehen. Sie sollte jetzt auf verschiedenen Geräten besser dargestellt werden und ist vom Ladevolumen her etwas leichtgewichtiger als bislang.

Jeder, der LaTeX unter Windows nutzt, kennt das Problem: Die meisten Anwendungen, mit denen man seine Graphiken erstellt, können kein Encapsulated PostScript (EPS) exportieren, und wenn man sich einen PostScript-Drucker einrichtet, stimmt die BoundingBox nicht und man muss jedes Mal per Hand nacharbeiten, was sich bei einer großen Anzahl von Graphiken als überaus lästig erweist. Doch Abhilfe naht. Denn ähnlich wie das Erzeugen von PDF lässt sich auch diese Aufgabe automatisieren.

Die Originalfassung dieser Anleitung entstand im April 2008. Nach mehreren Aktualisierungen gibt’s jetzt (2013) die (für mich) funktionierende Fassung für Windows 7 64-bit.

Danke an zahlreiche Kommentatoren, die zur aktuellen Fassung der Anleitung beigetragen haben. Wenn Ihnen diese Anleitung hilft, dann interessiert Sie bestimmt auch das LaTeX-Lern-Buch.

Bevor Sie loslegen

Wie lange verwenden Sie schon LaTeX? Wie oft erzeugen Sie neue EPS-Grafiken? Wenn die Antworten eher »kurz« und »ab und an« lautet, dann brauchen Sie nicht weiterzulesen. Richten Sie dann einfach einen PostScript-Drucker in eine Datei ein und konvertieren das Ergebnis mittels GSview und Ghostscript manuell.

Zutaten

Folgendes wird benötigt:

• GhostScript. Unterliegt der GPL und gibt’s von der Ghostscript Website. Einfach nach “Obtaining the latest GPL version” und dann nach der Windows-Version Ausschau halten.
• RedMon 1.9 Redirection Port Monitor unter der AFPL von Russel Langs Seite. Am besten auf deutsch ziehen, dann gibt es mit den Erklärungen hier keine Probleme.
• ps2eps, von Roland Bless ist ein Perlskript, welches PostScript in Encapsulated PostScript transformiert. Liegt in jedem Spiegel des CTAN-Archiv, die Kurzbeschreibung im TeX Catalogue.
• Perl. Am einfachsten nimmt man hier die Distribution ActivePerl von ActiveState. Kleiner Tipp: Beim Herunterladen muß man keine persönlichen Daten angeben, man kann auch so auf „Weiter“ klicken.

Installation der Zutaten

1. GhostScript installieren. Die Standardwerte der Installation können alle übernommen werden. Danach muss noch das Verzeichnis c:\gs\gs9.04\bin (oder wo auch immer hininstalliert wurde) in den Suchpfad aufgenommen werden. Also in Start → Einstellungen → Systemsteuerung → System → Erweitert → Umgebungsvariablen der Zeile PATH den entsprechenden Verzeichnisnamen hinzufügen. Wichtig: Die Umgebungsvariable des Systems ändern, nur die des Benutzers reicht nicht aus.
2. Das RedMon Ziparchiv in ein neues, dauerhaftes Verzeichnis entpacken und setup64.exe aufrufen. Dies installiert einen weiteren verfügbaren Druckeranschlusstyp.
3. ActivePerl installieren. Im Prinzip können alle Voreinstellungen übernommen werden, wer jedoch Platz sparen will, kann in der Ausstattungsauswahl alles abwählen, was sich abwählen lässt.
4. Aus dem ps2eps-Zip-Archiv die Datei bin\win32\bbox.exe in ein Verzeichnis entpacken, das bereits im Suchpfad enthalten ist. Im Zweifelsfall also das Verzeichnis, in das Sie auch Ghostscript installiert haben, also c:\gs\gs9.04\bin. Als zweites die Datei bin\ps2eps entpacken in ein beliebiges Verzeichnis. Bei mir ist dies in beiden Fällen c:\tools\bin, tut aber nichts zur Sache.

Einrichten des EPS Druckers

Die Einrichtung geht nun wie folgt von statten:

1. Einen neuen Drucker einrichten:Start → Einstellungen → Drucker → Neuer Drucker.
2. Lokalen Drucker ohne automatische Erkennung wählen.
3. Einen neuen Anschluss hinzufügen vom Typ „Redirected Port“.
   
4. Bei Druckertreiber auswählen zunächst Windows Update klicken, ein wenig warten.
   
   Dann aus der Gruppe »Generic« den 35PPM PS wählen. Für Windows Vista stattdessen den Apple Color LaserWriter 12/600.
   
5. Der Druckername wird am besten „EPS Drucker“
   
   
6. Keine Testseite drucken lassen.
7. Mit Rechtsklick auf den Drucker die Druckereigenschaften öffnen und den Reiter Anschlüsse wählen. Den neu erstellten Anschluss konfigurieren wie folgt:
   • Als Programm wählen Sie C:\Windows\system32\cmd.exe, oder wo auch immer das Windowsverzeichnis beheimatet ist.
   • Als Argumente geben Sie ein: /c perl.exe c:\tools\bin\ps2eps  -f -q -B -P -F -C > "%1"
     Was bei mir c:\tools\bin heißt, ist natürlich zu ersetzen durch das Verzeichnis, wo Sie das ps2eps-Skript hinkopiert haben.
   • Als Ausgabe wählen Sie „Prompt for filename“.
   • Der Ablauf ist „Hintergrund“.
   • Die „Ausführung als Benutzer“ ist nicht aktiv (anders als im Screenshot!).

   

8. Nur für Windows Vista und niedriger: Für den neu angelegten „EPS Drucker“ die Druckereigenschaften öffnen.
   • Im Reiter Erweitert die Standardwerte öffnen und bei Erweitert-PostScript-Optionen als Ausgabeoption „Eingekapselter Postscript (EPS)“ wählen. Außerdem muss unter „Farbverwaltung“ der Wert für „ICM-Methode“ auf „ICM ausgeschaltet“ gesetzt werden, da es sonst zu Farbverfälschungen kommen kann.
   • Im Reiter Geräteeinstellungen geben Sie bei Verfügbarer Postscript-Speicher als Zahl 32767 ein.

Fertig. Zum Testen einfach aus irgendeiner Anwendung heraus auf den neuen „EPS Drucker“ drucken, als Dateiname die Erweiterung .eps angeben. Die erzeugten Dateien lassen sich problemlos mit epstopdf nach PDF wandeln.

Benutzung

Die meisten Anwendungen unterstützen beim Drucken eine Option der Art „Nur Auswahl drucken“, genau diese kann benutzt werden, um einzelne Teile in ein EPS zu gießen. Beim Acrobat Reader beispielsweise bedient man sich dazu des „Schnappschuß-Werkzeugs“.

Versalzen?

Sollte etwas nicht gehen, sind folgende Fehler wahrscheinlich:

• Die PostScript-Ausgabe in Windows Vista steht nicht auf „Eingekapselter Postscript (EPS)“. Beheben in den Druckereigenschaften.
• Der Anschluß verweist nicht auf den richtigen Pfad zu cmd.exe. Beheben in den Anschlußeigenschaften.
• Das Programmargument verweist nicht auf den richtigen Pfad zu ps2eps. Beheben in den Anschlußeigenschaften.
• bbox.exe ist in einem Verzeichnis installiert, das nicht im Suchpfad enthalten ist. Umkopieren.
• Irgendein Datei- oder Verzeichnisname enthält ein Leerzeichen. Das ist generell zu vermeiden.
• Irgendeine Option für Ghostscript wurde in falscher Groß-/Kleinschreibung angegeben. Bitte korrigieren, Ghostscript will genau die Schreibweise!

Sollte noch ein anderer Fehler auftreten, so empfehle ich, Google oder Google Groups zu konsultieren und zu sehen, ob jemand anders schon auf dasselbe Problem gestoßen ist. In den Anschlusseigenschaften kann ein Logfile mit Debug angegeben werden, welches dann mehr Informationen bietet. Mit diesem gestaltet sich die Fehlersuche wesentlich einfacher.

In einem früheren Blogpost über fancyref und varioref können Sie lesen, wie Sie für Verweise auf Kapitel statt »auf Seite 123« automatisch »ab Seite 123« schreiben, da das Kapitel ja erheblich länger ist und das Wort »auf« doch eine gewisse räumliche Nähe suggeriert.

Kapitel sind länger als nur eine Seite – der Querverweis sollte das zeigen

Da mich einige Nachfragen erreichten, wie das ganze denn mit dem neueren Paket cleveref funktioniere. Hier gibt’s die Lösung:

So geht’s

Das Prinzip ist dasselbe wie bei der Lösung für fancyref, nur eben mit den Befehlen für cleveref. Wichtig ist, dass die Pakete varioref, hyperref und cleveref genau in dieser Reihenfolge geladen werden. Die Sprache sollten Sie als Option der Dokumentklasse mitgeben, da sowohl cleveref als auch babel diese Information benötigen.

Da Sie für die eigentliche Anpassung Makros mit einem @ im Namen brauche, packen Sie den Code in zwischen die Befehle \makeatletter und \makeatother in den Zeilen 10 und 20.

Die Zeilen 12 bis 15 verändern den Befehl \cref@vref und fügen einen Merker für den momentan erkannten Ankertyp zu. Diesen brauchen Sie dann im nächsten Befehl.

Nun verändern Sie für die Sprache ngerman ein weitere Makro namens \reftextfaraway. Im Original schreibt dieses für weiter als eine Seite entfernte Querverweise den Text »auf Seite«. Sie fügen nun eine Verzweigung ein, die »ab Seite« einfügt, wenn der Anker auf ein Kapitel verweist, ansonsten das normale »auf Seite.« Und das war’s auch schon. Das Ergebnis sehen Sie in der erstellten PDF-Datei: abseitecr.pdf und in den folgenden zwei Zeilen:

Sehen wir später in Kapitel 2 ab Seite 3.

Sehen wir später in Abschnitt 2.1 auf Seite 3.

Da ich niemals auf ganze Teile eines Buchs verweise, sondern nur auf Kapitel oder darunter, reicht dies aus.

Sie wollen jetzt wissen, wie Sie mit den -Paketen für Querverweise umgehen? Dann empfehle ich Ihnen mein Buch »Wissenschaftliche Arbeiten schreiben mit « mit allem, was ein schönes Dokument ausmacht. Cleveref wird in der (zum Zeitpunkt dieses Blogposts noch nicht terminierten) fünften Auflage besprochen werden.

Foto: Ingy The Wingy auf Flickr, Lizenz CC-BY-ND.

Auszüge aus dem -Buch waren bislang auch schon auf der Website zum Buch zu finden. Die Möglichkeit beschränkte sich darauf, mittels Flash-Browser eine Layout-getreue Ansicht zu bekommen, und damit sowohl den Text lesen zu können, als auch einen Eindruck vom Layout und der Aufmachung des Buches zu erhalten. Der Text selbst aber blieb verwehrt. Wie das ganze mittels iPad oder iPhone lesen?

Jetzt endlich gibt es die Gratis-Kaptel direkt auf der Website in sauberem HTML, und zwar sowohl das komplette Inhaltsverzeichnis, als auch die Einführung in das Was & Warum von , sowie das Kapitel über die ersten Schritte in .

Jetzt können Sie nach Herzenslust direkt in den Texten probelesen, ohne an die Formatierung gebunden zu sein.

Unter der Haube: TeX4ht

Möglich wird dies durch die Konvertierung von nach HTML mittels TeX4ht, dessen Installation ich auch in meinem »Tutorial LaTeX installieren« bespreche. TeX4ht funktioniert auf den meisten normalen -Dokumenten hervorragend. Ein Text wie der meines Buches »Wissenschaftliche Arbeiten schreiben mit « bedarf einiger Vorbereitung mehr, da viele Konstrukte und Pakete, die ich dort zur Aufbereitung nutze, nicht direkt durch TeX4ht abgebildet werden.

Vieles, was ich zur Feinbestimmung des Layouts des Buches verwende, habe ich für die Konvertierung nach HTML entfernt. Dadurch beispielsweise entsprechen die Verweise auf Seiten dann auch nicht den Seitenzahlen im Buch.

Wie notwendig ist denn für Sie tatsächlich das gleichzeitige Publizieren nach PDF und HTML?

Bild: iPhone Screenshot, Rahmen generiert mit Smartphones@, Lizenz CC-BY.

Wer, was, warum?

Was ist Versionierung?

Darauf bin ich in einem früheren Artikel eingegangen, so dass hier die Kurzfassung reichen sollte:

Stellen Sie sich vor, löschen aus Versehen einige Absätze aus Ihrer Masterarbeit und speichern dann, nur um sofort danach zu erkennen, dass das eine blöde Idee war. Was nun?

Ohne Versionierung müssen Sie Ihr Backup herauskramen (das Sie hoffentlich haben!) und darauf bauen, dass es noch nicht zu alt ist. Mit Versionierung holen Sie sich die fraglichen Absätze aus der Historie des Dokuments zurück.

Das einzige, an das Sie denken müssen, ist, des öfteren Ihre Änderungen in das Versionierungs-System zu übermitteln, am besten mehrmals täglich. Das geht schnell und einfach und ist Ihre beste Versicherung.

Was ist Git?

Git ist ein solches Versionierungsprogramm. Es hilft ganz ausgezeichnet dabei, Dateien, also Dokumente, Skripte, Grafiken und was Sie sonst noch für Ihre Arbeit brauchen, in dem Verzeichnis zu versionieren, in dem Sie ohnehin arbeiten. Die Ablage (=Repository) liegt also nicht irgendwo anders, sondern genau hier.

Wenn Sie wollen oder müssen, können Sie diese Ablage replizieren, weitergeben, und auf diese Weise mit anderen am selben Projekt arbeiten, ohne dass Sie immer alle Zugriff auf dieselbe Ablage haben. Mehrere Kopien der Ablage lassen sich synchronisieren.

Ich habe noch nie mit LaTeX gearbeitet. Ist dieser Artikel für mich?

Ja, aber nur die ersten Abschnitte. Lernen Sie zunächst LaTeX. Es lohnt sich.

Ich habe noch nie mit Versionierung gearbeitet. Nehme ich Git oder Subversion?

Nehmen Sie Git. Warum? Weil der simpelste Anwendungsfall rascher einzurichten ist als bei Subversion. Subversion verlangt, dass Sie explizit ein Verzeichnis als Repository anlegen und dann mittels einer URL-Syntax von Ihrem eigentlichen Arbeitsverzeichnis darauf verweisen. Das dürfte für den einen oder anderen frischen LaTeX-Anwender schon ziemlich kompliziert sein. Mit Git brauchen Sie das alles nicht. Sie sagen quasi einfach »hier möchte ich mit Git arbeiten« und das war’s.

Erspart mir Git das Anlegen einer Sicherungskopie, das Backup?

Nein. Das eine hat mit dem anderen nur bedingt etwas zu tun. Eine Versionierung schützt Sie vor eigenen Untaten und erlaubt Ihnen, auf frühere Versionen zurückzugreifen. Ein Backup schützt Sie vor Datenverlust.

Ich verwende Mac OS X und die Time Machine. Brauche ich trotzdem Git?

Ja. Wenn Sie Apple Time Machine ständig am laufen haben, also Ihre Backup-Festplatte ständig am PC hängt, dann haben Sie tatsächlich jede Stunde einen Schnappschuss und damit eine Art Versionierung. Leider sind Sie dann nicht gegen Datenverlust geschützt, weil die Festplatte am selben Stromkreis hängt und im selben Moment stürbe wie der Computer, wenn ein Stromnetz-Fehler auftritt. Wenn Sie nun schlau sind und mit zwei externen Festplatten im wöchentlichen Wechsel arbeiten, dann können Sie immer nur auf die Versionen der aktuellen Woche zurückgreifen. Da müssten Sie schon Time Capsule verwenden und diese in einem anderen Stromnetz, am besten in einem anderen Haus stehen haben.

Einrichten

Herunterladen und Installieren

Am einfachsten laden Sie GitHub herunter, dann haben Sie auch gleich eine grafische Bedienoberfläche. GitHub gibt es für Windows, für Mac OS X und für Linux.

Installieren Sie das Programm. Beim ersten Aufruf werden Sie folgenden Bildschirm sehen:

Klicken Sie »cancel« oder drücken Sie die Escape-Taste, wie in Zukunft jedes Mal, wenn Sie GitHub starten. Sie brauchen keinen Login, und Sie brauchen sich auch nirgendwo zu registrieren (»sign up«). GitHub ist der Name eines Online-Dienstes, der es erlaubt, öffentliche Git-Ablagen zu erstellen und im Internet zu speichern, und dafür benötigt man eine Anmeldung. GitHub stellt dieses grafische Programm zur Verfügung, das auch hervorragend auf rein lokalen Ablagen (»Repositories«) funktioniert.

Auch wenn Sie kein GitHub-Konto möchten, so sollten Sie doch einen Namen konfigurieren, damit bei der Versionierung auch mit abgespeichert werden kann, dass Sie das getan haben. Irgendwann werden Sie es mal brauchen, wenn Sie nämlich dann doch mal zu mehreren Personen an einem Projekt arbeiten. Wählen Sie dazu »tools → options«.

Im folgenden Dialog geben Sie unten Ihren gewünschten Namen und eine eMail-Adresse an, die Sie für die Versionierung verwenden möchten. Diese Informationen werden nur lokal gespeichert und nirgendwo online verwendet. Bestätigen Sie mit »update«.

Ein Repository anlegen

Und genau eine solches Repository erstellen Sie jetzt, dem Sie auf »+ add« klicken.

Nun gehen wir davon aus, Sie hätten Ihre Masterarbeit schon begonnen und in einem Verzeichnis mit dem Namen »Masterarbeit« abgelegt. Als Beispieldateien nehme ich die LaTeX-Vorlagen aus meinem LaTeX-Buch.

Geben Sie Namen des Repositories an, der dem Namen des bereits existierenden Verzeichnisses entsprechen sollte, und eine Beschreibung, dazu wo das Verzeichnis liegt.

Ein Klick auf »create« setzt den Wunsch in die Tat um, und Sie können in der Übersicht Ihr neu erzeugtes Repository auswählen durch Doppelklick oder Klick auf den blauen Pfeil.

Sie sehen nun alle Dateien Ihres Verzeichnisses in der Ansicht, die Ihnen alle noch nicht synchronisierten Änderungen zeigt.

Konkret: Sie suchen jetzt aus, welche Dateien Sie der Versionierung unterwerfen wollen. Arbeiten Sie mit LaTeX, brauchen Sie nur die eigentlichen Dokument-Dateien ins die Ablage übertragen, alle Zwischendateien (*.aux *.log *.bbl *.blg *.idx und so weiter) werden ja von LaTeX, BibTeX, biber und ähnlichen Programmen, ohnehin jedes Mal beim Kompilieren neu erzeugt.

Zwischendateien ignorieren

Damit Sie nicht jedes Mal neu die Häkchen vor den unnötigen Dateien, die Sie nicht im Repository haben wollen, entfernen müssen, können Sie Dateitypen ausschließen. Wählen sie dazu »tools → settings«.

Sie sehen im Feld »ignored files« einige, die GitHub von vornherein ausschließt. Für LaTeX, BibTeX und Konsorten füge ich folgende weitere Dateitypen am Ende hinzu:

# TeX/LaTeX intermediates # 
########################### 
*.*~ 
*.aux 
*.log 
*.tmp 
*.xref 
*.pdx 
*.pnd 
*.bbl 
*.bcf 
*.auto 
*.blg 
*.dvi 
*.glo 
*.out 
*.idx 
*.ilg 
*.ind 
*.idv 
*.4ct 
*.4tc 
*.lg 
*.xmpi 
*.tcp 
*.toc 
*.tps 
*blx.bib 
*.run.xml

Diese Liste wird in Ihrem Verzeichnis in der Datei .gitignore gespeichert. Sie sollten diese zu Ihrem Repository hinzufügen.

Damit Sie dies nicht jedes Mal aufs Neue konfigurieren müssen, machen Sie die Liste global bekannt. Kopieren Sie dazu die Datei .gitignore in Ihr Benutzerverzeichnis (bei mir c:\Users\jschloss) und benennen sie um in .gitignore_global. Nun wählen Sie »tools → open a shell here«. Im Kommandozeilenfenster, das sich nun öffnet, geben Sie folgenden Befehl ein:

git config –global core.excludesfile ~/.gitignore_global

Wenn alles klappt, kommt keine Meldung und Sie brauchen sich in GitHub um viele Zwischendateien zukünftig nicht mehr zu kümmern.

Der erste Commit

Nun ist es soweit: Sie prüfen nochmal die Liste der Dateien, die Sie der Versionierung unterwerfen wollen, geben ins Feld »Commit Message« eine knappe Beschreibung dessen ein, was Sie gerade tun, nämlich »Erster Commit«. Ein »Commit« ist die Aktion, Änderungen an Ihren Dateien in das Repository zu übernehmen. Wenn Sie möchten, können Sie auch eine ausführlichere Beschreibung ins Feld »Extended Description« aufnehmen. Dies empfiehlt sich bei den meisten späteren Commits in Git.

Weiterarbeiten und Änderungen vornehmen

Jetzt schreiben Sie Ihr LaTeX-Dokument bzw. schreiben daran weiter. Sie fügen weitere Teile hinzu, es kommt die eine oder andere Grafikdatei dazu oder auch Rohdaten und Notizen, die Sie gerne versioniert haben wollen.

GitHub zeigt, wenn Sie »uncommitted changes« wählen, alle geänderten und alle noch nicht versionierten Dateien an.

Ein Klick auf die kleinen vertikalen Pfeile rechts neben dem Dateinamen erlaubt Ihnen, die Änderungen zu sehen, soweit GitHub die Dateien als Text erkennt.

Mit einem Klick auf den Dateinamen oder das Häkchen links daneben wählen Sie Dateien für diesen Commit an oder ab. Warum das? Entweder Sie wollen in einem Commit nur bestimmte Änderungen übertragen, oder Sie wollen bestimmte Dateien eben (noch) nicht versionieren. Wenn Sie die Auswahl getroffen haben, geben Sie wieder eine »Commit Message« an und klicken »commit«.

Jetzt sehen Sie rechts alle bisherigen Commits, zusammen mit ihren jeweiligen Kurzbeschreibungen – und deswegen sind diese auch so wichtig.

Mit einer Auswahl in dieser Liste können Sie ganz genau sehen, was sich jeweils geändert hat. Möchten Sie Ihren letzten Commit rückgängig machen, wählen Sie »revert commit«. Dies erzeugt einen neuen Commit, der Ihre letzten Aktionen rückgängig macht.

Wollen Sie zum Zustand eines weiter zurückreichenden Commit gehen, wählen Sie beim jeweiligen Commit »roll back to this commit«. Dieses ändert Ihre Dateien im Verzeichnis, also stellen Sie sicher, dass Sie vorher alles ins Repository übertragen haben, was Sie vielleicht noch brauchen!

Branch – Verzweigen zum Ausprobieren

Nehmen wir an Sie wollen eine andere Art der Formulierung im bestehenden Text ausprobieren und dieses Projekt mal einige Zeit nachverfolgen, ohne dass der Rest Ihres LaTeX-Dokuments leidet, an dem Sie ja normal weiterschreiben. Dann brauchen Sie das, was im Versionierungs-Jargon »Branch« heisst, zu deutsch »verzweigen«. Sie verzweigen also den Fortschritt Ihres LaTeX-Dokuments. Das ist okay, denn später hilft Ihnen Git, die Zweige wieder zusammenzuführen.

Einen Branch erzeugen

In GitHub bewerkstelligen Sie das, in dem Sie auf »Branches« klicken und dann einen Namen für den neuen Zweig angeben, beispielsweise »Ausprobieren«.

Sie sehen nun hinter dem Gabelsymbol nicht mehr »master« stehen, sondern »Ausprobieren«, und sehen damit, dass sich gleichzeitig der aktuelle Zweig geändert hat.

Jetzt heisst es ein wenig Disziplin an den Tag legen: Alles, was Sie jetzt an Ihrem Dokument und den damit verbundenen Dateien ändern, sollte tatsächlich nur das Ausprobieren sein. Führen Sie regelmäßig einen Commit durch.

Den Branch wechseln

Wollen Sie einfach ganz normal Ihr LaTeX-Dokument weiterschreiben, so sollten Sie das im »master«-Branch tun. Schließen Sie die Dokumente im Editor, führen nochmal einen Commit auf dem »Ausprobieren«-Branch durch und klicken dann auf das Verzweigungssysmbol wie vorher zum Anlegen, wählen dann »master« aus. Nun werden alle Dateien in Ihrem Arbeitsverzeichnis auf den Stand gesetzt, den sie hatten, als Sie das letzte Mal mit dem Hauptzweig gearbeitet haben.

Schreiben Sie nun unbekümmert weiter und führen auch hier wieder regelmäßig einen Commit durch, um die Fortschritte Ihrer Arbeit zu sichern.

Zusammenführen – Merge

Irgendwann kommt nun der Punkt, an dem Sie das, was Sie nur ausprobiert haben, tatsächlich in Ihr Dokument übernehmen wollen. Versionierungssysteme unterstützen dies mit einer Technik, die »merge« heisst, »zusammenführen«.

Klicken Sie wieder auf das Verzweigungssymbol und wählen dann »manage«.

In diesem Dialog steuern Sie die Zusammenführung der Zweige. Ziehen Sie den »Ausprobieren«-Zweig an die erste freie Stelle und den »master«-Zweig an die zweite. Mit einem Klick auf »merge« führt Git die beiden Zweige zusammen.

In der Historie der »unsynched commits« können Sie nun genau ersehen, was sich geändert hat.

Zusammenführen bei Konflikten

Falls Sie in den verschiedenen Zweigen an denselben Stellen, in denselben Zeilen etwas geändert haben, kommt es beim Zusammenführen natürlich zum Konflikt. Diesen müssen Sie dann selbst beheben. Klicken Sie dazu auf »cancel«, um dann im Hauptfenster von GitHub zu sehen, welche LaTeX-Dateien den Merge verhindern.

Sie sehen eine Zeile Kleiner-Zeichen <<<<<<<<<<<<, gefolgt von der Fassung der betreffenden Zeile im Hauptzweig, gefolgt von einer Zeile Gleichzeichen ===============, der Version aus dem anderen Zweig, das ganze abgeschlossen von einer Zeile Größer-Zeichen >>>>>>>>>>>>.

In dieser Ansicht können Sie jedoch das Schlamassel nur sehen, nicht jedoch beheben. Dazu laden Sie die Datei in Ihren normalen LaTeX-Editor. Modifizieren Sie die fraglichen Abschnitte so, dass es für Sie passt. Löschen Sie die Markierungszeilen.

Dann können Sie wieder einen Commit durchführen, und als passenden Kommentar beispielsweise »Manuellen Merge« angeben.

Bei komplizierteren Merges ist es möglich, dass GitHub Sie auffordert, den Konflikt in der Shell zu beheben, also auf der Kommandozeile. Für das genaue Vorgehen empfehle ich Ihnen den entsprechenden Abschnitt zum Thema Merges in der hervorragenden Dokumentation von Git.

Zusammenfassung

Git und die grafische Oberfläche GitHub sind eine ideale Ergänzung für Ihre Schreibarbeit mit LaTeX. Die Versionierung geschieht dort, wo Sie sowieso Ihr LaTeX-Dokument liegen haben, Sie brauchen sich nicht wie bei anderen Versionierungssystemen mit dem Anlegen eines speziellen Repositories zu beschäftigen.

In einem der nächsten Artikel werde ich beleuchten, wie Sie mit Git und LaTeX zu mehreren Autoren ein Dokument schreiben. Folgen Sie mir auf Twitter, Google+ oder abonnieren Sie diesen Blog, um davon zu erfahren.

Git ist ebenso leichtgewichtig wie mächtig. Fangen Sie jetzt damit an und ersparen Sie sich zukünftig die Frage »wie hatte ich das denn vorgestern formuliert?«

Und wie versionieren Sie?

Git Logo by Jason Long is licensed under the Creative Commons Attribution 3.0 Unported License.

Der folgende Artikel erschien ursprünglich auf der LaTeX-Buch Seite und ist im Original dort zu finden.

Zen

ist anders. hat den Fokus aufs Wesentliche – den Inhalt eines Textes – so tief in den Genen, so tief im Konzept verankert, dass es viel leichter fällt, sich darauf ein und die Finger von wilden manuellen Formatierungen zu lassen. zu lernen heißt, sich auf eine andere Art des Schreibens einzulassen. Eine Art des Schreibens, bei der das geschriebene Wort zunächst wichtiger ist als der Schriftsatz, in der das Wort aufs Papier oder ins PDF gebracht werden soll. Und doch: Indem sich der Student, Doktorand, Wissenschaftler, Literat, Lehrer, Schüler oder Autoren und ganz normale Menschen wie Du und ich auf das Schreiben von Text und Struktur des Dokuments beschränken, lassen wir den Automaten, der heißt, seine Kenntnis ausspielen, wie ein gutes, schönes Schriftstück aussieht.

Ich lerne ist eine Rückbesinnung aufs Wesentliche, es ist Zen-Schreiben. Ja, lernen bedeutet, sich mit seltsamen Ausdrücken auseinanderzusetzen die man mitten in seinen Text schreiben soll. lernen bedeutet zu akzeptieren, dass man nicht sofort auf dem Bildschirm sieht, wie es vielleicht später auf Papier herauskommt. lernen heißt, die Struktur seines Dokuments wirklich zu bestimmen. lernen heißt Demut zeigen und sich nicht für den Experten für Ästhetik von Schriftstücken zu halten.

Zuverlässigkeit

Noch vor einigen Jahren war der Fall klar – sobald eine Arbeit mit Literaturhinweisen versehen sein soll, und diese Referenzen und das Literaturverzeichnis jederzeit sauber und halbwegs automatisch erzeugt werden soll, führte am Lernen von kein Weg vorbei. Ebenso wie für saubere Zeilenumbrüche. Und wenn man noch einige Jahre weiter zurückdenkt, war auch eine der wenigen stabilen Möglichkeiten, große Dokumente zu erstellen. Literaturverzeichnis kann heute auch ein Microsoft Word, sogar ein LibreOffice hat irgendwo für Literaturverweise eine Funktion vergraben. Word stürzt fast nie mehr ab, und es hat nun ein einigermassen nachvollziehbares Dateiformat. Doch auch heute machen insbesondere Anwender von Textverarbeitungsprogrammen immer noch Probeausdrucke. Warum, wenn das System doch darauf ausgelegt ist, schon auf dem Bildschirm anzuzeigen, was man später bekommt? (WYSIWYG = what you see is what you get) Weil sie sich eben nicht sicher sind. Weil es auf dem Bildschirm eben doch anders wirkt.

Mit mache ich fast nie einen Probeausdruck, wenn das, was ich im PDF sehe, ist exakt das, was ich später auf dem Drucker erwarten kann. Mit habe ich die Gewissheit, jede Anforderung an das Aussehen eines Literaturverzeichnis auf dieselbe Weise umsetzen zu können, und jede Art von Literaturverweis sauber und zuverlässig zu setzen – und wie die jüngere Vergangenheit lehrt, kann das über Karrieren entscheiden. Mit habe ich die Gewissheit, jede Dokumentgröße bearbeiten zu können, jedes Kapitelformat absolut reproduzierbar gestalten zu können. Wer schonmal ein Microsoft Word Dokument in LibreOffice oder OpenOffice.org geöffnet hat und andersherum, der wird es in als sehr angenehm empfinden, wenn der Konferenzbeitrag, die Masterarbeit nach verarbeiten durch eine andere -Distribution genauso aussieht wie bei der eigenen.

Zuwachs

lernen in Mathematik, Physik, Informatik oder Ingenieurwissenschaften wie Elektrotechnik oder Maschinenbau heißt, den theoretischen Unterbau der Fächer leichter zu Papier bringen zu können und auf viel Erfahrung und bestehendes Material zurückgreifen zu können. lernen in Jura, Lehramt, Wirtschaftswissenschaften oder Geisteswissenschaften heißt, die sprachliche Präzision, die angemessen ist, auch auf das Schreiben und in Dokumente zu übernehmen. Und damit ein Zuwachs an Professionalität.

lernen in einer Umgebung, in der nicht sowieso alle in schreiben heißt, auch mal schief angesehen und für seltsam erklärt zu werden. lernen heißt freilich auch, manchmal einen Fehler zu suchen, der das Verarbeiten des Dokuments verhindert – was oft seinen Grund darin hat, dass man irgend einen Automatismus überlisten will und meist gar nicht bräuchte. Und damit heißt lernen eben auch, immer wieder subtil darauf hingewiesen zu werden, dass das eigentliche am Schreiben der Inhalt des Textes ist. Und ebenso heißt lernen damit auch, sich immer wieder aufs neue zu freuen, welch schönes Ergebnis am Ende steht.

Warum also lernen? Nicht obwohl es anders ist. Sondern genau darum.

Fangen Sie an. Darum gibt es das LaTeX-Buch.

(Bild: Enso von Alex Castro auf Flickr. Lizenz CC-BY)

Mein spezieller Dank gilt an dieser Stelle denjenigen, die Fehler gefunden und vor allem mir mitgeteilt haben: Torben L, Helga Schmid, Henrik B., Fabian B., Peter B., Michael F., Stefan S., Christoph T., Justin G., André W. und Nadja Vajkonny. Danke fürs aufmerksame Lesen!

Wer mal reinschmökern möchte, kann das gerne tun auf der Seite zum LaTeX-Buch Probelesen.

Was wollen Sie bewirken? Wird Ihr Schriftstück tatsächlich besser, wenn Sie jetzt Stunden verbringen, um ein setzerisches Detail einzubauen? Vielleicht ja. Vielleicht sieht es tatsächlich besser aus. Und ja, Sie können tatsächlich sinnvoll Zeit mit der Suche nach der Lösung für setzerische Detailprobleme verbringen. Wenn Sie ansonsten komplett fertig sind, wenn Ihr Text inhaltlich vollkommen ist. Wenn Ihr Literaturverzeichnis vollständig ist, also alles referenziert, was Sie referenzieren sollten. Wenn Sie das Stichwortverzeichnis mit sinnvollen Wörtern befüllt haben, falls ihr Werk gedruckt werden soll, da in rein elektronischen Veröffentlichungen die Volltextsuche einen Index überflüssig macht. Wenn Ihre Querverweise sinnvoll sind. Wenn Ihre Grafiken dem Inhalt dienen und gut aussehen.

Dann, und nicht vorher, können Sie sich mit einem LaTeX-Hack bzw. der Suche danach beschäftigen. Sobald Sie an dieser Stelle ankommen, dann sind Sie kein Anfänger mehr. Sobald Sie an dieser Stelle ankommen, haben Sie wahrscheinlich schon einige Male mit englischen Erläuterungen von LaTeX-Eigenheiten zu tun gehabt, sei es in Form von Fehlermeldungen oder in Form einer Paketdokumentation. Und das ist auch gut so. Denn letztendlich können Sie die Funktionalität jeder Dokumentklasse, jeden Pakets verändern und erweitern, indem Sie Befehle umdefinieren, eigene Konstrukte hinzufügen und vorhandene außer Kraft setzen. Damit verlassen Sie in der Regel den Bereich, der für die normale Anwendung einer Klasse oder eines Pakets gedacht ist. Das ist okay, wenn ihnen klar ist, dass Sie sich dieser Bereich hinter den Kulissen ohne Vorwarnung von einer Version zur nächsten ändern kann, dass er oft schlecht ausgeschildert ist und möglicherweise mit anderen wechselwirkt. Kurzum: wer weiß, was er tut, kann alles tun. Die andere Art von Hacks, die Sie im Netz finden, verwenden gar keine Pakete, sondern basieren auf TeX-Basisbefehlen und bauen bestimmte Eigenschaften von Null auf nach. Auch daran ist nichts auszusetzen, wenn Ihnen bewusst ist, dass die von Ihnen gewünschte Eigenschaft vielleicht schon in anderer Form existiert und das Hack damit wiederum wechselwirkt.

Die Abhängigkeiten und Fehlerquellen sind so mannigfaltig und machen es damit unwahrscheinlich ist, dass Sie aufs erste Mal eine Lösung hinbekommen, die das tut, was Sie wollen und dazu keine einzige Fehlermeldung beim Kompilieren auswirft. Wenn Sie also eine Sammlung von speziellen Tricks zur Hand nehmen, wird diese Sie unweigerlich irgendwann verlassen, weil der Autor ja nicht wissen kann, was Sie an Paketen alles verwenden. Und dann müssen Sie sich ohnehin durch den Quellcode von Paketen wühlen und diesen versuchen zu verstehen.

Freilich habe auch ich für das LaTeX-Buch an so mancher Definition herumgebogen, um das Layout genau so hinzubekommen, wie es die Buchreihe des Verlags vorsieht. Das ganze habe ich möglichst weit oben und vollständig in den dafür vorgesehenen Rahmen von KOMA-Script programmiert, womit es eigentlich kein Hack mehr ist, sondern fortgeschrittene Anwendung. An anderer Stelle überschrieb ich tatsächlich Paketverhalten.

Im Buch werden Sie keine Beispiele dafür finden, denn ich möchte, dass Sie LaTeX als eine Dokumentsprache erleben, die einfach anzuwenden ist. Oder, um es mit den Worten Dieter Moors auszudrücken: »Was wir nicht haben, brauchen Sie nicht.« Bei keiner meiner wissenschaftlichen Arbeiten, weder bei Dissertation noch bei Diplomarbeit, habe ich einen solchen Hack verwendet oder vermisst.

Halten Sie es einfach. Es geht mit Bordmitteln schön.

Natürlich ist es schön, immer seine halbe Bibliothek dabei zu haben, doch in den meisten Fällen brauche ich das nicht, die paar Bücher, die ich gerade lese, reichen ja aus. Doch das sind nicht die Gründe für meine abwartende Haltung, sondern die folgenden:

1. Zuallererst möchte ich ein flexibles Display bzw. ein flexibles Gerät haben, das ich auch mal unordentlich einfach in die Tasche stecken kann. Eines, das nicht bricht, wenn ich dann doch noch ein echtes Buch darauf drücke. Eines, vom Knicken nicht kaputt geht. Halt so wie echtes Papier. E-Ink in schwarzweiss reicht erstmal. Die meisten Bücher, die ich lese, sind eh nur Text. Flexibles Display gibt’s schon, nur in einem eBook Reader habe ich es noch nicht gesehen.
2. Ein Buch muss ich nicht aufladen. Gut, ein eBook-Reader braucht halt Strom, aber dann sollte er sich bitte selbst aufladen. Ob da jetzt auf der Rückseite Solarzellen drauf sind und es dann ausreicht, wenn ich ihn ein oder zwei Stunden auf dem Schreibtisch nahe dem Fenster liegen habe, oder ob er den Strom aus der Bewegung oder von mir aus Radiowellen zieht, ist mir wurscht.
3. Papierbücher kann ich aus- und herleihen. Und so will ich auch für eBooks die Möglichkeit haben, Bücher aus- und herzuleihen. Das kann gerne auch mit DRM sein, so dass, so lange ich das Buch hergeliehen habe, es selbst nicht lesen kann. Insgesamt hat das Ausleihen von eBooks dann vielleicht sogar einen Vorteil: Ich wüsste immer, wem ich ein Buch ausgeliehen habe, und auch derjenige weiß, von wem er es hat. Das wäre durchaus mal eine faire Anwendung von DRM. (Einen ersten Ansatz davon beschreibt Johnny Haeusler im Artikel über MexxBooks.)
4. Und schließlich sollte ich auch vernünftig daraus zitieren können. Beim Papierbuch kann ich schreiben »auf Seite 381« und habe die Fundstelle dadurch bis auf wenige Absätze eingegrenzt aber beim eBook? Die Angabe »bei 79%« kann bei langen Werken zehn Papierseiten umfassen, und eine genauere Angabe »bei 79,832%« macht auch erst Sinn, wenn die Zählung bei den meisten eBook-Readern verbreitet und standardisiert ist.

So, wir machen das jetzt genauso wie mit dem Handy. 2001 kaufte ich mein Nokia 6150, und verkündete fortan, ich würde mir erst wieder ein neues Handy kaufen, wenn es eines ohne Tasten gäbe und zwar ziemlich reif. Neun Jahre später war’s dann soweit. Und genau so machen wir das jetzt mit dem eBook-Reader.

Eilt nicht. Ich kann’s erwarten. Über ein »Danke für die Produktidee« würde ich mich freuen.

(Foto: Cloned Milkmen on Flickr, License CC-BY-SA)

Ein Kindergarten macht weder sein Geschäft mit einer Website, noch ist diese das wichtigste Instrument der Geschäftsanbahnung (Ich spreche bewusst von Geschäft, denn egal ob privat, städtisch oder kirchlich: ausgelastet wollen sie alle sein). So ist es in der Regel nicht möglich, auf Dauer eine Agentur zu beauftragen und jede Änderung durch diese durchführen zu lassen. Eigenhändig aus Word HTML-Dateien exportieren ist auch keine zweckmäßige Lösung. Nun gibt es beispielsweise für evangelische Kindergärten in Bayern eine Lösung, bei der ein stark abgespecktes Webinterface zur Verfügung steht. In diesem kann eine geringe Anzahl Seiten mit wenigen Bildern abgelegt und mit einer hand voll Farbschemata versehen werden. Für einen Kindergarten, der sein Betreuungskonzept sauber gegliedert veröffentlichen möchte und außerdem noch einen optischen Eindruck vom Kindergartenleben geben will, ist das zu wenig. Und eine eigene Domain sollte auch dabei sein.

Also braucht es irgendetwas zwischen Agentur und selber machen. WordPress erlaubt verschiedene Rollen, sowohl den Administrator, der alles überblickt, als auch den Redakteur, der Inhalte verfasst und freigibt. Irgendein Elternteil, der WordPress einrichten beziehungsweise pflegen kann, ist ja immer da.

In unserem Fall bin das ich. Die Seiten, die die Evangelische Kindertagesstätte Göggingen in Augsburg nun hat, sind einfach gehalten, sowohl optisch als auch von der Struktur her. Die Struktur kann die Kindergartenleiterin dank des genialen Menümechanismus in WordPress selbst per Drag & Drop anpassen und sieht sofort, was sie tut. Sie kann selbst Seiten anlegen, Texte schreiben und Fotos hochladen, und in neueren Versionen wird die Benutzung immer weiter vereinfacht. Die Gestaltung habe ich einmal vorgenommen, da muss sie sich keine Mühe mehr machen. Zweifellos bin ich kein Gestalter, doch eventuell finden wir ja noch einen Elternteil, der dafür ein Faible hat und der dank der Standardplattform WordPress leicht das Aussehen der Website ändern kann.

Mittlerweile haben sich auch die zwei anderen Kindergärten der Pfarreiengemeinschaft, der Johanneskindergarten in Augsburg-Inningen und der Immanuelkindergarten in Augsburg-Leitershofen angeschlossen. Ihnen habe ich eine ähnliche Struktur und ähnliches Design verpasst, nur die Inhalte unterscheiden sich.

Eine Website geht zwar zu einem Zeitpunt online, doch sie lebt. Es sollte kein einmaliges Dokument sein, was wir da fabrizieren, sondern sich ändern und anpassen können. Nach einer ersten Einführung in die Arbeit mit WordPress haben die Damen nun auch schon Lust bekommen, ab und an auf aktuelle Ereignisse oder Neuigkeiten über die Website hinweisen zu können. Und siehe da, auch da hiflt WordPress. Denn dafür wurde es ursprünglich gebaut, andere Leute sagen nämlich »Blog« dazu.

So wie WordPress sollte Software sein: Leicht zu benutzen für jede Rolle. Den, der Texte verfassen soll, nicht mit anderen Dingen verunsichern, und dennoch alle Möglichkeiten haben. Vielleicht steigt ja das zentrale Angebot für die Kindergärten irgendwann auf WordPress um, dann können wir die Seiten umziehen. Oder der nächste Elternteil übernimmt. Denn WordPress – dafür findet sich immer jemand.

Danke, WordPress.

Bei welchem Projekt hat Ihnen WordPress schon geholfen?

Foto: Joachim Schlosser auf Flickr, Lizenz CC-BY-SA