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

http://txt2tags.googlecode.com/ · HTML · 476 lines · 438 code · 35 blank · 3 comment · 0 complexity · 7d794a58e5db572f36b43cd846fefe80 MD5 · raw file

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