Commit 19c28e23 authored by Clément Stenac's avatar Clément Stenac

Use new system for vlc-user-guide

parent 99405103
......@@ -387,13 +387,12 @@ the same url, use this option instead of the two above
<note><para>
In the <emphasis>url</emphasis> options, if you use
the <emphasis>file</emphasis> access, you can use the following macros
in the filename:
</para>
in the filename:</para>
<itemizedlist>
<listitem><para><emphasis>%n</emphasis> =
stream number
stream number</para></listitem>
<listitem><para><emphasis>%c</emphasis> = FOURCC ;</para></listitem>
<listitem><para><emphasis>%m</emphasis> =
muxer
......
......@@ -4,7 +4,7 @@
<para>
Click on the <emphasis>Uninstall VLC</emphasis>
icon that was created during installation
icon that was created during installation</para>
</sect2>
<sect2><title>BeOS</title>
......@@ -61,8 +61,7 @@ execute
<prompt># </prompt><userinput>make uninstall</userinput>
</screen>
<para>
Then you can remove the VLC sources
<para>Then you can remove the VLC sources</para>
.</para>
</sect2>
......@@ -382,8 +382,7 @@ macros dans le nom de fichier:
numéro de flux
;</para></listitem>
<listitem><para><emphasis>%c</emphasis> = FOURCC ;</para></listitem>
<listitem><para><emphasis>%m</emphasis> =
format
<listitem><para><emphasis>%m</emphasis> = format</para></listitem>
<listitem><para><emphasis>%a</emphasis> = access.</para></listitem>
</itemizedlist>
......
......@@ -11,28 +11,31 @@ XML_DECL := /usr/lib/sgml/declaration/xml.decl
# Default language (English)
LANG = en
XSL= /usr/share/xml/docbook/stylesheet/nwalsh/xhtml/chunk.xsl
# All available languages (used in 'make clean')
ALL_LANG = en fr de
# Build HTML, PDF, RTF and TXT outputs (for the web site)
all: $(LANG)/$(DOC)-$(LANG).html $(LANG)/$(DOC)-$(LANG).pdf $(LANG)/$(DOC)-$(LANG).rtf $(LANG)/$(DOC)-$(LANG).txt
# Extract one language (XML to XML transformation) and prepare the repository
$(LANG)/$(DOC)-$(LANG).xml: *.xml ../common/*.xml ../common/multilanguage.xsl
init-$(LANG):
mkdir -p $(LANG)
xsltproc --stringparam lang $(LANG) ../common/multilanguage.xsl $(DOC).xml | sed -e 's/id="$(DOC)"/id="$(DOC)-$(LANG)"/' > $@
cp -R ../../images/documentation $(LANG)/images
cp ../common/screen.css $(LANG)
cp ../common/htaccess $(LANG)/.htaccess
# HTML output
$(LANG)/$(DOC)-$(LANG).html: $(LANG)/$(DOC)-$(LANG).xml ../common/stylesheet-html.dsl
jade -t sgml -d ../common/stylesheet-html.dsl $(XML_DECL) $(LANG)/$(DOC)-$(LANG).xml
$(LANG)/$(DOC)-$(LANG).html: init-$(LANG)
xsltproc --stringparam chunker.output.encoding "iso-8859-15" --param chunk.section.depth 0 --stringparam html.stylesheet "screen.css" $(XSL) src/$(LANG)/$(DOC).xml > $(LANG)/$(DOC)-$(LANG).html
mv *.html $(LANG)
cd $(LANG) && cp index.html $(DOC)-$(LANG).html && cd ..
rm -f $(LANG)/$(DOC)-$(LANG)-html.zip
cd $(LANG) && zip $(DOC)-$(LANG)-html.zip *.html images/*.jpg images/*.gif
cd $(LANG) && zip $(DOC)-$(LANG)-html.zip *.html images/*.gif
# PDF output
$(LANG)/$(DOC)-$(LANG).pdf: $(LANG)/$(DOC)-$(LANG).xml ../common/stylesheet-print-noicones.dsl
jade -t tex -d ../common/stylesheet-print-noicones.dsl -o $(LANG)/$(DOC)-$(LANG).tex $(XML_DECL) $(LANG)/$(DOC)-$(LANG).xml
$(LANG)/$(DOC)-$(LANG).pdf: init-$(LANG)
jade -t tex -d ../common/stylesheet-print-noicones.dsl -o $(LANG)/$(DOC)-$(LANG).tex $(XML_DECL) src/$(LANG)/$(DOC).xml
cd $(LANG) && pdfjadetex $(DOC)-$(LANG).tex
cd $(LANG) && pdfjadetex $(DOC)-$(LANG).tex
cd $(LANG) && pdfjadetex $(DOC)-$(LANG).tex
......@@ -40,14 +43,14 @@ $(LANG)/$(DOC)-$(LANG).pdf: $(LANG)/$(DOC)-$(LANG).xml ../common/stylesheet-prin
cd $(LANG) && zip $(DOC)-$(LANG)-pdf.zip $(DOC)-$(LANG).pdf
# RTF output
$(LANG)/$(DOC)-$(LANG).rtf: $(LANG)/$(DOC)-$(LANG).xml ../common/stylesheet-print-noicones.dsl
cd $(LANG) && jade -t rtf -d ../../common/stylesheet-print-noicones.dsl -o $(DOC)-$(LANG).rtf $(XML_DECL) $(DOC)-$(LANG).xml
$(LANG)/$(DOC)-$(LANG).rtf:init-$(LANG)
cd $(LANG) && jade -t rtf -d ../../common/stylesheet-print-noicones.dsl -o $(DOC)-$(LANG).rtf $(XML_DECL) ../src/$(LANG)/$(DOC).xml
rm -f $(LANG)/$(DOC)-$(LANG)-rtf.zip
cd $(LANG) && zip $(DOC)-$(LANG)-rtf.zip $(DOC)-$(LANG).rtf images/*.jpg
cd $(LANG) && zip $(DOC)-$(LANG)-rtf.zip $(DOC)-$(LANG).rtf
# TXT output
$(LANG)/$(DOC)-$(LANG).txt: $(LANG)/$(DOC)-$(LANG).xml ../common/stylesheet-txt.dsl
jade -t sgml -d ../common/stylesheet-txt.dsl -V nochunks $(XML_DECL) $(LANG)/$(DOC)-$(LANG).xml > $(LANG)/dumpfortxt.html
$(LANG)/$(DOC)-$(LANG).txt:init-$(LANG)
jade -t sgml -d ../common/stylesheet-txt.dsl -V nochunks $(XML_DECL) src/$(LANG)/$(DOC).xml > $(LANG)/dumpfortxt.html
lynx -force_html -dump $(LANG)/dumpfortxt.html > $(LANG)/$(DOC)-$(LANG).txt
rm -f $(LANG)/dumpfortxt.html
......
<?xml version="1.0" encoding="iso-8859-1" ?>
<para>
<emphasis>
Immer aktiviert
</emphasis>
</para>
<?xml version="1.0" encoding="iso8859-1"?>
<chapter id="cmdline"><title id="tcmdline">
Die Befehlszeilenoberflche
</title>
<sect1>
<title>
Einfhrung
</title>
<para>
Viele Optionen sind nur ber die Befehlszeile verfgbar.
Sie werden hier aufgefhrt und erklrt
.</para>
</sect1>
<sect1><title>
Das ffnen von Streams
</title>
<para>
Die folgenden Befehle starten VLC und fgen das
erste Element der Wiedergabeliste hinzu
.</para>
<sect2><title>
Das ffnen einer Datei
</title>
<para>
Starten Sie VLC mit
:</para>
<screen>
<prompt>% </prompt><userinput>vlc -vvv my_file.mpg</userinput>
</screen>
<para>
Obwohl VLC in der Lage sein sollte, den Dateityp
zu erkennen, knnen Sie VLC den zu benutzenden Codec mit der
<emphasis>--codec</emphasis>-Option mitteilen. Um beispielsweise
die Datei my_file.mpg mit dem ffmpeg Ton/Bild - Dekoder wiederzugeben,
machen Sie folgendes
:</para>
<screen>
<prompt>% </prompt><userinput>vlc -vvv --codec ffmpeg my_file.mpg</userinput>
</screen>
<para>
Eine Liste aller von VLC untersttzten Audio- und
Videocodecs ist auf der Seite <ulink url="http://www.videolan.org/vlc/features.html">VLC features list</ulink>
verfgbar
.</para>
</sect2>
<sect2><title>
Das ffnen einer DVD, VCD oder einer Audio-CD
</title>
<para>
Starten Sie VLC mit
:</para>
<!-- Do not wrap me -->
<screen>
<prompt>% </prompt><userinput>vlc -vvv dvd://[Gert][@Gert_raw][@[Titel][,[Kapitel][,Winkel]]]
</userinput>
</screen>
<para>
oder
(VCD):</para>
<!-- Do not wrap me -->
<screen>
<prompt>% </prompt><userinput>vlc -vvv vcd://[Gert][@[Titel][,Kapitel]]</userinput>
</screen>
<para>
oder
(Audio CD):</para>
<!-- Do not wrap me -->
<screen>
<prompt>% </prompt><userinput>vlc -vvv cdda://[Gert][@[Titel]]</userinput>
</screen>
<para>
Wobei das Gert der komplette Pfad zu Ihrer DVD oder
Ihrer CD-ROM ist
.</para>
</sect2>
<sect2><title>
Empfangen eines Netzwerkstreams
</title>
<para>
Um einen Unicast-UDP-Stream (gesendet von VLS oder
VLCs Streamausgabe) zu empfangen, starten Sie VLC mit
:</para>
<screen>
<prompt>% </prompt><userinput>vlc -vvv udp:[@:Server_Port]</userinput>
</screen>
<para>
Um einen Multicast-UDP-Stream (gesendet von VLS oder
VLCs Streamausgabe) zu empfangen, starten Sie VLC mit
:</para>
<screen>
<prompt>% </prompt><userinput>vlc -vvv udp:@multicast_address[:Server_Port]</userinput>
</screen>
<para>
Um einen HTTP-Stream zu empfangen, starten Sie VLC mit
:</para>
<screen>
<prompt>% </prompt><userinput>vlc -vvv http://www.example.org/your_file.mpg</userinput>
</screen>
</sect2>
</sect1>
<sect1><title>
Auswahl der Module
</title>
<para>
VLC versucht die am Besten passende Oberflche und
Input- und Ausgabemodule unter den auf Ihrem System verfgbaren fr den
zu lesenden Stream zu whlen. Trotzdem mchten Sie eventuell die Benutzung
eines bestimmten Moduls mit den folgenden Optionen erzwingen (Schauen Sie
fr die komplette Liste von Modulen in die <xref linkend="modules" endterm="tmodules"/>Module-Sektion)
:</para>
<itemizedlist>
<listitem><para><emphasis>--intf &lt;module&gt;</emphasis>
erlaubt Ihnen das Oberflchenmodul zu whlen
.</para></listitem>
<listitem><para><emphasis>--extraintf &lt;module&gt;</emphasis>
Erlaubt Ihnen zustzliche Oberflchenmodul auszuwhlen,
die zustzlich zur Hauptoberflche gestartet werden
.</para></listitem>
<listitem><para><emphasis>--aout &lt;module&gt;</emphasis>
Erlaubt Ihnen das Tonausgabemodul zu whlen
.</para></listitem>
<listitem><para><emphasis>--vout &lt;module&gt;</emphasis>
Erlaubt Ihnen das Bildausgabemodul zu whlen
.</para></listitem>
<listitem><para><emphasis>--filter &lt;module&gt;</emphasis>
Erlaubt Ihnen Bildfilter hinzuzufgen
.</para></listitem>
<listitem><para><emphasis>--memcpy &lt;module&gt;</emphasis>
Erlaubt Ihnen ein Speicherkopiermodul zu whlen
.</para></listitem>
</itemizedlist>
</sect1>
<sect1><title>
Streamausgabe
</title>
&sout;
</sect1>
<sect1><title>Andere Optionen</title>
<sect2><title>
Tonoptionen
</title>
<itemizedlist>
<listitem><para><emphasis>--noaudio</emphasis>
Deaktiviert den Ton
.</para></listitem>
<listitem><para><emphasis>--mono</emphasis>
Zwingt VLC Monoton zu anzuwenden
.</para></listitem>
<listitem><para><emphasis>--volume &lt;Ganzzahl&gt;</emphasis>
Stellt die Lautstrke ein
.</para></listitem>
<listitem><para><emphasis>--aout-rate &lt;Ganzzahl&gt;</emphasis>
Stellt die Tonausgabefrequenz in Hz ein
.</para></listitem>
<listitem><para><emphasis>--desync &lt;Ganzzahl&gt;</emphasis>
Gleicht die Desynchronisation des Tons aus (ms)
.</para></listitem>
<listitem><para><emphasis>--headphone</emphasis>
Aktiviert den virtuellen Raumklangeffekt fr Kopfhrer
.</para></listitem>
<listitem><para><emphasis>--headphone-dim</emphasis>
Stellt die charakteristische Dimension des Kopfhrers ein
.</para></listitem>
</itemizedlist>
</sect2>
<sect2><title>
Bildoptionen
</title>
<itemizedlist>
<listitem><para><emphasis>--novideo</emphasis>
Deaktiviert die Bildausgabe
.</para></listitem>
<listitem><para><emphasis>--greyscale</emphasis>
Aktiviert Graustufenausgabe des Bildes
.</para></listitem>
<listitem><para><emphasis>--fullscreen</emphasis>
Aktiviert die Vollbildausgabe
.</para></listitem>
<listitem><para><emphasis>--nooverlay</emphasis>
Deaktiviert Hardwarebeschleunigung fr die
Bildausgabe
.</para></listitem>
<listitem><para><emphasis>--width, --height &lt;Ganzzahl&gt;</emphasis>
Stellt die Dimensionen des Bildausgabefensters ein
.</para></listitem>
<listitem><para><emphasis>--zoom &lt;Fliekommazahl&gt;</emphasis>
Fgt einen Vergrerungsfaktor hinzu
.</para></listitem>
<listitem><para><emphasis>--aspect-ratio &lt;mode&gt;</emphasis>
Forciert das Seitenverhltnis
.</para></listitem>
<listitem><para><emphasis>--spumargin &lt;Ganzzahl&gt;</emphasis>
Forciert die Position der SPU-Untertitel
.</para></listitem>
</itemizedlist>
</sect2>
<sect2><title>
Wiedergabelistenoptionen
</title>
<itemizedlist>
<listitem><para><emphasis>--playlist</emphasis>
Startet die Wiedergabeliste beim Start von VLC
.</para></listitem>
<listitem><para><emphasis>--random</emphasis>
Gibt die Datei immer in zuflliger Reihenfolge wieder
.</para></listitem>
<listitem><para><emphasis>--enqueue</emphasis>
Fgt die Objekte der Wiedergabeliste hinzu
.</para></listitem>
<listitem><para><emphasis>--loop</emphasis>
Wiederholt die Wiedergabeliste an deren Ende
.</para></listitem>
</itemizedlist>
</sect2>
<sect2><title>
Netzwerkoptionen
</title>
<itemizedlist>
<listitem><para><emphasis>--server-port &lt;Ganzzahl&gt;</emphasis>
Stellt den Port des Servers ein
.</para></listitem>
<listitem><para><emphasis>--iface &lt;Zeichenkette&gt;</emphasis>
Legt die zu benutzende Netzwerkschnittstelle fest
.</para></listitem>
<listitem><para><emphasis>--iface-addr &lt;Zeichenkette&gt;</emphasis>
Legt die IP Ihrer Netzwerkschnittstelle fest
.</para></listitem>
<listitem><para><emphasis>--mtu &lt;Ganzzahl&gt;</emphasis>
Legt die MTU der Netzwerkschnittstelle fest
.</para></listitem>
<listitem><para><emphasis>--ipv6</emphasis>
Erzwingt die Benutzung von IPv6
.</para></listitem>
<listitem><para><emphasis>--ipv4</emphasis>
Erzwingt die Benutzung von IPv4
.</para></listitem>
</itemizedlist>
</sect2>
<sect2><title>
Prozessoroptionen
</title>
<itemizedlist>
<listitem><para><emphasis>--nommx</emphasis>
Deaktiviert die Benutzung von MMX-Prozessorerweiterungen
.</para></listitem>
<listitem><para><emphasis>--no3dn</emphasis>
Deaktiviert die Benutzung von 3D Now!-Prozessorerweiterungen
.</para></listitem>
<listitem><para><emphasis>--nommxext</emphasis>
Deaktiviert die Benutzung von MMX-Ext-Prozessorerweiterungen
.</para></listitem>
<listitem><para><emphasis>--nosse</emphasis>
Deaktiviert die Benutzung von SSE-Prozessorerweiterungen
.</para></listitem>
</itemizedlist>
</sect2>
<sect2><title>
Diverse Optionen
</title>
<itemizedlist>
<listitem><para><emphasis>--quiet</emphasis>
Deaktiviert die Meldungen in der Console
.</para></listitem>
<listitem><para><emphasis>--color</emphasis>
Zeigt farbige Meldungen an
.</para></listitem>
<listitem><para><emphasis>--search-path &lt;Zeichenkette&gt;</emphasis>
Legt den standardmigen Oberflchensuchpfad fest
.</para></listitem>
<listitem><para><emphasis>--plugin-path &lt;Zeichenkette&gt;</emphasis>
Legt den Plugin-Suchpfad fest
.</para></listitem>
<listitem><para><emphasis>--dvd &lt;Zeichenkette&gt;</emphasis>
Legt das standardmige DVD-Gert fest
.</para></listitem>
<listitem><para><emphasis>--vcd &lt;Zeichenkette&gt;</emphasis>
Legt das standardmige VCD-Gert fest
.</para></listitem>
<listitem><para><emphasis>--program &lt;;Ganzzahl&gt;</emphasis>
Gibt das Programm (SID) an (fr Streams mit mehreren Programmen, wie
die von Satelliten)
.</para></listitem>
<listitem><para><emphasis>--audio-type &lt;&gt;</emphasis>
Legt den standardmigen Audiotyp bei DVDs fest
.</para></listitem>
<listitem><para><emphasis>--audio-channel &lt;Ganzzahl&gt;</emphasis>
Legt den standardmigen Tonkanal bei DVDs fest
.</para></listitem>
<listitem><para><emphasis>--spu-channel &lt;Ganzzahl&gt;</emphasis>
Legt den standardmigen Untertitelkanal bei DVDs fest
.</para></listitem>
</itemizedlist>
</sect2>
<sect2><title>
Hilfe-Optionen
</title>
<itemizedlist>
<listitem><para><emphasis>--verbose &lt;Verbosity&gt;</emphasis>
Legt das Verbosity-Level fest, d.h. wie viele Meldungen
ausgegeben werden
.</para></listitem>
<listitem><para><emphasis>--help</emphasis>
Zeigt Ihnen alle verfgbaren Optionen an
.</para></listitem>
<listitem><para><emphasis>--longhelp</emphasis>
Zeigt Ihnen eine detailierte Hilfe ber alle verfgbaren
Optionen an
.</para></listitem>
<listitem><para><emphasis>--version</emphasis>
Zeigt Ihnen Informationen ber die Version von VLC an
.</para></listitem>
<listitem><para><emphasis>--list</emphasis>
Zeigt Ihnen eine Liste aller verfgbaren Plugins an
.</para></listitem>
<listitem><para><emphasis>--module &lt;module&gt;</emphasis>
Zeigt Hilfe ber das angegebene Modul an
.</para></listitem>
</itemizedlist>
</sect2>
</sect1>
</chapter>
<?xml version="1.0" encoding="iso-8859-1" ?>
<para>
<emphasis>
Standardmig deaktiviert
</emphasis>
</para>
<?xml version="1.0" encoding="iso-8859-1" ?>
<para>
<emphasis>
standardmig aktiviert