/doc/German/manpage-de.man

http://txt2tags.googlecode.com/ · Unknown · 477 lines · 344 code · 133 blank · 0 comment · 0 complexity · d56e56f83b92b9aacd9ab5a187fa531b MD5 · raw file

  1. .TH "TXT2TAGS" 1 "Aug, 2010" ""
  2. .SH NAME
  3. .P
  4. txt2tags \- Textformatierungs\- und \-konvertierungswerkzeug
  5. .SH SYNOPSIS
  6. .P
  7. \fBtxt2tags\fR [\fIOptionen\fR] [\fIDATEI\fR...]
  8. .SH BESCHREIBUNG
  9. .P
  10. \fBtxt2tags\fR liest einen Text mit minimalem Markup und konvertiert ihn zu:
  11. \fIASCII Art\fR,
  12. \fIAsciiDoc\fR,
  13. \fICreole\fR,
  14. \fIDocBook\fR,
  15. \fIDokuWiki\fR,
  16. \fIGoogle Code Wiki\fR,
  17. \fIHTML\fR,
  18. \fILaTeX\fR,
  19. \fILout\fR,
  20. \fIMagicPoint\fR,
  21. \fIMan page\fR,
  22. \fIMoinMoin\fR,
  23. \fIPageMaker\fR,
  24. \fIPlain Text\fR,
  25. \fIPmWiki\fR,
  26. \fISGML\fR,
  27. \fIWikipedia\fR und
  28. \fIXHTML\fR.
  29. .P
  30. \fBtxt2tags\fR liest eine Textdatei mit minimalem Markup und wandelt ihn um in:
  31. ASCII\-Art, AsciiDoc, Creole, DocBook, DokuWiki, Google Code Wiki,
  32. HTML, LaTeX, Lout, MagicPoint, Manpage, MoinMoin, PageMaker,
  33. Plain Text, PmWiki, SGML, Wikipedia und XHTML.
  34. .P
  35. Diese Manpage wurde von txt2tags aus einer einfachen Textdatei erstellt.
  36. Der gleiche Textdatei wird auch für die Online\-Version dieses Handbuchs in HTML umgewandelt.
  37. Eine Quelle, MULTI\-Ziele \- http://txt2tags.org
  38. .P
  39. EIN Quellformat, VIELE Zielformate \- http://txt2tags.org
  40. .SH MARKUP
  41. .nf
  42. Headers Die ersten 3 Zeilen der Quelldatei
  43. Titel = Wörter =
  44. Nummerierter Titel + Wörter +
  45. Kommentar % Kommentare
  46. Trennungslinie -----------------------...
  47. Dicke Linie =======================...
  48. Bild [Dateiname.jpg]
  49. Link [Marke url]
  50. Fett **Wörter**
  51. Italic //Wörter//
  52. Understrichen __Wörter__
  53. Durchgestrichen --Wörter--
  54. Monospaced ``Wörter``
  55. Raw ""Wörter""
  56. Tagged ''Wörter''
  57. Absatz Wörter
  58. Zitat <TAB>Wörter
  59. Liste - Wörter
  60. Numerierte Liste + Wörter
  61. Definitionsliste : Wörter
  62. Tabelle | Zelle 1 | Zelle 2 | Zelle 3 ...
  63. Verbatim-Zeile ``` Wörter
  64. Raw-Zeile """ Wörter
  65. Tagged-Zeile ''' Wörter
  66. Verbatim-Block ```
  67. Zeilen
  68. ```
  69. Raw-Block """
  70. Zeilen
  71. """
  72. Tagged-Block '''
  73. Zeilen
  74. '''
  75. .fi
  76. .SH OPTIONEN
  77. .TP
  78. \fB\-\-art\-chars\fR=\fIMUSTER\fR
  79. Definiert \fIMUSTER\fR als das Muster von Zeichen, die ASCII\-Kunst darstellen, in der folgenden Reihenfolge: corner, border, side, bar1, bar2, level2, level3, level4, level5. Der Standardwert für das Zeichenmuster ist +\-|\-==\-^". Diese Option wird nur bei ASCII\-Kunst als Zielformat benutzt.
  80. .TP
  81. \fB\-C\fR, \fB\-\-config\-file\fR=\fIDATEI\fR
  82. Liest die Konfiguration aus einer externen \fIDATEI\fR. Die Konfiguration muß im Format \fI%!keyword:value\fR stehen. Siehe die Erläuterungen im Abschnitt EINSTELLUNGEN .
  83. .TP
  84. \fB\-\-css\-sugar\fR
  85. Verbessert den erzeugten HTML/XHTML\-Code, wenn CSS\-Dateien verwendet werden. Tag\-Attribute werden entfernt, Darstellungs\-Tags werden vermieden, Überschriften bestehen aus H1, H2 und H3 Tags, neue DIVs werden erzeugt: \fI#header\fR, \fI#body\fR, \fI.toc\fR.
  86. .TP
  87. \fB\-\-css\-inside\fR
  88. Fügt den Inhalt einer CSS\-Datei innerhalb der HTML/XHTML\-Kopfzeilen ein. Verwende`\-\-style``, um eine CSS\-Datei anzugeben, die gelesen werden soll.
  89. .TP
  90. \fB\-\-dump\-config\fR
  91. Druckt die gefundene Konfiguration und beendet.
  92. .TP
  93. \fB\-\-dump\-source\fR
  94. Druckt das Quelldokument erweitert um die Einfügungen (%!include).
  95. .TP
  96. \fB\-\-encoding\fR=\fICODE\fR
  97. Informiert über den Zeichensatz (die Dateicodierung), der vom Quelldokument verwendet wird. Beispiele sind UTF\-8 und iso\-8859\-1. Die Codierung wird nicht während der Konvertierung geändert, so dass das Ausgabedokument die gleiche Codierung wie die Quellen erhält.
  98. .TP
  99. \fB\-\-gui\fR
  100. Ruft die grafische Tk\-Benutzerschnittstelle auf.
  101. .TP
  102. \fB\-h\fR, \fB\-\-help\fR
  103. Druckt den Hilfetext und beendet.
  104. .TP
  105. \fB\-H\fR, \fB\-\-no\-headers\fR
  106. Unterdrückt Kopf\- und Fußzeilen in der Ausgabe. Nur der Inhalt (Body) wird gezeigt.
  107. .TP
  108. \fB\-\-headers\fR
  109. Zeigt Kopf\- und Fußzeilen in der Ausgabe. Standard ist AN.
  110. .TP
  111. \fB\-\-height\fR=\fINUM\fR
  112. Setzt die Höhe der Ausgabe zu \fINUM\fR Zeilen. Diese Option wird nur benutzt bei ASCII\-Kunst als Zielformat, wenn auch \-\-slides verwendet wird.
  113. .TP
  114. \fB\-i\fR, \fB\-\-infile\fR=\fIDATEI\fR
  115. Setzt \fIDATEI\fR als Eingabedateiname, das Quelldokument. Verwende '\-', um die Quellen von STDIN zu lesen.
  116. .TP
  117. \fB\-\-mask\-email\fR
  118. Versteckt E\-Mails vor Spamrobotern. Entfernt @ und Punkte. Die Adresse foo@bar.com wird zu <foo (a) bar com>.
  119. .TP
  120. \fB\-n\fR, \fB\-\-enum\-title\fR
  121. Verwendet die automatische Nummerierung für Titelzeilen. Ihnen wird 1, 1.1, 1.1.1, ... vorangestellt.
  122. .TP
  123. \fB\-\-no\-dump\-config\fR
  124. Beendet die \-\-dump\-config Aktion.
  125. .TP
  126. \fB\-\-no\-dump\-source\fR
  127. Beendet die \-\-dump\-source Aktion.
  128. .TP
  129. \fB\-\-no\-encoding\fR
  130. Löscht die Codierungseinstellung.
  131. .TP
  132. \fB\-\-no\-enum\-title\fR
  133. Unterdrückt die automatische Nummerierung für Titelzeilen.
  134. .TP
  135. \fB\-\-no\-infile\fR
  136. Löscht alle vorigen infile\-Deklarationen.
  137. .TP
  138. \fB\-\-no\-targets\fR
  139. Beendet die \-\-targets Aktion.
  140. .TP
  141. \fB\-\-no\-mask\-email\fR
  142. Unterdrückt die E\-Mailmaskierung.
  143. .TP
  144. \fB\-\-no\-outfile\fR
  145. Löscht die vorige outfile\-Deklaration.
  146. .TP
  147. \fB\-\-no\-quiet\fR
  148. Zeigt Meldungen, unterdrückt die \-\-quiet Option.
  149. .TP
  150. \fB\-\-no\-rc\fR
  151. Liest nicht die Benutzerkonfigurationsdatei ~/.txt2tagsrc.
  152. .TP
  153. \fB\-\-no\-slides\fR
  154. Schaltet das slides\-Feature aus.
  155. .TP
  156. \fB\-\-no\-style\fR
  157. Löscht alle Stileinstellungen.
  158. .TP
  159. \fB\-\-no\-toc\fR
  160. Entfernt das Inhaltsverzeichnis von der Ausgabe.
  161. .TP
  162. \fB\-\-no\-toc\-only\fR
  163. Schaltet die \-\-toc\-only Aktion aus.
  164. .TP
  165. \fB\-o\fR, \fB\-\-outfile\fR=\fIDATEI\fR
  166. Setzt \fIDATEI\fR als Ausgabedateiname. Benutzt '\-', um Ergebnisse nach STDOUT zu schicken.
  167. .TP
  168. \fB\-q\fR, \fB\-\-quiet\fR
  169. Stiller Modus. Unterdrückt alle Ausgaben, außer Fehler.
  170. .TP
  171. \fB\-\-rc\fR
  172. Liest die Benutzerkonfigurationsdatei ~/.txt2tagsrc. Standard ist AN.
  173. .TP
  174. \fB\-\-slides\fR
  175. Formatiert die Ausgabe als Präsentation. Diese Option wird nur benutzt bei ASCII\-Kunst als Zielformat.
  176. .TP
  177. \fB\-\-style\fR=\fIDATEI\fR
  178. Verwendet \fIDATEI\fR als Stildatei des Dokuments. Wird benutzt, um CSS\-Dateien für HTML/XHTML\-Dokumente zu definieren und Pakete für LaTeX. Diese Option kann mehrmals verwendet werden, um mehrere Dateien einzufügen.
  179. .TP
  180. \fB\-t\fR, \fB\-\-target\fR=\fITYPE\fR
  181. Setzt das Format des Ausgabedokuments zu \fITYPE\fR. Einige populäre Typen sind: \fIhtml\fR, \fIxhtml\fR, \fItex\fR, \fIman\fR, \fItxt\fR. Benutze die \-\-targets Option, um alle verfügbaren Formate zu sehen.
  182. .TP
  183. \fB\-\-targets\fR
  184. Druckt eine Liste aller verfügbaren Zielformate und beendet.
  185. .TP
  186. \fB\-\-toc\fR
  187. Fügt automatisch ein Inhaltsverzeichnis (TOC) in die Ausgabe zwischen Header und Body ein. Die Position kann mit dem %%TOC Makro festgelegt werden.
  188. .TP
  189. \fB\-\-toc\-level\fR=\fINUM\fR
  190. Setzt die maximale TOC\-Tiefe zu \fINUM\fR. Alle Titel tiefer als \fINUM\fR werden nicht ins Inhaltsverzeichnis eingefügt.
  191. .TP
  192. \fB\-\-toc\-only\fR
  193. Druckt nur das Inhaltsverzeichnis und beendet.
  194. .TP
  195. \fB\-v\fR, \fB\-\-verbose\fR
  196. Druckt informative Nachrichten während der Konvertierung. Diese Option kann mehrmals benutzt werden, um die Anzahl der angezeigten Nachrichten zu erhöhen.
  197. .TP
  198. \fB\-V\fR, \fB\-\-version\fR
  199. Druckt die Programmversion und beendet.
  200. .TP
  201. \fB\-\-width\fR=\fINUM\fR
  202. Setzt die Ausgabebreite auf \fINUM\fR Spalten. Diese Option wird nur bei ASCII\-Kunst als Zielformat verwendet.
  203. .SH QUELLDATEIEN
  204. .P
  205. Die Quelldateien werden normalerweise durch die \fI.t2t\fR Erweiterung (wie in myfile.t2t) ausgewiesen. In den Quelldateien können drei Bereiche vorkommen :
  206. .TP
  207. \fBHeader\fR (optional)
  208. Die ersten drei Zeilen der Datei. Lasse die erste Zeile leer, wenn keine Kopfzeilen gebraucht werden. Wird verwendet für Dokumenttitel, Autor, Version und Datumsinformation.
  209. .TP
  210. \fBSettings\fR (optional)
  211. Beginnt gleich nach dem Header (vierte oder zweite Zeile) und endet, wo der Body beginnt.
  212. Wird benutzt für Einstellungen im %!keyword:value Format.
  213. .TP
  214. \fBBody\fR
  215. Beginnt an der ersten gültigen Textzeile (nicht Kommentar oder Einstellung) nach dem Headerbereich und geht bis zum Ende des Dokuments. Wird für den Dokumentinhalt benutzt.
  216. .SH EINSTELLUNGEN
  217. .P
  218. Mit den Einstellungen kann \fBtxt2tags\fR angepasst werden, ähnlich den Otionen. Sie können im Quelldokument im Bereich Einstellungen benutzt werden, ~/.txt2tagsrc file, die externe Datei wird mit \-\-config\-file aufgerufen.
  219. .TP
  220. \fB%!target\fR
  221. Setzt das Ausgabeformat, wie bei \-\-target. Beispiel:
  222. .nf
  223. %!target: html
  224. .fi
  225. .TP
  226. \fB%!options(target)\fR
  227. Setzt die Standardoptionen für jedes Ziel. Du mußt die Optionen Kommandozeilen benutzen. Beispiel:
  228. .nf
  229. %!options(html): --toc --toc-level 3 --css-sugar
  230. .fi
  231. .TP
  232. \fB%!includeconf\fR
  233. Füge die Konfigurationen aus einer externen Datei in die aktuelle ein, wie bei \-\-config\-file. Beispiel:
  234. .nf
  235. %!includeconf: myconfig.t2t
  236. .fi
  237. .TP
  238. \fB%!style\fR
  239. Setzt eine Stildatei für das document, wie bei \-\-style. Kann mehrmals benutzt werden. Beispiel:
  240. .nf
  241. %!style: colors.css
  242. .fi
  243. .TP
  244. \fB%!encoding\fR
  245. Setzt den Zeichensatz, der vom Dokument verwendet wird, wie bei \-\-encoding. Beispiel:
  246. .nf
  247. %!encoding: UTF-8
  248. .fi
  249. .TP
  250. \fB%!preproc\fR
  251. Wendet ein Suchen/Ersetzen Filter an, das verwendet wird um den Body vom Quelldokument zu ändern, VOR jedem Parsen durch txt2tags. Die Suche verwendet reguläre Ausdrücke von Python. Beispiel:
  252. .nf
  253. %!preproc: "JJS" "John J. Smith"
  254. .fi
  255. .TP
  256. \fB%!postproc\fR
  257. Wendet ein Suchen/Ersetzen Filter an, das verwendet wird um das erzeugte Dokument zu ändern, NACH allem Verarbeiten durch txt2tags. Die Suche verwendet reguläre Ausdrücke von Python. Beispiel:
  258. .nf
  259. %!postproc(html): "<B>" "<STRONG>"
  260. .fi
  261. .P
  262. Wenn das gleiche Schlüsselwort mehr als einmal vorkommt, wird das letzte gefundene benutzt (außer bei: Optionen, preproc und postproc, welche kumulativ arbeiten). Ungültige Schlüsselwörter werden ignoriert. Die Reihenfolge ist: ~/.txt2tagsrc, Konfigurationsbereich des Quelldokuments, \-\-config\-file Option.
  263. .SH COMMANDS
  264. .P
  265. Kommandos führen Aufgaben während der Konvertierung aus. Sie müssen in den Body des Quelldokuments geschrieben werden.
  266. .TP
  267. \fB%!csv: Datei.csv\fR
  268. Fügt eine externe CSV\-Datei als Tabelle ein.
  269. .TP
  270. \fB%!include: Datei.t2t\fR
  271. Fügt eine txt2tags\-Datei ein.
  272. .TP
  273. \fB%!include: ``Datei.txt``\fR
  274. Fügt eine Textdatei (verbatim) in das Dokument ein.
  275. .TP
  276. \fB%!include: \&''Datei.html''\fR
  277. Fügt eine bereits getaggte Datei in das Dokument ein.
  278. .SH MAKROS
  279. .P
  280. Makros sind handliche Abkürzungen und erlauben es dynamisch Inhalt ins Dokument einzufügen. Sie müssen in den Body des Quelldokuments gestellt werden. Mit Ausnahme von %%toc können alle Makros mit speziellen Direktiven, wie %Y and %f angepaßt werden. Für Details siehe das txt2tags Benutzerhandbuch.
  281. .TP
  282. \fB%%date\fR
  283. Fügt das aktuelle Datum ein. Das Standardformat ist %%date(%Y%m%d), was YYYYMMDD ergibt.
  284. .TP
  285. \fB%%infile\fR
  286. Fügt den Pfad der Quelldatei ein. Das Standardformat ist %%infile(%f). Nützlich für links in Fußzeilen wie [See source %%infile].
  287. .TP
  288. \fB%%mtime\fR
  289. Füge die Änderungszeit der Quelldatei ein. Das Standardformat ist %%date(%Y%m%d), welche YYYYMMDD ergibt.
  290. .TP
  291. \fB%%outfile\fR
  292. Fügt den Pfad der Ausgabedatei ein. Das Standardformat ist %%outfile(%f). Nützlich für self mentioning wie "Dieses ist die manpage\-de.man Datei".
  293. .TP
  294. \fB%%toc\fR
  295. Bestimmt wo das Inhaltsverzeichnis gesetzt wird. Kann ebenso mehrmals benutzt werden. Dafür muß ebenfalls die \-\-toc Option benutzt werden.
  296. .SH BEISPIELE
  297. .TP
  298. txt2tags \-t html Datei.t2t
  299. Konvertiert nach HTML, speichert in file.html.
  300. .TP
  301. txt2tags \-t html \-o \- Datei.t2t
  302. Konvertiert nach HTML, sendet Ergebnisse nach STDOUT.
  303. .TP
  304. txt2tags \-t html \-\-toc Datei.t2t
  305. Konvertiert nach HTML, fügt automatisch ein Inhaltsverzeichnis ein.
  306. .TP
  307. txt2tags \-t html \-\-toc \-\-toc\-level 2 \-n Datei.t2t
  308. Konvertiert nach HTML, mit einem Inhaltsverzeichnis mit zwei Ebenen und nummerierten Titeln.
  309. .TP
  310. txt2tags \-\-toc\-only Datei.t2t
  311. Zeigt nur das Inhaltsverzeichnis, ohne Konvertierung.
  312. .TP
  313. txt2tags \-t html \-\-css\-sugar \-\-style base.css \-\-style ui.css Datei.t2t
  314. Konvertiert nach HTML, bereitet den sich ergebenden Code vor für CSS, und fügt Aufrufe von zwei externen CSS Dateien ein.
  315. .TP
  316. txt2tags \-t art \-\-slides \-\-width 80 \-\-height 25 \-o \- Datei.t2t | more
  317. Erzeugt Präsentationsfolien in ASCII\-Kunst, um auf einem 80x25 Bildschirm gezeigt zu werden.
  318. .TP
  319. (echo ; echo "**bold**") | txt2tags \-t html \-H \-
  320. Handlicher Einzeiler für schnelle Tests mit STDIN.
  321. .TP
  322. txt2tags \-t html \-o \- Datei.t2t | tidy > Datei.html
  323. Sendet Ergebnisse an STDOUT, dann verfeinere den Code mit einem externen Programm vor dem Speichern der Ausgabedatei.
  324. .SH DATEIEN
  325. .TP
  326. ~/.txt2tagsrc
  327. Konfigurationsdatei vom Standardbenutzer.
  328. .SH UMGEBUNG
  329. .TP
  330. T2TCONFIG
  331. Wenn nicht Null, wird der volle Pfadnamen für die Standardkonfigurationsdatei gesetzt.
  332. .SH AUTOR
  333. .P
  334. Aurelio Jargas <verde@aurelio.net>
  335. .P
  336. Manpage ins Deutsche übersetzt von Michael Malien, michael.malien@gmx.de.
  337. .SH BUGS
  338. .P
  339. http://bugs.txt2tags.org
  340. .SH COPYRIGHT
  341. .P
  342. Copyright (C) 2001\-2012 Aurelio Jargas, GNU GPL v2
  343. .\" man code generated by txt2tags 2.6.641 (http://txt2tags.org)
  344. .\" cmdline: txt2tags doc/German/manpage-de.t2t