Schreibblogg.de > SPBuchsatz > 1. Installation und erste Schritte

Karl-Heinz Zimmer

SPBuchsatz: Schöner Textsatz für Selfpublisher


gehe nach unten

Kurzinfo:

SPBuchsatz entwickelte ich als freies Hilfesystem für mit mir auf Twitter befreundete Selfpublisher.

Ziel ist die Vereinfachung des hochwertigen Buchsatzes mit TeX für deutschsprachige Romane, Novellen oder Geschichtensammlungen.

Die Nutzung ist lizenzkostenfrei gestattet.

Garantie kann ich keine geben und keine Gewährleistung übernehmen:
Falls du SPBuchsatz verwendest, tust du dies auf eigene Gefahr, auch wenn ich natürlich jede neue Version ausgiebig teste und Beta-Test(s) durchführen lasse.

Bei Fragen:

Individual-Support per DMs oder Mail leiste ich nicht, beantworte (im Rahmen meiner zeitlichen Möglichkeiten) aber gerne deine öffentlichen Fragen:

Mein Twittername ist @khzimmer2 und ich antworte, wenn du deine Frage als öffentlichen Tweet schreibst, d. h. sende den Tweet nicht an mich, sondern schreibe ihn als normalen Tweet, auf folgende Weise.

Schreibe als erstes Wort den besonderen Hashtag:

#SPBuchsatzFrage

Darunter schreibe bitte deine Frage. 🙂

Dies hat zwei Vorteile:

1. Antworten-Sammlung: Öffentliche Fragen und Antworten sind auch für Dritte nachlesbar, so ergeben sich nach und nach immer bessere Möglichkeiten, durch Nutzung der Twitter-Suchfunktion rasch eine Antwort zu finden, ohne selber neu fragen zu müssen.

Meine Antworten haben immer den Hashtag: #SPBuchsatzAntwort

Der Link findet sie:

https://twitter.com/search?f=tweets&q=%40khzimmer2 %23SPBuchsatzAntwort

Zur gezielten Suche hänge den passenden Begriff nach einer Leerstelle an.
Dieser Link sucht nach dem Wort „definiere“:

https://twitter.com/search?f=tweets&q=%40khzimmer2 %23SPBuchsatzAntwort definiere

2. Peer Support: Öffentlich gestellte Fragen werden von vielen Leuten gelesen, evtl. kennt jemand die Antwort und hilft gerne, ehe ich Abends die Frage sehe und Zeit finde, selber zu antworten.


gehe nach obengehe nach unten

Einleitung

Dein Buch hast du geschrieben mit Freude und Konzentration und willst es gedruckt veröffentlichen als Selfpublisher:

Schön soll es aussehen — außen wie innen! Professionell und überzeugend soll es wirken, wie die Werke sorgsam arbeitender Verlage.

Die Umschlaggestaltung vertraust du vermutlich einer Person mit Designerfahrung an, doch den Satz des inneren Buches möchtest du selber realisieren, um volle Kontrolle beim Umbruch zu haben.

Möglicherweise hörtest du bereits von TeX: Die ursprünglich für hochwertige Drucksachen im universitären Umfeld entwickelte, freie Software wird auch für belletristische Bücher sehr erfolgreich genutzt.

Beispieltext, links gesetzt mit herkömmlichem Textverarbeitungsprogramm, rechts mit TeX:

SPBuchsatz 1 002

Abstrakte Darstellung der Grauwertverteilung im Text:

SPBuchsatz 1 003

Der linke Text zeigt drei typographische Fehler:

  1. Zeilen mit großen Wortabständen und engere Zeilen wechseln planlos ab, denn das Textverarbeitungsprogramm beherrscht keinen Absatz- sondern nur Zeilen-bezogenen Umbruch.
  2. Die Enden der zweiten und der dritten Zeile des ersten Absatzes wirken ›angefressen‹, denn das Textverarbeitungsprogramm erzeugt keine optischen Randausgleich.
  3. Unten links irritieren sog. Gassen beim Lesen.

Der rechte Text wäre buchtauglich: TeX vergleicht alle Zeilen eines Absatzes und erzeugt möglichst ähnlich weite Wortabstände. Der optische Randausgleich nimmt Trennstrichen ihren Schrecken, da sie nicht so weit in die Zeile hinein ragen. Automatische Feinjustierung durch Paket microtype verringert das Risiko breiter Gassen und ergibt gleichmäßigeren Text.
Die Seite wirkt ordentlich, solch ein Buch ist angenehm lesbar. (Beide obigen Texte sind unkorrigierte Umbruch-Ergebnisse des jeweiligen Programms.)

Du möchtest guten Textsatz für Dein Buch und fragst dich, wie viel Aufwand es wäre, Dein Buch mit TeX zu setzen?

Früher war dazu ernsthafte Einarbeitung nötig, es galt, die Konzepte und Syntax der TeX/LaTeX-Welt zu verinnerlichen und sich mit KOMA-Script zu befassen, um dann, vor Beginn der eigentlichen Textsatz-Arbeit, eine sog. Präambel zu erstellen. Alles machbar, allerdings etwas mühsam, denn die Welt von TeX ist logisch, aber nicht intuitiv.

Eine qualitätsbewusste Schriftstellerin bringt es auf den Punkt:

Nachdem das Manuskript inhaltlich steht, ist der Buchsatz für mich die größte Herausforderung. Mit TeX kann ich es erreichen, dass der Buchblock aufgeräumt und klar wirkt. Mein höchstes Ziel ist nämlich ein guter Lesefluss. Ich muss mir nur einmal die Mühe machen, alles zu verstehen und mir einzurichten. Danach kann ich jedes Buch nach dieser ersten selbst erstellten Vorlage setzen. Und beliebig Änderungen machen.
Magret Kindermann, Autorin

Die freie Software SPBuchsatz will die Einstiegshürde senken und dir das exzellente Textsatz-System bequemer verfügbar machen:

TeX-Qualität für ganz normale Leute, also für Menschen, die keine Programmiersprache beherrschen und einfach nur ihren Roman oder ihre Geschichtensammlung ordentlich setzen möchten.

SPBuchsatz bedeutet schönere Selfpublisher-Bücher.

Ein zufriedener Autor:

Als Selfpublisher steht man vor einigen Herausforderungen, die weit über das Schreiben von Geschichten hinausgehen. Eine der größten ist die Erstellung des Buchsatzes. Man will ja schließlich, dass das eigene Buch professionell aussieht und nicht wie mit der Hand geschrieben. SPBuchsatz hat mir dabei einen Haufen Arbeit abgenommen. Anstatt in mühsamer Kleinarbeit jede Klammer und jedes Schrägzeichen selbst einzusetzen, muss man größtenteils nur noch die Lücken füllen, die bereits vorgegeben sind. Durch die Hilfsdateien und Möglichkeiten zur Fehlersuche erhält man am Ende ein Ergebnis, das sich mit jedem Verlagsbuch messen kann.
Marcel Michaelsen, Autor

SPBuchsatz erwartet dein Mitdenken und erfordert, wie jedes ernsthafte Textsatz-Programm, Geduld und Zeit zur Textsatz-Feinkorrektur.

Es ist die Mühe wert.

Eine begeisterte Autorin:

Ich werde das Programm auf jeden Fall auch in Zukunft beim Buchsatz benutzen. Auch wenn du dich am Anfang etwas reinfuchsen musst, ist es das insgesamt auf jeden Fall wert.
Autorin Jennifer J. Grimm / Kaye Pearson


gehe nach obengehe nach unten

Kurzübersicht

Bitte lies den Abschnitt in Ruhe durch und sieh die drei Grafiken an.

Die Übersicht hilft, die nachfolgenden Hinweise zu verstehen.

Du benötigst drei (evtl. vier) Programme:

  1. Den Dateimanager deines Betriebssystems
    (in Windows: Datei-Explorer; in macOS: Finder)

    Du bist unerfahren in der Anwendung des Dateimanagers?
    Bitte eine kenntnisreiche Freundin, dir zu zeigen, wie du einen Ordner (mit allen
    enthaltenen Dateien und Unterordnern)
    kopierst und diese Kopie dann umbenennst,
    so dass die Kopie des Ordners anschließend neben dem originalen Ordner liegt.
     

  2. Dein normales Text-Schreibprogramm
    (z. B. Microsoft Word oder Papyrus Autor)
     
  3. Das Programm TeXworks
    (wird bei der unten beschriebenen Installation von TeX Live automatisch mit installiert)
     
  4. Falls du keine aktuelle Windows-Version hast, benötigst du
    (nur während der Installation) vermutlich zusätzlich das Programm 7-Zip
    zum auspacken des SPBuchsatz-Projekte-Pakets.

    Du fühlst dich unsicher, was das Auspacken von .ZIP-Archiven betrifft?
    Bitte eine Freundin, dir bei der unten beschriebenen Installation
    von TeX Live und SPBuchsatz zu helfen.
     

Hier siehst du, wozu du die drei Programme verwendest, bitte probiere das jetzt noch nicht aus:

SPBuchsatz 1 000

So hilft SPBuchsatz dir:

Den Textsatz erledigt TeX für dich. SPBuchsatz ist eine kleine, nützliche Zwischenschicht und macht dir das Leben leichter. 🙂

Zur einfacheren Verwendung abstrahiert SPBuchsatz die für Romane, Novellen und Geschichten-Sammlungen meist-benötigten Befehle und Schlüsselwörter der inneren Ebene und bietet dir übersichtliche, deutschsprachige Hilfsfunktionen.

Zur Qualitätsicherung deines Buches macht SPBuchsatz dich (im Feinkorrektur-Modus) auf die häufigsten, typographischen Fehler aufmerksam und führt eine Absatz-Randkontrolle durch.

Hast du den Text und deine Daten in die drei Dateien eingetragen und die Feinkorrektur durchgeführt, generiert SPBuchsatz daraus mit Hilfe von TeX und ergänzenden Programmpaketen den fertigen Buchblock:

SPBuchsatz 1 001

Die Idee des Zentraldokuments ist dir vielleicht aus Textverarbeitungsprogrammen vertraut, bei SPBuchsatz nimmt es deine Daten auf, z. B. für Titel und Impressum, und verbindet deine Textdateien mit den internen Dateien.
(Letztere sind in der Skizze nicht gezeigt, da du sie im Normalfall nicht zu öffnen brauchst, auch wenn dir natürlich alle Optionen der individuellen Anpassung darin offen stehen, z. B. stellt SPBuchsatz eine LaTeX-Präambel und eine Datei zur Titelei-Erzeugung bereit und parametrisiert beide automatisch nach deinen im Zentraldokument eingetragenen Vorgaben.)

Freie Nutzbarkeit: So wie TeX selbst, ist auch SPBuchsatz freie Software und steht dir zur lizenzkostenfreien Nutzung zur Verfügung.
(Näheres, auch für den Fall, dass Du SPBuchsatz modifizieren möchtest, regelt die im Umfeld häufig verwendete und auch für SPBuchsatz geltende LaTeX Project Public License, siehe: http://www.latex-project.org/lppl.txt.)

Zusätzlich zur Vereinfachung der deutschsprachigen Arbeit mit TeX, bietet SPBuchsatz folgende Hauptvorteile:

  • Erzeugen der erweiterten Titelei
    mit Impressum und, wenn gewünscht, beschreibbarer Rückseite des Schmutztitels
  • Nützliche Hilfsfunktionen für Buchelemente
    (z. B. zum Einfügen eines Bildes im Fließtext mit anschließend automatisch wieder hergestellter Registerhaltigkeit)
  • Unterstützung von graphischen Szenentrennern
  • Einfache Kapitel-Titel-Vorlagenverwaltung

und besonders:

  • Optische Markierungen von zu prüfenden Stellen
    zur Textfehler-Erkennung und für die Textsatz-Detailoptimierung

Der letzte Punkt ist entscheidend, um ein ordentliches Resultat zu erzielen, denn viele Menschen erkennen auf einen Blick, ob ein Text sorgsam gesetzt wurde, und bewerten dein Buch unter Umständen ebenso sehr nach Cover und innerer Optik wie nach der darin abgedruckten Geschichte. SPBuchsatz unterstützt dich bei dieser manuellen Feinabstimmung:

Typographische Regeln helfen seit Jahrhunderten den Buchsetzer*innen, optisch gefällige, angenehm lesbare Texte herzustellen. SPBuchsatz nutzt einen Teil dieses Wissens und weist dich durch farbige Markierungen auf Details hin, die evtl. zu verbessern wären.

Der folgende Beispieltext wurde absichtlich so konstruiert, dass mehrere Markierungen zugleich auftreten. Bei der normalen Arbeit wirst du ihnen seltener begegnen und die vereinzelten Symbole finden deine Aufmerksamkeit beim Durchsehen der Seiten:

SPBuchsatz 1 004

Diese optischen Hinweise dienen deiner Orientierung, d.h. du selber entscheidest, was du korrigierst oder ignorierst: Bist du zufrieden mit dem Ergebnis, schaltest du die Markierungen aus und erzeugst den fertigen Buchblock. Theoretisch (aber nicht empfehlenswert) könntest du die Hinweise alle ignorieren, dein Ergebnis wäre dann zwar typographisch falsch, doch allemal schöner, als wenn Du die PDF-Export-Funktion eines Textverarbeitungsprogramms verwendet hättest.

(technisch gesehen: Die bunten Symbole sind sog. PDF Literale, sie werden durch Skripte in der Programmiersprache Lua generiert, die du selber ändern oder ergänzen könntest, falls du dich eines Tages in die interessante Welt von LuaTeX einarbeiten möchtest. Auch diese Skripte sind freie Software im Sinne der LaTeX Project Public License.)


gehe nach obengehe nach unten

Installation

SPBuchsatz basiert auf LuaTeX und verwendet einige Hilfspakete, die du unter Windows (und auch unter Linux) am bequemsten installiert bekommst durch Verwendung der bekannten Distribution TeX Live.

  1. Installation von TeX Live
    • Du bist Linuxer*in?
      Erkundige dich über die Namen der für deine Distro zu installierenden Pakete!
      Unter […]Ubuntu beispielsweise ist TeXworks ein eigenes Paket, das du bitte zusätzlich zu texlive-full installierst:
           sudo apt-get install texlive-full texworks

    In der Windows- und der Mac-Ausgabe ist TeX Live vollständig, es bringt alle von SPBuchsatz benötigten Pakete mit und hat auch TeXworks an Bord:

  2. Du hast TeX Live installiert, starte nun das Programm TeXworks:

  3. Stelle in TeXworks das Standard-Verarbeitungsprogramm um, denn SPBuchsatz verwendet nicht pdfLaTeX sondern LuaLaTeX.
    Wähle dazu im Einstellungen-Dialog LuaLaTeX aus:

    SPBuchsatz 1 005

    Ab jetzt sollte bei neuen Dokumenten über dem Editor-Fenster jeweils LuaLaTeX ausgewählt sein:

    SPBuchsatz 1 006

  4. Installiere SPBuchsatz.
     

    1. Lade das SPBuchsatz-Projekte-Paket von dort herunter: https://schreibblogg.de/SPBuchsatz/
    2. Entpacke (z. B. mit der freien Software 7-Zip) das Paket auf deinem PC und speichere den Inhalt in dem Ordner, in dem du zukünftig deine Buchsatz-Projekte bearbeiten möchtest.Das Paket enthält einen Ordner namens SPBuchsatz_Projekte_….Dein Dokumente-Ordner könnte ein sinnvoller Speicherort sein:

      SPBuchsatz 1 007


gehe nach obengehe nach unten

Ordner und Dateien

Der SPBuchsatz-Ordner nach dem Auspacken des Pakets:

SPBuchsatz 1 008

Der tex-Ordner des mitgelieferten Beispielbuch-Projekts:

SPBuchsatz 1 009

Inhalt des tex-Ordners:

  • Hilfs-Ordner: lokales_System
    Inhalt: Von SPBuchsatz für dieses eine Buch verwendete, interne Steuer-Dateien.
    Jedes SPBuchsatz-Projekt enthält einen solchen Ordner, normalerweise wird es keinen Grund für dich geben, darin Änderungen vorzunehmen.
    (Sinn der Aufteilung in das globale SPBuchsatz-System und die lokalen Ordner: Das lokale System könntest Du bei Bedarf für ein Buch anpassen, ohne dass dadurch deine anderen Buchprojekte verändert würden.)
     
  • Zentraldokument: Fauchende_Kesselfeuer.tex
    Das Beispielbuch trägt den Titel Fauchende Kesselfeuer, entsprechend heißt sein Zentraldokument Fauchende_Kesselfeuer.tex.
    Den von TeX erzeugten Buchblock Fauchende_Kesselfeuer.pdf findest du im Ordner build.

    Tipp: Es ist sinnvoll, das Zentraldokument passend zum Titel des zu erstellenden Buches zu benennen, denn TeX nennt die Buchblock-PDF-Datei ebenso.

  • Eingabedatei: Haupttext.tex
    Inhalt: Alle Kapitel deines Buches. 🙂
     
  • Eingabedatei: Schlussseiten.tex
    Inhalt: Texte der Schluss-Seiten, z. B. die Danksagung.
     
  • Eingabedatei: Silbentrennung.tex
    Inhalt: Besondere Ausnahme-Definitionen erlaubter Trennstellen für einzelne Worte dieses Buches.
    Für die meisten Werke genügt die automatische Silbentrennung von TeX, du brauchst die Datei nicht öffnen.
     

gehe nach obengehe nach unten

Dein Arbeitsablauf mit SPBuchsatz

Nach erfolgter Installation (siehe oben) folgt dein Arbeitsablauf zum Setzen eines neuen (d.h. fertig lektorierten) Buches diesen Schritten.
Bitte probiere das jetzt noch nicht aus, es ist nur ein Überblick:

  1. Erzeuge den neuen Buchsatz-Projekt-Ordner und nenne das Zentraldokument um, Details siehe folgender Abschnitt.
  2. Bereite in deinem Text-Programm dein Manuskript für den Satz vor (Details siehe weiter unten).
  3. Öffne dein Zentraldokument in TeXworks und fülle die erforderlichen Felder aus.
  4. Öffne Haupttext.tex in einem zweiten Fenster von TeXworks und kopiere deinen Text per [Strg]+[C] und [Strg]+[V] vom Text-Programm aus in das TeXworks-Fenster hinein.
  5. Entsprechend kopiere den Text für die Schluss-Seiten in Schlussseiten.tex hinein.
  6. Trage in den jeweils unteren(!) Abschnitt der Dateien Figurenliste.tex und Ortsliste.tex die Namen aller Personen und Orte ein, die im Buch vorkommen.
  7. Starte im TeXworks-Fenster, in dem du das Zentraldokument geladen hast, den Textsatz des aktuellen Kapitels, voreingestellt ist Kapitel-Nr. 1
  8. Korrigiere im Fenster des Haupttextes die Textsatz-Details entsprechend der im erzeugten PDF angezeigten Problem-Erkennungshilfen.
  9. Wiederhole die obigen Schritte (7.) + (8.) so lange, bis du mit dem Kapitel zufrieden bist und erhöhe dann im Zentraldokument die Kapitel-Nr. im Feld \spEinzelneKapitelnummer.
  10. Wiederhole die obigen Schritte (7.) … (9.) so lange, bis du Du alle Kapitel schön im Satz hast.
  11. Korrigiere nun im Fenster von Schlussseiten.tex auch die Satz-Details der Schluss-Seiten.
  12. Schalte im Zentraldokument den Feinkorrektur-Modus aus (lösche dazu x aus dem Feld \spFeinkorrekturModus) und lösche die Nummer aus dem Feld \spEinzelneKapitelnummer.
  13. Starte im Zentraldokument den Textsatz erneut, um den Buchblock mit allen Kapiteln zu setzen.
  14. Falls Dein Buch ein Inhaltsverzeichnis hat: Starte im Zentraldokument den Textsatz ein weiteres Mal, damit die Seitenzahlen im Verzeichnis korrekt dargestellt werden.

Dein Buchblock ist nun fertig gesetzt. 🙂

SPBuchsatz erzeugt gleichzeitig mit der im tex-Ordner gespeicherten PDF-Datei auch zwei Dateien im Rich Text Format (*.rtf) und legt sie im rtf-Ordner ab.
Du kannst die RTF-Dateien in dein Text-Schreibprogramm einlesen, um sie als Basis zur Herstellung des eBook zu nutzen.
Es werden dabei die meist-verwendeten Codes in RTF umkodiert.
Siehe im Zentraldokument die Detailhinweise zum OptionFeld: \spExportNachRTF
 


gehe nach obengehe nach unten

Erster Test

Bei diesem Schnelltest legst du ein neues Buchsatz-Projekt an und erzeugst probehalber einen eigenen (vorerst noch fast leeren) Buchblock.

  • Erzeuge innerhalb des Ordners SPBuchsatz_Projekte_1_… eine Kopie des darin enthaltenen Ordners neues_Buch.
    Du bist unerfahren in der Anwendung des Dateimanagers? Dann bitte eine kenntnisreiche Person, dir zu zeigen, wie du einen Ordner (mit allen enthaltenen Dateien und Unterordnern) kopierst und diese Kopie dann umbenennst, so dass die Kopie des Ordners anschließend neben dem originalen Ordner liegt.
  • Gib dem kopierten Ordner einen aussagekräftigen Namen, hier mein_erstes_Projekt.

SPBuchsatz 1 010

  • Öffne den tex-Ordner deines neuen Projekts und gib dem Zentraldokument einen aussagekräftigen Namen.
    Beachte: Der tex-Ordner von neues_Buch hat zwei formal identische Zentraldokument-Dateien:
    1. neues_Buch__mit_Hinweisen.tex — eine reichlich kommentierte Version und vermutlich für dich zum Kennenlernen von SPBuchsatz am sinnvollsten
    2. neues_Buch.tex — hat sehr viel weniger Kommentare, die Datei wirkt dadurch übersichtlicher, du wirst sie vermutlich für spätere Projekte nutzen, wenn dir SPBuchsatz vertraut ist und du zum Ausfüllen des Zentraldokuments weniger Tipps benötigst.

    Benenne die Datei neues_Buch__mit_Hinweisen.tex entsprechend um,
    hier wählte ich den Namen mein_Buch.tex:

SPBuchsatz 1 011

  • Starte TeXworks und lade dein neues Zentraldokument:

SPBuchsatz 1 012

  • Deine Eingaben im Zentraldokument schreibe bitte nur in die {}-Felder ab Zeile 40.
    Beginne testweise mit deinem Namen im verpflichtenden Textfeld \spVerfassBzwHrsg, das Feld ist für den Namen (bzw. die Namen) der Person(en), die das Buch verfasst bzw. herausgegeben hat bzw. haben:

SPBuchsatz 1 013

Arten und Zweck der Eingabefelder werden später erläutert. Für den ersten Test schreibe nur deinen Namen und Buchtitel bei den entsprechenden Feldern zwischen die {}-Klammern.

  • Starte den Textsatz durch Klick auf die grüne Pfeil-Taste:

    SPBuchsatz 1 014

  • Anstelle des Pfeils siehst du nun ein rotes Symbol, mit dem du den Textsatz abbrechen könntest.
    Im unteren Teil von TeXworks erscheinen das Konsolenausgabe-Fenster und die blau eingefasste Konsoleneingabezeile mit blinkendem Schreib-Cursor.
    Schreibt dort bitte jetzt nichts, warte die Erzeugung des Buchblocks ab:

    SPBuchsatz 1 015

  • Fall A: Der Test war erfolgreich.Nach erfolgreichem Textsatz verschwindet die Eingabezeile und die dritt-unterste Zeile der Konsolenausgabe meldet per „Output written on Name.pdf“ die Erzeugung der Buchblock-Datei:

    SPBuchsatz 1 016

    TeX hat sie dort gespeichert, wo das Zentraldokument liegt:

    SPBuchsatz_Projekte_1_… / mein_erstes_Projekt / tex /

    Ein zweites Fenster zeigt den Buchblock im PDF-Betrachter:

    SPBuchsatz 1 017

  • Fall B: Der Test war nicht erfolgreich.Falls TeX beim Setzen ein Problem feststellt, das nicht automatisch behebbar ist, bleibt die Konsolenausgabe stehen. Du hast drei Möglichkeiten:
  1. Oben die rote X-Taste klicken, um den Textsatz abzubrechen.
  2. In der Konsoleneingabezeile ein x eingeben und Enter betätigen, um den Textsatz abzubrechen.
  3. In der Konsoleneingabe durch passende Eingabe das Problem zu lösen versuchen.
    (Ohne TeX-/LaTeX-Kenntnisse ist das nur in einfacheren Fällen sinnvoll, z. B. falls du im Text ein PNG-Bild einfügen wolltest und dich beim Dateinamen vertippt hast.)

Falls du, wie oben geschrieben, die ersten sieben Punkte der TeX Live-Installationsanleitung erfolgreich ausgeführt hattest, sollte beim Test von SPBuchsatz theoretisch nur in zwei Fällen ein Fehler auftreten:

  • TeX wird durch äußere Umstände ausgebremst, z. B. weil die Festplatte voll ist.
  • Du hast versehentlich das Zentraldokument beschädigt, z. B. eine öffnende oder schließende Klammer gelöscht.
    In jedem Fall sieh die Konsolenausgabe genau an:
    Eine der letzten Zeilen zeigt den Text, vor dessen Beginn oder zu dessen Ende TeX den Fehler vermutet!

    Hast du z. B. nach der Buchtitel-Eingabe „Mein eingegebener Buchtitel“ die schließende Klammer gelöscht, wird TeX schreiben:


Runaway definition?
->Mein eingegebener Buchtitel \par \def \spCopyrightJahr \ETC.
! File ended while scanning definition of \spArtDesBuches.
<inserted text>
}
<*> mein_Buch.tex
?

Fiel der Löschtaste die öffnende Klammer zum Opfer, lautet die Ausgabe:


! Missing { inserted.
l.50 …s Mein eingegebener Buchtitel}
% darf leer sein, hier d…
?

Das Fragezeichen am Ende der Ausgabe zeigt, dass TeX in der Eingabezeile auf deine Entscheidung wartet: Der Textsatzvorgang ist nicht beendet, sondern TeX hat pausiert und gibt dir die Möglichkeit zu entscheiden, wie es weitergehen soll.

mein Rat: Brich den Vorgang ab (erst x-Taste, dann Enter-Taste), korrigiere den Fehler und starte den Textsatz erneut.


gehe nach obengehe nach unten

Wichtige Hinweise zum Zentraldokument

(Mit % beginnende Texte sind Kommentare, sie werden von SPBuchsatz und von TeX ignoriert.)

Sieh das Zentraldokument als Formular an:

Durch die Eingabefelder ab Zeile 42 teilst du SPBuchsatz mit, wie und mit welchen Grundangaben du das Buch erstellen möchtest.

Drei Arten von Eingabefeldern

  • Textfelder wie \spVerfassBzwHrsg
    Du kannst dort eine oder mehrere Zeilen eintragen.
    Ist ein nicht verpflichtendes Textfeld völlig leer und besteht nur aus dem Klammernpaar {}, so betrachtet SPBuchsatz es als nicht verwendet. Im Impressum wird z. B. die Zeile „Cover:“ weg gelassen, wenn das Feld \spCoverDesign leer ist.
     
  • Wertfelder wie \spDieSeitenbreite
    Du kannst dort einen einzelnen Wert eintragen.
    Die jeweilige Einheit (z. B. mm oder in für inch, also Zoll, oder pt für Punkt) schreibe bitte stets ohne Leerschritt unmittelbar hinter die von dir eingetragene Zahl.
    Einige der Wertefelder, wie \spLeereSeitenGanzAmEnde sind einheitenlos, bei anderen orientiere dich bitte am darin vorgeschlagenen Wert oder am dahinter stehenden Kommentar.
     
  • Ein-/ausschaltbare Optionfelder wie \spSchmutztitelErzeugen
    Sie gelten als angekreuzt, wenn ein beliebiger Text darin steht. SPBuchsatz nutzt dazu normalerweise ein „x“.
    Um eine Option abzuschalten, lösche den Inhalt, d.h. entferne das „x“.
    (Allerdings wäre es den meisten Büchern abträglich, \spSchmutztitelErzeugen auszuschalten, denn die schlichte Vorab-Seite vor dem Titel läßt ein Buch professioneller wirken. Außerdem verlörest du die Chance, auf der Rückseite des Schmutztitels einen oder zwei Texte zu präsentieren, um das Interesse der Stöbernden beim raschen Aufblättern des Buches zu wecken.)
     

Schweiz Sprachanpassung der Guillemets

In Grundeinstellung nimmt SPBuchsatz an, dass dein Text Chevrons in deutscher Fassung zeigt.

Dein Buch nutzt Guillemets in der französischen bzw. Schweizer Verwendung?
Um SPBuchsatz darüber zu informieren, lösche im betreffenden Eingabefeld den voreingestellten Wert german und trage stattdessen french ein:

\def \spSpracheDerGuillemets {french}

Diese Angabe – möglich sind dort die Worte german und french – berücksichtigt SPBuchsatz im Feinkorrektur-Modus beim Prüfen der Zeilen-Anfänge:
Im Dialog ist  »  am Zeilenbeginn bei deutschen Möwchen normal, während dort niemals  «  stehen sollte. Bei Schweizer und französischen Guillemets verhält es sich umgekehrt und ohne deinen Hinweis würde SPBuchsatz bei eingeschaltetem Feinkorrektur-Modus unzutreffende Prüf-Pfeile an den Rand zeichnen.

Ebenso wichtig ist die Angabe der Guillemets-Sprache, damit SPBuchsatz eventuell fehlerhafte Zeichensetzung zwischen dem Ende der wörtlichen Rede und nachfolgender Inquit-Formel erkennt:
Versehentlich gesetzten Punkt vor schließenden Guillemets meldet die Textfehlererkennung ebenso wie vertauschte Reihenfolge von Komma und Guillemets.

Feinkorrektur-Modus ein-/ausschalten und Kapitel wählen

Der nächste Artikel beleuchtet die Textsatz-Detailabstimmung.
Das wichtigste Optionfeld hierfür:

\spFeinkorrekturModus {x}

Der Feinkorrektur-Modus schaltet die optischen Hilfen zur Absatzrand-Kontrolle und zur typografischen Textfehler-Erkennung. Standardmäßig aktiv, vereinfacht die Absatzrand-Kontrolle durch farbige Markierungen im PDF deine Satz-Prüfung.
Die ebenfalls normalerweise aktive Textfehler-Erkennung weist dich auf drei der häufigsten, typographischen Fehler hin: Fehlende (oder zu breite) Leerschritte und Verwendung falscher Punkte oder Striche.

Mit Feld \spEinzelneKapitelnummer stellst Du das Kapitel ein, das Du aktuell feinkorrigieren möchtest:
Beginnt dein Buch mit Kapitel 1, so starte die Feinkorrektur mit der Nr. 1, hast du aber ein per \Prolog{} angelegtes Vorwort, so trägt dies die interne Kapitelnummer 0. Wären es zwei Prologe, also ein Grußwort und ein Vorwort, so hätte das Grußwort die Nr. -1 (also Minus Eins).

Du löschst diese Kapitel-Nr. erst dann (und schaltest den Feinkorrektur-Modus aus), wenn du zufrieden mit allem bist und den endgültigen Buchblock erstellst.


gehe nach obengehe nach unten

Text-Vorbereitung und -Eingabe

Vorbereiten des Manuskripts

Vor dem Einkopieren deiner Texte in die Dateien Haupttext.tex und Schlussseiten.tex, nimm bitte folgende, wenigen, aber wichtigen Anpassungen vor, damit SPBuchsatz weiß, welche Teile des Textes besondere Bedeutung haben oder besonders zu formatieren sind.

Erledige dies in deinem Text-Schreibprogramm:

  • Setze im gesamten Text vor jedes Prozentzeichen einen sog. Backslash: \
    Am besten per Suchen und Ersetzen
    alt:    %
    neu:  \%
     
  • Schreibe \Szenentrenner für jeden Szenen-Wechsel:

    … und hier endet der vorige Absatz.
    \Szenentrenner
    Hier beginnt der nächste Absatz nach dem Szenen-Wechsel, ohne Erstzeileneinzug.

    Tipp: Wenn Du magst, darfst du gerne auch Leerzeilen über und unter die Anweisung setzen!
    Leerzeilen zwischen Absätzen werden von SPBuchsatz ignoriert, Du kannst sie also schön zur Übersichtlichkeit innerhalb von Haupttext.tex verwenden.

  • Im Zentraldokument kreuzt du an, was SPBuchsatz dann tun soll.
    Nutze diese drei Optionfelder:

    \spSzenentrennerIstLeer { }  
    einzelne Leerzeile als Szenentrenner einsetzen
    (Dies spart Zeilen, doch es hat den Nachteil, nicht immer erkennbar zu sein, falls Szenen-Wechsel und Seitenwechsel zusammentreffen:
    Nur die Lücke nach dem Ende der letzten Absatzzeile und der fehlende Erstzeileneinzug am Kopf der neuen Seite weisen dann auf den stattgefundenen Szenen-Wechsel hin. Falls die letzte Zeile des vorigen Absatzes zufällig nahe am rechten Seitenrand endet, werden deine Leser*innen nicht nur den Szenen-Wechsel sondern auch den Absatz-Wechsel übersehen und irrtümlich annehmen, der Absatz würde auf der Folgeseite fortgesetzt.)

    \spSzenentrennerIstText {x}  
    den im Feld \spSzenentrennerText{} eingetragenen Text verwenden
    (Der Zwischenraum ist dann insgesamt 3 Zeilen hoch.)

    \spSzenentrennerIstBild { }  
    das im Feld \spSzenentrennerBildDatei{} angegebene Bild anzeigen
    (Der Zwischenraum ist dann normalerweise 4 Zeilen hoch.)

  • Sonderfall: Leerzeile ohne Szenen-Wechsel

    Möchtest du ausnahmsweise einmal eine Leerzeile im Fließtext haben,
    OHNE dass ein Szenen-Wechsel stattfindet,
    so verwende den Befehl:
    \Leerzeile

  • … und hier endet der vorige Absatz.
    \Leerzeile
    Hier folgt der nächste Absatz mit automatischem Erstzeileneinzug, weil ja kein Szenenwechsel stattgefunden hat. Theoretisch wäre es erlaubt, hier per \keinEinzug den Erstzeileneinzug zu verhindern. Dies ist manchmal typographisch korrekt, z. B. bei besonderen Texten innerhalb der Schluss-Seiten.

  • Rahme mit \kursiv{ } deine kursiven Worte ein:
    Falls du kursive Worte im Manuskript hast, markiere sie alle mit dem Kommando \kursiv{ … } auf diese Art:

    Dieser Text ist regulär geschrieben \kursiv{und diese sechs Worte sind kursiv.} Nun geht es wieder in regulärer Schrift weiter …

    Wichtiger Zeit-spar-Tipp:

    Nutze die besondere Methode „Suchen und Erweitern“, um alle kursiven Textstellen auf einmal zu ersetzen:

    Schnellanleitung im Artikel Text suchen und erweitern

    Besonderheit: \BeginnKursiv und \EndeKursiv (für mehrere Absätze).
    Hast du einen größeren, kursiven Textbereich, beispielsweise einen zitierten Brief, so verwende bitte die besonderen Bereichs-Markierungen, die du jeweils in eine einzelne Zeile schreibst.
    Innerhalb eines solchen Bereiches kannst du die Kursivschreibung einzelner Worte per \Normalschrift { … } ausschalten:

    \BeginnKursiv
    Erster, kursiver Absatz mit \Normalschrift{drei normalen Worten} und dann wieder kursivem Text.
    Zweiter, kursiver Absatz …
    \EndeKursiv

    Du hast vermutlich keine fett gedruckten Worte vorgesehen, fette Schrift ist in belletristischen Werken ja unüblich.
    Falls aber doch, markiere sie entsprechend: \fett{ … }

  • Schreibe \Kapitel für neu beginnende Kapitel:
    Jeden Kapitelbeginn markiere bitte per \Kapitel{ … } und gib dabei den Titel an.
    Als SPBuchsatz-Eingabetext sähen die Zeilen von Gerdt von Bassewitz (in Peterchens Mondfahrt) so aus:

… Es war die Sternenwiese, der sie sich näherten. Sie liegt mitten im Himmel und war die erste Station auf ihrer großen Fahrt.
\Kapitel{Die Sternenwiese}
Auf der Sternenwiese wohnt das Sandmännchen, das eine sehr wichtige Persönlichkeit im Himmelsraum ist und viele Ämter hat. Es muß den Sternen Unterricht im Singen geben …

Die wenigen, obigen Kommandos genügen für viele Bücher, eine kommentierte Liste aller SPBuchsatz-Befehle bietet der Artikel: SPBuchsatz Befehle

Möchtest du z. B. (vielleicht innerhalb der Schlussseiten) einen Seitenumbruch herbeiführen, ohne dabei ein neues Kapitel zu beginnen, so verwende das Kommando \neueSeite zwischen zwei Leerzeilen:

Nach diesem Text wird ein Seitenumbruch erfolgen.
\neueSeite
Dieser Text steht auf der nächsten Seite.

Trick: Soll auf der neuen Seite eine neue Szene beginnen, so verwende nicht \neueSeite sondern den besonderen Befehl: \neueSeiteUndSzene

 

Eintragen des Textes

Dein Manuskript hast du vorbereitet, wie oben beschrieben.

Trage in den jeweils unteren(!) Abschnitt der Dateien Figurenliste.tex und Ortsliste.tex die Namen aller Personen und Orte ein, die im Buch vorkommen, damit SPBuchsatz sie kennt und automatisch dafür sorgt, dass sie nicht getrennt werden: Schreibe dabei Vor- und Nachnamen in extra Zeilen, also NICHT: Name: Adrenalinus Weissmann, sondern in eine Zeile Name: Adrenalinus und in die nächste Zeile Name: Weissmann. Schließe die beiden Dateien dann wieder.

Falls du Papyrus Autor verwendest:
Schalte vor dem Markieren und Kopieren – also vor [Strg]+[C] – in Papyrus die Silbentrennung aus, sonst werden harte Trennstriche mitkopiert.

Kopiere nun den Hauptteil in die Datei Haupttext.tex und die Danksagung (und ggfs. weiteren Abschluss-Texte) in die Datei Schlussseiten.tex. Ab jetzt passe deine Texte jeweils innerhalb dieser .tex-Dateien an.

Starte dann im Zentraldokument den Buchsatz durch Klick auf das grüne Pfeil-Symbol, wie oben beschrieben.
Zur Detailabstimmung des Satzes dient der Artikel: SPBuchsatz Feinkorrektur

 

… und erneut der Hinweis:

Achte zum Erstellen deines Buchblocks darauf, den Textsatz immer für das Zentraldokument zu starten!

Rufe also nie den Textsatz in einem Fenster von TeXworks auf, in dem du den Haupttext oder die Schlussseiten geladen hast, sondern immer ausgehend vom Zentraldokument.

(Hast du versehentlich den Textsatz aus einem anderen Fenster heraus gestartet und dann abgebrochen, fragt dich TeXworks evtl., ob es als defekt erkannte Hilfsdateien löschen soll:
Tue das! Die Dateien sind nach falsch gestartetem Satz ungültig und werden nach dem Löschen beim nächsten Textsatz automatisch neu erstellt.)


gehe nach oben

Ausblick

Der nächste Artikel widmet sich der Textsatz-Detailabstimmung: SPBuchsatz Feinkorrektur
Du lernst, typographische Fehler zu erkennen und zu vermeiden und die Korrektur von Unvollkommenheiten fallweise abzuwägen.

Beachte auch das Beispiele- und Tippsbuch: Fauchende_Kesselfeuer.pdf
Es zeigt Beispiele häufig genutzter Befehle (beispielsweise zum Einfügen von Grafiken) und gibt nützliche Tipps zur Buch-Gestaltung und -Verschönerung.

Das Ziel: Dein Buchblock ist so schön gesetzt, als habest du ihn einem besonders sorgsam arbeitenden Verlag anvertraut.

Ich wünsche gutes Gelingen mit SPBuchsatz und lese, wenn du magst, deine Meinung gerne auf Twitter. 🙂

Herzlichst
Karl-Heinz

Teile diesen Beitrag
Scroll to Top