/doc/German/manpage-de.html
http://txt2tags.googlecode.com/ · HTML · 468 lines · 412 code · 54 blank · 2 comment · 0 complexity · 9d5293a7b708fcacd190dadd634b1db7 MD5 · raw file
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
- <HTML>
- <HEAD>
- <STYLE>body{margin:3em;} pre{background:#ffc;}</STYLE>
- <META NAME="generator" CONTENT="http://txt2tags.org">
- <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
- <TITLE>TXT2TAGS</TITLE>
- </HEAD><BODY BGCOLOR="white" TEXT="black">
- <CENTER>
- <H1>TXT2TAGS</H1>
- <FONT SIZE="4">Aug, 2010</FONT>
- </CENTER>
- <P></P>
- <HR NOSHADE SIZE=1>
- <P></P>
- <UL>
- <LI><A HREF="#name">NAME</A>
- <LI><A HREF="#synopsis">SYNOPSIS</A>
- <LI><A HREF="#beschreibung">BESCHREIBUNG</A>
- <LI><A HREF="#markup">MARKUP</A>
- <LI><A HREF="#optionen">OPTIONEN</A>
- <LI><A HREF="#quelldateien">QUELLDATEIEN</A>
- <LI><A HREF="#einstellungen">EINSTELLUNGEN</A>
- <LI><A HREF="#commands">COMMANDS</A>
- <LI><A HREF="#makros">MAKROS</A>
- <LI><A HREF="#beispiele">BEISPIELE</A>
- <LI><A HREF="#dateien">DATEIEN</A>
- <LI><A HREF="#umgebung">UMGEBUNG</A>
- <LI><A HREF="#autor">AUTOR</A>
- <LI><A HREF="#bugs">BUGS</A>
- <LI><A HREF="#copyright">COPYRIGHT</A>
- </UL>
- <P></P>
- <HR NOSHADE SIZE=1>
- <P></P>
- <H1 ID="name">NAME</H1>
- <P>
- txt2tags - Textformatierungs- und -konvertierungswerkzeug
- </P>
- <H1 ID="synopsis">SYNOPSIS</H1>
- <P>
- <B>txt2tags</B> [<I>Optionen</I>] [<I>DATEI</I>...]
- </P>
- <H1 ID="beschreibung">BESCHREIBUNG</H1>
- <P>
- <B>txt2tags</B> liest einen Text mit minimalem Markup und konvertiert ihn zu:
- <I>ASCII Art</I>,
- <I>AsciiDoc</I>,
- <I>Creole</I>,
- <I>DocBook</I>,
- <I>DokuWiki</I>,
- <I>Google Code Wiki</I>,
- <I>HTML</I>,
- <I>LaTeX</I>,
- <I>Lout</I>,
- <I>MagicPoint</I>,
- <I>Man page</I>,
- <I>MoinMoin</I>,
- <I>PageMaker</I>,
- <I>Plain Text</I>,
- <I>PmWiki</I>,
- <I>SGML</I>,
- <I>Wikipedia</I> und
- <I>XHTML</I>.
- </P>
- <P>
- <B>txt2tags</B> liest eine Textdatei mit minimalem Markup und wandelt ihn um in:
- ASCII-Art, AsciiDoc, Creole, DocBook, DokuWiki, Google Code Wiki,
- HTML, LaTeX, Lout, MagicPoint, Manpage, MoinMoin, PageMaker,
- Plain Text, PmWiki, SGML, Wikipedia und XHTML.
- </P>
- <P>
- Diese Manpage wurde von txt2tags aus einer einfachen Textdatei erstellt.
- Der gleiche Textdatei wird auch für die Online-Version dieses Handbuchs in HTML umgewandelt.
- Eine Quelle, MULTI-Ziele - <A HREF="http://txt2tags.org">http://txt2tags.org</A>
- </P>
- <P>
- EIN Quellformat, VIELE Zielformate - <A HREF="http://txt2tags.org">http://txt2tags.org</A>
- </P>
- <H1 ID="markup">MARKUP</H1>
- <PRE>
- Headers Die ersten 3 Zeilen der Quelldatei
- Titel = Wörter =
- Nummerierter Titel + Wörter +
- Kommentar % Kommentare
- Trennungslinie -----------------------...
- Dicke Linie =======================...
- Bild [Dateiname.jpg]
- Link [Marke url]
-
- Fett **Wörter**
- Italic //Wörter//
- Understrichen __Wörter__
- Durchgestrichen --Wörter--
- Monospaced ``Wörter``
- Raw ""Wörter""
- Tagged ''Wörter''
-
- Absatz Wörter
- Zitat <TAB>Wörter
- Liste - Wörter
- Numerierte Liste + Wörter
- Definitionsliste : Wörter
- Tabelle | Zelle 1 | Zelle 2 | Zelle 3 ...
-
- Verbatim-Zeile ``` Wörter
- Raw-Zeile """ Wörter
- Tagged-Zeile ''' Wörter
-
- Verbatim-Block ```
- Zeilen
- ```
- Raw-Block """
- Zeilen
- """
- Tagged-Block '''
- Zeilen
- '''
- </PRE>
- <H1 ID="optionen">OPTIONEN</H1>
- <DL>
- <DT> <B>--art-chars</B>=<I>MUSTER</I></DT><DD>
- Definiert <I>MUSTER</I> 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.
- <P></P>
- <DT><B>-C</B>, <B>--config-file</B>=<I>DATEI</I></DT><DD>
- Liest die Konfiguration aus einer externen <I>DATEI</I>. Die Konfiguration muß im Format <I>%!keyword:value</I> stehen. Siehe die Erläuterungen im Abschnitt <A HREF="#einstellungen">EINSTELLUNGEN</A> .
- <P></P>
- <DT> <B>--css-sugar</B></DT><DD>
- 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: <I>#header</I>, <I>#body</I>, <I>.toc</I>.
- <P></P>
- <DT> <B>--css-inside</B></DT><DD>
- Fügt den Inhalt einer CSS-Datei innerhalb der HTML/XHTML-Kopfzeilen ein. Verwende`--style``, um eine CSS-Datei anzugeben, die gelesen werden soll.
- <P></P>
- <DT> <B>--dump-config</B></DT><DD>
- Druckt die gefundene Konfiguration und beendet.
- <P></P>
- <DT> <B>--dump-source</B></DT><DD>
- Druckt das Quelldokument erweitert um die Einfügungen (<CODE>%!include</CODE>).
- <P></P>
- <DT> <B>--encoding</B>=<I>CODE</I></DT><DD>
- 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.
- <P></P>
- <DT> <B>--gui</B></DT><DD>
- Ruft die grafische Tk-Benutzerschnittstelle auf.
- <P></P>
- <DT><B>-h</B>, <B>--help</B></DT><DD>
- Druckt den Hilfetext und beendet.
- <P></P>
- <DT><B>-H</B>, <B>--no-headers</B></DT><DD>
- Unterdrückt Kopf- und Fußzeilen in der Ausgabe. Nur der Inhalt (Body) wird gezeigt.
- <P></P>
- <DT> <B>--headers</B></DT><DD>
- Zeigt Kopf- und Fußzeilen in der Ausgabe. Standard ist AN.
- <P></P>
- <DT> <B>--height</B>=<I>NUM</I></DT><DD>
- Setzt die Höhe der Ausgabe zu <I>NUM</I> Zeilen. Diese Option wird nur benutzt bei ASCII-Kunst als Zielformat, wenn auch <CODE>--slides</CODE> verwendet wird.
- <P></P>
- <DT><B>-i</B>, <B>--infile</B>=<I>DATEI</I></DT><DD>
- Setzt <I>DATEI</I> als Eingabedateiname, das Quelldokument. Verwende '-', um die Quellen von STDIN zu lesen.
- <P></P>
- <DT> <B>--mask-email</B></DT><DD>
- Versteckt E-Mails vor Spamrobotern. Entfernt @ und Punkte. Die Adresse foo@bar.com wird zu <foo (a) bar com>.
- <P></P>
- <DT><B>-n</B>, <B>--enum-title</B></DT><DD>
- Verwendet die automatische Nummerierung für Titelzeilen. Ihnen wird 1, 1.1, 1.1.1, ... vorangestellt.
- <P></P>
- <DT> <B>--no-dump-config</B></DT><DD>
- Beendet die <CODE>--dump-config</CODE> Aktion.
- <P></P>
- <DT> <B>--no-dump-source</B></DT><DD>
- Beendet die <CODE>--dump-source</CODE> Aktion.
- <P></P>
- <DT> <B>--no-encoding</B></DT><DD>
- Löscht die Codierungseinstellung.
- <P></P>
- <DT> <B>--no-enum-title</B></DT><DD>
- Unterdrückt die automatische Nummerierung für Titelzeilen.
- <P></P>
- <DT> <B>--no-infile</B></DT><DD>
- Löscht alle vorigen infile-Deklarationen.
- <P></P>
- <DT> <B>--no-targets</B></DT><DD>
- Beendet die <CODE>--targets</CODE> Aktion.
- <P></P>
- <DT> <B>--no-mask-email</B></DT><DD>
- Unterdrückt die E-Mailmaskierung.
- <P></P>
- <DT> <B>--no-outfile</B></DT><DD>
- Löscht die vorige outfile-Deklaration.
- <P></P>
- <DT> <B>--no-quiet</B></DT><DD>
- Zeigt Meldungen, unterdrückt die <CODE>--quiet</CODE> Option.
- <P></P>
- <DT> <B>--no-rc</B></DT><DD>
- Liest nicht die Benutzerkonfigurationsdatei ~/.txt2tagsrc.
- <P></P>
- <DT> <B>--no-slides</B></DT><DD>
- Schaltet das slides-Feature aus.
- <P></P>
- <DT> <B>--no-style</B></DT><DD>
- Löscht alle Stileinstellungen.
- <P></P>
- <DT> <B>--no-toc</B></DT><DD>
- Entfernt das Inhaltsverzeichnis von der Ausgabe.
- <P></P>
- <DT> <B>--no-toc-only</B></DT><DD>
- Schaltet die <CODE>--toc-only</CODE> Aktion aus.
- <P></P>
- <DT><B>-o</B>, <B>--outfile</B>=<I>DATEI</I></DT><DD>
- Setzt <I>DATEI</I> als Ausgabedateiname. Benutzt '-', um Ergebnisse nach STDOUT zu schicken.
- <P></P>
- <DT><B>-q</B>, <B>--quiet</B></DT><DD>
- Stiller Modus. Unterdrückt alle Ausgaben, außer Fehler.
- <P></P>
- <DT> <B>--rc</B></DT><DD>
- Liest die Benutzerkonfigurationsdatei ~/.txt2tagsrc. Standard ist AN.
- <P></P>
- <DT> <B>--slides</B></DT><DD>
- Formatiert die Ausgabe als Präsentation. Diese Option wird nur benutzt bei ASCII-Kunst als Zielformat.
- <P></P>
- <DT> <B>--style</B>=<I>DATEI</I></DT><DD>
- Verwendet <I>DATEI</I> 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.
- <P></P>
- <DT><B>-t</B>, <B>--target</B>=<I>TYPE</I></DT><DD>
- Setzt das Format des Ausgabedokuments zu <I>TYPE</I>. Einige populäre Typen sind: <I>html</I>, <I>xhtml</I>, <I>tex</I>, <I>man</I>, <I>txt</I>. Benutze die <CODE>--targets</CODE> Option, um alle verfügbaren Formate zu sehen.
- <P></P>
- <DT> <B>--targets</B></DT><DD>
- Druckt eine Liste aller verfügbaren Zielformate und beendet.
- <P></P>
- <DT> <B>--toc</B></DT><DD>
- Fügt automatisch ein Inhaltsverzeichnis (TOC) in die Ausgabe zwischen Header und Body ein. Die Position kann mit dem <CODE>%%TOC</CODE> Makro festgelegt werden.
- <P></P>
- <DT> <B>--toc-level</B>=<I>NUM</I></DT><DD>
- Setzt die maximale TOC-Tiefe zu <I>NUM</I>. Alle Titel tiefer als <I>NUM</I> werden nicht ins Inhaltsverzeichnis eingefügt.
- <P></P>
- <DT> <B>--toc-only</B></DT><DD>
- Druckt nur das Inhaltsverzeichnis und beendet.
- <P></P>
- <DT><B>-v</B>, <B>--verbose</B></DT><DD>
- Druckt informative Nachrichten während der Konvertierung. Diese Option kann mehrmals benutzt werden, um die Anzahl der angezeigten Nachrichten zu erhöhen.
- <P></P>
- <DT><B>-V</B>, <B>--version</B></DT><DD>
- Druckt die Programmversion und beendet.
- <P></P>
- <DT> <B>--width</B>=<I>NUM</I></DT><DD>
- Setzt die Ausgabebreite auf <I>NUM</I> Spalten. Diese Option wird nur bei ASCII-Kunst als Zielformat verwendet.
- </DL>
- <H1 ID="quelldateien">QUELLDATEIEN</H1>
- <P>
- Die Quelldateien werden normalerweise durch die <I>.t2t</I> Erweiterung (wie in <CODE>myfile.t2t</CODE>) ausgewiesen. In den Quelldateien können drei Bereiche vorkommen :
- </P>
- <DL>
- <DT><B>Header</B> (optional)</DT><DD>
- 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.
- <P></P>
- <DT><B>Settings</B> (optional)</DT><DD>
- Beginnt gleich nach dem Header (vierte oder zweite Zeile) und endet, wo der Body beginnt.
- Wird benutzt für Einstellungen im <CODE>%!keyword:value</CODE> Format.
- <P></P>
- <DT><B>Body</B></DT><DD>
- 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.
- </DL>
- <H1 ID="einstellungen">EINSTELLUNGEN</H1>
- <P>
- Mit den Einstellungen kann <B>txt2tags</B> angepasst werden, ähnlich den Otionen. Sie können im Quelldokument im Bereich Einstellungen benutzt werden, <CODE>~/.txt2tagsrc</CODE> file, die externe Datei wird mit <CODE>--config-file</CODE> aufgerufen.
- </P>
- <DL>
- <DT><B>%!target</B></DT><DD>
- Setzt das Ausgabeformat, wie bei <CODE>--target</CODE>. Beispiel:
- <PRE>
- %!target: html
- </PRE>
- <P></P>
- <DT><B>%!options(target)</B></DT><DD>
- Setzt die Standardoptionen für jedes Ziel. Du mußt die Optionen Kommandozeilen benutzen. Beispiel:
- <PRE>
- %!options(html): --toc --toc-level 3 --css-sugar
- </PRE>
- <P></P>
- <DT><B>%!includeconf</B></DT><DD>
- Füge die Konfigurationen aus einer externen Datei in die aktuelle ein, wie bei <CODE>--config-file</CODE>. Beispiel:
- <PRE>
- %!includeconf: myconfig.t2t
- </PRE>
- <P></P>
- <DT><B>%!style</B></DT><DD>
- Setzt eine Stildatei für das document, wie bei <CODE>--style</CODE>. Kann mehrmals benutzt werden. Beispiel:
- <PRE>
- %!style: colors.css
- </PRE>
- <P></P>
- <DT><B>%!encoding</B></DT><DD>
- Setzt den Zeichensatz, der vom Dokument verwendet wird, wie bei <CODE>--encoding</CODE>. Beispiel:
- <PRE>
- %!encoding: UTF-8
- </PRE>
- <P></P>
- <DT><B>%!preproc</B></DT><DD>
- 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:
- <PRE>
- %!preproc: "JJS" "John J. Smith"
- </PRE>
- <P></P>
- <DT><B>%!postproc</B></DT><DD>
- 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:
- <PRE>
- %!postproc(html): "<B>" "<STRONG>"
- </PRE>
- </DL>
- <P>
- 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: <CODE>~/.txt2tagsrc</CODE>, Konfigurationsbereich des Quelldokuments, <CODE>--config-file</CODE> Option.
- </P>
- <H1 ID="commands">COMMANDS</H1>
- <P>
- Kommandos führen Aufgaben während der Konvertierung aus. Sie müssen in den Body des Quelldokuments geschrieben werden.
- </P>
- <DL>
- <DT><B>%!csv: Datei.csv</B></DT><DD>
- Fügt eine externe CSV-Datei als Tabelle ein.
- <P></P>
- <DT><B>%!include: Datei.t2t</B></DT><DD>
- Fügt eine txt2tags-Datei ein.
- <P></P>
- <DT><B>%!include: ``Datei.txt``</B></DT><DD>
- Fügt eine Textdatei (verbatim) in das Dokument ein.
- <P></P>
- <DT><B>%!include: ''Datei.html''</B></DT><DD>
- Fügt eine bereits getaggte Datei in das Dokument ein.
- </DL>
- <H1 ID="makros">MAKROS</H1>
- <P>
- 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 <CODE>%%toc</CODE> können alle Makros mit speziellen Direktiven, wie <CODE>%Y</CODE> and <CODE>%f</CODE> angepaßt werden. Für Details siehe das txt2tags Benutzerhandbuch.
- </P>
- <DL>
- <DT><B>%%date</B></DT><DD>
- Fügt das aktuelle Datum ein. Das Standardformat ist <CODE>%%date(%Y%m%d)</CODE>, was YYYYMMDD ergibt.
- <P></P>
- <DT><B>%%infile</B></DT><DD>
- Fügt den Pfad der Quelldatei ein. Das Standardformat ist <CODE>%%infile(%f)</CODE>. Nützlich für links in Fußzeilen wie <CODE>[See source %%infile]</CODE>.
- <P></P>
- <DT><B>%%mtime</B></DT><DD>
- Füge die Änderungszeit der Quelldatei ein. Das Standardformat ist <CODE>%%date(%Y%m%d)</CODE>, welche YYYYMMDD ergibt.
- <P></P>
- <DT><B>%%outfile</B></DT><DD>
- Fügt den Pfad der Ausgabedatei ein. Das Standardformat ist <CODE>%%outfile(%f)</CODE>. Nützlich für self mentioning wie "Dieses ist die manpage-de.html Datei".
- <P></P>
- <DT><B>%%toc</B></DT><DD>
- Bestimmt wo das Inhaltsverzeichnis gesetzt wird. Kann ebenso mehrmals benutzt werden. Dafür muß ebenfalls die <CODE>--toc</CODE> Option benutzt werden.
- </DL>
- <H1 ID="beispiele">BEISPIELE</H1>
- <DL>
- <DT><CODE>txt2tags -t html Datei.t2t</CODE></DT><DD>
- <P></P>
- Konvertiert nach HTML, speichert in file.html.
- <P></P>
- <DT><CODE>txt2tags -t html -o - Datei.t2t</CODE></DT><DD>
- <P></P>
- Konvertiert nach HTML, sendet Ergebnisse nach STDOUT.
- <P></P>
- <DT><CODE>txt2tags -t html --toc Datei.t2t</CODE></DT><DD>
- <P></P>
- Konvertiert nach HTML, fügt automatisch ein Inhaltsverzeichnis ein.
- <P></P>
- <DT><CODE>txt2tags -t html --toc --toc-level 2 -n Datei.t2t</CODE></DT><DD>
- <P></P>
- Konvertiert nach HTML, mit einem Inhaltsverzeichnis mit zwei Ebenen und nummerierten Titeln.
- <P></P>
- <DT><CODE>txt2tags --toc-only Datei.t2t</CODE></DT><DD>
- <P></P>
- Zeigt nur das Inhaltsverzeichnis, ohne Konvertierung.
- <P></P>
- <DT><CODE>txt2tags -t html --css-sugar --style base.css --style ui.css Datei.t2t</CODE></DT><DD>
- <P></P>
- Konvertiert nach HTML, bereitet den sich ergebenden Code vor für CSS, und fügt Aufrufe von zwei externen CSS Dateien ein.
- <P></P>
- <DT><CODE>txt2tags -t art --slides --width 80 --height 25 -o - Datei.t2t | more</CODE></DT><DD>
- <P></P>
- Erzeugt Präsentationsfolien in ASCII-Kunst, um auf einem 80x25 Bildschirm gezeigt zu werden.
- <P></P>
- <DT><CODE>(echo ; echo "**bold**") | txt2tags -t html -H -</CODE></DT><DD>
- <P></P>
- Handlicher Einzeiler für schnelle Tests mit STDIN.
- <P></P>
- <DT><CODE>txt2tags -t html -o - Datei.t2t | tidy > Datei.html</CODE></DT><DD>
- <P></P>
- Sendet Ergebnisse an STDOUT, dann verfeinere den Code mit einem externen Programm vor dem Speichern der Ausgabedatei.
- </DL>
- <H1 ID="dateien">DATEIEN</H1>
- <DL>
- <DT>~/.txt2tagsrc</DT><DD>
- Konfigurationsdatei vom Standardbenutzer.
- </DL>
- <H1 ID="umgebung">UMGEBUNG</H1>
- <DL>
- <DT>T2TCONFIG</DT><DD>
- Wenn nicht Null, wird der volle Pfadnamen für die Standardkonfigurationsdatei gesetzt.
- </DL>
- <H1 ID="autor">AUTOR</H1>
- <P>
- Aurelio Jargas <<verde (a) aurelio net>>
- </P>
- <P>
- Manpage ins Deutsche übersetzt von Michael Malien, <michael malien (a) gmx de>.
- </P>
- <H1 ID="bugs">BUGS</H1>
- <P>
- <A HREF="http://bugs.txt2tags.org">http://bugs.txt2tags.org</A>
- </P>
- <H1 ID="copyright">COPYRIGHT</H1>
- <P>
- Copyright (C) 2001-2012 Aurelio Jargas, GNU GPL v2
- </P>
- <!-- html code generated by txt2tags 2.6.641 (http://txt2tags.org) -->
- <!-- cmdline: txt2tags -t html doc/German/manpage-de.t2t -->
- </BODY></HTML>