PageRenderTime 25ms CodeModel.GetById 15ms app.highlight 6ms RepoModel.GetById 1ms app.codeStats 1ms

/doc/German/writing-book-de.t2t

http://txt2tags.googlecode.com/
Unknown | 337 lines | 226 code | 111 blank | 0 comment | 0 complexity | 5715f4621d9a3be517b3f00b2e9e7f67 MD5 | raw file
  1Bücher schreiben mit Txt2tags
  2
  3Aurelio Jargas
  4
  5%!target : xhtml
  6%!encoding: UTF-8
  7%!style  : ../English/writing-book.css
  8%!options: -n --toc --css-sugar --css-inside -o writing-book-de.html
  9
 10%!preproc: URL_RE_BOOK  http://guia-er.sourceforge.net/
 11%!preproc: URL_HTMLDOC	http://www.easysw.com/htmldoc/
 12%!postproc: URL_PC_BOOK http://www.picocontainer.org/Contructor+Dependency+Injection+...+Book+Announcement
 13
 14	Dieses Dokument gibt eine knappe Anleitung, die die Vorteile
 15	zeigt, zum Schreiben von Büchern das Werkzeug Txt2tags zu
 16	verwenden. Außerdem kann es für andere große Dokumente wie
 17	Anleitungen, Diplom- und Doktorarbeiten benutzt werden.
 18
 19
 20= Einleitung=
 21
 22Ich bin der Txt2tags ``[1]`` Autor, und ich schrieb zwei bereits veröffentlichte Paper, die es verwenden:
 23ein Buch über reguläre Ausdrücke [Regular Expressions book URL_RE_BOOK] (96 Seiten) und einen
 24Programmierkurs für die Shell (108 Seiten). Das Schreiben lief sehr rund und hiermit will ich diese Erfahrung teilen.
 25
 26Für ein Buch ist viel Arbeit zu tun, aber es muß nicht kompliziert sein. Zu schreiben heißt Ideen in
 27Textstrukturen wie Abschnitte, Absätze und Listen zu organisieren. Txt2tags ist ein Werkzeug,
 28das diese Aufgabe einfach und leicht macht.
 29
 30Das Schreiben allein oder in einem Team, mit oder ohne Versionskontrolle, technischem
 31Inhalt oder nicht, nur Text oder mit Bildern. Jedenfalls
 32kann Txt2tags als das Hauptwerkzeug für die Buchentwicklung verwendet werden.
 33
 34Es gibt [ein Buch URL_PC_BOOK], das in diesem Augenblick geschrieben wird und Txt2tags verwendet.
 35
 36	``[1]`` Txt2tags liest eine Textdatei mit minimalem Markup,
 37	wie ""**fett**"" und ""//kursiv//"" und wandelt es in Dokumente wie
 38	für HTML, Latex und Adobe PageMaker um. Mehr Info:
 39	http://txt2tags.org.
 40
 41
 42
 43= Visuelle Editoren gegen Markup=
 44
 45Zwei gebräuchliche Arten ein Buch zu schreiben sind einen visuellen Editor
 46(//Microsoft Word//, //Adobe Pagemaker//) oder eine Markupsprache
 47(//Latex//, //docbook//) zu verwenden.
 48
 49In visuellen Editoren schreiben und formatieren Sie  den Inhalt zur gleichen Zeit.
 50Diese Verwendungsweise ist für kleine Texte ganz nett, aber für ein 300-Seiten-Buch braucht
 51die Formatierung Zeit und lenkt den Schriftsteller ab.
 52
 53In Markupsprachen schreiben Sie Inhalt, zeichnen ihn aus und
 54ein externes Programm bringt ihn in die Endform. Der
 55Schriftsteller braucht auf die Formatierung nicht acht zu geben, jedoch
 56ist der Vorgang des Einfügens ``<tags> </tags>`` und
 57``\more {tags}`` fehleranfällig und sehr aufdringlich, was den Quelltext schwer lesbar macht.
 58
 59Txt2tags verwendet auch Markup, aber der große Unterschied ist,
 60dass sein Markup sehr minimal ist und häufig fast natürlich aussieht, wie das
 61Verwenden des Bindestrichs für Listenelemente. So kann sich der Schriftsteller allein auf den
 62Inhalt konzentrieren
 63und die Quelle bleibt lesbar.
 64
 65
 66
 67= Die Verwendung von Txt2tags=
 68
 69Mit Txt2tags können Sie Bücher schreiben, indem Sie nach diesen Schritten vorgehen:
 70
 71+ Der Autor lernt die sehr einfachen Txt2tags-Markupregeln.
 72
 73+ Der Autor schreibt den Buchinhalt, ohne Seitenrand, Schriftarten, Farben und Größen zu beachten.
 74
 75+ Der Autor (oder der Herausgeber) öffnet den Inhalt in einem visuellen Textverarbeitungsprogramm,
 76  das HTML (oder Latex oder ...) liest und die Buchformatierung fortführt.
 77
 78
 79Schritt 1 ist gerade in ein paar Minuten geschafft. Schritt 2 wird Monate brauchen; und
 80Schritt 3 kann Tage oder Wochen dauern.
 81
 82Das Schreiben von Inhalt besteht darin, wenn Sie mehr Zeit auf das
 83Buch verwenden wollen,  aus diesem Vorgang eine einfache,
 84produktive und
 85angenehme Aufgabe zu machen.
 86
 87Im Folgenden werden Argumente gezeigt, wie Txt2tags verwendet werden kann,
 88um das zu erreichen.
 89
 90
 91
 92= Schnell und effizient=
 93
 94Zeit ist der Schlüssel zum Erfolg. Mit dem Verwenden von Txt2tags werden Sie eine sehr
 95hohe Produktivität erfahren, weil Sie Inhalt schreiben, ohne gleich zu formatieren.
 96
 97- **Schnelle Anfangsausgabe**
 98
 99Es ist sehr schwierig, etwas zu beginnen, aber Txt2tags hat eine
100nette Annäherung an dieses Problem. Sitzen Sie gerade und
101schreiben Sie Klartext. Wenn Sie das getan haben, können Sie das
102Txt2tags-Markup in ein paar Minuten einfügen, und das Dokument ist
103bereit umgewandelt und veröffentlicht zu werden.
104
105- **Schnelle Schnappschuß-Vorschau**
106
107Ganz gleich, in welchem Zielformat das Buch sein wird, ist HTML das
108bevorzugte Format zum Zeitpunkt des Schreibens. Ein Schnappschuß des
109gegenwärtigen Buchzustands kann jederzeit erfolgen, die Quellen
110werden in eine HTML-Seite umgewandelt, um sie auf jedem System
111mit Hilfe eines Browsers zu lesen. Wenn Sie eine druckfähige
112Version brauchen, können Sie mit dem ausgezeichneten Werkzeug [htmldoc URL_HTMLDOC] das HTML zu PDF umwandeln.
113
114- **Buch Inhaltsübersicht**
115
116  Um eine globale Übersicht des Buchinhalts jederzeit schnell zu haben,
117  verwenden Sie einfach //TOC Only//. Das Programm zeigt die
118  gegenwärtige Inhaltsübersicht für das Buch, mit der Auflistung von
119  Kapiteln und Abschnitten, ab jeder Tiefe nummeriert oder nicht.
120
121- **Schnelles Schreiben**
122
123Txt2tags-Markup ist einfach und minimal, sehr leicht zu lernen. Keine
124Namen, keine Optionen, keine Parameter. Sie müssen nicht
125aufhören, Inhalt zu schreiben, um Markup einzufügen, es
126fließt zusammen mit dem Text. Wenn Sie sich an spezifische
127Auszeichnungen im Moment nicht erinnern, schreiben Sie einfach
128weiter. Am Ende rezensieren Sie global den Text und
129fügen schnell das fehlende Markup ein.
130
131- **Schnelle Konvertierung**
132
133Selbst wenn Sie ein 500-Seiten-Buch haben, dauert der
134Umwandlungsprozeß gerade einen Moment. Es ist, weil Txt2tags wie ein
135Filter wirkt, von einem Format ins andere umwandelt, es
136weder indexiert,
137kompiliert, berechnet, komprimiert und zeichnet, noch findet eine
138starke Verarbeitung der Quellen statt. Keine Bibliothek-, Katalog-,
139Schema- und DTD-Albträume mehr.
140
141
142
143
144= Quellen in Ordnern organisieren=
145
146Txt2tags hat einen eingebauten Befehl externe Dateien in jeden Teil
147eines Dokumentes während der Umwandlung einzuschließen. Das ermöglicht es,
148Quellen in mehrere Dateien zu spalten.
149
150- **Jedes Kapitel in einem Ordner**
151
152Sie können ein Verzeichnis für jedes Kapitel anlegen, die
153Quellen in einem strukturierten Baum ablegen. Innerhalb der
154Kapitel-Ordner können Sie sogar Unterordner schaffen, um Bilder,
155Konfiguration und einzufügende Dateien bereit zu halten.
156
157- **Keine Dateikonflikte**
158
159In Kapitel getrennt, können verschiedene Teams in verschiedenen Kapiteln
160  ohne gegenseitige Einflußnahme arbeiten. Jedes Team arbeitet in seinem eigenen Verzeichnis,
161  wobei Dateikollisionen aufgrund gleichzeitiger Änderungen vermieden werden.
162
163- **Flexible Zugriffskontrolle**
164
165  Liegen Dateien und Verzeichnisse organisiert vor, können Sie  Zugriffskontrollregeln einführen,
166  Eigenschaften und Zugriffsregeln für jede Datei oder Kapitel aufstellen.
167  Verwenden Sie die Standard-Systemwerkzeuge, um die Lese-/Schreib-Zugriffe,
168  wie die Benutzer- und Gruppen- Schemen zu konfigurieren.
169
170- **Globale Ansicht der Quellen**
171
172Bei strukturierten Quellen hilft ein Dateimanager, eine globale Ansicht vom
173  Buch zu haben, den Anteil des Textes und
174  der Bilder am Kapitel schnell zu wissen. (Hinweis: unter UNIX die ``tree`` und ``du``-Befehle)
175
176- **Arbeiten Sie am Kapitel, vergessen Sie die anderen**
177
178Werden Quellen in Dateien getrennt, können Sie ein Kapitel
179allein umwandeln, ohne darauf zu warten bis das ganze Buch konvertiert
180ist. Neben dem schnelleren Umwandeln kann das Kapitel allein
181Rezensenten zugesandt oder als eine Probe des ganzen Buches
182veröffentlicht werden.
183
184- **Sie trennen, Txt2tags verbindet**
185
186Bei der Umwandlung wird Txt2tags alle Kapitel automatisch zum Buch
187zusammenfügen, egal wie tief oder groß der Verzeichnis-Baum
188ist.
189
190
191
192= Versionskontrolle einfach =
193
194Txt2tags hilft der Versionskontrolle mit zeilenbasierten Werkzeugen (wie CVS und Subversion). Die Quellen sind Klartext, nicht kompilierte
195Daten.
196
197- **Arbeiten mit kurzen Zeilen**
198
199Sie können kurze Zeilen setzen, die an 72 Spalten umbrechen. Es
200wird der Versionskontrolle helfen, weil es zeilenbasiert arbeitet.
201Wenn es das Zielformat verlangt, dass ein Absatz aus einer einzelnen
202langen Zeile (wie bei PageMaker) zusammengesetzt wird, verbindet Txt2tags diese automatisch.
203
204- **Lesbare Quellen**
205
206Durch die minimale Auszeichnung sind die Quellen lesbar. Man kann
207leicht sehen, was sich von einer Version zur anderen geändert hat,
208Markup verbirgt nicht den Text und  verunstaltet ihn nicht.
209
210- **Viel Text, kleine Quellen**
211
212Als Klartext können Sie eine riesige Menge von Text erzeugen und
213dabei einen geringen Speicherplatzgebrauch haben. Leute können
214volle Checkouts tun und das sogar bei langsamen Verbindungen.
215
216- **Kapitel versioning**
217
218Wie vorher gesehen, können Sie die Quellen in Verzeichnissen
219organisieren. Das ergibt Versionskontrolle getrennt nach den Kapiteln,
220oder sogar Abschnitten von Kapiteln, je nachdem wie stark granuliert
221Sie es brauchen.
222
223
224
225= Qualität zählt=
226
227Sie können ein Buch schreiben. Oder Sie können DAS Buch schreiben. Txt2tags hat nette,
228eingebaute Eigenschaften, um Ihre Qualität zu steigern.
229
230- **Rechtschreibprüfung**
231
232Weil alle Txt2tags-Zeichen Symbole und nicht Wörter sind,
233können Sie jeden Rechtschreibprüfer fur die Texte verwenden.
234Er wird sich nur um den Text kümmern, und nicht versuchen
235Auszeichnungen zu korrigieren.
236
237- **Alias Datenbank**
238
239  Txt2tags bietet //Filter zur Vorverarbeitung//, womit Sie Schlüsselwort/Wert-Paare definieren können. Wo auch immer das Schlüsselwort in den
240Quellen gefunden wird,
241  wird es während der Konvertierung zum gegebenen Wert erweitert. Verwenden Sie zum Beispiel die Zeichenkette ``URL_GOOGLE`` in Ihrem Text, wird sie als
242  ``http://www.google.com`` in dem Buch erscheinen. Wenn die Google-URL
243sich ändert, ändern Sie einfach die
244Filterdefinition und alle Vorkommen werden mit aktualisiert. Sie
245können unbegrenzt viele Schlüsselwörter verwenden.
246
247- **Dynamischer Inhalt**
248
249  Txt2tags hat auch einen Befehl, vorformatierten Text ins
250  Dokument einzuschließen während konvertiert wird, zum Beispiel einen Programm-Quelltext.
251  Auf diese Weise können Sie diesen Code getrennt vom
252  Buchtext halten und ihn mit der Hand oder sogar automatisch aktualisieren. Eine nette Idee
253  ist, den Quellcode mit speziellen Anmerkungen zu kennzeichnen und ein
254  kleines Programm zu verwenden, das die gekennzeichneten Teile herauszieht in getrennte Dateien.
255
256- **Kontrolle über das Ergebnis**
257
258  Txt2tags bietet //Filter zur Nach-Verarbeitung//, womit Sie Regeln
259definieren können, um das resultierende Dokument anpassen zu
260können. Wird die Standard-Konvertierung durch Txt2tags Ihren
261Bedürfnissen nicht völlig gerecht, können Sie sie mit
262Ihren eigenen Filtern verbessern. Sie können die Macht der regulären Ausdrücke verwenden, um Muster zu
263vergleichen.
264
265
266
267= Andere Vorteile =
268
269Und es gibt noch mehr!
270
271- **Die getrennte Formatierung von Inhalt**
272
273  Wird HTML als Zielformat verwendet, können Sie auch CSS-Dateien benutzen, um mit verschiedenen Layouts zu experimentieren. CSS definiert das Formatieren
274für
275  HTML-Seiten; dazu gibt es graphische Editoren, um CSS- Dateien zu schaffen.
276  Ein Team von Designern kann an den CSS-Dateien arbeiten, während
277  die Schriftsteller schreiben. 
278
279- **Fügen Sie komplizierte Strukturen ein**
280
281  Txt2tags hat wirklich Unterstützung für alle allgemein
282  in Texten verwendete Strukturen: Listen, Definitionen, Zitate, verbatim und Tabellen. Aber
283  wenn einige Teile Ihres Buches eine kompliziertere Struktur verlangen,
284  können Sie das //Pass - Thru// verwenden, wo Sie Text einfügen,
285  der bereits fertig mit einer HTML-Tabelle ausgezeichnet ist. Mit Txt2tags
286  sind Ausnahmen kein Problem!
287
288- **Verwenden Sie irgendeinen Editor**
289
290Für Klartext-Quelldateien
291  kann sogar der einfachste Texteditor der Welt verwendet werden, um das Buch zu
292schreiben. Als einzige Eigenschaft braucht er nur Text schreiben und speichern zu können. Wenn Sie Editoren mit
293  der Txt2tags-Unterstützung verwenden, haben Sie //Syntax-Highligthing//; das hilft
294  die Txt2tags-Zeichen besser zu erkennen. Das gibt es für: Vim, Emacs, Kate und Nano.
295
296- **Technische Unterstützung**
297
298  Txt2tags hat verschiedene Kanäle, um technische Unterstützung zu bekommen: zwei Mailinglisten
299  (in Englisch und Portugiesisch), einen IRC-Kanal und sogar eine Orkut-
300  Gemeinschaft. Und für Buchprojekte können Sie E-Mails
301  direkt an den Programm-Autor senden, der Ihre Antwort vorrangig behandeln wird.
302
303
304
305= Kein Werkzeug paßt für alles =
306
307Es gibt einige spezielle Fälle, wo Txt2tags kein geeignetes Werkzeug ist,
308um Bücher zu schreiben.
309
310- **Sehr komplizierte Bücher**
311
312Bücher, die viele komplizierte Tabellen, Formeln oder spezifische
313Strukturen verwenden, brauchen einen graphischen Editor oder eine
314umfangreichere Markupsprache, wie Latex. Wenn Ihr Buch in diese
315Beschreibung paßt, hilft Txt2tags nicht weiter.
316
317- **Fußnoten**
318
319  Txt2tags unterstützt keine Fußnoten. Wenn Sie welche verwenden wollen,
320  können Sie sie später hinzufügen. Planen Sie aber, einen intensiven
321  Gebrauch von Fußnoten zu machen, kann Txt2tags Ihnen nicht helfen.
322
323- **Verweise auf Seiten, Tabellen und Bilder**
324
325  Man kann einen visuellen Editor während des Publizierens verwenden,
326  um Indizes für Seiten, Tabellen und Bilder einzufügen, überhaupt kein Problem. Aber wenn
327Sie
328  planen, sich auf sie innerhalb des Textes zu beziehen, wie "//Siehe Tabelle 4.11 auf Seite 35//", kann Txt2tags Ihnen nicht helfen.
329
330
331
332-------------------------------------------------
333
334//Das Schreiben von Büchern mit Txt2tags - Okt/2004//
335([siehe Quelle %%infile])
336
337Übersetzung von Michael Malien