lyx-common 2.0.3-3 / usr / share / lyx / doc / de / Customization.lyx

#LyX 2.0 created this file. For more info see http://www.lyx.org/
\lyxformat 413
\begin_document
\begin_header
\textclass scrbook
\begin_preamble
% Präambel nicht verändern!!!
%
% Die Präambel stellt sicher, dass das Benutzerhandbuch korrekt
% in die Formate pdf, ps und dvi exportiert werden kann.
% Wenn Probleme beim Exportieren auftreten, können Sie sich
% an das LyX-Dokumentationsteam wenden.
% EMail: lyx-docs@lists.lyx.org

% wenn pdflatex benutzt wird:
\usepackage{ifpdf}
\ifpdf

 % Schrift für hübschere PDF-Ansichten
 \IfFileExists{lmodern.sty}
  {\usepackage{lmodern}}{}

\fi % Ende von: wenn pdflatex benutzt wird

% Setzt den Link für Spruenge zu Gleitabbildungen
% auf den Anfang des Gelitobjekts und nicht aufs Ende
\usepackage[figure]{hypcap}

% Die Seiten des Inhaltsverzeichnisses werden römisch numeriert,
% ein PDF-Lesezeichen für das Inhaltsverzeichnis wird hinzugefügt
\let\myTOC\tableofcontents
\renewcommand\tableofcontents{%
  \frontmatter
  \pdfbookmark[1]{\contentsname}{}
  \myTOC
  \mainmatter }
\end_preamble
\options fleqn,bibliography=totoc,index=totoc,BCOR7.5mm,titlepage,captions=tableheading
\use_default_options false
\begin_modules
logicalmkup
\end_modules
\maintain_unincluded_children false
\begin_local_layout
Format 7
InsetLayout CharStyle:MenuItem
LyxType               charstyle
LabelString           menu
LatexType             command
LatexName             menuitem
Font
Family              Sans
EndFont
Preamble
\newcommand*{\menuitem}[1]{{\sffamily #1}}
EndPreamble
End
# In case we need to do with sans...
#InsetLayout CharStyle:Code
#Font
#Family              Sans
#EndFont
#Preamble
#\renewcommand{\code}[1]{{\sffamily #1}}
#EndPreamble
#End
\end_local_layout
\language ngerman
\language_package default
\inputencoding auto
\fontencoding global
\font_roman default
\font_sans default
\font_typewriter default
\font_default_family default
\use_non_tex_fonts false
\font_sc false
\font_osf false
\font_sf_scale 100
\font_tt_scale 100

\graphics default
\default_output_format default
\output_sync 0
\bibtex_command default
\index_command default
\paperfontsize 12
\spacing single
\use_hyperref true
\pdf_title "LyX-Anpassung: Möglichkeiten für fortgeschrittene Benutzer"
\pdf_author "LyX Team, deutsche Übersetzung: Peter Sütterlin, Leif Albers und Hartmut Haase"
\pdf_subject "LyX-Dokumentation, Anpassung"
\pdf_keywords "LyX, Dokumentation"
\pdf_bookmarks true
\pdf_bookmarksnumbered true
\pdf_bookmarksopen false
\pdf_bookmarksopenlevel 1
\pdf_breaklinks false
\pdf_pdfborder false
\pdf_colorlinks true
\pdf_backref false
\pdf_pdfusetitle false
\pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue,  pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false"
\papersize default
\use_geometry false
\use_amsmath 0
\use_esint 0
\use_mhchem 0
\use_mathdots 0
\cite_engine basic
\use_bibtopic false
\use_indices false
\paperorientation portrait
\suppress_date false
\use_refstyle 0
\branch OutDated
\selected 0
\filename_suffix 0
\color #faf0e6
\end_branch
\index Stichwortverzeichnis
\shortcut idx
\color #008000
\end_index
\secnumdepth 3
\tocdepth 3
\paragraph_separation indent
\paragraph_indentation default
\quotes_language german
\papercolumns 1
\papersides 2
\paperpagestyle headings
\tracking_changes false
\output_changes false
\html_math_output 0
\html_css_as_file 0
\html_be_strict false
\end_header

\begin_body

\begin_layout Title
LyX-Anpassung:
\begin_inset Newline newline
\end_inset

Möglichkeiten für fortgeschrittene Benutzer
\end_layout

\begin_layout Author
vom LyX-Team
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Übersetzung: 
\noun on
Peter Sütterlin
\noun default
, 
\noun on
Leif Albers
\noun default
 und 
\noun on
Hartmut
\noun default
 
\noun on
Haase
\noun default
 (
\noun on
HHa
\noun default
, bis März 2010).
\end_layout

\end_inset


\begin_inset Newline newline
\end_inset


\begin_inset Newline newline
\end_inset

Version 2.0.x
\end_layout

\begin_layout Standard
\begin_inset CommandInset toc
LatexCommand tableofcontents

\end_inset


\end_layout

\begin_layout Chapter
Einleitung
\end_layout

\begin_layout Standard
In diesem Teil der Dokumentation wird beschrieben, welche Möglichkeiten
 LyX bietet, um es den eigenen Wünschen anzupassen.
 Es werden Dinge wie Tastaturkürzel, Vorschau am Bildschirm, Optionen zum
 Drucken, das Senden von Befehlen an LyX durch den LyX-Server, Internationalisie
rung, Installation neuer LaTeX-Klassen und LyX-Layouts usw.
\begin_inset space \space{}
\end_inset

behandelt.
 Es kann hier nicht alles beschrieben werden, das an LyX individuell eingestellt
 und verändert werden kann --- die Entwickler fügen Neuerungen schneller
 ein, als wir sie dokumentieren können --- doch werden die grundlegenden
 Fähigkeiten von LyX dokumentiert sowie für einige der etwas obskuren Hinweise
 gegeben.
\end_layout

\begin_layout Standard
Mit der Version 1.1.6 von LyX wurde eine neue Schnittstelle zu den konfigurierbare
n Eigenschaften eingeführt, die Sie über den Menüpunkt 
\family sans
Werkzeuge\SpecialChar \menuseparator
Einstellungen
\family default
\SpecialChar \ldots{}
 aufrufen können.
 Diese macht die weiter unten aufgeführten Erläuterungen zu den Konfigurationsda
teien von LyX nicht überflüssig, aber es vereinfacht doch den Prozess, LyX
 an 
\emph on
Ihre
\emph default
 Bedürfnisse anzupassen.
\end_layout

\begin_layout Chapter
Die Konfigurationsdateien von LyX
\end_layout

\begin_layout Standard
Dieses Kapitel soll Ihnen dabei helfen, sich mit den Konfigurationsdateien
 von LyX vertraut zu machen.
 Bevor Sie jedoch weiterlesen, sollten Sie herausfinden, wo sich das Systemverze
ichnis von LyX auf Ihrem Rechner befindet.
 Sie erfahren dies über den Menüpunkt 
\family sans
Hilfe\SpecialChar \menuseparator
Über
\begin_inset space ~
\end_inset

Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X
\family default
.
 In diesem Verzeichnis speichert LyX alle systemweiten Konfigurationsdateien,
 wir werden es im weiteren 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir
\family default
 nennen.
\end_layout

\begin_layout Section
Was befindet sich in 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir
\family default
?
\end_layout

\begin_layout Standard
Das Verzeichnis 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir
\family default
 sowie seine Unterverzeichnisse enthalten eine Anzahl Dateien, mit denen
 das Verhalten von LyX beeinflusst werden kann.
 Diese Dateien können direkt von LyX aus über den Dialog 
\family sans
Werkzeuge\SpecialChar \menuseparator
Einstellungen
\family default
\SpecialChar \ldots{}
 gelesen und geändert werden.
 Fast alles, was Sie möglicherweise an LyX ändern wollen, können Sie hier
 einstellen.
 Jedoch können auch viele interne Dinge in LyX angepasst werden, indem man
 diverse andere Dateien in 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir
\family default
 verändert.
 Sie sind in verschiedene Kategorien unterteilt, die in den folgenden Unterabsch
nitten behandelt werden.
\end_layout

\begin_layout Subsection
Automatisch erzeugte Dateien
\end_layout

\begin_layout Standard
Diese Dateien werden automatisch bei der Konfiguration von LyX erzeugt.
 Sie enthalten verschiedene Standardwerte, die durch Untersuchung des Systems
 ermittelt werden.
 Normalerweise sollte man sie nicht verändern, da sie jederzeit von LyX
 überschrieben werden können.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
lyxrc.defaults
\family default
\series default
 enthält Standardwerte für diverse Befehle.
 Einstellungen, die Ihnen nicht zusagen, können einfach über 
\family sans
Werkzeuge\SpecialChar \menuseparator
Einstellungen
\family default
\SpecialChar \ldots{}
 verändert werden.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
packages.lst
\family default
\series default
 enthält eine Auf\SpecialChar \textcompwordmark{}
listung aller LaTeX-Pakete, die von LyX erkannt wurden.
 Derzeit wird diese Liste von LyX selber nicht benutzt, jedoch ist die Informati
on, zusammen mit einigem anderen, über den Menüpunkt 
\family sans
Hilfe\SpecialChar \menuseparator
LaTe
\family default

\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset


\family sans
X
\begin_inset space \space{}
\end_inset

Konfiguration
\family default
 zugänglich.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
textclass.lst
\family default
\series default
 ist eine Liste mit den im Verzeichnis 
\family typewriter
layout
\family default
 gefundenen Textklassen, zusammen mit den entsprechenden LaTeX-Dokumentenklassen
 und einer kurzen Beschreibung.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
doc/LaTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XConfig.lyx
\family default
 wird bei der Konfiguration aus der Datei 
\family typewriter
LaTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XConfig.
\begin_inset Newline linebreak
\end_inset

lyx.in
\family default
 erzeugt.
 Jeder Eintrag der Form 
\family typewriter
@chk_bla@
\family default
 wird dabei durch 
\emph on
yes
\emph default
 oder 
\emph on
no
\emph default
 ersetzt, je nachdem, ob das Paket 
\family typewriter
bla
\family default
 gefunden wurde.
\end_layout

\begin_layout Subsection
Verzeichnisse
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
bind/
\family default
\series default
 Dieses Verzeichnis enthält Dateien mit der Endung 
\family typewriter
.bind
\family default
.
 In ihnen werden die Tastenkombinationen festgelegt, mit denen Sie Menüs
 öffnen und Bearbeitungsoperationen direkt starten können.
 Falls eine Datei 
\family typewriter
$LANG_xxx.bind
\family default
 mit einer an die internationalisierte Version von LyX angepassten Tastenbelegun
g existiert, wird diese bevorzugt geladen.
 Näheres dazu finden Sie in Kapitel
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "cha:Internationales-LyX"

\end_inset

.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
clipart/
\family default
\series default
 Hier sind einige PostScript-Bilder gespeichert, die Sie in Ihre Dokumente
 einbinden können.
 
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
doc/
\family default
\series default
 Enthält die Dateien der LyX-Dokumentation (einschließlich der, die Sie
 gerade lesen).
 Eine kleine Ausnahmestellung hat die bereits beschriebene Datei 
\family typewriter
LaTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XConfig.lyx
\family default
.
 Auch hier wird eine übersetzte Version mit dem Vorsatz 
\family typewriter
$LANG_
\family default
 vor dem Dateinamen zuerst gesucht und, falls vorhanden, geladen.
 Siehe dazu Kapitel
\begin_inset space ~
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "cha:Internationales-LyX"

\end_inset

.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
examples/
\family default
\series default
 Enthält Beispieldateien, die erläutern, wie Sie die unterschiedlichen Möglichke
iten von LyX nutzen können.
 Verwenden Sie die Schaltfläche 
\family sans
Beispiele
\family default
 im Dateiauswahlmenü, um in dieses Verzeichnis zu gelangen.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
images/[math/]
\family default
 Enthält Bilddateien, die von der Dialogbox 
\family sans
Aufzählungszeichen
\family default
 im Menü 
\family sans
Do\SpecialChar \-
ku\SpecialChar \-
ment
\family default
\SpecialChar \menuseparator

\family sans
Einstellungen
\family default
 benötigt werden.
 Außerdem finden Sie hier die unterschiedlichen Icons für die Werkzeugleiste
 und das Bild für den Startbildschirm.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
kbd/
\family default
\series default
 Hier sind die Definitionsdateien für die Tastaturbelegung gespeichert.
 Näheres dazu finden Sie im Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Internationale-Tastaturtabellen"

\end_inset

.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
layouts/
\family default
\series default
 Hier werden die in Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand ref
reference "cha:Installieren-neuer-Textklassen"

\end_inset

 beschriebenen Layoutdateien für die unterschiedlichen Dokumentenklassen
 gespeichert.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
lyx2lyx
\family default
/ Enthält Dateien, die für die Konvertierung zwischen verschiedenen LyX
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

"=
\end_layout

\end_inset

Versionen benötigt werden.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
scripts
\family default
/
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
templates
\family default
/ Enthält die Vorlagendateien, die Ihnen bei 
\family sans
Datei\SpecialChar \menuseparator
Neu
\begin_inset space \space{}
\end_inset

von
\begin_inset space \space{}
\end_inset

Vorlage
\family default
 präsentiert werden, siehe Abschnitt
\begin_inset space ~
\end_inset


\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Vorlagen-erstellen"

\end_inset

.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
tex/
\family default
 Einige LyX-spezifische LaTeX-Textklassen- (
\family typewriter
.cls
\family default
) und -Stildateien
\begin_inset Newline linebreak
\end_inset

 (.
\family typewriter
sty
\family default
).
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
ui/
\family default
 Hier finden Sie Dateien mit der Endung 
\family typewriter
.ui
\family default
, die die Benutzerschnitt\SpecialChar \-
stel\SpecialChar \-
le von LyX festlegen, also welche Einträge
 in welchen Menüs sind, und wie die Werkzeugleiste zusammengesetzt ist.
\end_layout

\begin_layout Subsection
Dateien, die Sie nicht verändern sollten
\end_layout

\begin_layout Standard
Die folgenden Dateien werden intern von LyX verwendet.
 Sie sollten im Normalfall nur von den Entwicklern editiert werden.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
CREDITS
\family default
\series default
 Diese Datei enthält eine Liste der Entwickler.
 Ihr Inhalt wird über die Menüauswahl 
\family sans
Hilfe\SpecialChar \menuseparator
Über
\begin_inset space \space{}
\end_inset

Ly
\family default

\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset


\family sans
X
\family default
 angezeigt.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
chkconfig.ltx
\family default
\series default
 ist ein LaTeX-Skript, das bei der Konfiguration verwendet wird.
 Starten Sie es nie direkt.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\series medium
configure
\family default
\series default
 ist das eigentliche Skript, das zur Neukonfiguration von LyX verwendet
 wird.
 Es erzeugt die Konfigurationsdateien in dem Verzeichnis, von dem aus es
 aufgerufen wurde.
\end_layout

\begin_layout Subsection
Andere Dateien
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
encodings
\family default
 Die hier enthaltene Tabelle beschreibt, wie die unterschiedlichen Zeichenkodier
ungen in Unicode dargestellt werden.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
external_templates
\family default
 Diese Datei enthält die Vorlagen für das neue 
\family sans
Externes
\begin_inset space \space{}
\end_inset

Material
\family default
-Modul.
 Siehe dazu Kapitel
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "cha:Externes-Material-einfügen"

\end_inset


\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
languages
\family default
 Eine Liste mit allen derzeit von LyX unterstützten Sprachen.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
lyxrc.example
\family default
 Veraltet.
\end_layout

\begin_layout Section
Das lokale Konfigurationsverzeichnis
\end_layout

\begin_layout Standard
Eventuell benutzen Sie LyX als normaler Benutzer und wollen dennoch einige
 Einstellungen der Konfiguration ändern.
 Zu diesem Zweck gibt es ein benutzereigenes Verzeichnis 
\family typewriter
UserDir
\family default
, in dem Ihre gesamte persönliche Konfiguration gespeichert wird.
 Der Name dieses Verzeichnisses wird als 
\emph on
Benutzerverzeichnis
\emph default
 in 
\family sans
Hilfe\SpecialChar \menuseparator
Über
\begin_inset space \space{}
\end_inset

Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X
\family default
 angezeigt.
 Dieses Verzeichnis wird als Spiegelung des systemweiten Verzeichnisses
 verwendet.
 Das bedeutet, dass jede Datei, die Sie dort speichern, die entsprechende
 Datei im Systemverzeichnis ersetzt.
 Jede der im vorigen Abschnitt beschriebenen Konfigurationsdateien kann
 sich entweder im Systemverzeichnis 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir
\family default
 oder aber in Ihrem privaten Verzeichnis befinden.
 Im ersten Fall gelten die Einstellungen für alle Benutzer, im zweiten Fall
 nur für Sie.
\end_layout

\begin_layout Standard
Dies lässt sich an einigen Beispielen leichter erklären:
\end_layout

\begin_layout Itemize
Um eine LyX Version älter als 1.1.6 umzukonfigurieren, musste der Benutzer
 zunächst die Datei 
\begin_inset Flex URL
status collapsed

\begin_layout Plain Layout

LyXDir/lyxrc.example
\end_layout

\end_inset


\begin_inset Note Note
status collapsed

\begin_layout Plain Layout
HHa: wie bereits im Benutzerhandbuch erwähnt, ist URL eine einfache Möglichkeit,
 um Schreibmaschinenformat umzubrechen.
\end_layout

\end_inset

 nach 
\family typewriter
UserDir/lyxrc
\family default
 kopieren und diese dann manuell editieren.
 Neuere Versionen von LyX lesen diese Datei zwar noch, wenn sie in 
\family typewriter
UserDir
\family default
 gefunden wird, aber alle Änderungen, die über den neuen Dialog 
\family sans
Werkzeuge\SpecialChar \menuseparator
Einstellungen
\family default
\SpecialChar \ldots{}
 gemacht werden, werden in der Datei 
\family typewriter
preferences
\family default
 gespeichert.
 Danach (das heißt wenn 
\family typewriter
preferences
\family default
 gefunden wird) wird die alte 
\family typewriter
lyxrc
\family default
 nicht mehr eingelesen und kann gelöscht werden.
 
\end_layout

\begin_layout Itemize
Wenn Sie mit dem Menüpunkt 
\family sans
Werkzeuge\SpecialChar \menuseparator
Neu
\begin_inset space \space{}
\end_inset

konfigurieren
\family default
 eine Neukonfiguration von LyX durchführen, werden die dabei erzeugten Dateien
 in Ihrem privaten Konfigurationsverzeichnis 
\family typewriter
UserDir
\family default
 gespeichert.
 Das bedeutet, dass ab sofort etwaige neue Dokumentenklassen, die Sie in
 Ihrem Verzeichnis 
\family typewriter
UserDir/layouts
\family default
 gespeichert haben, im Feld 
\family sans
Dokumentklasse
\family default
 des Dialoges 
\family sans
Dokument
\family default
\SpecialChar \menuseparator

\family sans
Einstellungen
\family default
\SpecialChar \ldots{}
 erscheinen.
\end_layout

\begin_layout Itemize
Falls Sie irgendwelche Dateien für neue LaTeX-Dokumentenklassen in einem
 Verzeichnis installiert haben, das LaTeX über die Umgebungsvariable 
\family typewriter
TEX\SpecialChar \-
IN\SpecialChar \-
PUTS
\family default
 findet, können auch diese in LyX verwendet werden.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
vorausgesetzt, es gibt auch eine 
\family typewriter
.layout
\family default
-Datei dafür.
\end_layout

\end_inset


\end_layout

\begin_layout Itemize
Wenn Sie sich von einem LyX-FTP-Server eine aktuellere Version (oder zum
 Beispiel diese deutsche Version) der Dokumentation besorgt haben, sie aber
 nicht 
\emph on
offiziell
\emph default
 installieren können, da Sie keine Systemadministratorrechte haben, können
 Sie diese Dateien einfach nach 
\family typewriter
UserDir/doc
\family default
 kopieren, und sie werden automatisch über das 
\family sans
Hilfe
\family default
-Menü geöffnet.
\end_layout

\begin_layout Section
LyX mit mehreren Konfigurationen
\end_layout

\begin_layout Standard
Die hochgradige Konfigurierbarkeit von LyX durch das lokale Verzeichnis
 wird für diejenigen nicht ausreichend sein, die parallel mehrere unterschiedlic
he Konfigurationen verwenden wollen, zum Beispiel unterschiedliche Tastaturkürze
l und/oder Druckerkonfigurationen.
 Sie können dies durch das Anlegen von mehreren Konfigurationsverzeichnissen
 erreichen und LyX jeweils beim Start mitteilen, welches davon verwendet
 werden soll.
\end_layout

\begin_layout Standard
Indem Sie LyX mit der Option 
\family typewriter
-userdir
\family default
 
\family typewriter
\emph on
<verzeichnis>
\family default
\emph default
 starten, erreichen Sie, dass die Konfiguration aus diesem Verzeichnis anstelle
 des Standardverzeichnisses gelesen wird (das Standardverzeichnis ermitteln
 Sie, indem Sie LyX ohne diese Option starten).
 Falls das so angegebene Verzeichnis noch nicht existiert, fragt LyX genau
 wie beim ersten Start nach, ob es angelegt werden soll.
 Die Konfiguration in diesem Verzeichnis können Sie dann wie im Normalfall
 in LyX verändern, die Einstellungen im Standardverzeichnis werden aber
 nicht verändert -- beide Verzeichnisse sind völlig unabhängig.
 Anstelle der Kommandozeilenoption können Sie übrigens auch die Umgebungsvariabl
e 
\family typewriter
LYX_USERDIR_20x
\family default
 auf das zu verwendende Verzeichnis setzen.
\end_layout

\begin_layout Standard
Unterschiedliche Konfigurationsverzeichnisse bedeuten aber auch zusätzlichen
 Aufwand: Wenn Sie etwa eine neue Layoutdatei in 
\family typewriter
UserDir/layouts
\family default
 hinzufügen und diese für alle Konfigurationen sichtbar sein soll, müssen
 Sie sie in 
\emph on
allen
\emph default
 Verzeichnissen separat hinzufügen.
 Sie können das jedoch mit einem Trick umgehen: Nachdem LyX das neue UserDir
 angelegt hat, sind praktisch alle Unterverzeichnisse (siehe oben) leer.
 Sie können also all diese Verzeichnis durch einen symbolischen Link auf
 das entsprechende Verzeichnis im originalen 
\family typewriter
UserDir
\family default
 ersetzen.
 Lediglich mit dem Verzeichnis 
\family typewriter
doc
\family default
 müssen Sie vorsichtig sein, denn dort wird eine Datei durch das Konfigurationss
kript (
\family sans
Werkzeuge\SpecialChar \menuseparator
Neu
\begin_inset space \space{}
\end_inset

konfigurieren
\family default
) abgelegt, die konfigurationsabhängig ist.
\end_layout

\begin_layout Chapter
Der Dialog Werkzeuge
\family sans
\SpecialChar \menuseparator

\family default
Ei
\family sans
nstellungen
\end_layout

\begin_layout Section
Formate
\begin_inset CommandInset label
LatexCommand label
name "Formate"

\end_inset


\end_layout

\begin_layout Standard
Als ersten Schritt müssen Sie Ihre Dateiformate definieren, wenn das nicht
 bereits passiert ist.
 Dazu öffnen Sie 
\family sans
Werkzeuge\SpecialChar \menuseparator
Einstellungen\SpecialChar \menuseparator
Datei-Handhabung\SpecialChar \menuseparator
Dateiformate
\family default
 und klicken auf 
\family sans
Neu
\family default
.
 Das 
\family sans
Format
\family default
-Feld enthält den Namen, unter dem das Format im GUI identifiziert wird.
 Im Feld 
\family sans
Einsortieren
\begin_inset space \space{}
\end_inset

als
\family default
 steht der Name, mit dem das Format intern identifiziert wird.
 Außerdem muss eine 
\family sans
Dateiendung
\family default
 festgelegt werden.
 Diese drei Felder sind erforderlich.
 Zusätzlich kann ein 
\family sans
Tastenkürzel
\family default
 definiert werden.
 Zum Beispiel bedeutet 
\family sans
Strg+D
\family default
: 
\family sans
Ansicht\SpecialChar \menuseparator
DVI
\family default
.
\end_layout

\begin_layout Standard
Ein Format kann ein 
\family sans
Bearbeitungsprogramm
\family default
 und ein 
\family sans
Anzeigeprogramm
\family default
 haben.
 Am Beispiel von JPEG-Dateien steht bei mir in beiden Feldern 
\family sans
gimp
\family default
.
 Was bei Ihnen steht, hängt von der Software-Ausstattung Ihres PCs ab.
 Zum Definieren des Befehls können auch die vier Variablen aus dem nächsten
 Abschnitt benutzt werden.
 Das 
\family sans
Bearbeitungsprogramm
\family default
 wird aufgerufen, wenn Sie nach einem Rechtsklick auf ein Bild 
\family sans
Datei
\begin_inset space \space{}
\end_inset

extern
\begin_inset space \space{}
\end_inset

bearbeiten
\family default
 auswählen.
 
\end_layout

\begin_layout Standard
Wenn 
\family sans
Dokumentformat
\family default
 angekreuzt ist, weiß LyX, dass das Format für den Dokumentexport geeignet
 ist.
 Wenn dann auch noch ein geeigneter Konverter existiert (siehe Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "Konverter"

\end_inset

), wird das Format unter 
\family sans
Datei\SpecialChar \menuseparator
Exportieren
\family default
 erscheinen.
 Außerdem wird es im 
\family sans
Ansicht
\family default
-Menü erscheinen, wenn ein 
\family sans
Anzeigeprogramm
\family default
 angegeben wurde.
 Reine Grafikformate wie 
\family typewriter
png
\family default
 sollten diese Option nicht benutzen, dagegen aber Formate, die sowohl Vektorgra
fiken als auch Dokumente repräsentieren wie 
\family typewriter
pdf
\family default
.
\end_layout

\begin_layout Standard
Die Option 
\family sans
Vektorgrafik-Format
\family default
 sagt LyX, dass ein Format Vektorgrafiken ent\SpecialChar \-
halten kann.
 Diese Information wird dazu benutzt, um ein Zielformat für eingefügte Grafiken
 für den 
\family typewriter
pdflatex
\family default
-Export zu bestimmen.
 Eingefügte Grafiken müs\SpecialChar \-
sen nach 
\family typewriter
pdf
\family default
, 
\family typewriter
png
\family default
 oder 
\family typewriter
jpg
\family default
 konvertiert werden, weil 
\family typewriter
pdflatex
\family default
 keine anderen Grafikformate handhaben kann.
 Hat eine eingefügte Grafik bereits eines der Formate, wird sie nach pdf
 konvertiert, wenn 
\family sans
Vektorgrafik-Format
\family default
 angekreuzt ist, sonst nach 
\family typewriter
png
\family default
.
\end_layout

\begin_layout Section
Kopierer
\end_layout

\begin_layout Standard
Weil alle Konvertierungen im temporären Verzeichnis von LyX stattfinden,
 muss eine Datei manchmal geändert werden bevor sie ins temporäre Verzeichnis
 kopiert wird, damit die Konvertierung durchgeführt werden kann.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Wenn die Datei beispielsweise auf andere Dateien mit relativen Pfaden verweist
 -- vielleicht Bilder -- und diese Pfade beim Kopieren ungültig werden.
\end_layout

\end_inset

 Das macht ein Kopierer: er kopiert eine Datei ins (oder vom) temporären
 Verzeichnis und ändert sie dabei.
\end_layout

\begin_layout Standard
Die Definitionen der Kopierer können vier Variablen benutzen:
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$s
\family default
 ist das Systemverzeichnis von LyX (zum Beispiel 
\family typewriter
/usr/local/bin/
\begin_inset Newline linebreak
\end_inset

lyx
\family default
).
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$i
\family default
 ist die Eingabedatei.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$o
\family default
 ist die Ausgabedatei.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$l
\family default
 ist der 
\emph on
LaTeX-Name
\emph default
.
 Dies sollte der Dateiname sein, den LaTeX im 
\family typewriter

\backslash
include
\family default
-Befehl benutzt.
 Er ist nur dann relevant, wenn die expor\SpecialChar \-
tier\SpecialChar \-
ten Dateien für den Befehl
 geeignet sind.
\end_layout

\begin_layout Standard
Kopierer können benutzt werden, um 
\emph on
fast
\emph default
 alles mit Ausgabedateien zu machen.
 Wenn Sie zum Beispiel 
\family typewriter
pdf
\family default
-Dateien in ein spezielles Verzeichnis kopieren wollen, können Sie ein Shell-Skr
ipt wie folgt schreiben:
\end_layout

\begin_layout LyX-Code
#!/bin/bash
\end_layout

\begin_layout LyX-Code
FROMFILE=$1
\end_layout

\begin_layout LyX-Code
TOFILE=`basename $2`
\end_layout

\begin_layout LyX-Code
cp $FROMFILE /home/you/pdf/$TOFILE
\end_layout

\begin_layout Standard
Speichern Sie das Skript ausführbar in Ihrem lokalen LyX-Verzeichnis --
 etwa 
\family typewriter
/home/you/lyx/scripts/pdfkopierer.sh
\family default
.
 Dann wählen Sie in 
\family sans
Werkzeuge\SpecialChar \menuseparator
Ein\SpecialChar \-
stel\SpecialChar \-
lun\SpecialChar \-
gen\SpecialChar \menuseparator
Datei-Handhabung\SpecialChar \menuseparator
Dateiformate
\family default
 das Format 
\family sans
PDF
\begin_inset space \space{}
\end_inset

(pdflatex)
\family default
 und tragen im Kopierer-Feld 
\family typewriter
pdfkopierer.sh $$i $$o
\family default
 ein.
\end_layout

\begin_layout Standard
Kopierer werden von LyX in vielen eigenen Konvertierungen benutzt.
 Wenn auf dem PC geeignete Programme installiert sind, wird LyX automatisch
 Kopierer für 
\family sans
HTML
\family default
 und 
\family sans
HTML
\begin_inset space \space{}
\end_inset

(MS
\begin_inset space \space{}
\end_inset

Word)
\family default
 installieren.
 Wenn diese Formate exportiert werden, 
\emph on
sieht
\emph default
 der Kopierer, dass nicht nur die Haupt-HTML-Datei, sondern auch verschiedene
 zugehörige Dateien (Stildateien, Bilder usw.) kopiert werden müssen.
 All diese Dateien werden in ein Unterverzeichnis des Verzeichnisses geschrieben
, in dem die LyX-Datei steht.
\begin_inset Foot
status open

\begin_layout Plain Layout
Kopierer können angepasst werden.
 Der optionale Parameter 
\family typewriter
-e
\family default
 kann eine durch Kommata getrennte Liste von Erweiterungen enthalten, die
 mitkopiert werden sollen.
 Wenn es fehlt, werden alle Dateien kopiert.
 Der Parameter 
\family typewriter
-t
\family default
 bestimmt die Namenserweiterung, die an den erzeugten Verzeichnisnamen angehängt
 werden soll.
 Standardmäßig ist es 
\family sans
Ly
\begin_inset ERT
status open

\begin_layout Plain Layout

{}
\end_layout

\end_inset

Xconv
\family default
, so dass die aus 
\family typewriter
Datei.lyx
\family default
 erzeugte HTML-Datei im Unterverzeichnis 
\family typewriter
Datei.html.Ly
\begin_inset ERT
status open

\begin_layout Plain Layout

{}
\end_layout

\end_inset

Xconv
\family default
 landet.
\end_layout

\end_inset


\end_layout

\begin_layout Section
Konverter
\begin_inset CommandInset label
LatexCommand label
name "Konverter"

\end_inset


\end_layout

\begin_layout Standard
Sie können eigene Konverter in 
\family sans
Werkzeuge\SpecialChar \menuseparator
Ein\SpecialChar \-
stel\SpecialChar \-
lun\SpecialChar \-
gen\SpecialChar \menuseparator
Datei-Handhabung\SpecialChar \menuseparator
Kon\SpecialChar \-
verter
\family default
 definieren.
 Dazu wählen aus 
\family sans
Von
\begin_inset space \space{}
\end_inset

Format
\family default
 und 
\family sans
In
\begin_inset space \space{}
\end_inset

Format
\family default
 jeweils eins aus, schreiben den benötigten Befehl ins Feld 
\family sans
Konverter
\family default
 und klicken auf 
\family sans
Hinzufügen
\family default
 rechts oben.
 Sie können im Befehl mehrere Variablen benutzen:
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$s
\family default
 ist das Systemverzeichnis von LyX (zum Beispiel 
\family typewriter
/usr/local/bin/
\begin_inset Newline linebreak
\end_inset

lyx
\family default
).
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$i
\family default
 ist die Eingabedatei.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$o
\family default
 ist die Ausgabedatei.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$b
\family default
 ist der Dateiname ohne Erweiterung (siehe Linux-Befehl 
\family typewriter
basename
\family default
).
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$p
\family default
 ist der Pfad zur Eingabedatei.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
$$r
\family default
 ist der Pfad zur ursprünglichen Eingabedatei.
 Wenn eine Kette von Konvertern aufgerufen wird, weicht er von 
\family typewriter
$$p
\family default
 ab.
\end_layout

\begin_layout Standard
Ins Feld Zusatz-Flag können Sie folgende, durch Kommata getrennte, Flags
 schrei\SpecialChar \-
ben:
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
latex
\family default
 Damit ein besonderer LaTeX-Lauf gestartet, der die LaTeX-Fehlermel\SpecialChar \-
dun\SpecialChar \-
gen
 von LyX verfügbar macht.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
needaux
\family default
 benötigt die LaTeX-Datei 
\family typewriter
xyz.aux
\family default
 zur Konvertierung.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
xml
\family default
 Damit wird die Ausgabe im XML-Format gespeichert.
\end_layout

\begin_layout Standard
Die folgenden Flags sind keine richtigen, weil sie ein Argument der Form
 
\family typewriter
key=value
\family default
 benutzen:
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
parselog
\family default
 Wenn das gesetzt ist, wird der Standardfehler des Konverters in die Datei
 
\family typewriter
infile.out
\family default
 umgeleitet, und das Skript wird so ausgeführt: 
\family typewriter
script
\begin_inset space \space{}
\end_inset

<
\begin_inset space \space{}
\end_inset

infile.out
\begin_inset space \space{}
\end_inset

>
\begin_inset space \space{}
\end_inset

infile.log
\family default
.
 Das Argument kann 
\family typewriter
$$s
\family default
 ent\SpecialChar \-
halten.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
resultdir
\family default
 ist der Name des Verzeichnisses, in dem der Konverter die erzeugten Dateien
 ablegen soll.
 LyX wird das Verzeichnis nicht anlegen und auch nichts hineinkopieren,
 aber dieses Verzeichnis an seinen Bestimmungs\SpecialChar \-
ort kopieren.
 Das Argument darf 
\family typewriter
$$b
\family default
 enthalten, was durch die Basisnamen von Ein- oder Ausgabedatei ersetzt
 wird, wenn das Verzeichnis kopiert wird.
\begin_inset Newline newline
\end_inset

Beachten Sie, das 
\family typewriter
resultdir
\family default
 und 
\family typewriter
usetempdir
\family default
 zusammen keinen Sinn machen.
 Wenn das erste definiert wurde, wird das zweite ignoriert.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
resultfile
\family default
 ist der Name der Ausgabedatei und darf 
\family typewriter
$$b
\family default
 enthalten.
 Er wird nur zusammen mit 
\family typewriter
resultdir
\family default
 benutzt und ist auch da nur optional.
 Wenn er nicht angegeben wird, wird 
\family typewriter
index
\family default
 benutzt.
\end_layout

\begin_layout Standard
Keines dieser Flags wird zur Zeit in einem Konverter benutzt, der zusammen
 mit LyX installiert wird.
\end_layout

\begin_layout Standard
Sie müssen nicht für alle Formate, zwischen denen Sie konvertieren wollen,
 Konverter definieren.
 Zum Beispiel gibt es keinen Konverter von LyX nach PostScript, aber LyX
 wird PostScript exportieren.
 Dies geschieht, indem zunächst eine LaTeX-Datei erzeugt wird -- dafür wird
 auch kein Konverter benötigt --, die dann mit dem Konverter von LyX nach
 DVI in eine DVI-Datei konvertiert wird, die schließlich nach PostScript
 konvertiert wird.
 LyX findet solche Konverter-Ketten automatisch und wird immer die kürzeste
 finden.
\end_layout

\begin_layout Standard
Trotzdem können Sie Mehrfachkonversionen zwischen Dateiformaten definieren.
 Zum Beispiel liefert die Standardkonfiguration von LyX drei Möglichkeiten,
 um von LaTeX nach PDF zu konvertieren:
\end_layout

\begin_layout Enumerate
direkt mit 
\family typewriter
pdflatex
\end_layout

\begin_layout Enumerate
mit 
\family typewriter
ps2pdf
\family default
 über DVI und PostScript
\end_layout

\begin_layout Enumerate
mit 
\family typewriter
dvipdfm
\family default
 über DVI.
\end_layout

\begin_layout Standard
Um andere Ketten zu definieren, müssen Sie andere Ziel-
\emph on
Dateiformate
\emph default
 definieren, wie in Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "Formate"

\end_inset

 beschrieben.
 Zum Beispiel enthält die Standardkonfiguration drei Formate für pdf-Dateien,
 die 
\family sans
pdf
\family default
 für 
\family typewriter
ps2pdf
\family default
, 
\family sans
pdf2
\family default
 für 
\family typewriter
pdflatex
\family default
 und 
\family sans
pdf3
\family default
 für 
\family typewriter
dvipdfm
\family default
 heißen.
\end_layout

\begin_layout Chapter
Internationales LyX
\begin_inset CommandInset label
LatexCommand label
name "cha:Internationales-LyX"

\end_inset


\end_layout

\begin_layout Standard

\emph on
Anmerkung des Übersetzers: Dieses Kapitel behandelt zwei Themenbereiche.
 Einmal wird in
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "sec:Eine-andere-Sprache"

\end_inset

 und
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "sec:Tastaturkürzel-für-andere"

\end_inset

 erklärt, wie man LyX mitteilt, dass man in einer fremdsprachlichen Umgebung
 arbeitet.
 Der überwiegende Rest des Kapitels erläutert, wie man LyX an eine neue
 Sprache anpasst, das heißt wie man es übersetzt.
 Da diese Arbeiten für eine deutsche Umgebung bereits erledigt wurden, dürfte
 dieser Teil des Kapitels für die Leser dieser Übersetzung weitgehend uninteress
ant sein.
 Die letzten beiden Abschnitte, 
\begin_inset CommandInset ref
LatexCommand vref
reference "sec:Internationale-Tastaturbelegung"

\end_inset

 und 
\begin_inset CommandInset ref
LatexCommand vref
reference "sec:Internationale-Tastaturtabellen"

\end_inset

, waren bei der Übersetzung noch nicht ganz up to date.
 (Leif Albers)
\end_layout

\begin_layout Standard
LyX kann mit übersetzten Versionen seiner Benutzerschnittstelle arbeiten.
 Als dieser Text erstellt wurde, waren über den normalen englischen Text
 Anpassungen für 23 Sprachen Bestandteil der LyX-Distribution.
 Die von Ihnen benutze Sprache zeigt Ihnen der Befehl 
\family typewriter
locale
\family default
.
 (Für weitere Informationen über 
\emph on
locale
\emph default
-Definitionen ist die Manpage 
\emph on
locale(5)
\emph default
 ein guter Startpunkt.)
\end_layout

\begin_layout Standard
Bitte beachten Sie, dass diese Übersetzungen zwar funktionieren, aber oft
 ein paar Einschränkungen unterliegen.
 Insbesondere wurde das Design der Popup-Menüs auf den englischen Text zugeschni
tten.
 Das bedeutet, dass der übersetzte Text an einigen Stellen mehr Platz benötigt
 als dort zur Verfügung steht.
 Dies ist natürlich nur ein Darstellungsproblem und schränkt nicht die Funktions
weise von LyX ein.
 Sie werden auch feststellen, dass einige Übersetzungen nicht für alle Menüpunkt
e Tastenkürzel definieren.
 Manchmal stehen einfach nicht genügend freie Buchstaben zur Verfügung,
 manchmal hatte der Übersetzer einfach bisher keine Zeit, sich darum zu
 kümmern.
\end_layout

\begin_layout Standard
Wir werden versuchen, diese Dinge in einer späteren Version zu korrigieren.
\end_layout

\begin_layout Section
Eine andere Sprache für die Schnittstelle auswählen
\begin_inset CommandInset label
LatexCommand label
name "sec:Eine-andere-Sprache"

\end_inset


\end_layout

\begin_layout Standard
Normalerweise erfolgt die gesamte Benutzerführung in der Sprache, die in
 der Umgebungsvariablen 
\family typewriter
LANG
\family default
 gesetzt wurde.
 Um eine andere Sprache auszuwählen, müssen Sie die Umgebungsvariable 
\family typewriter
LANG
\family default
 ändern.
 Benutzen Sie 
\family typewriter
setenv LANG xx
\family default
 in csh-kompatiblen und 
\family typewriter
export LANG=xx
\family default
 in sh-kompatiblen Shells.
 Ersetzen Sie dabei 
\family typewriter
xx
\family default
 durch den Zwei-Buchstaben-Code der Sprache, die Sie verwenden möchten --
 zum Beispiel 
\family typewriter
de
\family default
 für deutsch.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Noch besser wäre es, 
\family typewriter
LANG
\family default
 auf den Wert de_DE zu setzen, da andere Programme (zum Beispiel KDE) nach
 DE suchen, oder sogar den vollständigen Wert de_DE.iso88591
\end_layout

\end_inset


\end_layout

\begin_layout Standard
Normalerweise werden Sie den passenden Befehl in eine der Startdateien einfügen,
 also zum Beispiel in 
\family typewriter
~/.Xsession
\family default
, 
\family typewriter
~/.xinitrc
\family default
 oder 
\family typewriter
~/.bashrc
\family default
, damit die übersetzte Schnittstelle automatisch benutzt wird.
 
\end_layout

\begin_layout Standard
Beachten Sie, dass all dies 
\emph on
nicht
\emph default
 funktioniert, wenn Sie LyX mit der Option 
\family typewriter
--disable\SpecialChar \-
nls
\family default
 kompiliert haben.
\end_layout

\begin_layout Section
Tastaturkürzel für andere Sprachen anpassen
\begin_inset CommandInset label
LatexCommand label
name "sec:Tastaturkürzel-für-andere"

\end_inset


\end_layout

\begin_layout Standard
Ein Hauptgrund für Inkonsistenzen in übersetzten LyX-Versionen ist die Tatsache,
 dass alle Tastaturkürzel für die Menüfunktionen ursprünglich auf den englischen
 Text zugeschnitten wurden.
 Das heißt, unabhängig vom tatsächlichen Menüeintrag wird das Kürzel 
\family sans
Strg+Umschalt+N
\family default
 das Popup 
\family typewriter
new-file-from-template
\begin_inset Foot
status collapsed

\begin_layout Plain Layout

\family typewriter
new-file-from-template
\family default
 ist der LyX-interne Befehl, der das Menü 
\family sans
Datei\SpecialChar \menuseparator
Neu
\begin_inset space ~
\end_inset

von
\begin_inset space ~
\end_inset

Vorlage
\family default
\SpecialChar \ldots{}
 auswählt.
\end_layout

\end_inset


\family default
 öffnen.
\end_layout

\begin_layout Standard
Es ist allerdings einfach, dies zu ändern, da alle Tastenkürzel für die
 Menüfunktionen in einer einzigen Datei definiert werden, in 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir/bind/menus.bind
\family default
.
 Jeder Anwender kann eine eigene Version dieser Datei in sein privates LyX-Verze
ichnis (
\family typewriter
~/.lyx/bind
\family default
) kopieren und verändern.
 Diese wird anstelle der systemweiten Datei eingelesen.
\end_layout

\begin_layout Standard
In diesem privaten Verzeichnis kann man die Definitionen einfach ändern,
 zum Beispiel von 
\family sans
Strg+Umschalt+N
\family default
 nach 
\family sans
Strg+D+V
\family default
 (für 
\family sans
Datei\SpecialChar \menuseparator
Neu
\begin_inset space ~
\end_inset

von
\begin_inset space ~
\end_inset

Vorlage
\family default
\SpecialChar \ldots{}
).
 Für einige Sprachen existieren schon angepasste Versionen 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir/bind/
\series bold
xx
\series default
_me\SpecialChar \-
nus.bind
\family default
 (
\family typewriter
\series bold
xx
\family default
\series default
 bezeichnet den Code der Sprache).
 Diese werden von LyX automatisch benutzt, sofern sie existieren (und Ihre
 
\emph on
locale
\emph default
 auf 
\family typewriter
$LANG=
\series bold
xx
\family default
\series default
 gesetzt wurde).
\end_layout

\begin_layout Standard
Sie müssen darauf achten, dass neue Definitionen nicht mit anderen, vorangehende
n Definitionen kollidieren.
 Beispielsweise würde die oben genannte Definition von 
\family sans
Strg+D+V
\family default
 für Benutzer, die 
\family typewriter
emacs.bind
\family default
 verwenden, eine Fehlermeldung erzeugen, denn in 
\family typewriter
emacs.bind
\family default
 wird 
\family sans
Strg+D
\family default
 bereits als 
\family typewriter
word-delete-forward
\begin_inset Foot
status collapsed

\begin_layout Plain Layout

\family typewriter
word-delete-forward
\family default
 löscht das Wort rechts vom Cursor.
\end_layout

\end_inset


\family default
 definiert.
 
\end_layout

\begin_layout Standard
In LyX Version 1.0 werden die übersetzten Namen der Hauptmenüs (die in den
 
\family typewriter
po
\family default
-Dateien stehen) für den Tastendefinitions-Mechanismus verwendet -- deshalb
 müssen auch in 
\family typewriter
menus.bind
\family default
 die 
\emph on
übersetzten
\emph default
 Menünamen verwendet werden.
\end_layout

\begin_layout Section
LyX übersetzen
\end_layout

\begin_layout Subsection
Die Benutzerschnittstelle übersetzen (Textmeldungen)
\end_layout

\begin_layout Standard
LyX verwendet die GNU-gettext-Bibliothek, um die Internationalisierung der
 Benutzerschnittstelle zu verwalten.
 Um LyX dazu zu bringen, in allen Menüs und Dialog-Boxen Ihre Lieblingssprache
 zu verwenden, müssen Sie eine 
\family typewriter
po
\family default
-Datei für diese Sprache erstellen.
 Anschließend müssen Sie daraus eine 
\family typewriter
mo
\family default
-Datei erzeugen und diese installieren.
 Eine umfassende Anleitung dazu finden Sie in der Dokumentation für GNU
 gettext
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Natürlich nur auf englisch.
 Die Veränderungen, die an der 
\family typewriter
po
\family default
-Datei durchgeführt werden müssen, sind allerdings recht intuitiv.
\end_layout

\end_inset

.
 Kurz gesagt müssen folgende Veränderungen durchgeführt werden (
\family typewriter
\series bold
xx
\family default
\series default
 bezeichnet den Sprachencode der neuen Sprache):
\end_layout

\begin_layout Itemize
Kopieren Sie die Datei 
\family typewriter
lyx.pot
\family default
 in das Verzeichnis der .po-Dateien.
 Benennen Sie anschließend die Datei in 
\family typewriter
\series bold
xx
\series default
.po
\family default
 um.
 (Falls 
\family typewriter
lyx.pot
\family default
 nicht existiert, kann sie mit dem Befehl 
\family typewriter
make
\begin_inset space \space{}
\end_inset

lyx.pot
\family default
 neu erzeugt werden.)
\end_layout

\begin_layout Itemize
Editieren Sie 
\family typewriter
xx.po
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Für diese Aufgabe gibt es spezielle Programme, wie 
\family typewriter
Poedit
\family default
 (für alle Plattformen) oder 
\family typewriter
KBabel
\family default
 (für KDE).
 
\family typewriter
Emacs
\family default
 hat ebenfalls einen Modus, der Sie bei dieser Arbeit unterstützt.
\end_layout

\end_inset


\family default
.
 Für einige Menü- und Widgetfunktionen gibt es Tastenkürzel, die ebenfalls
 übersetzt werden sollten.
 Diese Tasten werden mit '
\family typewriter
|
\family default
' markiert und sollten passend mitübersetzt werden.
 Es gibt ein Prolog-Programm namens 
\family typewriter
scgen.pl
\family default
, das sich im Quellverzeichnis in 
\family typewriter
LYX\SpecialChar \-
SOURCE\SpecialChar \-
DIR/development/tools/
\family default
 befindet.
 Vielleicht hilft es Ihnen bei der Bestimmung der Tastenkürzel.
 Beachten Sie, dass XForms (zumindest die Version 0.86) nur 7-Bit-Zeichen
 als Tastenkürzel verarbeiten kann.
\begin_inset Newline newline
\end_inset

Sie sollten auch das Informationsfeld am Anfang der neuen po-Datei ausfüllen
 (mit Ihrer EMail-Adresse, usw.), damit Sie für andere Leute erreichbar sind,
 die Ihnen Vorschläge oder unterhaltsame Flames schicken möchten.
\end_layout

\begin_layout Itemize
Erzeugen Sie in 
\begin_inset Flex URL
status collapsed

\begin_layout Plain Layout

LYX-SOURCE-DIR/po/lyx.pot
\end_layout

\end_inset

 mit dem Befehl 
\family typewriter
make up\SpecialChar \-
date-gmo
\family default
 die Datei 
\family typewriter
\series bold
xx
\series default
.gmo
\family default
.
\end_layout

\begin_layout Itemize
Installieren Sie die 
\family typewriter
gmo
\family default
-Datei mit dem Befehl 
\family typewriter
su -c 'make install'
\family default
.
\end_layout

\begin_layout Standard
Um eine neue 
\family typewriter
po
\family default
-Datei zu der LyX-
\emph on
Distribution
\emph default
 hinzuzufügen, müssen eine Reihe von Dateien (Konfigurations-Skripts und
 mehr) verändert werden.
 Aber dank der gettext-Bibliothek ist ein Einbinden in den LyX-Quellcode
 für den Anwender unnötig.
\end_layout

\begin_layout Standard
Wenn Sie eine Übersetzung für eine Sprache erstellt haben, die LyX zur Zeit
 noch nicht unterstützt, sollten Sie uns ruhig ein Patch mit Ihrer Datei
 zusenden.
 Wie man ein Patch erstellt, erfahren Sie in der README-Datei im Verzeichnis
 
\family typewriter
LYX-SOURCE-DIR/po/
\family default
.
\end_layout

\begin_layout Subsection
Die Dokumentation übersetzen
\end_layout

\begin_layout Standard

\emph on
[Anmerkung des Übersetzers:
\emph default
 wenn 
\emph on
Sie die Dokumentation übersetzen wollen, benutzen Sie als Vorlage auf jeden
 Fall das englische Original.
 Übersetzungen -- diese eingeschlossen -- sind oft nicht ganz auf dem neuesten
 Stand.
 -LA]
\end_layout

\begin_layout Standard
Auch die Online-Dokumentation (im 
\family sans
Hilfe
\family default
-Menü) kann (und sollte!) übersetzt werden.
 Wenn übersetzte Versionen verfügbar sind
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Derzeit (November 2006) sind praktisch alle Texte bis auf 
\emph on
LaTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X-Konfiguration
\emph default
 ins Deutsche übersetzt.
 Andere Sprachen sind in Arbeit.
 Die Bibliothek an übersetzten Texten wächst ständig.
\end_layout

\end_inset

 und die 
\emph on
locale
\emph default
 entsprechend gesetzt wurde, werden diese automatisch von LyX benutzt.
 Zur Zeit sind Übersetzungen in etwa 20 Sprachen vorhanden.
 LyX sucht nach übersetzten Versionen in 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir/doc/
\series bold
xx
\series default
_DocName.lyx
\family default
, wobei wie immer 
\family typewriter
\series bold
xx
\family default
\series default
 für das entsprechende Sprach\SpecialChar \-
kür\SpecialChar \-
zel steht, das in der Umgebungsvariablen
 
\family typewriter
LANG
\family default
 gesetzt wird.
\end_layout

\begin_layout Standard
Falls solche Dateien nicht existieren, wird die englische Version verwendet.
 Auch die übersetzten Versionen müssen (bis auf das 
\family typewriter
\series bold
xx
\series default
_
\family default
) den gleichen (englischen) Dateinamen (im Beispiel oben 
\family typewriter
DocName
\family default
) tragen wie die englischen Originale.
 Wenn Sie gerne die Dokumentation übersetzen möchten (übrigens ein guter
 Weg, um die Originale Korrektur zu lesen!), hier ein paar Tipps, die Ihnen
 möglicherweise etwas Arbeit ersparen:
\end_layout

\begin_layout Itemize
Werfen Sie einen Blick auf die Seiten des Übersetzungsteams auf der Homepage
 des LyX-Entwickler-Teams: 
\begin_inset Flex URL
status open

\begin_layout Plain Layout

http://www.devel.lyx.org
\end_layout

\end_inset

.
 Dort erfahren Sie, welche Texte bereits in Ihre Sprache übersetzt sind,
 auch sehen Sie, ob jemand (und wenn ja, wer) die Übersetzungsaktivitäten
 koordiniert.
\end_layout

\begin_layout Standard
Wenn Sie dann mit der eigentlichen Übersetzungsarbeit beginnen, sind hier
 einige Tipps, die Ihnen vielleicht helfen, einige Schwierigkeiten zu überwinden
:
\end_layout

\begin_layout Itemize
Machen Sie im Dokumentationsteam mit! Informationen dazu gibt es in 
\family sans
Hilfe\SpecialChar \menuseparator
Einführung
\family default
.
 Dies ist übrigens das erste Dokument, das Sie übersetzen sollten.
\end_layout

\begin_layout Itemize
Machen Sie sich mit den typographischen Konventionen der Sprache vertraut,
 in die Sie übersetzen möchten.
 Typographie ist eine alte Kunst, und in vielen Teilen der Welt wurden verschied
ene Konventionen eingeführt.
 Auch sollten Sie die typographische Terminologie in Ihrem Land lernen.
 Eine eigene Terminologie würde nur die Leser verwirren.
 
\emph on
(Warnung: Typographie macht süchtig!)
\end_layout

\begin_layout Itemize
Legen Sie eine Kopie des Originaldokumentes an.
 Von Zeit zu Zeit wird die Originalversion erneuert.
 Sie können beispielsweise CVSweb auf der LyX-Entwickler-Seite im WWW verwenden
 um zu sehen, was sich verändert hat.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Alternativ können Sie auch lokal eine Kopie des (englischen) Ausgangstextes
 aufbewahren und diese dann mit der neuen Version vergleichen (zum Beispiel
 mit dem Befehl 
\family typewriter
diff
\family default
).
\end_layout

\end_inset

 
\end_layout

\begin_layout Itemize
Wann immer Sie einen Fehler im Originaltext entdecken, korrigieren Sie ihn
 und teilen dem Rest des Dokumentationsteams Ihre Veränderungen mit.
 (Sie haben nicht vergessen, dem Dokumentationsteam beizutreten, oder?)
 
\emph on
Auch die Originaldokumentation ist nicht komplett.
\end_layout

\begin_layout Section
Internationale Tastaturbelegung
\begin_inset CommandInset label
LatexCommand label
name "sec:Internationale-Tastaturbelegung"

\end_inset


\end_layout

\begin_layout Subsection
Eigene Tastaturtabellen definieren: das 
\emph on
Keymap
\emph default
-Dateiformat
\end_layout

\begin_layout Standard
Sehen wir uns einmal die 
\emph on
Keymap
\emph default
-Datei ein wenig näher an.
 Es handelt sich um eine ASCII-Datei, in der folgendes definiert wird:
\end_layout

\begin_layout Itemize
Taste-Taste- oder Taste-String-Transformationen
\end_layout

\begin_layout Itemize

\emph on
Tote
\emph default
 Tasten -- sogenannte 
\emph on
dead keys
\end_layout

\begin_layout Itemize
Ausnahmen für tote Tasten.
\end_layout

\begin_layout Standard
Zur Definition einer Taste-Taste- oder Taste-String-Transformation dient
 folgender Befehl:
\end_layout

\begin_layout Quotation

\family typewriter

\backslash
kmap Taste Ausgabe
\end_layout

\begin_layout Standard
wobei 
\family typewriter
Taste
\family default
 die zu übersetzende Taste bezeichnet und 
\family typewriter
Ausgabe
\family default
 die Taste oder den String, der dafür in das Dokument eingefügt werden soll.
 Eine tote Taste definiert man mit:
\begin_inset space ~
\end_inset


\end_layout

\begin_layout Quotation

\family typewriter

\backslash
kmod
\family default
 
\family typewriter
Taste Tote-Taste
\end_layout

\begin_layout Standard
wobei 
\family typewriter
Taste
\family default
 wieder eine Taste auf der Tastatur bezeichnet und 
\family typewriter
Tote-Taste
\family default
 der Name einer toten Taste ist.
 LyX unterstützt folgende toten Tasten (Abkürzungen in Klammern):
\end_layout

\begin_layout Quotation

\emph on
Name
\begin_inset space \hfill{}
\end_inset

Beispiel
\end_layout

\begin_layout Quotation
acute (acu)
\begin_inset space \hfill{}
\end_inset

áéíóú
\end_layout

\begin_layout Quotation
grave (gra)
\begin_inset space \hfill{}
\end_inset

àèìòù
\end_layout

\begin_layout Quotation
macron (mac)
\begin_inset space \hfill{}
\end_inset

 ō
\end_layout

\begin_layout Quotation
tilde (til)
\begin_inset space \hfill{}
\end_inset

ñÑ
\end_layout

\begin_layout Quotation
underbar (underb)
\begin_inset space \hfill{}
\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
b o
\end_layout

\end_inset


\end_layout

\begin_layout Quotation
cedilla (ced)
\begin_inset space \hfill{}
\end_inset

çÇ
\end_layout

\begin_layout Quotation
underdot (underd)
\begin_inset space \hfill{}
\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
d o
\end_layout

\end_inset


\end_layout

\begin_layout Quotation
circumflex (circu)
\begin_inset space \hfill{}
\end_inset

âêîôû
\end_layout

\begin_layout Quotation
circle (circl)
\begin_inset space \hfill{}
\end_inset

ÅůŮ
\end_layout

\begin_layout Quotation
tie (tie)
\begin_inset space \hfill{}
\end_inset


\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
t oo
\end_layout

\end_inset


\end_layout

\begin_layout Quotation
breve (bre)
\begin_inset space \hfill{}
\end_inset

ă
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
u o
\end_layout

\end_inset


\end_layout

\begin_layout Quotation
caron (car)
\begin_inset space \hfill{}
\end_inset

čšž
\end_layout

\begin_layout Quotation
hungarian umlaut (hug)
\begin_inset space \hfill{}
\end_inset

őű
\end_layout

\begin_layout Quotation
umlaut (uml)
\begin_inset space \hfill{}
\end_inset

äöü
\end_layout

\begin_layout Quotation
dot (dot)
\begin_inset space \hfill{}
\end_inset

ż
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
.s
\end_layout

\end_inset


\end_layout

\begin_layout Standard
Da es auf vielen internationalen Tastaturen Ausnahmen dafür gibt, wie eine
 bestimmte tote Taste das folgende Zeichen verändern soll, können diese
 definiert werden, und zwar mit:
\end_layout

\begin_layout Quotation

\family typewriter

\backslash
kxmod
\family default
 
\family typewriter
Tote-Taste Taste Ausgabe
\end_layout

\begin_layout Standard
Zum Beispiel soll caron-o auf einer slowakischen Tastatur ein circumflex-o
 erzeugen.
 Dies erreicht man mit:
\end_layout

\begin_layout Quotation

\family typewriter

\backslash
kxmod
\family default
 
\family typewriter
caron o "
\backslash
^o"
\end_layout

\begin_layout Standard
Auch müssen für die Buchstaben i und j Ausnahmen definiert werden, um den
 Punkt zu löschen, bevor ein Akzent eingefügt wird.
 Ich werde dies beizeiten ändern, hatte aber bisher noch keine Zeit dazu.
\end_layout

\begin_layout Standard
Ach so, zur Definition der Ausgabe: Der Backslash 
\begin_inset Quotes gld
\end_inset


\family typewriter

\backslash

\family default

\begin_inset Quotes grd
\end_inset

 ist ein Sonderzeichen.
 Um ihn einzugeben, muss man einen doppelten Backslash 
\begin_inset Quotes gld
\end_inset


\family typewriter

\backslash

\backslash

\family default

\begin_inset Quotes grd
\end_inset

 eingeben.
 Auch das Anführungszeichen 
\begin_inset Quotes gld
\end_inset

"
\begin_inset Quotes grd
\end_inset

 und das Doppelkreuz 
\begin_inset Quotes gld
\end_inset


\family typewriter
#
\family default

\begin_inset Quotes grd
\end_inset

 haben eine andere Bedeutung.
 
\family typewriter
#
\family default
 bezeichnet einen Kommentar, Anführungszeichen markieren den Anfang und
 das Ende eines Strings (das heißt einer LaTeX-Befehlssequenz).
 Um diese Zeichen einzugeben, muss ein Backslash vorangestellt werden (also:
 
\family typewriter

\backslash
"
\family default
 und 
\family typewriter

\backslash
#
\family default
).
 Wenn Sie eine funktionierende Keymap-Datei für eine neue Sprache angefertigt
 haben, mailen Sie diese bitte an das Entwickler-Team, damit sie in die
 nächste Distribution integriert werden kann.
\end_layout

\begin_layout Standard
In Zukunft werden auch noch folgende Befehle unterstützt:
\end_layout

\begin_layout Itemize

\family typewriter

\backslash
kinclude Dateiname
\family default
\emph on

\begin_inset space \hfill{}
\end_inset


\emph default
bindet eine andere Datei ein 
\end_layout

\begin_layout Itemize

\family typewriter

\backslash
kprog
\family default
 
\family typewriter
Programm
\family default
\emph on

\begin_inset space \hfill{}
\end_inset


\emph default
 definiert ein externes Keymap-Programm 
\end_layout

\begin_layout Standard
Auch sollte es die 
\family typewriter
lyxrc-D
\family default
atei nach Voreinstellungen durchsuchen (zum Beispiel nach einer Option 
\family typewriter

\backslash
kinclude
\family default
, um eine Standardtastatur zu verwenden).
\end_layout

\begin_layout Section
Internationale Tastaturtabellen: 
\emph on
Keymaps
\emph default

\begin_inset CommandInset label
LatexCommand label
name "sec:Internationale-Tastaturtabellen"

\end_inset


\end_layout

\begin_layout Standard
Die nächsten beiden Abschnitte beschreiben detailliert die Syntax der 
\family typewriter
.kmap
\family default
- und 
\family typewriter
.cdef
\family default
-Dateien.
 Diese Abschnitte sollten Ihnen dabei helfen, Ihre eigene Tastaturtabelle
 zu entwerfen, wenn die vorhandenen nicht ganz Ihren Bedürfnissen entsprechen.
\end_layout

\begin_layout Subsection
Die 
\family typewriter
.kmap
\family default
-Datei
\begin_inset CommandInset label
LatexCommand label
name "sub:Die-.kmap-Datei"

\end_inset


\end_layout

\begin_layout Standard
Eine 
\family sans
\shape up
.
\family typewriter
kmap
\family default
\shape default
-Datei transformiert gedrückte Tasten zu Buchstaben oder Strings (Zeichenketten)
 -- es definiert ein 
\emph on
keyboard mapping
\emph default
.
 Im Folgenden werden die Schlüsselwörter 
\family typewriter
kmap
\family default
, 
\family typewriter
kmod
\family default
, 
\family typewriter
kxmod
\family default
 und 
\family typewriter
kcomb
\family default
 beschrieben.
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\shape up
kmap
\family default
\shape default
 Transformiere einen Buchstaben zu einem String
\end_layout

\begin_layout LyX-Code

\backslash
kmap 
\family roman
\emph on
Zeichen Ausgabe
\end_layout

\begin_layout Standard
Dieser Ausdruck definiert, dass 
\emph on
Zeichen
\emph default
 zu 
\emph on
Ausgabe
\emph default
 transformiert werden soll.
 Dabei müssen in 
\emph on
Ausgabe
\emph default
 die Zeichen Backslash 
\begin_inset Quotes gld
\end_inset


\family typewriter

\backslash

\family default

\begin_inset Quotes grd
\end_inset

 und Anführungszeichen 
\begin_inset Quotes gld
\end_inset


\family typewriter
"
\family default

\begin_inset Quotes grd
\end_inset

 mit einem vorangehenden Backslash versehen werden.
 
\end_layout

\begin_layout Standard
Als Beispiel ein Ausdruck, der das Zeichen 
\begin_inset Quotes gld
\end_inset


\family typewriter
/
\family default

\begin_inset Quotes grd
\end_inset

 ausgibt, wenn die Taste 
\begin_inset Quotes gld
\end_inset


\family typewriter
&
\family default

\begin_inset Quotes grd
\end_inset

 gedrückt wurde:
\end_layout

\begin_layout LyX-Code

\backslash
kmap & /
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
\shape up
kmod
\family default
\shape default
 Spezifiziere ein Akzentzeichen 
\end_layout

\begin_layout LyX-Code

\backslash
kmod 
\family roman
\emph on
Zeichen Akzent erlaubt
\end_layout

\begin_layout Standard
Dieser Ausdruck wird dafür sorgen, dass 
\emph on
Zeichen
\emph default
 als ein bestimmter 
\emph on
Akzent
\emph default
 interpretiert wird, und zwar bei allen Zeichen, die in 
\emph on
erlaubt
\emph default
 aufgeführt sind.
 Dies ist der Mechanismus toter Tasten 
\emph on
(dead keys).
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Der Ausdruck 
\emph on
tote
\emph default
 
\emph on
Taste
\emph default
 kommt daher, dass diese Taste allein kein Zeichen erzeugt, aber, gefolgt
 von einer anderen Taste, akzentuierte Zeichen erzeugt.
 Zum Beispiel kann auf diese Weise é
\begin_inset Quotes grd
\end_inset

 erzeugt werden.
\end_layout

\end_inset


\emph default
 Wenn Sie die Taste 
\emph on
Zeichen
\emph default
 drücken, gefolgt von einem Zeichen, das 
\emph on
nicht
\emph default
 in 
\emph on
erlaubt
\emph default
 aufgeführt wurde, werden einfach beide Zeichen einzeln ausgegeben.
\end_layout

\begin_layout Standard
Der folgende Ausdruck definiert, dass die Taste 
\begin_inset Quotes gld
\end_inset


\family typewriter
^
\family default

\begin_inset Quotes grd
\end_inset

 der circumflex-Akzent wird, wenn er von einem der Buchstaben a, e, i, o,
 u, A, E, I ,O oder U gefolgt wird:
\end_layout

\begin_layout LyX-Code

\backslash
kmod ^ circumflex aeiouAEIOU
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
kxmod
\family default
 Definiere eine Ausnahme zu einem Akzentzeichen
\end_layout

\begin_layout LyX-Code

\backslash
kxmod  
\family roman
\emph on
Akzent Zeichen Ausgabe
\end_layout

\begin_layout Standard
Dieser Ausdruck definiert eine Ausnahme für die Wirkung, die 
\emph on
Akzent
\emph default
 in Verbin\SpecialChar \-
dung mit 
\emph on
Zeichen
\emph default
 haben soll.
 Dabei muss 
\emph on
Akzent
\emph default
 vorher mit Hilfe einer 
\family typewriter

\backslash
kmod
\family default
-Zeile einer Taste zugewiesen worden sein.
 Wenn Sie die Sequenz 
\emph on
Akzent, Zeichen
\emph default
 drücken, wird 
\emph on
Ausgabe
\emph default
 produziert.
 Falls solch eine Definition 
\emph on
nicht
\emph default
 existiert, und Sie 
\emph on
Akzent, Zeichen
\emph default
 eingeben, erhalten Sie das 
\emph on
Zeichen
\emph default
 -- akzentuiert.
\end_layout

\begin_layout Standard
Der folgende Ausdruck sorgt dafür, dass LaTeX bei einem 
\begin_inset Quotes gld
\end_inset

i
\begin_inset Quotes grd
\end_inset

 mit circumflex den I-Punkt entfernt, bevor das Akzentsymbol eingefügt wird:
\end_layout

\begin_layout LyX-Code

\backslash
kxmod circumflex i "
\backslash

\backslash
^{
\backslash

\backslash
i}"
\end_layout

\begin_layout Labeling
\labelwidthstring 00.00.0000

\family typewriter
kcomb
\family default
 Kombiniere zwei Akzentsymbole
\end_layout

\begin_layout LyX-Code

\backslash
kcomb 
\family roman
\emph on
Akzent1 Akzent2 erlaubt
\end_layout

\begin_layout Standard
Hier wird es ziemlich esoterisch.
 Dieser Ausdruck erlaubt die Kombination der Effekte von 
\emph on
Akzent1
\emph default
 und 
\emph on
Akzent2
\emph default
 (in dieser Reihenfolge!) bei allen 
\emph on
erlaubten
\emph default
 Zei\SpecialChar \-
chen.
 Die Bedeutungen von 
\emph on
Akzent1
\emph default
 und 
\emph on
Akzent2
\emph default
 müssen zuvor mit Hilfe von 
\family typewriter

\backslash
kmod
\family default
 definiert worden sein.
\end_layout

\begin_layout Standard
Folgendes Beispiel aus der Datei 
\family typewriter
greek.kmap
\family default
:
\end_layout

\begin_layout LyX-Code

\backslash
kmod ; acute aeioyvhAEIOYVH 
\end_layout

\begin_layout LyX-Code

\backslash
kmod : umlaut iyIY 
\end_layout

\begin_layout LyX-Code

\backslash
kcomb acute umlaut iyIY
\end_layout

\begin_layout Standard
Diese Zeilen erlauben es, 
\begin_inset Quotes gld
\end_inset


\family typewriter
;:i
\family default

\begin_inset Quotes grd
\end_inset

 einzugeben und auf diese Weise 
\begin_inset Quotes gld
\end_inset


\family typewriter

\backslash
'{
\backslash
"{i}}
\family default

\begin_inset Quotes grd
\end_inset

 zu erzeugen (
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
'{
\backslash
"{i}}
\end_layout

\end_inset

).
 In diesem Fall löscht die Backspace-Taste das letzte gedrückte Zei\SpecialChar \-
chen.
 Wenn Sie also 
\family typewriter
;:
\family default
 
\family sans
Backspace
\family default
 
\family typewriter
i
\family default
 eingeben, erhalten Sie 
\begin_inset Quotes gld
\end_inset


\family typewriter

\backslash
'(i)
\family default

\begin_inset Quotes grd
\end_inset

 (
\begin_inset ERT
status collapsed

\begin_layout Plain Layout


\backslash
'i
\end_layout

\end_inset

).
 
\end_layout

\begin_layout Subsection
Die 
\family typewriter
.cdef
\family default
-Datei
\end_layout

\begin_layout Standard
Nachdem LyX die 
\family typewriter
.kmap
\family default
-Datei verarbeitet hat, erklärt eine 
\family typewriter
.cdef
\family default
-Datei, wie die einzelnen Symbole im gegenwärtigen Zeichensatz dargestellt
 werden sollen.
 Die LyX-Dis\SpecialChar \-
tri\SpecialChar \-
bu\SpecialChar \-
tion enthält wenigstens die Dateien 
\begin_inset Flex URL
status collapsed

\begin_layout Plain Layout

iso8859-1.cdef
\end_layout

\end_inset

 und 
\family typewriter
\shape up
iso8859-
\begin_inset Newline linebreak
\end_inset

2.cdef
\family default
\shape default
.
\end_layout

\begin_layout Standard
Generell besteht eine 
\family typewriter
.
\shape up
cdef
\family default
\shape default
-Datei aus einer Reihe von Deklarationen der folgenden Form:
\end_layout

\begin_layout LyX-Code

\family roman
\emph on
Position_im_Zeichensatz String
\end_layout

\begin_layout Standard
Um beispielsweise dem String (
\emph on
Ausgabe
\emph default
 im vorigen Abschnitt) 
\begin_inset Quotes gld
\end_inset


\family typewriter
'{e}
\family default

\begin_inset Quotes grd
\end_inset

 das ent\SpecialChar \-
spre\SpecialChar \-
chen\SpecialChar \-
de Zeichen im ISO-8859-1 Zeichensatz (233) zuzuweisen, benutzt
 man folgenden Ausdruck:
\end_layout

\begin_layout LyX-Code
233 "
\backslash

\backslash
'{e}"
\end_layout

\begin_layout Standard
Wieder müssen den Zeichen 
\begin_inset Quotes gld
\end_inset


\family typewriter

\backslash

\family default

\begin_inset Quotes grd
\end_inset

 und 
\begin_inset Quotes gld
\end_inset


\family typewriter
"
\family default

\begin_inset Quotes grd
\end_inset

 ein Backslash vorangestellt werden.
 Beachten Sie, dass es durchaus möglich ist, dass dasselbe Zeichen (sinnvoll)
 zwei verschiedene Strings repräsentieren kann.
 Zum Beispiel in 
\family typewriter
i
\shape up
so-8859-7.cdef
\family default
\shape default
 gibt es die Zeilen:
\end_layout

\begin_layout LyX-Code
192 "
\backslash

\backslash
'{
\backslash

\backslash

\backslash
"{i}}"
\begin_inset Newline newline
\end_inset

192 "
\backslash

\backslash

\backslash
"{
\backslash

\backslash
'{i}}"
\end_layout

\begin_layout Standard
Wenn LyX kein passendes Zeichen für einen String finden kann, der durch
 eine Tastensequenz erzeugt wurde, wird es versuchen, falls der String wie
 ein akzentuierter Buchstabe aussieht, auf dem Bildschirm den Buchstaben
 mit Akzent selbst zu zeichnen.
\end_layout

\begin_layout Subsection
Tote Tasten definieren
\end_layout

\begin_layout Standard

\emph on
Anmerkung des Übersetzers: An dieser Stelle weiche ich krass vom Original
 ab.
 Der englische Text ist hier viel zu weitschweifig und ein bisschen konfus.
 -LA
\end_layout

\begin_layout Standard
Es gibt noch eine zweite Möglichkeit, internationale Buchstaben mit Hilfe
 von 
\emph on
toten
\emph default
 
\emph on
Tasten (dead keys)
\emph default
 zu erzeugen -- nämlich direkt in der 
\family typewriter
.bind
\family default
-Datei.
 Dazu ein einfaches Beispiel:
\end_layout

\begin_layout Standard
Nehmen wir an, Sie benötigen eine Zirkumflex-Taste.
 Diese können Sie definieren, indem Sie in der 
\family typewriter
lyxrc-D
\family default
atei folgende Zeile einfügen:
\end_layout

\begin_layout Standard

\family typewriter

\backslash
bind "asciicircum" "accent-circumflex"
\end_layout

\begin_layout Standard
Dabei ist 
\family typewriter
asciicircum
\family default
 die Bezeichnung, die das X11-System für die 
\begin_inset Quotes gld
\end_inset


\family typewriter
^
\family default

\begin_inset Quotes grd
\end_inset

-Taste verwendet.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Die Bezeichnungen anderer Symbole lassen sich ganz gut aus einer c-Include-Datei
 namens 
\family typewriter
keysymdef.h
\family default
 ablesen.
 Meist findet man sie in 
\family typewriter
/usr/X11/include/X11/
\family default
.
\end_layout

\end_inset

 
\family typewriter
accent-circum\SpecialChar \-
flex
\family default
 ist ein LyX-Befehl, der den Zirkumflex-Akzent erzeugt.
\end_layout

\begin_layout Standard
Leider unterscheidet sich die Wirkungsweise der toten Tasten, die in 
\family typewriter
.lyxrc
\family default
 definiert wurden, merklich von der, die in Abschnitt
\begin_inset space ~
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Die-.kmap-Datei"

\end_inset

 beschrieben wurde.
\end_layout

\begin_layout Subsection
Ihre Sprachkonfiguration einstellen
\end_layout

\begin_layout Standard
Sie können Ihre 
\family typewriter
lyxrc-D
\family default
atei so verändern, dass Ihre gewünschte Sprachumgebung automatisch geladen
 wird, wenn LyX gestartet wird.
 Dieser Abschnitt beschreibt Befehle, die folgendes spezifizieren:
\end_layout

\begin_layout Itemize
Standard-, erste und zweite Tastaturbelegung
\end_layout

\begin_layout Itemize
Zeichensatzkodierung
\end_layout

\begin_layout Standard
In Ihrer 
\family typewriter
lyxrc-D
\family default
atei finden Sie verschiedene Beispiele, wie man sie konfigurieren kann.
 Zum Beispiel können Sie einen Eintrag für eine Tastaturbelegung folgendermaßen
 vornehmen:
\end_layout

\begin_layout LyX-Code

\backslash
bind "american" "keymap-primary"
\end_layout

\begin_layout Standard
eine tote Taste 
\emph on
(dead key)
\emph default
 definieren:
\end_layout

\begin_layout LyX-Code

\backslash
bind "Alt+,"  "accent-cedilla"
\end_layout

\begin_layout Standard
oder eine Zeichensatzkodierung festlegen:
\end_layout

\begin_layout LyX-Code
# Die Norm für die Bildschirmzeichensätze 
\end_layout

\begin_layout LyX-Code
# Voreinstellung ist iso8859-1.
\end_layout

\begin_layout LyX-Code

\backslash
font_norm iso8859-2
\end_layout

\begin_layout Chapter
Installieren neuer Textklassen, Layouts und Vorlagen
\begin_inset CommandInset label
LatexCommand label
name "cha:Installieren-neuer-Textklassen"

\end_inset


\end_layout

\begin_layout Standard
In diesem Abschnitt wird beschrieben, wie Sie beim Installieren neuer Layout-
 und Vorlagedateien vorgehen müssen, außerdem auch eine kleine Auf\SpecialChar \textcompwordmark{}
frischung,
 wie man neue Dokumentenklassen für LaTeX korrekt installiert.
 Zunächst ein paar Definitionen:
\end_layout

\begin_layout Standard
Eine 
\emph on
Dokumentenklasse
\emph default
 ist eine LaTeX-Datei (normalerweise mit der Endung 
\family typewriter
.cls
\family default
 oder 
\family typewriter
.sty
\family default
), die das Format einer speziellen Art von Dokument beschreibt, etwa Artikel,
 Brief usw., und auch alle dazu notwendigen Befehle definiert.
\end_layout

\begin_layout Standard
Eine 
\emph on
Layout-Datei
\emph default
 ist eine LyX-Datei, die einer LaTeX-Dokumentenklasse ent\SpecialChar \-
spricht und LyX
 mitteilt, wie die diversen Formatelemente am Bildschirm dar\SpecialChar \-
ge\SpecialChar \-
stellt werden
 sollen, damit der Eindruck möglichst gut dem späteren Druckbild entspricht.
 Genauer gesagt beschreibt eine Layoutdatei eine 
\emph on
Textklasse
\emph default
, das interne Konstrukt, welches LyX verwendet, um den Text am Bildschirm
 darzustellen.
\end_layout

\begin_layout Standard

\emph on
Layout
\emph default
 und 
\emph on
Textklasse
\emph default
 sind somit in gewisser Weise äquivalent, aber es ist besser, die Datei
 als Layout zu bezeichnen und die interne Realisation im Speicher von LyX
 als Textklasse.
 Eine Vorlage ist einfach ein LyX-Dokument, welches bereits einige vordefinierte
 Einträge für eine bestimmte Textklasse enthält.
 Derartige Vorlagen sind beispielsweise für Briefe oder Artikel für Zeitschrifte
n sehr hilfreich.
\end_layout

\begin_layout Section
Installation eines neuen LaTeX-Paketes
\end_layout

\begin_layout Standard
Bei manchen TeX-Installationen fehlt möglicherweise das eine oder andere
 Paket, das Sie gerne mit LyX verwenden würden.
 Zum Beispiel wollen Sie FoilTeX verwenden, ein Paket zur Erstellung von
 Dias und Folien für Overheadprojektoren.
 Moderne LaTeX-Distributionen wie TeXLive (2008 oder neuer) oder MiKTeX
 besitzen ein grafisches Programm um solche Pakete zu installieren.
 Z.
\begin_inset space \thinspace{}
\end_inset

B.
 bei MiKTeX starten Sie das Programm 
\begin_inset Quotes gld
\end_inset

Package
\begin_inset space ~
\end_inset

Manager
\begin_inset Quotes grd
\end_inset

 um eine Liste mit den verfügbaren Paketen zu bekommen.
 Um eines davon zu installieren, rechts-klicken Sie oder benutzen den entspreche
nden Werkzeugleistenknopf.
\end_layout

\begin_layout Standard
Falls Ihre LaTeX-Distribution keinen Paketmanager besitzt, oder falls das
 Paket nicht direkt über Ihre Distribution verfügbar ist, folgen Sie diesen
 Schritten um es manuell zu installieren:
\end_layout

\begin_layout Enumerate
Besorgen Sie sich das Paket von 
\begin_inset CommandInset href
LatexCommand href
name "CTAN"
target "http://www.ctan.org/"

\end_inset

 oder einer anderen Quelle.
\end_layout

\begin_layout Enumerate
Falls das Paket eine Datei mit der Endung 
\begin_inset Quotes gld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
.ins
\end_layout

\end_inset


\begin_inset Quotes grd
\end_inset

 enthält (was bei FoilTeX der Fall ist), dann öffnen sie eine Kommandozeile
 wechseln in das Verzeichnis der Datei und führen den Befehl
\begin_inset Newline newline
\end_inset


\family sans
latex foiltex.ins
\family default

\begin_inset Newline newline
\end_inset

aus.
 Sie haben damit dass Paket entpackt und haben alle Dateien um es zu installiere
n.
 Die meisten LaTeX-Pakete sind nicht gepackt und man kann direkt mit der
 Installation beginnen:
\end_layout

\begin_layout Enumerate
Nun müssen Sie entscheiden, ob das Paket für alle Nutzer oder nur für Sie
 verfügbar sein soll.
\end_layout

\begin_deeper
\begin_layout Enumerate
Bei *nix Systemen (Linux, OSX, etc.), wenn Sie das Paket für alle Nutzer
 installieren möchten, installieren Sie es in den lokalen TeX Ordner; anderenfal
ls installieren Sie es in dein eigenen 
\begin_inset Quotes gld
\end_inset

Benutzer
\begin_inset Quotes grd
\end_inset

-TeX Ordner.
 Wo man diese Ordner anlegt, sofern sie nicht schon existieren, hängt von
 Ihrem System ab.
 Dazu schauen Sie in die Datei 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
texmf.cnf
\end_layout

\end_inset

.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Diese befindet sich normalerweise im Ordner 
\family sans
$TEXMF/web2c
\family default
.
 Falls nicht, führen Sie den Befehl 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
kpsewhich texmf.cnf
\end_layout

\end_inset

 aus, um sie zu lokalisieren.
\end_layout

\end_inset

 Der Ort des lokalen TeX Ordners ist in der Variable 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
TEXMFLOCAL
\end_layout

\end_inset

 definiert; es ist üblicherweise der Pfad 
\family sans
/usr/local/share/texmf/
\family default
 .
 Der Ort des Benutzer-TeX Ordners ist in der Variable 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
TEXMFHOME
\end_layout

\end_inset

 definiert und ist üblicherweise der Pfad 
\family sans
$HOME/texmf/
\family default
 .
 (Wenn diese Variablen nicht vordefiniert sind, müssen Sie diese selbst
 definieren.) Sie brauchen wahrscheinlich Root-Rechte um in den lokalen TeX
 Ordner zu schreiben, beim Benutzer-TeX Ordner ist die nicht nötig.
\begin_inset Newline newline
\end_inset

Allgemein empfiehlt es sich, Pakete in den Benutzer-TeX Ordner zu installieren,
 da dieser nicht verändert oder gar überschrieben wird, wenn Sie ihr System
 aktualisieren.
 Des Weiteren wird er zusammen mit Ihren Nutzerdaten gesichert, wenn Sie
 ein Backup machen (was Sie natürlich regelmäßig tun).
\end_layout

\begin_layout Enumerate
Bei Windows, wenn Sie das Paket für alle Nutzer installieren möchten, gehen
 Sie in den Ordner, in dem LaTeX installiert ist und wechseln dort in das
 Verzeichnis 
\family sans
~tex
\backslash
latex
\family default
.
 (Verwendet man MiKTeX, wäre es standardmäßig der Ordner 
\family sans
~:
\backslash
Programme
\backslash
MiKTeX
\backslash
tex
\backslash
latex
\family default
 .) Legen Sie dort einen neuen Ordner mit dem Namen 
\begin_inset Quotes gld
\end_inset

foiltex
\begin_inset Quotes grd
\end_inset

 an und kopieren Sie alle Dateien das Pakets hinein.
 Wenn das Paket nur für den aktuellen Benutzer verfügbar sein soll bzw.
 Sie keine Administrator-Rechte haben, tun Sie dasselbe, aber im lokalen
 LaTeX-Ordner.
 Z.
\begin_inset space \thinspace{}
\end_inset

B.
 bei MiKTeX
\begin_inset space ~
\end_inset

2.8 wäre das unter WinXP der Ordner
\begin_inset Newline newline
\end_inset


\family sans
~:
\backslash
Dokumente und Einstellungen
\backslash
<Benutzername>
\backslash
Anwendungsdaten
\backslash

\begin_inset Newline newline
\end_inset


\begin_inset Phantom HPhantom
status open

\begin_layout Plain Layout

\family sans
~:
\backslash

\end_layout

\end_inset

MiKTeX
\backslash
2.8
\backslash
tex
\backslash
latex
\family default

\begin_inset Newline newline
\end_inset

, unter WinVista wäre es der Ordner
\begin_inset Newline newline
\end_inset


\family sans
~:
\backslash
Users
\backslash
<Benutzername>
\backslash
AppData
\backslash
Roaming
\backslash
2.8
\backslash
MiKTeX
\backslash
tex
\backslash
latex
\family default
 .
\end_layout

\end_deeper
\begin_layout Enumerate
Jetzt muss man LaTeX nur noch mitteilen, dass es neue Dateien gibt.
 Die ist je nach LaTeX-Distribution anders:
\end_layout

\begin_deeper
\begin_layout Enumerate
Bei TeXLive führen Sie von einer Kommandozeile den Befehl 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
texhash
\end_layout

\end_inset

 aus.
 Wenn Sie das Paket für alle Nutzer installiert haben, brauchen sie dazu
 wahrscheinlich Root-Rechte.
\end_layout

\begin_layout Enumerate
Bei MiKTeX, wenn Sie das Paket für alle Nutzer installiert haben, starten
 Sie das Programm 
\begin_inset Quotes gld
\end_inset

Settings
\begin_inset space ~
\end_inset

(Admin)
\begin_inset Quotes grd
\end_inset

 und drücken dann auf den Kopf 
\begin_inset Quotes gld
\end_inset

Refresh FNDB
\begin_inset Quotes grd
\end_inset

.
 Anderenfalls starten Sie das Programm 
\begin_inset Quotes gld
\end_inset

Settings
\begin_inset Quotes grd
\end_inset

 und machen dasselbe.
\end_layout

\end_deeper
\begin_layout Enumerate
Nun muss man LyX noch mitteilen, dass es neue Pakete gibt.
 Verwenden Sie dazu in LyX das Menü 
\family sans
Werkzeuge\SpecialChar \menuseparator
Neu
\begin_inset space \space{}
\end_inset

konfigurieren
\family default
 und starten LyX danach neu.
\end_layout

\begin_layout Standard
Nun ist das Paket installiert.
 In unserem Beispiel wird nun die Dokumentklasse 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Slides
\begin_inset space ~
\end_inset

(FoilTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

x)
\end_layout

\end_inset

 im Menü 
\family sans
Dokument\SpecialChar \menuseparator
Einstellungen\SpecialChar \menuseparator
Dokumentklasse
\family default
 verfügbar sein.
\end_layout

\begin_layout Standard
Möchten sie eine LaTeX-Dokumentklasse verwenden, die generell nicht im Menü
 
\family sans
Dokument\SpecialChar \menuseparator
Einstellungen\SpecialChar \menuseparator
Dokumentklasse
\family default
 gelistet ist, müssen Sie dafür selbst ein 
\begin_inset Quotes gld
\end_inset

Layout
\begin_inset Quotes grd
\end_inset

 erstellen.
 Dies ist das Thema des nächsten Abschnitts.
\end_layout

\begin_layout Section
Layout-Dateitypen
\end_layout

\begin_layout Standard

\lang english
This section describes the various sorts of LyX files that contain layout
 information.
 These files describe various paragraph and character styles, determining
 how LyX should display them and how they should be translated into LaTeX,
 DocBook, XHTML, or whatever output format is being used.
 
\end_layout

\begin_layout Standard

\lang english
We shall try to provide a thorough description of the process of writing
 layout files here.
 However, there are so many different types of documents supported even
 by just LaTeX that we can't hope to cover every different possibility or
 problem you might encounter.
 The LyX users' list is frequented by people with lots of experience with
 layout design who are willing to share what they've learned, so please
 feel free to ask questions there.
\end_layout

\begin_layout Standard

\lang english
As you prepare to write a new layout, it is extremely helpful to look at
 the layouts distributed with LyX.
 If you write a LyX layout for a LaTeX document class that might also be
 used by others, or write a module that might be useful to others, then
 you should consider posting your layout to the 
\begin_inset CommandInset href
LatexCommand href
name "layout section on the LyX wiki"
target "http://wiki.lyx.org/Layouts/Layouts"

\end_inset

 or even to the LyX developers' list, so that it might be included in LyX
 itself.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout

\lang english
Note that LyX is licensed under the General Public License, so any material
 that is contributed to LyX must be similarly licensed.
\end_layout

\end_inset


\end_layout

\begin_layout Subsection
Layout Module
\begin_inset CommandInset label
LatexCommand label
name "sub:Layout-Module"

\end_inset


\end_layout

\begin_layout Standard

\lang english
We have spoken to this point about `layout files'.
 But there are different sorts of files that contain layout information.
 Layout files, strictly so called, have the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
.layout
\end_layout

\end_inset

 extension and provide LyX with information about document classes.
 As of LyX 1.6, however, layout information can also be contained in layout
 
\emph on
modules
\emph default
, which have the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
.module
\end_layout

\end_inset

 extension.
 Modules are to LaTeX packages much as layouts are to LaTeX classes, and
 some modules—such as the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
endnotes
\end_layout

\end_inset

 module—specifically provide support for one package.
 In a sense, layout modules are similar to included
\begin_inset Foot
status collapsed

\begin_layout Plain Layout

\lang english
These can have any extension, but by convention have the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
.inc
\end_layout

\end_inset

 extension.
\end_layout

\end_inset

 files—files like 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
stdsections.inc
\end_layout

\end_inset

—in that modules are not specific to a given document class but may be used
 with many different classes.
 The difference is that using an included file with 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
article.cls
\end_layout

\end_inset

 requires editing that file.
 Modules, by contrast, are selected in the 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
Document\SpecialChar \menuseparator
Settings
\end_layout

\end_inset

 dialog.
\end_layout

\begin_layout Standard

\lang english
Building modules is the easiest way to get started with layout editing,
 since it can be as simple as adding a single new paragraph style or flex
 inset.
 But modules may, in principle, contain anything a layout file can contain.
\end_layout

\begin_layout Standard

\lang english
After creating a new module and copying it to the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
layouts/
\end_layout

\end_inset

 folder, you will need to reconfigure and then restart LyX for the module
 to appear in the menu.
 However, changes you make to the module will be seen immediately, if you
 open 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
Document\SpecialChar \menuseparator
Settings
\end_layout

\end_inset

, highlight something, and then hit 
\begin_inset Quotes eld
\end_inset

OK
\begin_inset Quotes erd
\end_inset

.
 
\emph on
It is strongly recommended that you save your work before doing this
\emph default
.
 In fact, 
\emph on
it is strongly recommended that you not attempt to edit modules while simultaneo
usly working on actual documents
\emph default
.
 Though of course the developers strive to keep LyX stable in such situations,
 syntax errors and the like in your module file could cause strange behavior.
\end_layout

\begin_layout Subsubsection
Lokales Format
\end_layout

\begin_layout Standard

\lang english
Modules are to LyX as packages are to LaTeX.
 Sometimes, however, you find yourself wanting a specific inset or character
 style just for one document and writing a module that will also be available
 to other documents makes little sense.
 What you need is LyX's 
\begin_inset Quotes eld
\end_inset

Local Layout
\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Standard

\lang english
You will find it under 
\family sans
Document\SpecialChar \menuseparator
Settings\SpecialChar \menuseparator
Local Layout
\family default
.
 The large text box allows you to enter anything that you might enter in
 a layout file or module.
 You can think of a document's local layout, in fact, as a module that belongs
 just to it.
 So, in particular, you must enter a 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Format
\end_layout

\end_inset

 tag.
 Any format is acceptable, but one would normally use the format current
 at the time.
 (In LyX 2.0, the current layout format is 35.) You should be aware that local
 layout is not supported by versions of LyX prior to 1.6, so you should not
 use it if you want to be able to export your document to LyX 1.5 or earlier
 (without, that is, losing the local layout information).
 If you wish to be able to export to 1.6---local layout is supported in 1.6,
 though there is no UI for it---then you should use format 11 and, of course,
 use only layout constructs that were available in LyX 1.6.
\end_layout

\begin_layout Standard

\lang english
When you have entered something in the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Local Layout
\end_layout

\end_inset

 pane, LyX will enable the 
\begin_inset Quotes eld
\end_inset

Validate
\begin_inset Quotes erd
\end_inset

 button at the bottom.
 Clicking this button will cause LyX to determine whether what you have
 entered is valid layout information for the chosen format.
 LyX will report the result but, unfortunately, will not tell you what errors
 there might have been.
 These will be written to the terminal, however, if LyX is started from
 a terminal.
 You will not be permitted to save your local layout until you have entered
 something valid.
\end_layout

\begin_layout Standard

\lang english
The warnings at the end of the previous section apply here, too.
 Do not play with local layout while you are actually working, especially
 if you have not saved your document.
 That said, using local layout with a test document can be a very convenient
 way to try out layout ideas, or even to start developing a module.
\end_layout

\begin_layout Subsection
Layout für 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout
.sty
\end_layout

\end_inset

-Dateien
\end_layout

\begin_layout Standard

\lang english
There are two situations you are likely to encounter when wanting to support
 a new LaTeX document class, involving style (
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
.sty
\end_layout

\end_inset

) files and LaTeX2e class (
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
.cls
\end_layout

\end_inset

) .
 Supporting a style file is usually fairly easy.
 Supporting a new class file is a bit harder.
 We'll discuss the former in this section and the latter in the next.
 Similar remarks apply, of course, if you want to support a new DocBook
 DTD.
\end_layout

\begin_layout Standard

\lang english
The easier case is the one in which your new document class is provided
 as a style file that is to be used in conjunction with an already supported
 document class.
 For the sake of the example, we'll assume that the style file is called
 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
myclass.sty
\end_layout

\end_inset

 and that it is meant to be used with 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
report.cls
\end_layout

\end_inset

, which is a standard class.
 
\end_layout

\begin_layout Standard

\lang english
Start by copying the existing class's layout file into your local directory:
\begin_inset Foot
status collapsed

\begin_layout Plain Layout

\lang english
Of course, which directory is your local directory will vary by platform,
 and LyX allows you to specify your local directory on startup, too, using
 the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
-userdir
\end_layout

\end_inset

 option.
\end_layout

\end_inset


\end_layout

\begin_layout LyX-Code

\lang english
cp report.layout ~/.lyx/layouts/myclass.layout
\end_layout

\begin_layout Standard

\lang english
Then edit 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
myclass.layout
\end_layout

\end_inset

 and change the line: 
\end_layout

\begin_layout LyX-Code

\lang english

\backslash
DeclareLaTeXClass{report}
\end_layout

\begin_layout Standard

\lang english
to read
\end_layout

\begin_layout LyX-Code

\lang english

\backslash
DeclareLaTeXClass[report, myclass.sty]{report (myclass)}
\end_layout

\begin_layout Standard

\lang english
Then add:
\end_layout

\begin_layout LyX-Code

\lang english
Preamble 
\begin_inset Newline newline
\end_inset

    
\backslash
usepackage{myclass}
\begin_inset Newline newline
\end_inset

EndPreamble
\end_layout

\begin_layout Standard

\lang english
near the top of the file.
\end_layout

\begin_layout Standard

\lang english
Start LyX and select 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
Tools\SpecialChar \menuseparator
Reconfigure
\end_layout

\end_inset

.
 Then restart LyX and try creating a new document.
 You should see "
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
report (myclass)
\end_layout

\end_inset

" as a document class option in the 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
Document\SpecialChar \menuseparator
Settings
\end_layout

\end_inset

 dialog.
 It is likely that some of the sectioning commands and such in your new
 class will work differently from how they worked in the base class—
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
report
\end_layout

\end_inset

 in this example—so you can fiddle around with the settings for the different
 sections if you wish.
 The layout information for sections is contained in 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
stdsections.inc
\end_layout

\end_inset

, but you do not need to copy and change this file.
 Instead, you can simply add your changes to your layout file, after the
 line 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Input stdclass.inc
\end_layout

\end_inset

, which itself includes 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
stdsections.inc
\end_layout

\end_inset

.
 For example, you might add these lines:
\end_layout

\begin_layout LyX-Code

\lang english
Style Chapter
\end_layout

\begin_layout LyX-Code

\lang english
    Font
\end_layout

\begin_layout LyX-Code

\lang english
        Family Sans
\end_layout

\begin_layout LyX-Code

\lang english
    EndFont
\end_layout

\begin_layout LyX-Code

\lang english
End
\end_layout

\begin_layout Standard

\lang english
to change the font for chapter headings to sans-serif.
 This will override (or, in this case, add to) the existing declaration
 for the Chapter style.
 
\end_layout

\begin_layout Standard

\lang english
Your new package may also provide commands or environments not present in
 the base class.
 In this case, you will want to add these to the layout file.
 See 
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Das-Layout-Dateiformat"

\end_inset

 for information on how to do so.
\end_layout

\begin_layout Standard

\lang english
If 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
myclass.sty
\end_layout

\end_inset

 can be used with several different document classes, and even if it cannot,
 you might find it easiest just to write a module that you can load with
 the base class.
 The simplest possible such module would be:
\end_layout

\begin_layout LyX-Code

\lang english
#
\backslash
DeclareLyXModule{My Package} 
\end_layout

\begin_layout LyX-Code

\lang english
#DescriptionBegin 
\end_layout

\begin_layout LyX-Code

\lang english
#Support for mypkg.sty.
\end_layout

\begin_layout LyX-Code

\lang english
#DescriptionEnd
\begin_inset Newline newline
\end_inset


\end_layout

\begin_layout LyX-Code

\lang english
Format 21
\begin_inset Newline newline
\end_inset


\end_layout

\begin_layout LyX-Code

\lang english
Preamble
\begin_inset Newline newline
\end_inset

    
\backslash
usepackage{mypkg}
\begin_inset Newline newline
\end_inset

EndPreamble
\end_layout

\begin_layout Standard

\lang english
A more complex module might modify the behavior of some existing constructs
 or define some new ones.
 Again, see 
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Das-Layout-Dateiformat"

\end_inset

 for discussion.
\end_layout

\begin_layout Subsection
Layout für 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout
.cls
\end_layout

\end_inset

-Dateien
\end_layout

\begin_layout Standard

\lang english
There are two possibilities here.
 One is that the class file is itself based upon an existing document class.
 For example, many thesis classes are based upon 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
book.cls
\end_layout

\end_inset

.
 To see whether yours is, look for a line like
\end_layout

\begin_layout LyX-Code

\lang english

\backslash
LoadClass{book}
\end_layout

\begin_layout Standard

\lang english
in the file.
 If so, then you may proceed largely as in the previous section, though
 the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
DeclareLaTeXClass
\end_layout

\end_inset

 line will be different.
 If your new class is 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
thesis
\end_layout

\end_inset

 and it is based upon 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
book
\end_layout

\end_inset

, then the line should read:
\begin_inset Foot
status collapsed

\begin_layout Plain Layout

\lang english
And it will be easiest if you save the file to 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
thesis.layout
\end_layout

\end_inset

: LyX assumes that the document class has the same name as the layout file.
 
\end_layout

\end_inset


\end_layout

\begin_layout LyX-Code

\lang english

\backslash
DeclareLaTeXClass[thesis,book]{thesis}
\end_layout

\begin_layout Standard

\lang english
If, on the other hand, the new class is not based upon an existing class,
 you will probably have to 
\begin_inset Quotes eld
\end_inset

roll your own
\begin_inset Quotes erd
\end_inset

 layout.
 We strongly suggest copying an existing layout file which uses a similar
 LaTeX class and then modifying it, if you can do so.
 At least use an existing file as a starting point so you can find out what
 items you need to worry about.
 Again, the specifics are covered below.
\end_layout

\begin_layout Subsection
Vorlagen erstellen
\begin_inset CommandInset label
LatexCommand label
name "sub:Vorlagen-erstellen"

\end_inset


\end_layout

\begin_layout Standard

\lang english
Once you have written a layout file for a new document class, you might
 want to consider writing a 
\emph on
template
\emph default
 for it, too.
 A template acts as a kind of tutorial for your layout, showing how it might
 be used, though containing dummy content.
 You can of course look at the various templates included with LyX for ideas.
\end_layout

\begin_layout Standard

\lang english
Templates are created just like usual documents: using LyX.
 The only difference is that usual documents contain all possible settings,
 including the font scheme and the paper size.
 Usually a user doesn't want a template to overwrite his preferred settings
 for such parameters.
 For that reason, the designer of a template should remove the corresponding
 commands like 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english

\backslash
font_roman
\end_layout

\end_inset

 or 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english

\backslash
papersize
\end_layout

\end_inset

 from the template LyX file.
 This can be done with any simple text-editor, for example 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
vi
\end_layout

\end_inset

 or 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
notepad
\end_layout

\end_inset

.
 
\end_layout

\begin_layout Standard

\lang english
Put the edited template files you create in 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
UserDir/templates/
\end_layout

\end_inset

, copy the ones you use from the global template directory in 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LyXDir/templates/
\end_layout

\end_inset

 to the same place, and redefine the template path in the 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
Tools\SpecialChar \menuseparator
Preferences\SpecialChar \menuseparator
Paths
\end_layout

\end_inset

 dialog.
\end_layout

\begin_layout Standard

\lang english
Note, by the way, that there is a template which has a particular meaning:
 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
defaults.lyx
\end_layout

\end_inset

.
 This template is loaded every time you create a new document with 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
File\SpecialChar \menuseparator
New
\end_layout

\end_inset

 in order to provide useful defaults.
 To create this template from inside LyX, all you have to do is to open
 a document with the correct settings, and use the 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
Save as Document Defaults
\end_layout

\end_inset

 button.
\end_layout

\begin_layout Subsection
Alte Layout-Dateien auf den neuesten Stand bringen
\end_layout

\begin_layout Standard

\lang english
The format of layout files changes with each LyX release, so old layout
 files need to be converted to the new format.
 This process has been automated since LyX 1.4: If LyX reads a layout file
 in an older format, it automatically calls the script 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
layout2layout.py
\end_layout

\end_inset

 to convert it to a temporary file in current format.
 The original file is left untouched.
 If you use the layout file often, then, you may want to convert it permanently,
 so that LyX does not have to do so itself every time.
 To do this, you can call the converter manually:
\end_layout

\begin_layout LyX-Code

\lang english
mv myclass.layout myclass.old
\end_layout

\begin_layout LyX-Code

\lang english
python LyXDir/scripts/layout2layout.py myclass.old myclass.layout
\end_layout

\begin_layout Standard

\lang english
You need to replace 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LyXDir
\end_layout

\end_inset

 with the name of your LyX system directory, of course.
\end_layout

\begin_layout Standard

\lang english
Note that manual conversion does not affect included files, so these will
 have to be converted separately.
\end_layout

\begin_layout Section
Das Layout-Dateiformat
\begin_inset CommandInset label
LatexCommand label
name "sec:Das-Layout-Dateiformat"

\end_inset


\end_layout

\begin_layout Standard

\lang english
When it's finally time to get your hands dirty and create or edit your own
 layout file, the following sections describe what you're up against.
 Our advice is to go slowly, save and test often, listen to soothing music,
 and enjoy one or two of your favorite adult beverages; more if you are
 getting particularly stuck.
 It's really not that hard, except that the multitude of options can become
 overwhelming if you try to do too much in one sitting.
 Go have another adult beverage, just for good measure.
\end_layout

\begin_layout Standard

\lang english
Note that all the tags used in layout files are case-insensitive.
 This means that 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Style
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
style
\end_layout

\end_inset

 and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
StYlE
\end_layout

\end_inset

 are really the same tag.
 The possible values are printed in brackets after the feature's name.
 The default value if a feature isn't specified inside a text class-description
 is typeset 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\emph on
\lang english
emphasized
\end_layout

\end_inset

.
 If the argument has a data type like 
\begin_inset Quotes eld
\end_inset

string
\begin_inset Quotes erd
\end_inset

 or 
\begin_inset Quotes eld
\end_inset

float
\begin_inset Quotes erd
\end_inset

, the default is shown like this: 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
float=
\emph on
default
\end_layout

\end_inset

.
\end_layout

\begin_layout Subsection
Deklaration einer neuen Textklasse
\end_layout

\begin_layout Standard
Zeilen, die mit einem 
\family typewriter
#
\family default
 beginnen, sind Kommentare.
 Mit einer Ausnahme: alle Textklassen sollten mit Zeilen ähnlich wie den
 folgenden beginnen:
\end_layout

\begin_layout LyX-Code

\size small
#% Do not delete the line below; configure depends on this
\end_layout

\begin_layout LyX-Code

\size small
#  
\backslash
DeclareLaTe
\family typewriter
\size default

\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset


\family default
\size small
XClass{article}
\end_layout

\begin_layout Standard
Die zweite Zeile wird benötigt, wenn Sie LyX konfigurieren.
 Die Textklassen-Datei wird von dem LaTeX-Skript 
\family typewriter

\begin_inset Flex URL
status collapsed

\begin_layout Plain Layout

chkconfig.ltx
\end_layout

\end_inset


\family default
 gelesen, und zwar in einem speziellen Modus, in dem 
\family typewriter
#
\family default
-Zeichen ignoriert werden.
 Die erste Zeile ist einfach ein LaTeX-Kommentar, in der zweiten wird die
 Textklasse deklariert.
 Eine Datei namens 
\family typewriter
article.layout
\family default
, die mit diesen beiden Zeilen beginnt, definiert eine Textklasse mit dem
 Namen 
\family typewriter
article
\family default
 und benutzt die LaTeX-Dokumentenklasse 
\family typewriter
article.cls
\family default
.
 
\emph on
article
\emph default
 ist auch die Beschreibung, die später im Popup-Menü 
\family sans
Dokument\SpecialChar \menuseparator
Einstellungen
\family default
 auftaucht.
 
\end_layout

\begin_layout Standard
Angenommen, Sie möchten Ihre eigene Textklasse schreiben, welche die LaTeX-Doku\SpecialChar \-
m
en\SpecialChar \-
tenklasse 
\family typewriter
article
\family default
 benutzt, in der Sie aber das Aussehen der Kopfzeile verändert haben.
 Wenn Sie dann Ihre Textklasse in eine Datei namens 
\family typewriter
myarticle.
\begin_inset Newline linebreak
\end_inset

layout
\family default
 schreiben, sollten die ersten beiden Zeilen der Datei etwa so aussehen:
\end_layout

\begin_layout LyX-Code

\size small
#% Do not delete the line below; configure depends on this
\end_layout

\begin_layout LyX-Code

\size small
#  
\backslash
DeclareLaTe
\family typewriter
\size default

\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset


\family default
\size small
XClass[article]{article (with my own headings)}
\end_layout

\begin_layout Standard
Auf diese Weise deklarieren Sie eine Textklasse 
\family typewriter
myarticle
\family default
, die die LaTeX
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

"=
\end_layout

\end_inset

Dokumentklasse 
\family typewriter
article.cls
\family default
 verwendet und (im Popup-Menü) beschrieben wird mit: 
\family sans
article (with my own headings)
\family default
.
 Falls Ihre Textklasse auch noch von weiteren Paketen abhängt, können Sie
 das so angeben:
\end_layout

\begin_layout LyX-Code

\size small
#% Do not delete the line below; configure depends on this
\end_layout

\begin_layout LyX-Code

\size small
#  
\backslash
DeclareLaTe
\family typewriter
\size default

\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset


\family default
\size small
XClass[article,foo.sty]{article (with my own head
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

"-
\end_layout

\end_inset

ings)}
\end_layout

\begin_layout Standard
Dadurch wird angezeigt, dass Ihre Klasse auch das Paket 
\family typewriter
foo.sty
\family default
 verwendet.
 Schließlich können Sie auch Klassen für DocBook festlegen.
 Eine typische Deklaration sieht so aus:
\end_layout

\begin_layout LyX-Code

\end_layout

\begin_layout LyX-Code

\size small
#% Do not delete the line below; configure depends on this
\end_layout

\begin_layout LyX-Code

\size small
# 
\backslash
DeclareDocBookClass[article]{SGML (DocBook article)}
\end_layout

\begin_layout Standard
Diesen Deklarationen kann außerdem ein optionaler Parameter zugefügt werden,
 der den Namen der Dokumentenklasse festlegt (hier ist aber keine Liste
 erlaubt).
\end_layout

\begin_layout Standard
Wenn Sie eine Textklasse nach Ihrem Geschmack erstellt haben, müssen Sie
 die Datei nur noch in das Verzeichnis 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir/layouts/
\family default
 oder nach 
\family typewriter
UserDir/layouts
\family default
 kopieren und unter LyX den Menüpunkt 
\family sans
Werkzeuge\SpecialChar \menuseparator
Neu
\begin_inset space \space{}
\end_inset

konfigurieren
\family default
 auswählen.
 Nach dem Neustart von LyX sollte Ihre Textklasse im Popup-Menü 
\family sans
Dokument\SpecialChar \menuseparator
Einstellungen
\family default
 auswählbar sein.
\end_layout

\begin_layout Subsection

\lang english
The Module declaration
\end_layout

\begin_layout Standard

\lang english
A module must begin with a line like the following:
\end_layout

\begin_layout LyX-Code
#
\backslash
DeclareLyXModule[endnotes.sty]{Endnotes} 
\end_layout

\begin_layout Standard

\lang english
The mandatory argument, in curly brackets, is the name of the module, as
 it should appear in 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
Document\SpecialChar \menuseparator
Settings\SpecialChar \menuseparator
Modules
\end_layout

\end_inset

.
 The argument in square brackets is optional: It declares any LaTeX packages
 on which the module depends.
 Please note that only packages about which LyX knows should be listed in
 the square brackets.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout

\lang english
The list of such packages is documented only in the source code.
\end_layout

\end_inset

 LyX will not check for arbitrary packages.
 It is also possible to use the form 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
from->to
\end_layout

\end_inset

 as an optional argument, which declares that the module can only be used
 when there exists a conversion chain between the formats `
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
from
\end_layout

\end_inset

' and `
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
to
\end_layout

\end_inset

'.
\end_layout

\begin_layout Standard

\lang english
The module declaration should then be followed by lines like the following
\begin_inset Foot
status collapsed

\begin_layout Plain Layout

\lang english
Preferably in English if the module should be published with LyX.
 This description will appear in the list of messages to be translated and
 will be thus translated with the next interface update.
\end_layout

\end_inset

:
\end_layout

\begin_layout LyX-Code
#DescriptionBegin 
\end_layout

\begin_layout LyX-Code
#Adds an endnote command, in addition to footnotes.
 
\end_layout

\begin_layout LyX-Code
#You will need to add  
\backslash
theendnotes in TeX code where you 
\end_layout

\begin_layout LyX-Code
#want the endnotes to appear.
 
\end_layout

\begin_layout LyX-Code
#DescriptionEnd 
\end_layout

\begin_layout LyX-Code
#Requires: somemodule | othermodule
\end_layout

\begin_layout LyX-Code
#Excludes: badmodule
\end_layout

\begin_layout Standard

\lang english
The description is used in 
\begin_inset Flex MenuItem
status collapsed

\begin_layout Plain Layout

\lang english
Document\SpecialChar \menuseparator
Settings\SpecialChar \menuseparator
Modules
\end_layout

\end_inset

 to provide the user with information about what the module does.
 The 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Requires
\end_layout

\end_inset

 line is used to identify other modules with which this one must be used;
 the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Excludes
\end_layout

\end_inset

 line is used to identify modules with which this one may not be used.
 Both are optional, and, as shown, multiple modules should be separated
 with the pipe symbol: |.
 Note that the required modules are treated disjunctively: 
\emph on
at least one
\emph default
 of the required modules must be used.
 Similarly, 
\emph on
no
\emph default
 excluded module may be used.
 Note that modules are identified here by their 
\emph on
filenames
\emph default
 without the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
.module
\end_layout

\end_inset

 extension.
 So 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
somemodule
\end_layout

\end_inset

 is really 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
somemodule.module
\end_layout

\end_inset

.
\end_layout

\begin_layout Subsection
Dateiformat
\end_layout

\begin_layout Standard
Die erste Zeile, die kein Kommentar ist, muss die Dateiformatnummer enthalten:
\end_layout

\begin_layout Description

\family typewriter
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Format
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
int
\end_layout

\end_inset

] 
\family default
\lang english
The format of the layout file.
\end_layout

\begin_layout Standard

\lang english
This tag was introduced with LyX 1.4.0.
 Layout files from LyX 1.3.x and earlier don't have an explicit file format
 and are considered to be of format 1.
 The format for the present version of LyX is format 21.
 But each version of LyX is capable of reading earlier versions' layout
 files, just as they are capable of reading files produced by earlier versions
 of LyX.
 There is, however, no provision for converting to earlier formats.
 So LyX 1.6.x will not read layout files in format 21 but only files in format
 11 or earlier.
\end_layout

\begin_layout Subsection
Allgemeine Parameter für Textklassen
\begin_inset CommandInset label
LatexCommand label
name "sub:Allgemeine-Parameter-für"

\end_inset


\end_layout

\begin_layout Standard
Nachfolgend allgemeine Parameter, die die Form des gesamten Dokumentes be\SpecialChar \-
schrei\SpecialChar \-
b
en:
\end_layout

\begin_layout Description

\family typewriter
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
AddToHTMLPreamble
\end_layout

\end_inset

 
\family default
\lang english
Adds information that will be output in the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<head>
\end_layout

\end_inset

 block when this document class is output to XHTML.
 Typically, this would be used to output CSS style information, but it can
 be used for anything that can appear in 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<head>
\end_layout

\end_inset

.
 Must end with 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
EndPreamble
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Description

\family typewriter
\series medium
AddToPreamble
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

fügt Informationen zum LaTeX-Vorspann hinzu und muss mir 
\family typewriter
EndPreamble
\family default
 beendet werden.
\end_layout

\begin_layout Description

\family typewriter
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
CiteFormat
\end_layout

\end_inset

 
\family default
\lang english
Defines formats for use in the display of bibliographic information.
 See Section 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Citation-format-description"

\end_inset

 for details.
 Must end with 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
End
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ClassOptions\SpecialChar \ldots{}
End
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Dieser Abschnitt beschreibt verschiedene globale Optionen, die von der Dokumente
nklasse unterstützt werden.
 Eine detaillierte Beschreibung finden Sie in Abschnitt 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Der-Abschnitt-ClassOptions"

\end_inset

.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Columns
\family default
\series default
 [
\family typewriter
\emph on
1
\emph default
, 2
\family default
]
\begin_inset Newline newline
\end_inset

Gibt an, ob die Textklasse standardmäßig ein- oder zweispaltig gesetzt wird.
 Kann im Popup-Menü 
\family sans
Dokument\SpecialChar \menuseparator
Einstellungen
\family default
\SpecialChar \ldots{}
 geändert werden.
 Diese Einstellung ist wichtig: Falls Ihre Textklasse standardmäßig zweispaltig
 gesetzt wird, Sie aber vergessen, das korrekt anzugeben, wird die Option
 
\family typewriter
twocolumn
\family default
 
\emph on
nicht
\emph default
 gesetzt, wenn Sie 
\family sans
Zweispaltiges
\family default

\begin_inset space \space{}
\end_inset


\family sans
Dokument
\family default
 in 
\family sans
Dokument\SpecialChar \menuseparator
Einstellungen
\family default
\SpecialChar \ldots{}
 aktivieren.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Counter
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

definiert einen neuen Zähler (siehe 
\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Zähler"

\end_inset

) und muss mit 
\family typewriter
End
\family default
 beendet werden.
\end_layout

\begin_layout Description

\family typewriter
\series medium
DefaultFont
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Dieser Parameter definiert den Standardzeichensatz des Dokuments.
 Eine genauere Beschreibung finden Sie in Abschnitt 
\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Beschreibung-des-Zeichensatzes"

\end_inset

.
\end_layout

\begin_layout Description

\family typewriter
\series medium
DefaultModule
\begin_inset space ~
\end_inset

[string] 
\family default
\series default

\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

spezifiziert ein Modul, das standardmäßig zu dieser Dokumentklasse hinzugefügt
 wird.
 string ist der Dateiname ohne die Erweiterung 
\family typewriter
.module
\family default
.
 Sie können das Modul zwar entfernen, aber es bleibt von Beginn an aktiv.
 Es wird nur angewendet, wenn neue Dateien erstellt oder diese Klasse für
 ein vorhandenes Dokument gewählt werden.
\end_layout

\begin_layout Description

\family typewriter
\series medium
DefaultStyle
\series default

\begin_inset space ~
\end_inset

[string]
\family default
 
\family typewriter

\begin_inset Newline newline
\end_inset


\family default
Dies ist das Layout für neu angelegte Absätze, normalerweise 
\family sans
Standard
\family default
.
 Fehlt dieser Eintrag, wird das erste definierte Layout verwendet; dennoch
 ist es sehr ratsam, diese Anweisung anzugeben.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ExcludesModule
\series default

\begin_inset space ~
\end_inset


\series medium
[string]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

zeigt an, dass das genannte Modul -- spezifiziert durch den Dateinamen ohne
 die Erweiterung 
\family typewriter
.module
\family default
 -- in dieser Dokumentklasse nicht benutzt werden kann.
 Dies könnte in einem Journal-spezifischen Layout benutzt werden, um zum
 Beispiel die Verwendung des theorems-sec-Moduls, das Theoreme abschnittsweise
 nummeriert, zu verhindern.
 Diese Marke darf 
\emph on
nicht
\emph default
 in einem Modul benutzt werden.
 Module haben einen anderen Weg, andere Module auszuschließen (siehe 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Layout-Module"

\end_inset

).
\end_layout

\begin_layout Description

\family typewriter
\series medium
Float
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

definiert ein neues Gleitobjekt (siehe 
\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Gleitobjekte"

\end_inset

) und muss mit 
\family typewriter
End
\family default
 beendet werden.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
HTMLPreamble
\end_layout

\end_inset

 
\lang english
Sets the information that will be output in the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<head>
\end_layout

\end_inset

 block when this document class is output to XHTML.
 Note that this will completely override any prior 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLPreamble
\end_layout

\end_inset

 or 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
AddToHTMLPreamble
\end_layout

\end_inset

 declarations.
 (Use 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
AddToHTMLPreamble
\end_layout

\end_inset

 if you just want to add material to the preamble.) Must end with 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
EndPreamble
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
HTMLTOCSection
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
string
\end_layout

\end_inset

] 
\lang english
The layout to use for the table of contents, bibliography, and so forth,
 when the document is output to HTML.
 For articles, this should normally be Section; for books, Chapter.
 If it is not given, then LyX will attempt to figure out which layout to
 use.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
IfCounter
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
string
\end_layout

\end_inset

] 
\lang english
Modifies the properties of the given counter.
 If the counter does not exist, the section is ignored.
 Must end with 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
End
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
\begin_inset Newline newline
\end_inset

See Section
\begin_inset space ~
\end_inset


\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Zähler"

\end_inset

 for details on counters.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
IfStyle
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
string
\end_layout

\end_inset

] 
\lang english
Modifies the properties of the given paragraph style.
 If the style does not exist, the section is ignored.
 Must end with 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
End
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Input
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Hiermit können Sie andere Dateien einbinden, die Definitionen für Textklassen
 enthalten.
 Damit können Sie unnötige Mehrfachdefinitionen vermeiden.
 Beispielsweise binden die meisten Standardtextklassen die Datei 
\family typewriter
stdclass.inc
\family default
 ein, in der ein Großteil der Definitionen für Standardlayouts gemacht wird.
\end_layout

\begin_layout Description

\family typewriter
\series medium
InsetLayout
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

definiert das Layout einer Einfügung (neu).
 
\family typewriter
\series medium
InsetLayout
\family default
\series default
 kann auf eine vorhandene Einfügung angewendet werden oder eine neue, benutzerde
finierte, zum Beispiel einen neuen Zeichenstil.
 Abschnitt 
\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Flexible-Einfügungen-und"

\end_inset

 enthält weitere Einzelheiten.
 Diese Marke muss mit 
\family typewriter
End
\family default
 beendet werden.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LeftMargin
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist eine Zeichenkette, deren Länge die Breite des linken Randes festlegt,
 zum Beispiel 
\begin_inset Quotes gld
\end_inset

MMMMM
\begin_inset Quotes grd
\end_inset

.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
NoCounter
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
string
\end_layout

\end_inset

] 
\lang english
This command deletes an existing counter, usually one defined in an included
 file.
\end_layout

\begin_layout Description

\family typewriter
\series medium
NoFloat
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

löscht ein vorhandenes Gleitobjekt.
 Dies ist besonders dann nützlich, wenn Sie ein Gleitobjekt, das in einer
 Eingabedatei definiert wurde, unterdrücken wollen.
\end_layout

\begin_layout Description

\family typewriter
\series medium
NoStyle
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Mit diesem Befehl können Sie die Definition eines bereits mit 
\family typewriter
Style 
\family default
defi\SpecialChar \-
nier\SpecialChar \-
ten Layouts rückgängig ma\SpecialChar \-
chen.
 Dies ist dann nützlich, wenn Sie ein Layout unterdrücken möchten, das in
 einer Datei definiert wird, die Sie mit 
\family typewriter
Input
\family default
 eingebunden haben.
\end_layout

\begin_layout Description

\family typewriter
\series medium
OutputFormat
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset


\lang english
A string indicating the file format (as defined in the Preferences dialog)
 produced by this class.
 It is mainly useful when OutputType is `literate' and one wants to define
 a new type of literate document.
 This string is reset to `docbook', `latex', or `literate' when the correspondin
g OutputType parameter is encountered.
\end_layout

\begin_layout Description

\family typewriter
\series medium
OutputType
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist eine Zeichenkette, die angibt, welche Dokumentart diese Klasse erzeugt.
 Zur Zeit gibt es folgende Möglichkeiten: 
\family typewriter
docbook
\family default
, 
\family typewriter
latex
\family default
 und 
\family typewriter
literate
\family default
.
\end_layout

\begin_layout Description

\family typewriter
\series medium
PageStyle
\family default
\series default
 [
\family typewriter
\emph on
plain
\emph default
, empty, headings
\family default
]
\begin_inset Newline newline
\end_inset

Der Standardseitenstil.
 Kann ebenfalls im Popup-Menü 
\family sans
Dokument\SpecialChar \menuseparator
Ein\SpecialChar \-
stel\SpecialChar \-
lun\SpecialChar \-
gen
\family default
\SpecialChar \ldots{}
 geändert werden.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Preamble
\begin_inset CommandInset label
LatexCommand label
name "Preamble"

\end_inset

\SpecialChar \ldots{}
EndPreamble
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

An dieser Stelle können Sie LaTeX-Code angeben, der vor 
\family typewriter

\backslash
begin{document}
\family default
 in die LaTeX-Ausgabe eingebunden wird.
 Zum Beispiel eigene Definitionen von LaTeX-Makros.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Provides
\begin_inset space ~
\end_inset

[string][
\emph on
0
\emph default
,
\begin_inset space ~
\end_inset

1]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset


\begin_inset CommandInset label
LatexCommand label
name "Provides"

\end_inset

zeigt an, ob die Klasse bereits die Funktion 
\family typewriter
string
\family default
 liefert.
 Normalerweise ist eine Funktion der Name eines Paketes (
\family typewriter
amsmath
\family default
, 
\family typewriter
makeidx
\family default
,\SpecialChar \ldots{}
) oder ein Makro (
\family typewriter
url
\family default
, 
\family typewriter
boldsymbol
\family default
,\SpecialChar \ldots{}
).
 Die vollständige Liste der unterstützten Funktionen ist leider nur in den
 LyX-Quellen dokumentiert -- in 
\family typewriter
src/LaTe
\family sans

\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset


\family typewriter
X\SpecialChar \-
Features.cpp
\family default
.
 
\family sans
Hilfe\SpecialChar \menuseparator
LaTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X-Konfiguration
\family default
 gibt einen Überblick über die unterstützten Pakete.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ProvidesModule
\begin_inset space ~
\end_inset

[string]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

zeigt an, dass dieses Layout die Funktionalität des Moduls 
\family typewriter
\series medium
string
\family default
\series default
 liefert, das als Dateiname ohne die Erweiterung 
\family typewriter
.module
\family default
 spezifiziert ist.
 Dies wird typischerweise benutzt, um anzuzeigen, dass es benutzt werden
 sollte.
 Es könnte in einem Modul benutzt werden, das eine andere Implementation
 derselben Funktion liefert.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Requires
\begin_inset space ~
\end_inset

[string] 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset


\family default
\series default
zeigt an, ob die Klasse die Funktion 
\family typewriter
string
\family default
 benötigt.
 Mehrfache Funktionen müssen durch Komma getrennt werden Beachten Sie, dass
 Sie nur unterstützte Funktionen anfordern können.
\end_layout

\begin_layout Description

\family typewriter
\series medium
RightMargin
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist eine Zeichenkette, deren Länge die Breite des rechten Randes festlegt,
 zum Beispiel 
\begin_inset Quotes gld
\end_inset

MMMMM
\begin_inset Quotes grd
\end_inset

.
\end_layout

\begin_layout Description

\family typewriter
\series medium
SecNumDepth
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

legt die Nummerierungstiefe fest und korrespondiert mit dem LaTeX-Zähler
 
\family typewriter
secnumdepth
\family default
.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Sides
\family default
\series default
 [
\family typewriter
\emph on
1
\emph default
, 2
\family default
]
\begin_inset Newline newline
\end_inset

Gibt an, ob der Text standardmäßig für ein- oder für zweiseitigen Druck
 gesetzt wird.
 Kann im Popup-Menü 
\family sans
Dokument\SpecialChar \menuseparator
Einstellungen
\family default
\SpecialChar \ldots{}
 geändert werden.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Style
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

definiert einen neuen Absatzstil.
 Wenn er bereits existiert, werden stattdessen einige seiner Parameter neu
 definiert (siehe auch 
\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Einzelne-Absatz-Layouts"

\end_inset

).
 Diese Marke muss mit 
\family typewriter
End
\family default
 beendet werden.
\end_layout

\begin_layout Description

\family typewriter
\series medium
TitleLatexName
\begin_inset space ~
\end_inset

[string="maketitle"]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist der Name des Befehls oder der Umgebung, der für 
\family typewriter
TitleLatexType
\family default
 benutzt werden soll.
\end_layout

\begin_layout Description

\family typewriter
\series medium
TitleLatexType
\begin_inset space ~
\end_inset

[
\emph on
CommandAfter
\emph default
,
\begin_inset space ~
\end_inset

Environment]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

gibt an, wie der Dokumenttitel aussehen soll.
 
\family typewriter
CommandAfter
\family default
 bedeutet, dass das Makro namens 
\family typewriter
\series medium
TitleLatexName
\family default
\series default
 nach dem letzten Layout mit 
\family typewriter
InTitle
\begin_inset space \space{}
\end_inset

1
\family default
 eingesetzt werden soll.
 
\family typewriter
\series medium
Environment
\family default
\series default
 korrespondiert zu dem Fall, in dem der Absatzblock mit 
\family typewriter
InTitle
\begin_inset space \space{}
\end_inset

1
\family default
 in die 
\family typewriter
\series medium
TitleLatexName
\family default
\series default
-Umgebung einge\SpecialChar \-
schlos\SpecialChar \-
sen werden soll.
\end_layout

\begin_layout Description

\family typewriter
\series medium
TocDepth
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

legt fest, bis zu welcher Tiefe das Inhaltsverzeichnis gehen soll und korrespond
iert mit dem LaTeX-Zähler 
\family typewriter
tocdepth
\family default
.
\end_layout

\begin_layout Subsection
Der Abschnitt 
\family typewriter
ClassOptions
\family default

\begin_inset CommandInset label
LatexCommand label
name "sub:Der-Abschnitt-ClassOptions"

\end_inset


\end_layout

\begin_layout Standard
Der Abschnitt 
\family typewriter
ClassOptions
\family default
 kann folgende Einträge enthalten:
\end_layout

\begin_layout Description

\family typewriter
\series medium
FontSize
\family default
\series default
 [
\family typewriter
string="10|11|12"
\family default
]
\begin_inset Newline newline
\end_inset

Eine Liste verfügbarer Größen für den Hauptzeichensatz; die Einträge werden
 mit 
\begin_inset Quotes gld
\end_inset


\family typewriter
|
\family default

\begin_inset Quotes grd
\end_inset

 getrennt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Header
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

wird benutzt, um die DTD-Zeile mit XML-basierten Klassen zu setzen.
 Zum Beispiel PUBLIC 
\begin_inset Quotes eld
\end_inset

-//OASIS//DTD DocBook V4.2//EN
\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Other
\begin_inset space ~
\end_inset


\family default
[
\family typewriter
string=""
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Sonstige Optionen für die Dokumentenklasse, die durch Komma getrennt werden.
 Sie werden in dem 
\family typewriter
documentclass-
\family default
Befehl als optionales Argument übergeben.
\end_layout

\begin_layout Description

\family typewriter
\series medium
PageStyle
\family default
\series default
 [
\family typewriter
string="empty|plain|headings|fancy"
\family default
]
\begin_inset Newline newline
\end_inset

Eine Liste verfügbarer Seitenstile; die Einträge werden mit 
\begin_inset Quotes gld
\end_inset


\family typewriter
|
\family default

\begin_inset Quotes grd
\end_inset

 getrennt.
\end_layout

\begin_layout Subsection
Einzelne Absatz-Layouts
\begin_inset CommandInset label
LatexCommand label
name "sub:Einzelne-Absatz-Layouts"

\end_inset


\end_layout

\begin_layout Standard
Eine Layoutbeschreibung für einen Absatz sieht wie folgt aus
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Sie können mit diesem Ausdruck entweder ein neues Layout definieren oder
 aber ein bereits definiertes umdefinieren.
 
\end_layout

\end_inset

:
\end_layout

\begin_layout LyX-Code
Style 
\family roman
\emph on
Name
\end_layout

\begin_layout LyX-Code
 ...
\end_layout

\begin_layout LyX-Code
End
\end_layout

\begin_layout Standard
Innerhalb des Blocks sind folgende Befehle erlaubt:
\end_layout

\begin_layout Description

\family typewriter
\series medium
Align
\family default
\series default
 [
\family typewriter
\emph on
block
\emph default
, left, right, center
\family default
]
\begin_inset Newline newline
\end_inset

Gibt an, ob der Text im Blocksatz linksbündig, rechtsbündig oder zentriert
 gesetzt wird.
\end_layout

\begin_layout Description

\family typewriter
\series medium
AlignPossible
\family default
\series default
 [
\family typewriter
\emph on
block
\emph default
, left, right, center
\family default
]
\begin_inset Newline newline
\end_inset

Eine 
\emph on
Liste
\emph default
 von möglichen Textausrichtungen, die durch Kommata voneinander getrennt
 werden.
 Einige LaTeX-Stile verbieten bestimmte Ausrichtungen, weil sie keinen Sinn
 machen.
 Beispielsweise sollte in einer Aufzählung der Text nicht rechtsbündig oder
 zentriert gesetzt werden.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
BabelPreamble
\end_layout

\end_inset

 
\lang english
Note that this will completely override any prior 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
BabelPreamble
\end_layout

\end_inset

 declaration for this style.
 Must end with 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
EndBabelPreamble
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
 See section 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:I18n"

\end_inset

 for details on its use.
\end_layout

\begin_layout Description

\family typewriter
\series medium
BottomSep
\family default
\series default
 [
\family typewriter
float=0
\family default
]
\begin_inset Newline newline
\end_inset

Ähnlich wie 
\family typewriter
TopSep
\family default
 -- nur ist dies der Abstand nach einer Serie von Absätzen.
 Ist der 
\family typewriter
TopSep
\family default
 des nachfolgenden Layouts nicht 0, so werden die beiden Abstände 
\emph on
nicht
\emph default
 addiert, sondern LyX wählt das Maximum der beiden Abstände.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Category
\begin_inset space ~
\end_inset

[string]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist die Kategorie für diesen Stil.
 Sie wird benutzt, um zugehörige Stile in der Layout-Kombobox der Werkzeugleiste
 zu gruppieren.
 Eine beliebige Zei\SpecialChar \-
chenkette kann benutzt werden, aber vielleicht wollen
 Sie vorhandene Ka\SpecialChar \-
te\SpecialChar \-
gorien zusammen mit Ihren eigenen Stilen benutzen.
\end_layout

\begin_layout Description

\family typewriter
\series medium
CommandDepth
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist die Tiefe des XML-Befehls und wird nur für XML-Formate benutzt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
CopyStyle
\family default
\series default
 Hiermit können Sie alle Optionen eines bereits definierten Layouts in das
 aktuelle kopieren.
\end_layout

\begin_layout Description

\family typewriter
\series medium
DependsOn
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist der Name eines Stils, dessen Vorspann 
\emph on
vor
\emph default
 diesem ausgegeben werden soll.
 Dadurch wird eine Reihenfolge von Vorspannteilen bewirkt, wenn Makro-Definition
en voneinander abhängen.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Beachten Sie, dass es außer dieser Funktionalität keine andere Möglichkeit
 gibt, Vorspanne zu ordnen.
 Die Reihenfolge, die Sie in einer LyX-Version sehen, kann sich in späteren
 Versionen ohne Warnung ändern.
\end_layout

\end_inset


\end_layout

\begin_layout Description

\family typewriter
\series medium
EndLabelType
\family default
\series default
 
\family typewriter
[
\emph on
No_Label
\emph default
, Box, Filled_Box, Static] 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset


\family default
ist der Markentyp, der am Ende eines Absatzes steht (oder mehrerer Absätze,
 wenn 
\family typewriter
LaTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XType
\family default
 auf 
\family typewriter
Environment
\family default
 , 
\family typewriter
Item_Environment
\family default
 oder 
\family typewriter
List_En\SpecialChar \-
vironment
\family default
 gesetzt ist).
 No_Label bedeutet 
\emph on
nichts
\emph default
, 
\family typewriter
Box
\family default
 oder 
\family typewriter
Filled_Box
\family default
 ist ein weißes oder schwarzes Quadrat, das für das Markieren eines Beweisendes
 geeignet ist.
 
\family typewriter
Static
\family default
 ist eine explizite Zeichenkette.
\end_layout

\begin_layout Description

\family typewriter
\series medium
EndLabelString
\begin_inset space ~
\end_inset

[string=""]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist eine Zeichenkette, die für einen 
\family typewriter
Static
\family default
 
\family typewriter
\series medium
EndLabelType
\family default
\series default
 benutzt wird.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Font
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Der Zeichensatz, der für den Textkörper 
\emph on
und
\emph default
 die Marke verwendet wird (siehe Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Beschreibung-des-Zeichensatzes"

\end_inset

).
 Wird 
\family typewriter
Font
\family default
 gesetzt, dann erhält 
\family typewriter
Label\SpecialChar \-
Font
\family default
 automatisch denselben Wert.
\end_layout

\begin_layout Description

\family typewriter
\series medium
FreeSpacing
\family default
\series default
 [
\family typewriter
\emph on
0
\emph default
, 1
\family default
]
\begin_inset Newline newline
\end_inset


\begin_inset CommandInset label
LatexCommand label
name "FreeSpacing"

\end_inset

Normalerweise erlaubt es LyX nicht, mehr als ein Leerzeichen zwischen Wörtern
 einzufügen.
 Diese Eigenschaft kann in bestimmten Fällen umständ\SpecialChar \-
lich sein, zum Beispiel,
 wenn ein Programmcode eingegeben werden soll.
 In solchen Fällen kann 
\family typewriter
FreeSpacing
\family default
 auf 
\family typewriter
1
\family default
 gesetzt werden.
 LyX erzeugt in diesem Fall für jedes zusätzliche Leerzeichen ein geschütztes
 Leerzeichen, es sei denn, LyX befindet sich im LaTeX-Modus.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTML*
\end_layout

\end_inset

 These tags are used with XHTML output.
 See 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Paragraph-Style-XHTML"

\end_inset

.
\end_layout

\begin_layout Description

\family typewriter
\series medium
InnerTag
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

wird nur für XML-Formate benutzt.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
InPreamble
\end_layout

\end_inset

 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
[1, 0]
\end_layout

\end_inset

 
\lang english
If 1, marks the style as to be included in the document preamble rather
 than in the document body.
 This is useful for document classes that want such information as the title
 and author to appear in the preamble.
 Note that this works only for styles for which the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LatexType
\end_layout

\end_inset

 is 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Command
\end_layout

\end_inset

 or 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Paragraph
\end_layout

\end_inset

.
\end_layout

\begin_layout Description

\family typewriter
\series medium
InTitle
\family default
\series default
 [
\family typewriter
1,
\family default
 
\family typewriter
\emph on
0
\family default
\emph default
]
\begin_inset Newline newline
\end_inset

Bei 1 wird nach dem Layout noch ein 
\family typewriter

\backslash
maketitle
\family default
 in LaTeX eingefügt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ItemSep
\family default
\series default
 [
\family typewriter
float=0
\family default
]
\begin_inset Newline newline
\end_inset

Dies ist ein zusätzlicher Abstand für die Unterpunkte eines 
\family typewriter
Environment
\family default
-Layouts.
 Wenn in solch einem Layout andere Layouts integriert werden, so werden
 diese mit 
\family typewriter
ParSep
\family default
 getrennt.
 Aber die einzelnen Unterpunkte der Umgebung werden 
\emph on
zusätzlich
\emph default
 mit 
\family typewriter
ItemSep
\family default
 getrennt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ItemTag
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

wird nur für XML-Formate benutzt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
KeepEmpty
\family default
\series default
 
\family typewriter
[
\emph on
0
\emph default
, 1]
\begin_inset Newline newline
\end_inset


\family default
Normalerweise ist es in LyX nicht möglich, einen Absatz leer zu lassen,
 da das zu einer leeren LaTeX-Ausgabe führen würde.
 In manchen Fällen ist das aber durchaus gewünscht: So können beispielsweise
 in einer Briefvorlage die benötigten Felder leer voreingestellt werden,
 damit keiner vergisst, sie anzugeben.
 In anderen Klassen wird ein solcher Absatz als Unterbrechung verwendet,
 die keinen eigentlichen Text enthält.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelBottomSep
\family default
\series default
 [
\family typewriter
float=0
\family default
]
\begin_inset Newline newline
\end_inset

Der vertikale Abstand zwischen der Marke und dem folgenden Text.
 Wird nur für Marken benutzt, die über dem folgenden Text stehen (
\family typewriter
Top_En\SpecialChar \-
vi\SpecialChar \-
ron\SpecialChar \-
ment
\family default
, 
\family typewriter
Center\SpecialChar \-
ed_Top_Environment
\family default
).
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelCounter
\begin_inset space ~
\end_inset

[string=""]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist der Name des Zählers zur automatischen Nummerierung (siehe Abschnitt
\begin_inset Newline linebreak
\end_inset

 
\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Zähler"

\end_inset

 für Einzelheiten).
 Er muss vorhanden sein, wenn 
\family typewriter
LabelType
\family default
 
\family typewriter
Counter
\family default
 ist.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelFont
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Der Zeichensatz, der für die Marke verwendet wird.
 (Siehe Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Beschreibung-des-Zeichensatzes"

\end_inset

.)
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
LabelIndent
\end_layout

\end_inset

 
\lang english
Text that indicates how far a label should be indented.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelSep
\family default

\begin_inset space ~
\end_inset

[
\family typewriter
string=""
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Der horizontale Abstand zwischen der Marke und dem folgenden Text.
 Wird nur für Marken benutzt, die nicht über dem folgenden Text stehen.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelString
\family default

\begin_inset space ~
\end_inset

[
\family typewriter
string=""
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Der String, der für den 
\family typewriter
LabelType
\family default
 
\family typewriter
\emph on
Static
\family default
\emph default
 verwendet wird.
 Wenn 
\family typewriter
\series medium
Label\SpecialChar \-
Counter
\family default
\series default
 gesetzt wurde, kann diese Zeichenkette spezielle Formatierungsbefehle enthalten
, wie sie in Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Zähler"

\end_inset

 be\SpecialChar \-
schrieben sind.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Wegen der Rückwärtskompatibilität wird die Zeichenkette 
\family typewriter
\emph on
@style-name@
\family default
\emph default
 durch den expandierten 
\family typewriter
\series medium
LabelString
\family default
\series default
 mit dem Stil 
\family typewriter
\emph on
style-name
\family default
\emph default
 ersetzt.
 Diese Funktion ist jetzt überflüssig und sollte durch die Mechanismen,
 die in Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Zähler"

\end_inset

 beschrieben sind, ersetzt werden.
\end_layout

\end_inset


\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelStringAppendix
\begin_inset space ~
\end_inset

[
\family default
string=""
\family typewriter
]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

wird im Anhang anstatt 
\family typewriter
\series medium
LabelString
\family default
\series default
 benutzt.
 Beachten Sie, dass jeder 
\family typewriter
\series medium
LabelString
\family default
\series default
-Befehl auch 
\family typewriter
\series medium
LabelStringAppendix
\family default
\series default
 zurücksetzt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelTag
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

wird nur für XML-Formate benutzt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelType
\family default
\series default
 [
\family typewriter
\emph on
No_Label
\emph default
, Manual, Static, Top_Environment, Centered_Top_
\family default

\begin_inset Newline linebreak
\end_inset


\family typewriter
En\SpecialChar \-
vi\SpecialChar \-
ron\SpecialChar \-
ment, Sensitive, Counter
\family default
]
\end_layout

\begin_deeper
\begin_layout Description

\family typewriter
\series medium
Manual
\family default
\series default
 bedeutet: die Marke ist das erste Wort (bis zum ersten echten Leerzeichen).
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Wenn Sie mehr als ein Wort als Marke haben wollen, müssen Sie geschützte
 Leerzeichen benutzen.
\end_layout

\end_inset

 
\end_layout

\begin_layout Description

\family typewriter
\series medium
Static
\family default
\series default
 bedeutet: die Marke wird im Layout definiert (siehe: 
\family typewriter
LabelString
\family default
).
\end_layout

\begin_layout Description

\family typewriter
\series medium
Top_Environment
\family default
 und
\family typewriter
 Centered_Top_Environment
\family default
\series default
 sind Spezialfälle von
\family typewriter
 Static
\family default
.
 Die Marke wird über dem Absatz abgebildet, aber nur am Anfang der Umgebung
 oder am Anfang einer Serie von Absätzen mit diesem Layout.
 Dies benutzt man zum Beispiel im 
\family sans
Abstract
\family default
-Layout oder im 
\family sans
Bibliography
\family default
-Layout.
 Dasselbe trifft auch für 
\family typewriter
Manual
\family default
-Marken mit dem LaTeX-Typ 
\family typewriter
Environment
\family default
 zu, damit Layouts für Theoreme korrekt arbeiten.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Sensitive
\family default
\series default
 ist ein Spezialfall von Bildunterschriften für Gleitobjekte (Abbildungen
 und Tabellen).
 
\family typewriter
Sensi\SpecialChar \-
tive
\family default
 bedeutet, dass der gedruckte Text von der Art des Gleitobjekts abhängt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Counter 
\family default
\series default
definiert automatisch nummerierte Zähler, wie in Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Zähler"

\end_inset

 beschrieben.
\end_layout

\end_deeper
\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
LangPreamble
\end_layout

\end_inset

 
\lang english
Note that this will completely override any prior 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LangPreamble
\end_layout

\end_inset

 declaration for this style.
 Must end with 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
EndLangPreamble
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
 See section 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:I18n"

\end_inset

 for details on its use.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LatexName
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Der Name, den LaTeX für dieses Layout wählt, das heißt entweder der Name
 eines LaTeX-Befehls oder der einer LaTeX-Umgebung.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LatexParam
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Ein optionaler Parameter, der 
\family typewriter
\series medium
LatexName
\family default
\series default
 (dem zugehörigen Befehl oder der Umgebung) übergeben wird.
 Dieser Parameter kann innerhalb von LyX nicht mehr geändert werden.
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
LatexType
\family default
\series default
 [
\family typewriter
\emph on
Paragraph
\emph default
, Command, Environment, Item_Environment, 
\begin_inset Newline newline
\end_inset

List_Environment
\family default
]
\begin_inset Newline newline
\end_inset

Legt fest, wie das Layout in LaTeX überführt wird.
 
\end_layout

\begin_deeper
\begin_layout Description

\family typewriter
\series medium
Paragraph
\family default
\series default
 bewirkt nichts besonderes -- der Text wird als 
\emph on
normaler
\emph default
 
\emph on
Absatz
\emph default
 übernommen.
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
Command
\family default
\series default
 behandelt den Text als Argument eines LaTeX-Befehls (
\family typewriter
\emph on

\backslash
LatexBe\SpecialChar \-
fehl
\emph default
 {\SpecialChar \ldots{}
}
\family default
).
\end_layout

\begin_layout Description

\family typewriter
\series medium
Environment
\family default
\series default
 behandelt den Text als Kern einer LaTeX-Umgebung
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
LaTeX-Umgebung und LaTeX-Befehl sind hier etwas irreführend, denn diese
 Regeln gelten auch für SGML-Klassen.
 Schauen Sie sich am besten die SGML-Klassen-Dateien für Beispiele an.
\end_layout

\end_inset

 
\begin_inset Newline newline
\end_inset

(
\family typewriter

\backslash
begin{
\emph on
LatexUmgebung
\emph default
} \SpecialChar \ldots{}
 
\backslash
end{
\emph on
LatexUmgebung
\emph default
}
\family default
).
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
Item_Environment
\family default
\series default
 bewirkt dasselbe wie 
\family typewriter
Environment
\family default
, nur dass vor jedem Absatz ein 
\family typewriter

\backslash
item
\family default
 eingefügt wird.
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
List_Environment
\family default
\series default
 funktioniert wie 
\family typewriter
Item_Environment
\family default
, nur dass
\family typewriter
 Label\SpecialChar \-
Width\SpecialChar \-
String
\family default
 als Argument an die Umgebung übergeben wird.

\family typewriter
 Label\SpecialChar \-
WidthString
\family default
 kann im Menü 
\family sans
Absatz-Einstellungen
\family default
 (
\family sans
Bearbeiten
\family default
\SpecialChar \menuseparator

\family sans
Absatz-Einstellungen
\family default
 
\begin_inset Marginal
status open

\begin_layout Plain Layout
\begin_inset Graphics
	filename ../../images/layout-paragraph.png
	BoundingBox 0bp 6bp 20bp 20bp

\end_inset


\end_layout

\end_inset

 definiert werden.

\emph on
 
\end_layout

\end_deeper
\begin_layout Standard
Fasst man die letzten Sachen zusammen, wird die LaTeX-Ausgabe entweder so:
\end_layout

\begin_layout LyX-Code

\backslash
latexname[latexparam]{\SpecialChar \ldots{}
}
\end_layout

\begin_layout Standard
oder so:
\end_layout

\begin_layout LyX-Code

\backslash
begin{latexname}[latexparam] \SpecialChar \ldots{}
 
\backslash
end{latexname}.
\end_layout

\begin_layout Standard
aussehen, abhängig vom LaTeX-Typ.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LeftMargin
\family default
\series default
 [
\family typewriter
string=""
\family default
]
\begin_inset Newline newline
\end_inset

Definiert den linken Einzug.
 Wenn ein Layout in ein anderes 
\family typewriter
Environment
\family default
-Layout integriert wird, werden die Breiten der verschiedenen 
\family typewriter
LeftMargin
\family default
s nicht einfach addiert, sondern vorher in Abhängigkeit zur Schachtelungstiefe
 mit dem Faktor 
\begin_inset Formula $\frac{4}{\mathrm{Tiefe}+4}$
\end_inset

 multipliziert.
 Dieser Parameter wird auch dann benutzt, wenn der Rand als 
\family typewriter
Manual
\family default
 oder 
\family typewriter
Dynamic
\family default
 definiert wurde.
 In diesem Fall wird der Wert zu den gegebenen manuellen oder dynamischen
 Rändern hinzugefügt.
 Für die Bedeutung des Wertes gilt das bei 
\family typewriter
ParIndent
\family default
 Gesagte.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Margin
\family default
\series default
 [
\family typewriter
\emph on
Static
\emph default
, Manual, Dynamic, First_Dynamic, Right_Address_Box
\family default
]
\begin_inset Newline newline
\end_inset

legt fest, wie der linke Rand des Textes bestimmt wird.
 
\end_layout

\begin_deeper
\begin_layout Description

\family typewriter
\series medium
Static
\family default
\series default
 wählt feste Randbreiten.
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
Manual
\family default
\series default
 bedeutet, dass der Rand von der Einstellung der 
\family sans
Ausrichtung
\family default
 im Menü 
\family sans
Absatz-Einstellungen
\family default
 (
\family sans
Bearbeiten
\family default
\SpecialChar \menuseparator

\family sans
Absatz-Einstellungen
\family default

\begin_inset Marginal
status open

\begin_layout Plain Layout
\begin_inset Graphics
	filename ../../images/layout-paragraph.png
	BoundingBox 0bp 6bp 20bp 20bp

\end_inset


\end_layout

\end_inset

) abhängt.
 Dies wird für hübsche Listen ohne Tabulatoren benutzt.
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
Dynamic
\family default
\series default
 bedeutet, der linke Rand hängt von der Größe der verwendeten Markierung
 ab.
 Dies wird zum Beispiel bei automatisch nummerierten Überschriften verwendet.
 Es leuchtet ein, dass die Überschrift 
\begin_inset Quotes gld
\end_inset

5.4.3.2.1 Sehr lange \SpecialChar \ldots{}
 Überschrift
\begin_inset Quotes grd
\end_inset

 einen größeren linken Rand benötigt, als 
\begin_inset Quotes gld
\end_inset

3.2 Sehr lange \SpecialChar \ldots{}
 Überschrift
\begin_inset Quotes grd
\end_inset

.
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
First_Dynamic
\family default
\series default
 arbeitet ähnlich wie 
\family typewriter
Dynamic
\family default
, aber nur die erste Zeile wird dynamisch gesetzt, die anderen statisch.
 Dies wird für die LaTeX
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

"=
\end_layout

\end_inset

Umgebung 
\family sans
description
\family default
 benutzt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Right_Address_Box
\family default
\series default
 bedeutet, dass der Rand wird so gewählt, dass die längste Zeile des Absatzes
 gerade den rechten Rand berührt.
 Dies wird zum Setzen einer Adresse am rechten Rand der Seite eingesetzt.
\end_layout

\end_deeper
\begin_layout Description

\family typewriter
\series medium
NeedProtect
\family default
\series default

\begin_inset space ~
\end_inset


\series medium
[
\family typewriter
\emph on
0
\emph default
,1
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Gibt an, ob 
\emph on
zerbrechliche
\emph default
 LaTeX-Befehle innerhalb dieses Layouts durch 
\family typewriter

\backslash
protect
\family default
 ge\SpecialChar \-
schützt werden müssen.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Newline
\family default
\series default

\begin_inset space ~
\end_inset


\series medium
[
\family typewriter
0,
\emph on

\begin_inset space ~
\end_inset

1
\family default
\emph default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Gibt an, ob Zeilenumbrüche in LaTeX als 
\begin_inset Quotes gld
\end_inset


\family typewriter

\backslash

\backslash

\family default

\begin_inset Quotes grd
\end_inset

 dargestellt werden, oder nicht.
 Es macht Sinn, diese Option auszuschalten (Wert: 0), um LaTeX-Einschübe
 in LyX komfortabler editieren zu können.
\end_layout

\begin_layout Description

\family typewriter
\series medium
NextNoIndent
\family default
\series default

\begin_inset space ~
\end_inset


\series medium
[
\family typewriter
1,
\emph on

\begin_inset space ~
\end_inset

0
\family default
\emph default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Gibt an, ob der nachfolgende Absatz einen linken Einzug haben darf oder
 nicht.
 
\family typewriter
1
\family default
 heißt, der Absatz erhält auf keinen Fall einen Einzug.
 (Zum Beispiel nach einer Überschrift.)
\end_layout

\begin_layout Description

\family typewriter
\series medium
ObsoletedBy
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist der Name eines Layouts, das durch dieses ersetzt wurde.
 So können Sie ein Layout umbenennen und die Rückwärtskompatibilität erhalten.
\end_layout

\begin_layout Description

\family typewriter
\series medium
OptionalArgs
\begin_inset space ~
\end_inset

[int=0]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist die Zahl der optionalen Argumente, die in diesem Layout benutzt werden
 können.
 Dies ist zum Beispiel bei Abschnittsüberschriften hilfreich und macht nur
 mit LaTeX Sinn.
\end_layout

\begin_layout Description

\series medium
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\series medium
ParbreakIsNewline
\end_layout

\end_inset


\series default
 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
0
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
1
\end_layout

\end_inset

] 
\lang english
Indicates that paragraphs will not be separated by an empty line in LaTeX
 output, but only by a line break; together with 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
PassThru 1
\end_layout

\end_inset

, this allows to emulate a plain text editor (like the ERT inset).
\end_layout

\begin_layout Description

\family typewriter
\series medium
ParIndent
\family default
\series default

\begin_inset space ~
\end_inset


\series medium
[
\family typewriter
string=""
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Der Einzug der ersten Zeile eines Absatzes.
 Als Argument wird eine Zeichenkette übergeben.
 Zum Beispiel bedeutet 
\begin_inset Quotes gld
\end_inset


\family typewriter
MM
\family default

\begin_inset Quotes grd
\end_inset

, dass die erste Zeile genau so weit eingezogen wird, wie die Breite von
 
\begin_inset Quotes gld
\end_inset


\family typewriter
MM
\family default

\begin_inset Quotes grd
\end_inset

 im normalen Zeichensatz ist.
 Einen negativen Wert können Sie angeben, indem Sie ein 
\begin_inset Quotes gld
\end_inset

-
\begin_inset Quotes grd
\end_inset

 voranstellen.
\begin_inset Newline newline
\end_inset

Diese Methode wurde gewählt, damit das Aussehen auf dem Bildschirm bei unterschi
edlichen Zeichensätzen möglichst ähnlich bleibt.
 
\family typewriter
ParIndent
\family default
 bleibt für ein bestimmtes Layout fest.
 Eine Ausnahme ist das Standard-Layout, denn dort kann der Einzug vom vorherigen
 Layout mit 
\family typewriter
NextNoIndent
\family default
 verboten werden.
\begin_inset Newline newline
\end_inset

Auch benutzt das Standard-Layout innerhalb von Umgebungen den Einzug der
 Umgebung und nicht den eigenen.
 Zum Beispiel haben Standardabsätze innerhalb einer Aufzählung keinen Einzug.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ParSep
\family default
\series default

\begin_inset space ~
\end_inset


\series medium
[
\family typewriter
float=0
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Der vertikale Anstand zwischen den Absätzen dieses Layouts.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ParSkip
\family default

\begin_inset space ~
\end_inset

[
\family typewriter
float=0
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

LyX erlaubt im Menü 
\family sans
Dokument
\family default
\SpecialChar \menuseparator

\family sans
Einstellungen
\family default
\SpecialChar \menuseparator

\family sans
Textformat
\family default
 die Einstellung 
\family sans
Absätze
\begin_inset space \space{}
\end_inset

trennen
\begin_inset space \space{}
\end_inset

durch
\family default
.
 Mögliche Einstellungen sind entweder 
\family sans
Einrü\SpecialChar \-
ckung
\family default
 oder 
\family sans
Vertikaler
\begin_inset space \space{}
\end_inset

Abstand
\family default
.
 Wenn 
\family sans
Vertikaler
\begin_inset space \space{}
\end_inset

Abstand
\family default
 gewählt wird, wird in einem Layout mit 
\family typewriter
Latex\SpecialChar \-
Type Paragraph
\family default
 der Wert von 
\family typewriter
ParIndent
\family default
 ignoriert.
 Stattdessen werden alle Absätze durch einen vertikalen Abstand getrennt.
 Die Länge dieses Abstands ist das Produkt von 
\family typewriter
ParSkip
\family default
 und der Höhe des Standardzeichensatzes.
\end_layout

\begin_layout Description

\family typewriter
\series medium
PassThru
\series default

\begin_inset space ~
\end_inset


\series medium
[0,
\series default
 1]
\begin_inset Newline newline
\end_inset


\family default
Legt fest, ob der Absatzinhalt unverändert ausgegeben werden soll, also
 ohne diverse von LaTeX benötigte Ersetzungen durchzuführen.
 Dies ersetzt in gewisser Weise das alte Zeichensatzattribut 
\family typewriter
LaTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X
\family default
.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Preamble\SpecialChar \ldots{}
EndPreamble
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Eine Serie von Makrodefinitionen, die in die Präambel (vor 
\family typewriter

\backslash
begin{docu\SpecialChar \-
ment}
\family default
) eingefügt werden, falls dieses Layout benutzt wird.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\series medium
RefPrefix
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
string
\end_layout

\end_inset

] 
\lang english
The prefix to use when creating labels referring to paragraphs of this type.
 This allows the use of formatted references.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\series medium
RequiredArgs
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
int=0
\end_layout

\end_inset

] 
\lang english
The number of required arguments that the LaTeX command or environment correspon
ding to this style expects.
 In the case of a command, these are required arguments 
\emph on
other than
\emph default
 that associated with the content of the paragraph itself.
 These do not actually have to be provided: LyX will output empty arguments
 if necessary.
 Note that optional arguments will be output before required arguments.
 See the discussion of the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
OptionalArgs
\end_layout

\end_inset

 tag above for more information.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Requires
\family default
\series default

\begin_inset space ~
\end_inset


\series medium
[
\family typewriter
string
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset


\series medium

\begin_inset CommandInset label
LatexCommand label
name "Requires-2"

\end_inset


\series default
legt fest, dass das Layout die Funktion 
\family typewriter
string
\family default
 benötigt.
 Sehen Sie sich auch die Beschreibung von 
\family typewriter
Provides
\family default

\begin_inset CommandInset ref
LatexCommand vpageref
reference "Provides"

\end_inset

 an.
\end_layout

\begin_layout Description

\family typewriter
\series medium
RightMargin
\family default
\series default

\begin_inset space ~
\end_inset


\series medium
[
\family typewriter
string=""
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Ähnlich wie 
\family typewriter
LeftMargin
\family default
.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Spacing
\family default
\series default

\begin_inset space ~
\end_inset


\series medium
[
\family typewriter
\emph on
single
\emph default
,
\begin_inset space ~
\end_inset

onehalf,
\begin_inset space ~
\end_inset

double,
\begin_inset space ~
\end_inset

other
\family default
\emph on

\begin_inset space ~
\end_inset

Wert
\emph default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Dies definiert die Voreinstellung für den Zeilenabstand des Layouts.
 Die Argumente 
\family typewriter
single
\family default
, 
\family typewriter
onehalf
\family default
 und 
\family typewriter
double
\family default
 entsprechen Multiplikatoren 1, 1.25 und 1.667.
 Wenn Sie als Argument 
\family typewriter
other
\family default
 angeben, müssen Sie  als 
\emph on
Wert
\emph default
 einen konkreten Multiplikator angeben.
 Im Gegensatz zu anderen Parametern erzeugt LyX, wenn 
\family typewriter
Spacing
\family default
 gesetzt wird, spezifischen LaTeX-Code, der auf das Paket 
\family typewriter
setspace.sty
\family default
 zurückgreift.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\series medium
Spellcheck
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
0
\end_layout

\end_inset

,
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
1
\end_layout

\end_inset

] 
\lang english
Spellcheck paragraphs of this style.
 Default is true.
\end_layout

\begin_layout Description

\family typewriter
\series medium
TextFont
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Der Zeichensatz, der für den Textkörper verwendet wird.
 (Siehe auch Abschnitt 
\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Beschreibung-des-Zeichensatzes"

\end_inset

.)
\end_layout

\begin_layout Description

\family typewriter
\series medium
TocLevel
\begin_inset space ~
\end_inset

[int]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist die Stufe des Stils im Inhaltsverzeichnis und wird zur automatischen
 Nummerierung von Abschnittsüberschriften benutzt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
TopSep
\family default
\series default

\begin_inset space ~
\end_inset


\series medium
[
\family typewriter
float=0
\family default
]
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Der vertikale Abstand, der die erste Serie von Absätzen vom vorangehenden
 Text trennt.
\end_layout

\begin_layout Subsection

\lang english
\begin_inset CommandInset label
LatexCommand label
name "sub:I18n"

\end_inset

Internationalization of Paragraph Styles
\end_layout

\begin_layout Standard

\lang english
LyX has long supported internationalization of layout information, but,
 until version 2.0, this applied only to the user interface and not to, say,
 PDF output.
 Thus, French authors were forced to resort to ugly hacks if they wanted
 `
\lang french
Théorème
\lang english
 1' instead of `Theorem 1'.
 Thanks to Georg Baum, that is no longer the case.
\end_layout

\begin_layout Standard

\lang english
If a 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Style
\end_layout

\end_inset

 defines text that is to appear in the typeset document, it may use 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LangPreamble
\end_layout

\end_inset

 and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
BabelPreamble
\end_layout

\end_inset

 to support non-English and even multi-language documents correctly.
 The following excerpt (from the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
theorems-ams.inc
\end_layout

\end_inset

 file) shows how this works:
\end_layout

\begin_layout LyX-Code
Preamble
\end_layout

\begin_deeper
\begin_layout LyX-Code
  
\backslash
theoremstyle{remark}
\end_layout

\begin_layout LyX-Code
  
\backslash
newtheorem{claim}[thm]{
\backslash
protect
\backslash
claimname}
\end_layout

\begin_layout LyX-Code
EndPreamble
\end_layout

\begin_layout LyX-Code
LangPreamble
\end_layout

\begin_layout LyX-Code
  
\backslash
providecommand{
\backslash
claimname}{_(Claim)}
\end_layout

\begin_layout LyX-Code
EndLangPreamble
\end_layout

\begin_layout LyX-Code
BabelPreamble
\end_layout

\begin_layout LyX-Code
    
\backslash
addto
\backslash
captions$$lang{
\backslash
renewcommand{
\backslash
claimname}{_(Claim)}}
\end_layout

\begin_layout LyX-Code
EndBabelPreamble
\end_layout

\end_deeper
\begin_layout Standard

\lang english
In principle, any legal LaTeX may appear in the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LangPreamble
\end_layout

\end_inset

 and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
BabelPreamble
\end_layout

\end_inset

 tags, but in practice they will typically look as they do here.
 The key to correct translation of the typeset text is the definition of
 the LaTeX command 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english

\backslash
claimname
\end_layout

\end_inset

 and its use in 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english

\backslash
newtheorem
\end_layout

\end_inset

.
 
\end_layout

\begin_layout Standard

\lang english
The 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LangPreamble
\end_layout

\end_inset

 tag provides for internationalization based upon the overall language of
 the document.
 The contents of the tag will be included in the preamble, just as with
 the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Preamble
\end_layout

\end_inset

 tag.
 What makes it special is the use of the 
\begin_inset Quotes eld
\end_inset

function
\begin_inset Quotes erd
\end_inset

 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
_()
\end_layout

\end_inset

, which will be replaced, when LyX produces LaTeX output, with the translation
 of its argument into the document language.
\end_layout

\begin_layout Standard

\lang english
The 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
BabelPreamble
\end_layout

\end_inset

 tag is more complex, since it is meant to provide support for multi-language
 documents and so offers an interface to the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
babel
\end_layout

\end_inset

 package.
 Its contents will be added to the preamble once for each language that
 appears in the document.
 In this case, the argument to 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
_()
\end_layout

\end_inset

 will be replaced with its translation into the language in question; the
 expression 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
$$lang
\end_layout

\end_inset

 is replaced by the language name (as used by the babel package).
\end_layout

\begin_layout Standard

\lang english
A German document that also included a French section would thus have the
 following in the preamble:
\end_layout

\begin_layout LyX-Code

\backslash
addto
\backslash
captionsfrench{
\backslash
renewcommand{
\backslash
claimname}{Affirmation}}   
\backslash
addto
\backslash
captionsngerman{
\backslash
renewcommand{
\backslash
claimname}{Behauptung}}   
\backslash
providecommand{
\backslash
claimname}{Behauptung}
\end_layout

\begin_layout Standard

\lang english
LaTeX and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
babel
\end_layout

\end_inset

 will then conspire to produce the correct text in the output.
\end_layout

\begin_layout Standard

\lang english
One important point to note here is that the translations are provided by
 LyX itself, through the same mechanism it uses for internationalization
 of the user interface.
 This means, in effect, that 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LangPreamble
\end_layout

\end_inset

 and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
BabelPreamble
\end_layout

\end_inset

 are really only of use in layout files that are provided with LyX, since
 text entered in user-created layout files will not be seen by LyX's internation
alization routines.
 That said, however, any layout created with the intention that it will
 be included with LyX should use these tags where appropriate.
\end_layout

\begin_layout Subsection
Gleitobjekte
\begin_inset CommandInset label
LatexCommand label
name "sub:Gleitobjekte"

\end_inset


\end_layout

\begin_layout Standard
Seit LyX 1.3.0 ist es möglich und nötig, Gleitobjekte (
\family sans
Abbildung
\family default
, 
\family sans
Tabelle
\family default
,\SpecialChar \ldots{}
) in der Textklasse selber zu definieren.
 Standardgleitobjekte sind in der Datei 
\family typewriter
stdfloats.inc
\family default
 enthalten, so dass Sie sie nur noch
\end_layout

\begin_layout LyX-Code
Input stdfloats.inc
\end_layout

\begin_layout Standard
zu Ihrer Layoutdatei hinzufügen müssen.
 Wenn Sie eine Textklasse implementieren wollen, die andere Gleitobjekttypen
 enthält (wie zum Beispiel die AGU-Klasse), werden Ihnen die folgenden Informati
onen helfen:
\end_layout

\begin_layout Description

\family typewriter
\series medium
Extension
\begin_inset space ~
\end_inset

[string=""]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Die Dateinamenerweiterung einer zusätzlichen Datei für das Abbildungsver\SpecialChar \-
zeichnis
 (oder andere).
 LaTeX schreibt die Beschriftungen in diese Datei.
\end_layout

\begin_layout Description

\family typewriter
\series medium
GuiName
\begin_inset space ~
\end_inset

[string=""]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Die Zeichenkette, die in den Menüs und für die Beschriftung benutzt wird.
 Dies wird in die aktuelle Sprache übersetzt, wenn babel verwendet wird.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LaTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XBuiltin
\begin_inset space ~
\end_inset

[0,
\begin_inset space ~
\end_inset

1]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

1 bedeutet, das das Gleitobjekt bereits von der LaTeX-Dokumentklasse benutzt
 wird.
 0 bedeutet, das das Gleitobjekt im LaTeX-Paket 
\family typewriter
float
\family default
 definiert wird.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ListName
\begin_inset space ~
\end_inset

[string=""]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Die Überschrift für das Gleitobjekt-Verzeichnis.
 Dies wird in die Dokumentsprache übersetzt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
NumberWithin
\begin_inset space ~
\end_inset

[string=""]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Dieses optionale Argument bestimmt, ob Gleitobjekte dieser Klasse mit der
 Abschnittsnummer dieses Dokuments nummeriert werden.
 Wenn zum Beispiel [string="chapter"] gesetzt ist, werden die Gleitobjekte
 mit den Kapitelnummern nummeriert.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Placement
\begin_inset space ~
\end_inset

[string=""]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Die Standardplatzierung für die Gleitobjektklasse.
\family typewriter

\begin_inset Newline linebreak
\end_inset

string
\family default
 sollte die Standard-LaTeX-Werte 
\family typewriter
t
\family default
, 
\family typewriter
b
\family default
, 
\family typewriter
p
\family default
 und 
\family typewriter
h
\family default
 für oben, unten, Seite und hier enthalten.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Wie in LaTeX ist die Reihenfolge der Buchstaben unerheblich.
\end_layout

\end_inset

 Zusätzlich gibt es den neuen Typ 
\family typewriter
H
\family default
, der mit Gleitobjekt nichts mehr zu tun hat, denn er bedeutet: drucke es
 
\emph on
hier
\emph default
 und nirgendwo sonst.
 Beachten Sie, dass 
\family typewriter
H
\family default
 besonders ist und wegen der Implementierungsdetails nicht bei nicht-eingebauten
 Gleitobjekttypen benutzt werden kann.
 Wenn Sie das nicht verstehen, benutzen Sie einfach 
\family typewriter
"tbp"
\family default
.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Style
\begin_inset space ~
\end_inset

[string=""] 
\family default
\series default

\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist der Gleitobjektstil, wenn er mit 
\family typewriter

\backslash
newfloat
\family default
 definiert wird.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Type
\begin_inset space ~
\end_inset

[string=""] 
\family default
\series default

\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist der 
\emph on
Typ
\emph default
 der neuen Gleitobjektklasse, wie Programm oder Algorithmus.
 Nach dem entsprechenden 
\family typewriter

\backslash
newfloat
\family default
 stehen Befehle wie 
\family typewriter

\backslash
be\SpecialChar \-
gin{program}
\family default
 oder 
\family typewriter

\backslash
end{algorithm*}
\family default
 zur Verfügung.
\end_layout

\begin_layout Description
Anmerkung: Wenn ein Gleitobjekt vom Typ 
\emph on
type
\emph default
 definiert wurde, gibt es automatisch einen dazugehörigen Zähler namens
 
\emph on
type
\emph default
.
\end_layout

\begin_layout Subsection
Flexible Einfügungen und InsetLayout
\begin_inset CommandInset label
LatexCommand label
name "sub:Flexible-Einfügungen-und"

\end_inset


\end_layout

\begin_layout Standard
Seit Version 1.4.0 unterstützt LyX Zeichenstile.
 Seit Version 1.6.0 heißen sie Flexible Einfügungen.
\end_layout

\begin_layout Standard
Es gibt drei Arten von flexiblen Einfügungen:
\end_layout

\begin_layout Itemize
Zeichenstil (
\family typewriter
CharStyle
\family default
): diese definieren semantische Textauszeichnungen, die mit LaTeX-Befehlen
 wie 
\family typewriter

\backslash
noun
\family default
 oder 
\family typewriter

\backslash
code
\family default
 korrespondieren.
\end_layout

\begin_layout Itemize
benutzerdefiniert (
\family typewriter
Custom
\family default
): diese können benutzt werden, um benutzer\SpecialChar \-
de\SpecialChar \-
fi\SpecialChar \-
nier\SpecialChar \-
te einklappbare Einfügungen
 zu definieren, ähnlich wie TeX-Code, Fuß\SpecialChar \-
no\SpecialChar \-
te usw.
 Ein naheliegendes Beispiel ist die Endnotiz, die im 
\family typewriter
endnote
\family default
-Modul definiert ist.
\end_layout

\begin_layout Itemize
XML-Element (
\family sans
Element
\family default
): diese werden mit DocBook-Klassen benutzt.
\end_layout

\begin_layout Standard
Flexible Einfügungen werden mit der 
\family typewriter
InsetLayout
\family default
-Marke definiert, die weiter unten erklärt wird.
\end_layout

\begin_layout Standard
Die 
\family typewriter
InsetLayout
\family default
-Marke besitzt noch eine andere Funktion: sie kann benutzt werden, um das
 allgemeine Aussehen vieler verschiedener Einfügungstypen anzupassen.
 Zurzeit kann 
\family typewriter
InsetLayout
\family default
 benutzt werden, um die Layout-Parameter für Fußnoten, Randnoten, eingefügten
 Noten, TeX-Code (ERT), Zweige, Stichwortverzeichnisse, Boxen, Tabellen,
 Algorithmen, URLs und optionaler Argumente anzupassen, ebenso um flexible
 Einfügungen zu definieren.
\end_layout

\begin_layout Standard
Die 
\family typewriter
InsetLayout
\family default
-Definition muss mit folgender Zeile beginnen:
\end_layout

\begin_layout LyX-Code

\family typewriter
InsetLayout <Type>
\end_layout

\begin_layout Standard
Hier bezeichnet 
\family typewriter
<Type>
\family default
 die Einfügung, deren Layout definiert wird.
 Es gibt zwei Möglichkeiten.
\end_layout

\begin_layout Enumerate
Das Layout für eine existierende Einfügung wird geändert.
 In diesem Fall kann 
\family typewriter
<Type>
\family default
 folgendes sein: 
\family typewriter
Algorithm
\family default
, 
\family typewriter
Branch
\family default
, Box, 
\family typewriter
Box:shaded
\family default
, 
\family typewriter
ERT
\family default
, 
\family typewriter
Figure
\family default
, 
\family typewriter
Foot
\family default
, 
\family typewriter
Index
\family default
, 
\family typewriter
Info
\family default
, 
\family typewriter
Info:menu
\family default
, 
\family typewriter
Info:shortcut
\family default
, 
\family typewriter
Info:shortcuts
\family default
, 
\family typewriter
Listings
\family default
, 
\family typewriter
Marginal
\family default
, 
\family typewriter
Note:Comment
\family default
, 
\family typewriter
Note:Note
\family default
, 
\family typewriter
Note:GreyedOut
\family default
, 
\family typewriter
OptArg
\family default
, 
\family typewriter
Table
\family default
 oder 
\family typewriter
URL
\family default
.
\end_layout

\begin_layout Enumerate
Das Layout für eine flexible Einfügung wird definiert.
 In diesem Fall kann 
\family typewriter
<Type>
\family default
 ein beliebiger gültiger Bezeichner sein, der in keiner existierenden Einfügung
 benutzt wird.
 Beachten Sie, dass die Definition einer flexiblen Einfügung 
\emph on
auch
\emph default
 einen 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XType
\family default
-Eintrag enthalten muss.
\end_layout

\begin_layout Standard
Die 
\family typewriter
InsetLayout
\family default
-Definition kann folgende Einträge enthalten:
\end_layout

\begin_layout Description

\family typewriter
\series medium
BGColor
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist die Hintergrundfarbe der Einfügung.
 Die gültigen Farben sind in 
\family typewriter
src/Co\SpecialChar \-
lorCode.h
\family default
 definiert.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
ContentAsLabel
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
0
\end_layout

\end_inset

,
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
1
\end_layout

\end_inset

] 
\lang english
Whether to use the content of the inset as the label, when the inset is
 closed.
 Default is false.
\end_layout

\begin_layout Description

\family typewriter
\series medium
CopyStyle
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Hiermit können Sie alle Optionen eines bereits definierten Layouts in das
 aktuelle kopieren.
\end_layout

\begin_layout Description

\family typewriter
\series medium
CustomPars
\begin_inset space ~
\end_inset

[
\emph on
0
\emph default
,
\begin_inset space ~
\end_inset

1]
\family default
\series default
 zeigt an, ob der Benutzer den Absatzeinstellungen-Dialog (
\begin_inset Graphics
	filename ../../images/layout-paragraph.png
	scale 70
	scaleBeforeRotation
	BoundingBox 0bp 6bp 20bp 20bp
	groupId Icon

\end_inset

) benutzen darf.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Decoration
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

kann 
\family typewriter
Classic
\family default
, 
\family typewriter
Minimalistic
\family default
 oder 
\family typewriter
Conglomerate
\family default
 sein.
 Es beschreibt den Rendering-Stil für den Einfügungsrahmen und die -knöpfe.
 Fußnoten benutzen im allgemeinen 
\family typewriter
Classic
\family default
, TeX-Code
\family typewriter
 Minimalistic
\family default
 und Buchstabenstile 
\family typewriter
Conglomerate
\family default
.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Display
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
0
\end_layout

\end_inset

,
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
1
\end_layout

\end_inset

] 
\lang english
Only useful if 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LatexType
\end_layout

\end_inset

 is 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Environment
\end_layout

\end_inset

.
 Indicates whether the environment will stand on its own in LaTeX output
 or will appear inline with the surrounding text.
 If set to false, it is supposed that the LaTeX environment ignores white
 space (including one newline character) after the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english

\backslash
begin{
\emph on
LatexName
\emph default
}
\end_layout

\end_inset

 and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english

\backslash
end{
\emph on
LatexName
\emph default
}
\end_layout

\end_inset

 tags.
 Default is true.
\end_layout

\begin_layout Description

\family typewriter
\series medium
End
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

beendet die 
\family typewriter
InsetLayout
\family default
-Definition.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Font
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

wird für den Text 
\emph on
und
\emph default
 die Marke benutzt (siehe 
\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Beschreibung-des-Zeichensatzes"

\end_inset

).
 Beachten Sie, dass die Definition dieses Fonts automatisch dem 
\family typewriter
LabelFont
\family default
 denselben Wert zuweist, das heißt 
\family typewriter
Font
\family default
 muss zuerst definiert werden und 
\family typewriter
LabelFont
\family default
 danach, wenn sie unterschiedlich sein sollen.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ForceLTR
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

erzwingt die 
\emph on
latex
\emph default
-Sprache und führt zu einer links-nach-rechts-Ausgabe (latin), zum Beispiel
 bei TeX-Code oder URL.
 Es ist eine Behelfslösung.
\end_layout

\begin_layout Description

\family typewriter
\series medium
ForcePlain
\begin_inset space ~
\end_inset

[
\emph on
0
\emph default
,
\begin_inset space ~
\end_inset

1]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

zeigt an, ob PlainLayout benutzt werden soll oder ob der Benutzer den Absatzstil
 der Einfügung ändern darf.
\end_layout

\begin_layout Description

\family typewriter
\series medium
FreeSpacing
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Normalerweise erlaubt es LyX nicht, mehr als ein Leerzeichen zwischen Wörtern
 einzufügen.
 Diese Eigenschaft kann in bestimmten Fällen umständ\SpecialChar \-
lich sein, zum Beispiel,
 wenn ein Programmcode eingegeben werden soll.
 In solchen Fällen kann 
\family typewriter
FreeSpacing
\family default
 auf 
\family typewriter
1
\family default
 gesetzt werden.
 LyX erzeugt in diesem Fall für jedes zusätzliche Leerzeichen ein geschütztes
 Leerzeichen, es sei denn, LyX befindet sich im LaTeX-Modus.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
HTML*
\end_layout

\end_inset

 
\lang english
These tags control XHTML output.
 See section 
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Tags-for-XHTML"

\end_inset

.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
InToc
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
0
\end_layout

\end_inset

,
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
1
\end_layout

\end_inset

] 
\lang english
Whether to include the contents of this inset in the strings generated for
 the `Outline' pane.
 One would not, for example, want the content of a footnote in a section
 header to be included in the TOC displayed in the outline, but one would
 normally want the content of a character style displayed.
 Default is false: not to include.
\end_layout

\begin_layout Description

\family typewriter
\series medium
KeepEmpty
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Normalerweise ist es in LyX nicht möglich, einen Absatz leer zu lassen,
 da das zu einer leeren LaTeX-Ausgabe führen würde.
 In manchen Fällen ist das aber durchaus gewünscht: So können beispielsweise
 in einer Briefvorlage die benötigten Felder leer voreingestellt werden,
 damit keiner vergisst, sie anzugeben.
 In anderen Klassen wird ein solcher Absatz als Unterbrechung verwendet,
 die keinen eigentlichen Text enthält.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelFont
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist der für die Marke benutze Font (siehe 
\begin_inset CommandInset ref
LatexCommand vref
reference "sub:Beschreibung-des-Zeichensatzes"

\end_inset

).
 Beachten Sie, dass diese Definition niemals vor 
\family typewriter
Font
\family default
 erscheinen darf, weil sie sonst unwirksam ist.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelString
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

wird auf dem Knopf und anderswo als Einfügungsmarke angezeigt.
 Einige Einfügungstypen (TeX-Code und Zweig) ändern diese Marke im Vo\SpecialChar \-
rü\SpecialChar \-
ber\SpecialChar \-
gehen.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LatexName
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist der Name des zugehörigen LaTeX-Stoffes, entweder der Umgebungs- oder
 Befehlsname.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LatexParam
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist ein optionaler Parameter für den zugehörigen 
\family typewriter
\series medium
LatexName
\family default
\series default
-Stoff, einschließ\SpecialChar \-
lich möglicher Klammerpaare wie 
\family typewriter
[]
\family default
.
 Dieser Parameter kann in LyX nicht geändert werden.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LatexType
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

[
\family typewriter
\emph on
Paragraph
\emph default
, Command, Environment, Item_Environment, 
\begin_inset Newline newline
\end_inset

List_Environment
\family default
]
\begin_inset Newline newline
\end_inset

Legt fest, wie das Layout in LaTeX überführt wird.
 
\end_layout

\begin_deeper
\begin_layout Description

\family typewriter
\series medium
Paragraph
\family default
\series default
 bewirkt nichts besonderes -- der Text wird als 
\emph on
normaler
\emph default
 
\emph on
Absatz
\emph default
 übernommen.
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
Command
\family default
\series default
 behandelt den Text als Argument eines LaTeX-Befehls (
\family typewriter
\emph on

\backslash
LatexBe\SpecialChar \-
fehl
\emph default
 {\SpecialChar \ldots{}
}
\family default
).
\end_layout

\begin_layout Description

\family typewriter
\series medium
Environment
\family default
\series default
 behandelt den Text als Kern einer LaTeX-Umgebung
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
LaTeX-Umgebung und LaTeX-Befehl sind hier etwas irreführend, denn diese
 Regeln gelten auch für SGML-Klassen.
 Schauen Sie sich am besten die SGML-Klassen-Dateien für Beispiele an.
\end_layout

\end_inset

 
\begin_inset Newline newline
\end_inset

(
\family typewriter

\backslash
begin{
\emph on
LatexUmgebung
\emph default
} \SpecialChar \ldots{}
 
\backslash
end{
\emph on
LatexUmgebung
\emph default
}
\family default
).
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
Item_Environment
\family default
\series default
 bewirkt dasselbe wie 
\family typewriter
Environment
\family default
, nur dass vor jedem Absatz ein 
\family typewriter

\backslash
item
\family default
 eingefügt wird.
 
\end_layout

\begin_layout Description

\family typewriter
\series medium
List_Environment
\family default
\series default
 funktioniert wie 
\family typewriter
Item_Environment
\family default
, nur dass
\family typewriter
 Label\SpecialChar \-
Width\SpecialChar \-
String
\family default
 als Argument an die Umgebung übergeben wird.

\family typewriter
 Label\SpecialChar \-
WidthString
\family default
 kann im Menü 
\family sans
Absatz-Einstellungen
\family default
 (
\family sans
Bearbeiten
\family default
\SpecialChar \menuseparator

\family sans
Absatz-Einstellungen
\family default
 
\begin_inset Marginal
status open

\begin_layout Plain Layout
\begin_inset Graphics
	filename ../../images/layout-paragraph.png
	BoundingBox 0bp 6bp 20bp 20bp

\end_inset


\end_layout

\end_inset

 definiert werden.
\end_layout

\end_deeper
\begin_layout Description

\family typewriter
\series medium
LyxType
\family default
\series default
 kann die Werte 
\family typewriter
charstyle
\family default
, 
\family typewriter
custom
\family default
, 
\family typewriter
element
\family default
 oder 
\family typewriter
end
\family default
 (zeigt das Ende einer Definition an).
 Dieser Eintrag wird für flexible Einfügungen benötigt und ist nur dort
 sinnvoll.
 Neben anderen Dingen legt er fest, in welchem Menü diese Einfügung erscheinen
 wird.
\end_layout

\begin_layout Description

\family typewriter
\series medium
MultiPar
\begin_inset space ~
\end_inset

[
\emph on
0
\emph default
,
\begin_inset space ~
\end_inset

1]
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

zeigt an, ob in dieser Einfügung mehrfache Absätze erlaubt sind.
 Dadurch wird 
\family typewriter
\series medium
CustomPars
\family default
\series default
 auf denselben Wert gesetzt und 
\family typewriter
\series medium
ForcePlain
\family default
\series default
 auf den anderen.
 Diese können auf andere Werte gesetzt werden, wenn sie 
\emph on
nach
\emph default
 
\family typewriter
\series medium
Multi\SpecialChar \-
Par
\family default
\series default
 benutzt werden.
\end_layout

\begin_layout Description

\family typewriter
\series medium
NeedProtect
\begin_inset space ~
\end_inset

[
\emph on
0
\emph default
,
\begin_inset space ~
\end_inset

1] 
\family default
\series default

\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

zeigt an, ob 
\emph on
zerbrechliche
\emph default
 Befehle in diesem Layout ge\SpecialChar \-
schützt (
\family typewriter

\backslash
protect
\family default
) werden sollen.
 Es zeigt 
\emph on
nicht
\emph default
 an, ob der Befehl selber geschützt werden soll.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
ParbreakIsNewline
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
0
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
1
\end_layout

\end_inset

] [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
0
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
1
\end_layout

\end_inset

] 
\lang english
Indicates that paragraphs will not be separated by an empty line in LaTeX
 output, but only by a line break; together with 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
PassThru 1
\end_layout

\end_inset

, this allows to emulate a plain text editor (like the ERT inset).
\end_layout

\begin_layout Description

\family typewriter
\series medium
PassThru
\begin_inset space ~
\end_inset

[
\emph on
0
\emph default
,
\begin_inset space ~
\end_inset

1] 
\family default
\series default

\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Legt fest, ob der Absatzinhalt unverändert ausgegeben werden soll, also
 ohne diverse von LaTeX benötigte Ersetzungen durchzuführen.
 Dies ersetzt in gewisser Weise das alte Zeichensatzattribut 
\family typewriter
LaTe
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X
\family default
.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Preamble\SpecialChar \ldots{}
EndPreamble
\family default
\series default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Eine Serie von Makrodefinitionen, die in die Präambel (vor 
\family typewriter

\backslash
begin{docu\SpecialChar \-
ment}
\family default
) eingefügt werden, falls dieses Layout benutzt wird.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
RefPrefix
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
string
\end_layout

\end_inset

] 
\lang english
The prefix to use when creating labels referring to insets of this type.
 This allows the use of formatted references.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Requires
\begin_inset space ~
\end_inset

[string] 
\family default
\series default

\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Legt fest, dass das Layout die Funktion 
\family typewriter
string
\family default
 benötigt.
 Sehen Sie sich auch die Beschreibung von 
\family typewriter
Provides
\family default

\begin_inset CommandInset ref
LatexCommand vpageref
reference "Provides"

\end_inset

 an.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
ResetsFont
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
0
\end_layout

\end_inset

,
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
1
\end_layout

\end_inset

] 
\lang english
Whether this inset should use the font of its surrounding environment or
 uses its own.
 Default is true: uses its own.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Spellcheck
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
0
\end_layout

\end_inset

,
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
1
\end_layout

\end_inset

] 
\lang english
Spellcheck the contents of this inset.
 Default is true.
\end_layout

\begin_layout Subsection
Zähler
\begin_inset CommandInset label
LatexCommand label
name "sub:Zähler"

\end_inset


\end_layout

\begin_layout Standard
Seit LyX-Version 1.3.0 ist es möglich und notwendig, Zähler (
\family typewriter
chapter
\family default
, 
\family typewriter
figure
\family default
,\SpecialChar \ldots{}
) in der Textklasse selber zu definieren.
 Die Standardzähler sind in der Datei 
\family typewriter
lib/
\begin_inset Newline linebreak
\end_inset

layouts/stdcounters.inc
\family default
 definiert, so dass Sie nur die Zeile
\end_layout

\begin_layout LyX-Code
Input stdcounters.inc
\end_layout

\begin_layout Standard
zu zu Ihrer Layout-Datei hinzufügen müssen, damit sie arbeiten.
 Aber wenn Sie eigene Zähler definieren wollen, können Sie das tun.
 Zähler-Deklarationen beginnen mit
\end_layout

\begin_layout LyX-Code
Counter name
\end_layout

\begin_layout Standard
wobei 
\family typewriter
name
\family default
 der Name Ihres Zählers ist.
 Die Deklaration endet mit
\end_layout

\begin_layout LyX-Code
End
\end_layout

\begin_layout Standard
Folgende Parameter können auch benutzt werden:
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelString
\begin_inset space ~
\end_inset

[string=""]
\family default
 
\series default

\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

definiert, wie der Zähler dargestellt wird.
 Hierdurch wird 
\family typewriter
LabelStringAp\SpecialChar \-
pen\SpecialChar \-
dix
\family default
 auf denselben Wert gesetzt.
 In der Zeichenkette können folgende Konstrukte benutzt werden:
\end_layout

\begin_layout Itemize

\family typewriter

\backslash
thecounter
\family default
 wird durch die Erweiterung von 
\family typewriter
LabelString
\family default
 (oder 
\family typewriter
Label\SpecialChar \-
StringAppendix
\family default
) des Zählers 
\family typewriter
counter
\family default
 ersetzt.
\end_layout

\begin_layout Itemize
Zählerwerte können durch LaTeX-ähnliche Makros wie 
\family typewriter
\emph on

\backslash
numbertype{coun\SpecialChar \-
ter}
\family default
\emph default
 ausgedrückt werden, wobei 
\family typewriter
\emph on
numbertype
\family default
\emph default
 folgendes sein kann:
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Genaugenommen ist die Situation etwas komplizierter: andere 
\emph on
numbertype
\emph default
 als die beschriebenen erzeugen arabische Zahlen.
 Wahrscheinlich wird sich das in Zukunft ändern.
\end_layout

\end_inset

 
\family typewriter
arabic
\family default
: 1, 2, 3,\SpecialChar \ldots{}
; 
\family typewriter
alph
\family default
 für Kleinbuchstaben: a, b, c,\SpecialChar \ldots{}
; 
\family typewriter
Alph
\family default
 für Großbuchstaben: A, B, C,\SpecialChar \ldots{}
; 
\family typewriter
roman
\family default
 für kleine römische Zahlen: i, ii, iii,\SpecialChar \ldots{}
; 
\family typewriter
Roman
\family default
 für große römische Zahlen: I, II, III,\SpecialChar \ldots{}
; 
\family typewriter
hebrew
\family default
 für hebräische Zahlen.
\end_layout

\begin_layout Standard
Wenn 
\family typewriter
LabelString
\family default
 nicht definiert ist, wird ein Standardwert wie folgt benutzt: wenn der
 Zähler einen Hauptzähler 
\emph on
master
\emph default
 (über 
\family typewriter
Within
\family default
 definiert) hat, wird 
\family typewriter

\backslash
themaster.
\backslash
arabic{counter}
\family default
 benutzt, sonst 
\family typewriter

\backslash
arabic{counter}
\family default
.
\end_layout

\begin_layout Description

\family typewriter
\series medium
LabelStringAppendix
\begin_inset space ~
\end_inset

[string=""]
\family default
 
\series default

\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

ist dasselbe wie 
\family typewriter
\series medium
LabelString
\family default
\series default
, wird aber in Anhängen benutzt.
\end_layout

\begin_layout Description

\family typewriter
\series medium
Within
\begin_inset space ~
\end_inset

[string=""]
\family default
 
\begin_inset space ~
\end_inset


\begin_inset Newline newline
\end_inset

Wenn dies auf den Namen eines anderen Zählers gesetzt wird, wird der gegenwärtig
e Zähler jedesmal zurückgesetzt, wenn der andere erhöht wird.
 Zum Beispiel wird 
\family typewriter
\series default
subsection
\family default
\series medium
 innerhalb 
\family typewriter
\series default
section
\family default
\series medium
 nummeriert.
\end_layout

\begin_layout Subsection
Beschreibung des Zeichensatzes
\begin_inset CommandInset label
LatexCommand label
name "sub:Beschreibung-des-Zeichensatzes"

\end_inset


\end_layout

\begin_layout Standard
Eine Zeichensatzbeschreibung sieht folgendermaßen aus:
\end_layout

\begin_layout LyX-Code
Font 
\family roman
\emph on
oder
\family default
\emph default
 LabelFont
\end_layout

\begin_layout LyX-Code
 ...
\end_layout

\begin_layout LyX-Code
EndFont
\end_layout

\begin_layout Standard
und es sind folgende Befehle vorhanden:
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Color
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
none
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
black
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
white
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
red
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
green
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
blue
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
cyan
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
magenta
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
yellow
\end_layout

\end_inset

]
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Family
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Roman
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Sans
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Typewriter
\end_layout

\end_inset

]
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Misc
\end_layout

\end_inset

 
\lang english
[
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] Valid arguments are: 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
emph
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
noun
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
strikeout
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
underbar
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
uuline
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
uwave
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
no_emph
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
no_noun
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
no_strikeout
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
no_bar
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
no_uuline
\end_layout

\end_inset

 and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
no_uwave
\end_layout

\end_inset

.
 Each of these turns on or off the corresponding attribute.
 For example, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
emph
\end_layout

\end_inset

 turns on emphasis, and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
no_emph
\end_layout

\end_inset

 turns it off.
 
\begin_inset Newline newline
\end_inset

If the latter seems puzzling, remember that the font settings for the present
 context are generally inherited from the surrounding context.
 So 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
no_emph
\end_layout

\end_inset

 would turn off the emphasis that was anyway in effect, say, in a theorem
 environment.
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Series
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Medium
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Bold
\end_layout

\end_inset

] 
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Shape
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Up
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Italic
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
SmallCaps
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Slanted
\end_layout

\end_inset

] 
\end_layout

\begin_layout Description
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
Size
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
tiny
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
small
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
normal
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
large
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
larger
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
largest
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
huge
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout
giant
\end_layout

\end_inset

]
\end_layout

\begin_layout Subsection

\lang english
\begin_inset CommandInset label
LatexCommand label
name "sub:Citation-format-description"

\end_inset

Citation format description
\end_layout

\begin_layout Standard

\lang english
The 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
CiteFormat
\end_layout

\end_inset

 blocks are used to describe how bibliographic information should be displayed,
 both within LyX itself (in the citation dialog and in tooltips, for example)
 and in XHTML output.
 Such a block might look like this:
\end_layout

\begin_layout LyX-Code
CiteFormat
\end_layout

\begin_layout LyX-Code
 article ...
\end_layout

\begin_layout LyX-Code
 book ...
\end_layout

\begin_layout LyX-Code
End
\end_layout

\begin_layout Standard

\lang english
The individual lines define how the bibliographic information associated
 with an article or book, respectively, is to be displayed, and such a definitio
n can be given for any `entry type' that might be present in a BibTeX file.
 LyX defines a default format in the source code that will be used if no
 specific definition has been given.
 LyX predefines several formats in the file 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
stdciteformats.inc
\end_layout

\end_inset

, which is included in most of LyX's document classes.
\end_layout

\begin_layout Standard

\lang english
The definitions use a simple language that allows BibTeX keys to be replaced
 with their values.
 Keys should be enclosed in 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
%
\end_layout

\end_inset

 signs, e.g.: 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
%author%
\end_layout

\end_inset

.
 So a simple definition might look like this:
\end_layout

\begin_layout LyX-Code
misc %author%, 
\begin_inset Quotes eld
\end_inset

%title
\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Standard

\lang english
This would print the author, followed by a comma, followed by the title,
 in quotes, followed by a period.
\end_layout

\begin_layout Standard

\lang english
Of course, sometimes you may want to print a key only if it exists.
 This can be done by using a conditional construction, such as: 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
{%volume%[[vol.
\begin_inset space ~
\end_inset

%volume%]]}
\end_layout

\end_inset

.
 This says: If the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
volume
\end_layout

\end_inset

 key exists, then print 
\begin_inset Quotes eld
\end_inset

vol.
\begin_inset space ~
\end_inset


\begin_inset Quotes erd
\end_inset

 followed by the volume key.
 It is also possible to have an else clause in the conditional, such as:
 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
{%author%[[%author%]][[%editor%, ed.]]}
\end_layout

\end_inset

.
 Here, the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
author
\end_layout

\end_inset

 key is printed if it exists; otherwise, the editor key is printed, followed
 by 
\begin_inset Quotes eld
\end_inset

,
\begin_inset space ~
\end_inset

ed.
\begin_inset Quotes erd
\end_inset

 Note that the key is again enclosed in 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
%
\end_layout

\end_inset

 signs; the entire conditional is enclosed in braces; and the if and else
 clauses are enclosed in double brackets, 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
[[
\end_layout

\end_inset


\begin_inset Quotes eld
\end_inset

 and 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
]]
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
 There must be no space between any of these.
\end_layout

\begin_layout Standard

\lang english
There is one other piece of syntax available in definitions, which looks
 like this: 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
{!<i>!}
\end_layout

\end_inset

.
 This defines a piece of formatting information that is to be used when
 creating 
\begin_inset Quotes eld
\end_inset

rich text
\begin_inset Quotes erd
\end_inset

.
 Obviously, we do not want to output HTML tags when writing plain text,
 so they should be wrapped in 
\begin_inset Quotes eld
\end_inset

{!
\begin_inset Quotes erd
\end_inset

 and 
\begin_inset Quotes eld
\end_inset

!}
\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Standard

\lang english
Two special sorts of definitions are also possible in a 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
CiteFormat
\end_layout

\end_inset

 block.
 An example of the first would be:
\end_layout

\begin_layout LyX-Code
!quotetitle 
\begin_inset Quotes eld
\end_inset

%title%
\begin_inset Quotes erd
\end_inset


\end_layout

\begin_layout Standard

\lang english
This is an abbreviation, or macro, and it can be used by treating it as
 if it were a key: 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
%!quotetitle%
\end_layout

\end_inset

.
 LyX will treat 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
%!quotetitle%
\end_layout

\end_inset

 exactly as it would treat its definition.
 So, let us issue the obvious 
\emph on
warning
\emph default
.
 Do not do this:
\end_layout

\begin_layout LyX-Code
!funfun %funfun%
\end_layout

\begin_layout Standard

\lang english
or anything like it.
 LyX shouldn't go into an infinite loop, but it may go into a long one before
 it gives up.
\end_layout

\begin_layout Standard

\lang english
The second sort of special definition might look like this:
\end_layout

\begin_layout LyX-Code
_pptext pp.
\end_layout

\begin_layout Standard

\lang english
This defines a translatable piece of text, which allows relevant parts of
 the bibliography to be translated.
 It can be included in a definition by treating it as a key: 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
%_pptext%
\end_layout

\end_inset

.
 Several of these are predefined in 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
stdciteformats.inc
\end_layout

\end_inset

.
 Note that these are not macros, in the sense just defined.
 They will not be expanded.
\end_layout

\begin_layout Standard

\lang english
So here then is an example that use all these features:
\end_layout

\begin_layout LyX-Code
!authoredit {%author%[[%author%, ]][[{%editor%[[%editor%, %_edtext%, ]]}]]}
\end_layout

\begin_layout Standard

\lang english
This defines a macro that prints the author, followed by a comma, if the
 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
author
\end_layout

\end_inset

 key is defined, or else prints the name of the editor, followed by the
 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
_edtext
\end_layout

\end_inset

 or its translation (it is by default 
\begin_inset Quotes eld
\end_inset

ed.
\begin_inset Quotes erd
\end_inset

), if the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
editor
\end_layout

\end_inset

 key is defined.
 Note that this is in fact defined in 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
stdciteformats.inc
\end_layout

\end_inset

, so you can use it in your own definitions, or re-definitions, if you load
 that file first.
\end_layout

\begin_layout Section

\lang english
\begin_inset CommandInset label
LatexCommand label
name "sec:Tags-for-XHTML"

\end_inset

Tags for XHTML output
\end_layout

\begin_layout Standard

\lang english
As with LaTeX or DocBook, the format of LyX's XHTML output is also controlled
 by layout information.
 In general, LyX provides sensible defaults and, as mentioned earlier, it
 will even construct default CSS style rules from the other layout tags.
 For example, LyX will attempt to use the information provided in the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Font
\end_layout

\end_inset

 declaration for the Chapter style to write CSS that will appropriately
 format chapter headings.
\end_layout

\begin_layout Standard

\lang english
In many cases, then, you may not have to do anything at all to get acceptable
 XHTML output for your own environments, custom insets, and so forth.
 But in some cases you will, and so LyX provides a number of layout tags
 that can be used to customize the XHTML and CSS that are generated.
\end_layout

\begin_layout Standard

\lang english
Note that there are two tags, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLPreamble
\end_layout

\end_inset

 and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
AddToHTMLPreamble
\end_layout

\end_inset

 that may appear outside style and inset declarations.
 See 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Allgemeine-Parameter-für"

\end_inset

 for details on these.
\end_layout

\begin_layout Subsection

\lang english
\begin_inset CommandInset label
LatexCommand label
name "sub:Paragraph-Style-XHTML"

\end_inset

Paragraph styles
\end_layout

\begin_layout Standard

\lang english
The sort of XHTML LyX outputs for a paragraph depends upon whether we are
 dealing with a normal paragraph, a command, or an environment, where this
 is itself determined by the contents of the corresponding 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LaTeXType
\end_layout

\end_inset

 tag.
 
\end_layout

\begin_layout Standard

\lang english
For a command or normal paragraph, the output XHTML has the following form:
\end_layout

\begin_layout LyX-Code

\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>
\end_layout

\begin_layout LyX-Code

\lang english
<labeltag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>Label</labeltag>
\end_layout

\begin_layout LyX-Code

\lang english
Contents of the paragraph.
\end_layout

\begin_layout LyX-Code

\lang english
</tag>
\end_layout

\begin_layout Standard

\lang english
The label tags are of course omitted if the paragraph does not have a label.
\end_layout

\begin_layout Standard

\lang english
For an environment that is not some sort of list, the XHTML takes this form:
\end_layout

\begin_layout LyX-Code

\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>
\end_layout

\begin_layout LyX-Code

\lang english
<itemtag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

><labeltag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>Environment Label</labeltag>First paragraph.</itemtag>
\end_layout

\begin_layout LyX-Code

\lang english
<itemtag>Second paragraph.</itemtag>
\end_layout

\begin_layout LyX-Code

\lang english
</tag>
\end_layout

\begin_layout Standard

\lang english
Note that the label is output only for the first paragraph, as it should
 be for a theorem, for example.
 
\end_layout

\begin_layout Standard

\lang english
For a list, we have one of these forms:
\end_layout

\begin_layout LyX-Code

\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>
\end_layout

\begin_layout LyX-Code

\lang english
<itemtag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

><labeltag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>List Label</labeltag>First item.</itemtag>
\end_layout

\begin_layout LyX-Code

\lang english
<itemtag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

><labeltag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>List Label</labeltag>Second item.</itemtag>
\end_layout

\begin_layout LyX-Code

\lang english
</tag>
\end_layout

\begin_layout LyX-Code

\end_layout

\begin_layout LyX-Code

\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>
\end_layout

\begin_layout LyX-Code

\lang english
<labeltag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>List Label</labeltag><itemtag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>First item.</itemtag>
\end_layout

\begin_layout LyX-Code

\lang english
<labeltag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>List Label</labeltag><itemtag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>Second item.</itemtag>
\end_layout

\begin_layout LyX-Code

\lang english
</tag>
\end_layout

\begin_layout Standard

\lang english
Note the different orders of 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
labeltag
\end_layout

\end_inset

 and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
itemtag
\end_layout

\end_inset

.
 Which order we get depends upon the setting of 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLLabelFirst
\end_layout

\end_inset

: If 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLLabelFirst
\end_layout

\end_inset

 is false (the default), you get the first of these, with the label within
 the item; if true, you get the second, with the label outside the item.
\end_layout

\begin_layout Standard

\lang english
The specific tags and attributes output for each paragraph type can be controlle
d by means of the layout tags we are about to describe.
 As mentioned earlier, however, LyX uses sensible defaults for many of these,
 so you often may not need to do very much to get good XHTML output.
 Think of the available tags as there so you can tweak things to your liking.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLAttr
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] Specifies attribute information to be output with the main tag.
 For example, 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
class=`mydiv'
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
 By default, LyX will output 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
class=`layoutname'
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

, where 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
layoutname
\end_layout

\end_inset

 is the LyX name of the layout, made lowercase, for example: chapter.
 This should 
\emph on
not
\emph default
 contain any style information.
 Use 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLStyle
\end_layout

\end_inset

 for that purpose.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLForceCSS
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\emph on
\lang english
0
\emph default
,1
\end_layout

\end_inset

] Whether to output the default CSS information LyX generates for this layout,
 even if additional information is explicitly provided via 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLStyle
\end_layout

\end_inset

.
 Setting this to 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
1
\end_layout

\end_inset

 allows you to alter or augment the generated CSS, rather than to override
 it completely.
 Default is 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
0
\end_layout

\end_inset

.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLItem
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] The tag to be used for individual paragraphs of environments, replacing
 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
itemtag
\end_layout

\end_inset

 in the examples above.
 Defaults to 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
div
\end_layout

\end_inset

.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLItemAttr
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] Attributes for the item tag.
 Defaults to 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
class=`layoutname_item'
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
 This should 
\emph on
not
\emph default
 contain any style information.
 Use 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLStyle
\end_layout

\end_inset

 for that purpose.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLLabel
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] The tag to be used for paragraph and item labels, replacing 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
labeltag
\end_layout

\end_inset

 in the examples above.
 Defaults to 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
span
\end_layout

\end_inset

, unless 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
LabelType
\end_layout

\end_inset

 is either 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Top_Environment
\end_layout

\end_inset

 or 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Centered_Top_Environment
\end_layout

\end_inset

, in which case it defaults to 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
div
\end_layout

\end_inset

.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLLabelAttr
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] Attributes for the label tag.
 Defaults to 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
class=`layoutname_label'
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
 This should 
\emph on
not
\emph default
 contain any style information.
 Use 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLStyle
\end_layout

\end_inset

 for that purpose.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLLabelFirst
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\emph on
\lang english
0
\emph default
,1
\end_layout

\end_inset

] Meaningful only for list-like environments, this tag controls whether
 the label tag is output before or inside the item tag.
 This is used, for example, in the description environment, where we want
 `
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<dt>\SpecialChar \ldots{}
</dt><dd>\SpecialChar \ldots{}
</dd>
\end_layout

\end_inset

.
 Default is 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
0
\end_layout

\end_inset

: The label tag is output inside the item tag.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLPreamble
\end_layout

\end_inset

 Information to be output in the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<head>
\end_layout

\end_inset

 section when this style is used.
 This might, for example, be used to include a 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<script>
\end_layout

\end_inset

 block defining an 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
onclick
\end_layout

\end_inset

 handler.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLStyle
\end_layout

\end_inset

 CSS style information to be included when this style is used.
 Note that this will automatically be wrapped in a layout-generated 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<style>
\end_layout

\end_inset

 block, so only the CSS itself need be included.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLTag
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] The tag to be used for the main label, replacing 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
tag
\end_layout

\end_inset

 in the examples above.
 Defaults to 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
div
\end_layout

\end_inset

.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLTitle
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\emph on
\lang english
0
\emph default
,1
\end_layout

\end_inset

] Marks this style as the one to be used to generate the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<title>
\end_layout

\end_inset

 tag for the XHTML file.
 By default, it is false.
 The 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
stdtitle.inc
\end_layout

\end_inset

 file sets it to true for the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
title
\end_layout

\end_inset

 environment.
 
\end_layout

\begin_layout Subsection

\lang english
InsetLayout XHTML
\end_layout

\begin_layout Standard

\lang english
The XHTML output of insets can also be controlled by information in layout
 files.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout

\lang english
At present, this is true only for 
\begin_inset Quotes eld
\end_inset

text
\begin_inset Quotes erd
\end_inset

 insets (insets you can type into) and is not true for 
\begin_inset Quotes eld
\end_inset

command
\begin_inset Quotes erd
\end_inset

 insets (insets that are associated with dialog boxes).
\end_layout

\end_inset

 Here, too, LyX tries to provide sensible defaults, and it constructs default
 CSS style rules.
 But everything can be customized.
\end_layout

\begin_layout Standard

\lang english
The XHTML LyX outputs for an inset has the following form:
\end_layout

\begin_layout LyX-Code

\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>
\end_layout

\begin_layout LyX-Code

\lang english
<labeltag>Label</labeltag>
\end_layout

\begin_layout LyX-Code

\lang english
<innertag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>Contents of the inset.</innertag>
\end_layout

\begin_layout LyX-Code

\lang english
</tag>
\end_layout

\begin_layout Standard

\lang english
If the inset permits multiple paragraphs---that is, if 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
MultiPar
\end_layout

\end_inset

 is true---then the contents of the inset will itself be output as paragraphs
 formatted according to the styles used for those paragraphs (standard,
 quote, and the like).
 The label tag is of course omitted if the paragraph does not have a label
 and, at present, is always 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
span
\end_layout

\end_inset

.
 The inner tag is optional and, by default, does not appear.
\end_layout

\begin_layout Standard

\lang english
The specific tags and attributes output for each inset can be controlled
 by means of the following layout tags.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLAttr
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] Specifies attribute information to be output with the main tag.
 For example, 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
class=`myinset' onclick=`\SpecialChar \ldots{}
'
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
 By default, LyX will output 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
class=`insetname'
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

, where 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
insetname
\end_layout

\end_inset

 is the LyX name of the inset, made lowercase and with non-alphanumeric
 characters converted to underscores, for example: footnote.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLForceCSS
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\emph on
\lang english
0
\emph default
,1
\end_layout

\end_inset

] Whether to output the default CSS information LyX generates for this layout,
 even if additional information is explicitly provided via 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLStyle
\end_layout

\end_inset

.
 Setting this to 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
1
\end_layout

\end_inset

 allows you to alter or augment the generated CSS, rather than to override
 it completely.
 Default is 0.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLInnerAttr
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] Attributes for the inner tag.
 Defaults to 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
class=`insetname_inner'
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLInnerTag
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] The inner tag, replacing 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
innertag
\end_layout

\end_inset

 in the examples above.
 By default, there is none.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLIsBlock
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
0,
\emph on
1
\end_layout

\end_inset

] Whether this inset represents a standalone block of text (such as a footnote)
 or instead represents material that is included in the surrounding text
 (such as a branch).
 Defaults to 1.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLLabel
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] A label for this inset, possibly including a reference to a counter.
 For example, for footnote, it might be: 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english

\backslash
arabic{footnote}
\end_layout

\end_inset

.
 This is optional, and there is no default.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLPreamble
\end_layout

\end_inset

 Information to be output in the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<head>
\end_layout

\end_inset

 section when this style is used.
 This might, for example, be used to include a 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<script>
\end_layout

\end_inset

 block defining an 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
onclick
\end_layout

\end_inset

 handler.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLStyle
\end_layout

\end_inset

 CSS style information to be included when this style is used.
 Note that this will automatically be wrapped in a layout-generated 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<style>
\end_layout

\end_inset

 block, so only the CSS itself need be included.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLTag
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] The tag to be used for the main label, replacing 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
tag
\end_layout

\end_inset

 in the examples above.
 The default depends upon the setting of 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
MultiPar
\end_layout

\end_inset

: If 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
MultiPar
\end_layout

\end_inset

 is true, the default is 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
div
\end_layout

\end_inset

; if it is false, the default is 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
span
\end_layout

\end_inset

.
\end_layout

\begin_layout Subsection

\lang english
Float XHTML
\end_layout

\begin_layout Standard

\lang english
The XHTML output for floats too can be controlled by layout information.
 The output has the following form:
\end_layout

\begin_layout LyX-Code

\lang english
<tag attr=
\begin_inset Quotes erd
\end_inset

value
\begin_inset Quotes erd
\end_inset

>
\end_layout

\begin_layout LyX-Code

\lang english
Contents of the float.
\end_layout

\begin_layout LyX-Code

\lang english
</tag>
\end_layout

\begin_layout Standard

\lang english
The caption, if there is one, is a separate inset and will be output as
 such.
 Its appearance can be controlled via the InsetLayout for caption insets.
 
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLAttr
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] Specifies attribute information to be output with the main tag.
 For example, 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
class=`myfloat' onclick=`\SpecialChar \ldots{}
'
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
 By default, LyX will output 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
class=`float float-floattype'
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

, where 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
floattype
\end_layout

\end_inset

 is LyX's name for this type of float, as determined by the float declaration
 (see 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Gleitobjekte"

\end_inset

), though made lowercase and with non-alphanumeric characters converted
 to underscores, for example: float-table.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLStyle
\end_layout

\end_inset

 CSS style information to be included when this float is used.
 Note that this will automatically be wrapped in a layout-generated 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
<style>
\end_layout

\end_inset

 block, so only the CSS itself need be included.
\end_layout

\begin_layout Description

\lang english
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
HTMLTag
\end_layout

\end_inset

 [
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
string
\end_layout

\end_inset

] The tag to be used for this float, replacing 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
tag
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

 in the example above.
 The default is 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
div
\end_layout

\end_inset

 and will rarely need changing.
\end_layout

\begin_layout Subsection

\lang english
Bibliography formatting
\end_layout

\begin_layout Standard

\lang english
The bibliography can be formatted using 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
CiteFormat
\end_layout

\end_inset

 blocks.
 See Section 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Citation-format-description"

\end_inset

 for the details.
\end_layout

\begin_layout Subsection

\lang english
LyX-generated CSS
\end_layout

\begin_layout Standard

\lang english
We have several times mentioned that LyX will generate default CSS style
 rules for both insets and paragraph styles, based upon the other layout
 information that is provided.
 In this section, we shall say a word about which layout information LyX
 uses and how.
\end_layout

\begin_layout Standard

\lang english
At present, LyX auto-generates CSS only for font information, making use
 of the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Family
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Series
\end_layout

\end_inset

, 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Shape
\end_layout

\end_inset

, and 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Size
\end_layout

\end_inset

 specified in the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Font
\end_layout

\end_inset

 declaration.
 (See 
\begin_inset CommandInset ref
LatexCommand ref
reference "sub:Beschreibung-des-Zeichensatzes"

\end_inset

.) The translation is mostly straightforward and obvious.
 For example, 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
Family Sans
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

 becomes 
\begin_inset Quotes eld
\end_inset


\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
font-family: sans-serif;
\end_layout

\end_inset


\begin_inset Quotes erd
\end_inset

.
 The correspondence of LyX sizes and CSS sizes is a little less obvious
 but nonetheless intuitive.
 See the 
\begin_inset Flex Code
status collapsed

\begin_layout Plain Layout

\lang english
getSizeCSS()
\end_layout

\end_inset

 function in 
\begin_inset Flex URL
status collapsed

\begin_layout Plain Layout

src/FontInfo.cpp
\end_layout

\end_inset

 for the details.
\end_layout

\begin_layout Chapter
Externes Material einfügen
\begin_inset CommandInset label
LatexCommand label
name "cha:Externes-Material-einfügen"

\end_inset


\end_layout

\begin_layout Section
Hintergrund
\end_layout

\begin_layout Standard
Einer der am häufigsten geäußerten Wünsche der LyX-Benutzer ist die Möglichkeit
 einer Schnittstelle zwischen LyX und XFig, Dia oder ähnlichen Anwendungsprogram
men, die darauf spezialisiert sind, spezielle Diagramme, Abbildungen oder
 ähnliches zum Einbinden in Dokumente zu erstellen.
 Bislang war es lediglich möglich, statische, festgelegte Abbildungen über
 das normale Grafik-Inset einzubinden, jedoch hat dieser Ansatz einige Einschrän
kungen:
\end_layout

\begin_layout Itemize
Wenn Sie die Abbildung ändern wollen, müssen Sie extra von Hand das entsprechend
e Programm starten.
\end_layout

\begin_layout Itemize
LyX merkt nicht, dass Sie die Abbildung geändert haben, und die Darstellung
 am Bildschirm wird schnell veraltet; dies wird noch durch die fehlende
 Möglichkeit, die Anzeige zu aktualisieren, erschwert.
\end_layout

\begin_layout Itemize
Das Grafik-Inset kann nicht mit unterschiedlichen Export-Formaten wie DocBook,
 HTML oder ASCII umgehen.
\end_layout

\begin_layout Standard
Die Einfügung 
\family sans
Externes
\begin_inset space \space{}
\end_inset

Material
\family default
 ist der Versuch, diese Probleme zu lösen.
\begin_inset Foot
status collapsed

\begin_layout Plain Layout
Auch wenn das alte Grafik-Inset einige Mängel hat, so ist es dennoch sehr
 wertvoll, denn es bietet eine Anzeige der Grafik sowie die Möglichkeit
 zu geometrischen Transformationen über eine komfortable Benutzerschnittstelle.
 
\end_layout

\end_inset

 Dies wird erreicht, indem eine abstrahierte Methode der Interaktion zwischen
 LyX und einer externen Anwendung definiert wird.
 Anstatt also eine lange Liste von Einfügungen für alle möglichen Arten
 von Material anzubieten, haben wir auf die Darstellung in LyX verzichtet
 und dafür die Möglichkeit geschaffen, einen sehr weiten Bereich von Anwendungen
 abzudecken.
\end_layout

\begin_layout Standard
Das Ergebnis ist eben genau diese Einfügung 
\family sans
Externes
\begin_inset space \space{}
\end_inset

Material
\family default
.
 Eine solche Einfügung erscheint im LyX-Dokument lediglich als einfache
 Schaltfläche, aber lassen Sie sich dadurch nicht täuschen.
 Wenn Sie darauf klicken, erscheint ein Dialog, in dem Sie genau festlegen
 können, welche Art von Material Sie einbinden wollen.
 Und in den folgenden Abschnitten werden Sie lernen, wie Sie damit all die
 oben aufgezeigten Probleme umgehen können und einiges mehr.
\end_layout

\begin_layout Section
Wie funktioniert das?
\end_layout

\begin_layout Standard
Die Einfügung 
\family sans
Externes
\begin_inset space \space{}
\end_inset

Material
\family default
 basiert auf dem Konzept der Vorlage.
 Eine solche Vorlage ist eine Spezifikation, wie LyX mit einer bestimmten
 Sorte von Material umgehen soll.
 Derzeit gehören zu LyX derartige Vorlagen für XFig-Abbildungen, Dia-Diagramme,
 diverse Abbildungen im Rasterformat, Gnuplot und noch ein paar mehr.
 Die vollständige Liste sehen Sie in 
\family sans
Einfügen\SpecialChar \menuseparator
Datei\SpecialChar \menuseparator
Externes
\begin_inset space \space{}
\end_inset

Material
\family default
.
\end_layout

\begin_layout Standard
Darüberhinaus ist es möglich, durch eigene Vorlagen beliebige andere Formate
 einzubinden.
 Wir werden weiter unten beschreiben, was genau Sie dazu machen müssen und
 hoffen, dass Sie derartig erstellte Vorlagen an das LyX-Team schicken,
 damit sie in kommenden LyX-Versionen integriert werden können.
\end_layout

\begin_layout Standard
Ein weiteres Merkmal der Idee der externen Einfügung ist die Unterscheidung
 zwischen der ursprünglichen Datei, die als Grundlage für das eingefügte
 Material dient, und der erzeugten Datei, die dann letztendlich in Ihr Dokument
 eingebunden wird.
 Wir wollen dies am Beispiel einer XFig-Abbildung erläutern.
\end_layout

\begin_layout Standard
Das Programm XFig bearbeitet eine speziell formatierte Datei mit der Endung
 
\family typewriter
.fig
\family default
.
 In XFig können Sie Ihre Abbildung editieren und ändern, und zum Schluss
 speichern Sie diese 
\family typewriter
.fig
\family default
-Datei.
 Wenn Sie nun eine derartige Abbildung in LyX einbinden wollen, müssen Sie
 zunächst 
\family typewriter
transfig
\family default
 starten, um eine PostScript-Datei zu erzeugen, die von LaTeX eingebunden
 werden kann.
 In diesem Fall ist also die 
\family typewriter
.fig
\family default
-Datei die oben erwähnte Originaldatei, und die 
\family typewriter
.ps-
\family default
Datei die tatsächlich eingebundene Datei.
\end_layout

\begin_layout Standard
Diese Unterscheidung ist wichtig, denn Sie erlaubt das einfache Ändern und
 Aktualisieren des Materials, während Sie an Ihrem Text schreiben.
 Außerdem ist erst so die Flexibilität gegeben, die benötigt wird, um unterschie
dliche Exportformate für die LyX-Datei zu ermöglichen.
\end_layout

\begin_layout Standard
So ist es im Falle einer Ausgabe als reiner (ASCII) Text sicher nicht sinnvoll,
 eine PostScript-Datei im Rohformat einzubinden.
 In diesem Fall wird dann entweder nur eine Referenz auf die Bilddatei angegeben
, oder aber es wird ein Konverter gestartet, der eine ASCII-Darstellung
 erzeugt, die in etwa so aussieht wie die ursprüngliche Grafik.
 Genau dies ist mit der Einfügung 
\family sans
Externes Material
\family default
 möglich, denn sie kennt all die notwendigen Befehle für derartige Konvertierung
en (sofern sie von LyX unterstützt werden).
\end_layout

\begin_layout Standard
Darüberhinaus erlaubt die Einfügung 
\family sans
Externes Material
\family default
 aber auch die einfache Integration mit externen Betrachtern und Editoren.
 So sind Sie bei einer XFig-Abbildung in der Lage, mit einem einigen Klick
 XFig zu starten, um die Abbildung zu bearbeiten oder die erstellte PostScript-D
atei mit 
\family typewriter
ghostview
\family default
 zu betrachten.
 Kein langes Herumsuchen mit Dateimanagern nach den Original- und Grafikdateien
 mehr, und Sie müssen sich nicht mehr an die unterschiedlichen Parameter
 erinnern, die vielleicht für diese Abbildung notwendig sind, um sie in
 der richtigen Größe zu erstellen.
 Sie haben ohne viel Aufwand Zugriff auf eine Vielzahl von Applikationen
 und können so Ihre Produktivität ungemein steigern.
\end_layout

\begin_layout Standard
LyX besitzt also die Information über eine Vielzahl von externen Programmen,
 um diese von Ihnen unbemerkt nutzen zu können und Ihnen so den größtmöglichen
 Komfort zu bieten.
 Und genau diese Information ist in den oben erwähnten Vorlagen gespeichert.
 Jede dieser Vorlagen enthält eine Liste von Befehlen und Optionen, um externe
 Programme zu starten, Formate zu konvertieren usw\SpecialChar \@.

\end_layout

\begin_layout Standard
Ein fortgeschrittener Anwender kann mit derartigen selbst erstellten Vorlagen
 die Möglichkeiten von LyX stark erweitern, ohne dazu den eigentlichen Quellcode
 verändern zu müssen.
 Zwar ist dazu einiges an Arbeit notwendig, um all diese Befehle festzulegen,
 aber zum Glück hat das LyX-Team das in einigen Fällen ja schon getan.
\end_layout

\begin_layout Standard
Eine kleine Einschränkung gibt es aber doch: Da es wie erwähnt eine Vielzahl
 möglicher Exportformate für das eingefügte Material gibt, wäre es zu vermuten,
 dass man von LyX aus auch alle diese Formate als Vorschau ansehen kann.
 Das LyX-Team hat sich entschlossen, das nicht zu tun, um die Benutzerschnittste
lle so einfach wie möglich zu halten.
 Anstatt im Dialog für jedes mögliche Exportformat einen eigenen Knopf für
 die Vorschau zu haben, wurde das Konzept des primären Formats eingeführt,
 und es gibt nur einen Schalter 
\family sans
in
\begin_inset space \space{}
\end_inset

Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X
\begin_inset space \space{}
\end_inset

anzeigen
\family default
, der die Datei in genau diesem primären Format anzeigt.
\end_layout

\begin_layout Standard
Dieses Format wird durch die verwendete Dokumentenklasse festgelegt.
 So ist es für die meisten Klassen LaTeX, für die DocBook-Klassen ist es
 aber DocBook.
 Denken Sie also daran, dass Ihnen die Vorschau lediglich das Aussehen in
 diesem Hauptformat anzeigt; wenn Sie sehen wollen, wie das Ergebnis in
 anderen Formaten aussieht, müssen Sie wie gewohnt die Konvertierung manuell
 durchführen.
\end_layout

\begin_layout Section
Der Dialog 
\family sans
Externes Material
\end_layout

\begin_layout Standard
Eine Externe Einfügung wird vom Menü 
\family sans
Einfügen
\family default
\SpecialChar \menuseparator

\family sans
Datei
\family default
\SpecialChar \menuseparator

\family sans
Externes
\family default

\begin_inset space \space{}
\end_inset


\family sans
Material
\family default
\SpecialChar \ldots{}
 aus aufgerufen.
 Es wird dann der Dialog 
\family sans
Externes
\begin_inset space \space{}
\end_inset

Material
\family default
 geöffnet.
 In diesem Dialog können Sie genau festlegen, welche Art von Material Sie
 einbinden wollen, und auch wie das geschehen soll.
 Darüberhinaus können Sie über diesen Dialog die externen Bearbeitungsprogramme
 und Betrachter starten.
\end_layout

\begin_layout Standard
Auf der Karteikarte 
\family sans
Datei
\family default
 befindet sich zunächst ein Fenster 
\family sans
Datei:
\family default
, in das Sie einen Dateinamen direkt oder über 
\family sans
Durchsuchen
\family default
\SpecialChar \ldots{}
 eingeben können.
 Da die tatsächlich eingebundene Datei bei Bedarf automatisch erstellt wird,
 besteht kein Grund, hierfür auch ein Dialogfeld anzulegen.
 Darunter ist ein Schalter 
\family sans
Datei
\begin_inset space \space{}
\end_inset

bearbeiten\SpecialChar \ldots{}

\family default
, mit dem ein Bearbeitungsprogramm für die eingegebene Datei aufgerufen
 werden kann.
\end_layout

\begin_layout Standard
Dann kommt eine Liste mit Vorlagen.
 Im Textfenster darunter finden Sie einige hoffentlich hilfreiche Hinweise
 zur Verwendung der gewählten Vorlage: Meist eine kurze Beschreibung, was
 die Vorlage macht und welche Parameter möglich sind.
\end_layout

\begin_layout Standard
Unten links im Dialogfenster können Sie noch 
\family sans
Entwurf
\family default
 de/aktivieren.
\end_layout

\begin_layout Standard
Wenn Sie auf der Karteikarte 
\family sans
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X-Ansicht in
\begin_inset space \space{}
\end_inset

Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X
\begin_inset space \space{}
\end_inset

anzeigen
\family default
 aktiviert haben, wird die externe Datei angezeigt, wenn es möglich ist.
 Ist 
\family sans
in
\begin_inset space \space{}
\end_inset

Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

X
\begin_inset space \space{}
\end_inset

anzeigen
\family default
 deaktiviert, erscheint nur ein grau hinterlegtes Kästchen mit Vorlagentyp
 und Dateinamen.
\end_layout

\begin_layout Standard
Dann gibt es noch die Karteikarten 
\family sans
Drehen
\family default
, 
\family sans
Größe
\family default
, 
\family sans
Zuschneiden
\family default
 und 
\family sans
Optionen
\family default
, die Sie bereits aus 
\family sans
Einfügen\SpecialChar \menuseparator
Grafik\SpecialChar \ldots{}

\family default
 kennen.
 Die letzten beiden sind abhängig vom Vorlagentyp aktiviert.
\end_layout

\begin_layout Standard
Ganz unten befinden sich schließlich die gewohnten Knöpfe 
\family sans
OK,
\family default
 
\family sans
Übernehmen
\family default
 und 
\family sans
Abbrech
\family default
en
\family sans
/Schließen
\family default
.
\end_layout

\begin_layout Section
Beispiele
\end_layout

\begin_layout Standard
In Diesem Abschnitt sollten wir einige Beispiele zeigen, wie diese Einfügungen
 von externem Material verwendet werden können.
 Dies sollte etwa folgendes umfassen:
\end_layout

\begin_layout Itemize
Externe Rasterbilder
\end_layout

\begin_layout Itemize
Externe XFig-Abbildungen
\end_layout

\begin_layout Itemize
Schachdiagramme
\end_layout

\begin_layout Itemize
Datum
\end_layout

\begin_layout Section
Die Konfigurationsdatei
\end_layout

\begin_layout Standard
Es ist recht einfach, eigene neue Vorlagen für externe Einfügungen zu erstellen.
 Allerdings sollten Sie sich im klaren sein, dass Sie, wenn Sie dabei zu
 unbesorgt vorgehen, sehr schnell ein Sicherheitsloch erzeugen können.
 Wenn Sie also eigene Vorlagen erstellen wollen, lesen Sie bitte 
\emph on
unbedingt
\emph default
 den Abschnitt
\begin_inset space \space{}
\end_inset


\begin_inset CommandInset ref
LatexCommand vref
reference "sec:Sicherheitshinweise"

\end_inset

.
\end_layout

\begin_layout Standard
Trotzdem sollten Sie unbedingt selbst erstellte Vorlagen an das LyX-Team
 senden.
\end_layout

\begin_layout Standard
Die Vorlagendefinitionen befinden sich in der Datei 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir/external_tem\SpecialChar \-
plates
\family default
.
 Sie können sich eine Kopie davon in Ihr privates Benutzerverzeichnis 
\family typewriter
UserDir
\family default
 kopieren und editieren.
 Zu einem späteren Zeitpunkt werden Sie in diesem Abschnitt hier auch eine
 genaue Beschreibung der Syntax dieser Datei und der vorhandenen Einträge
 finden\SpecialChar \ldots{}

\end_layout

\begin_layout Section
Der Ersetzungsmechanismus
\end_layout

\begin_layout Standard
Wenn über die externe Einfügung ein externes Programm gestartet wird, geschieht
 dies anhand eines Befehls, der in der Vorlage festgelegt wurde.
 Ein solcher Befehl kann diverse Makros enthalten, die vor dem eigentlichen
 Aufruf ausgewertet werden.
 Die Ausführung erfolgt dabei immer in demjenigen Verzeichnis, das auch
 das LyX-Dokument enthält.
 Eine derartige Ersetzung findet ebenfalls statt, wenn die Vorschau aktiviert
 wird.
 Hier finden Sie eine Liste dieser Makros:
\end_layout

\begin_layout Description
$$FName Der Name der im Dialog angegeben Datei.
\end_layout

\begin_layout Description
$$Basename Der Dateiname ohne die Endung
\end_layout

\begin_layout Description
$$Tempname Ein Name (inklusive vollem Pfad) einer temporären Datei; diese
 wird automatisch gelöscht, wenn das Dokument geschlossen oder die Einfügung
 gelöscht wird.
\end_layout

\begin_layout Description
$$Contents(
\begin_inset Quotes gld
\end_inset

Datei.ext
\begin_inset Quotes grd
\end_inset

) Dieses Makro wird zum Inhalt der Datei mit dem Namen 
\family typewriter
Datei.ext
\family default
 expandiert.
\end_layout

\begin_layout Description
$$Sysdir Dies wird durch den Namen des Systemverzeichnisses ersetzt.
 Es wird normalerweise verwendet, um diverse Hilfsskripte anzusprechen,
 die Teil von LyX sind.
\end_layout

\begin_layout Standard
Darüberhinaus werden sämtliche Umgebungsvariablen der Form 
\family typewriter
${PATH}
\family default
 expandiert.
\end_layout

\begin_layout Section
Sicherheitshinweise
\begin_inset CommandInset label
LatexCommand label
name "sec:Sicherheitshinweise"

\end_inset


\end_layout

\begin_layout Standard
Der Mechanismus der Einfügung externen Materials bietet eine Schnittstelle
 zu einer Vielzahl von externen Programmen und startet diese automatisch.
 Darum ist es notwendig, auf die dadurch bedingten Sicherheitsprobleme einzugehe
n.
 Insbesondere besteht durch die Möglichkeit, eigene Dateinamen und/oder
 Parameter anzugeben, scheinbar Gefahr, dass jemand bösartige Dokumente
 erstellt, die willkürliche Befehle ausführen, sobald ein Benutzer sie betrachte
t oder ausdruckt.
 Dies ist etwas, das wir unter allen Umständen vermeiden wollen.
\end_layout

\begin_layout Standard
Da jedoch die nutzbaren Programme ausschließlich in der Vorlagenkonfigurationsda
tei festgelegt werden können, bestehen keine Sicherheitsbedenken, solange
 LyX selbst korrekt und nur mit sicheren Vorlagen konfiguriert ist.
 Der Grund dafür ist, dass die externen Programme nicht mit dem Systembefehl
 
\family typewriter
system()
\family default
 aufgerufen werden, sondern mit 
\family typewriter
execvp()
\family default
.
 Dadurch ist es nicht möglich, über Dateinamen oder zusätzliche Parameter
 willkürliche Befehle durch die Shell ausführen zu lassen.
\end_layout

\begin_layout Standard
Bedingt durch diese Sicherheit, sind Sie allerdings etwas in der Auswahl
 der Befehlszeichenketten eingeschränkt, die Sie in der Vorlagedatei verwenden
 können.
 Insbesondere sind Ausgabeumleitungen und Pipes nicht möglich, und das muss
 auch so bleiben, wenn LyX weiterhin sicher bleiben soll.
 Wenn Sie derartige Fähigkeiten der Shell nutzen wollen, müssen Sie ein
 Skript schreiben und dieses dann aufrufen.
\end_layout

\begin_layout Standard
Im Verzeichnis 
\family typewriter
Ly
\begin_inset ERT
status collapsed

\begin_layout Plain Layout

{}
\end_layout

\end_inset

XDir/scripts
\family default
 finden Sie das Skript 
\family typewriter
general_command_wrap\SpecialChar \-
per.py
\family default
, das auf sicherem Weg die Verwendung der Ein/Ausgabeumleitung erlaubt.
 Es ist auch ein gutes Beispiel, wenn Sie selbst eigene, sichere Skripte
 erstellen wollen.
 Ein sehr viel komplexeres Beispiel, das auch 
\family typewriter
fork
\family default
 und Konsorten verwendet, finden Sie mit 
\family typewriter
pic2ascii.py
\family default
 im selben Verzeichnis.
\end_layout

\begin_layout Standard
Es ist zwar durchaus möglich, eine Vorlage zu erstellen, die eine direkte
 Interaktion mit der Shell erlaubt.
 Dies würde jedoch einem böswilligen Benutzer erlauben, durch die clevere
 Wahl von Dateinamen und/oder Parametern willkürliche Befehle auszuführen.
 Deswegen raten wir generell dazu, ausschließlich sichere Skripte zu verwenden,
 die mit dem 
\family typewriter
execvp()
\family default
-Mechanismus arbeiten.
\end_layout

\begin_layout Standard
Selbstverständlich mag es verlockend sein, in einer sicheren Umgebung zu
 den einfacheren Shellscripts zurückzukehren.
 Aber seien Sie sich bewusst, dass Sie dadurch ein potentielles Sicherheitsloch
 schaffen.
 Und obwohl wir jeden ermuntern, selbst erstellte Vorlagen im Sinne der
 Open Source an uns zu schicke,n sollte klar sein, dass ein derartiges,
 unsicheres Skript niemals fester Bestandteil der LyX-Distribution werden
 kann.
\end_layout

\begin_layout Standard
Die Einfügung externes Material gibt eine große Macht, und man muss sicherheitsb
ewusst damit umgehen.
 Ein einziger kleiner Fehler in einem vermeintlich harmlosen Skript kann
 die Türe zu gewaltigen Sicherheitsproblemen öffnen.
 Im Zweifelsfall wenden Sie sich an einen angesehenen Sicherheitsexperten
 oder fragen Sie das LyX-Team, wenn Sie sich nicht sicher sind, ob eine
 von Ihnen erstellte Vorlage als sicher angesehen werden kann oder nicht.
 Und tun Sie das auf jeden Fall, bevor Sie die Vorlage in einem nicht genau
 kontrollierten Umfeld verwenden.
\end_layout

\begin_layout Section
Die Zukunft der externen Einfügung
\end_layout

\begin_layout Standard
Die gegenwärtige Implementation der Einfügung ist ein stabiler und mächtiger
 Mechanismus, der einen Zugang zu den Interna von LyX bietet.
 Doch wie bei fast allem in LyX gilt: Es befindet sich stetiger Entwicklung.
 Falls sich jemand an die Weiterentwicklung macht, sind hier ein paar Hinweise,
 welche Wege dabei gegangen werden sollten:
\end_layout

\begin_layout Itemize
Ermöglichen der eingebetteten Vorschau anstelle des einfachen Knopfes.
\end_layout

\begin_layout Itemize
Eingebettete Bearbeitung, zum Beispiel über OpenParts oder ein ähnliches
 Protokoll.
\end_layout

\begin_layout Itemize
Erweiterung der dynamischen Information und dadurch die Möglichkeit, optionale
 Eingabefelder für die Umwandlungsprogramme in allen Exportformaten zu haben,
 ebenso für die Parameter für jedes dieser Formate.
 Derzeit kann nur eine einziger Parameterkombination angegeben werden, die
 global für diese eine Vorlage gilt.
 Dies würde es ermöglichen, auf die etwas willkürliche Festlegung eines
 primären Formates für das einzubindende Material zu verzichten.
\end_layout

\begin_layout Itemize
Erweiterung der Definitionsbasis um intelligentere Konfigurationsoptionen
 als die einfache Parameterzeile zu ermöglichen.
 Mit einer passenden Skriptsprache wäre es möglich, eine sehr benutzerfreundlich
e Version der Einfügungsdialoge zu erstellen.
\end_layout

\end_body
\end_document