824 lines
14 KiB
Plaintext
824 lines
14 KiB
Plaintext
#LyX 1.4.3 created this file. For more info see http://www.lyx.org/
|
|
\lyxformat 245
|
|
\begin_document
|
|
\begin_header
|
|
\textclass article
|
|
\begin_preamble
|
|
\usepackage{hyperref}
|
|
\usepackage{html}
|
|
\usepackage{german}
|
|
\end_preamble
|
|
\language ngerman
|
|
\inputencoding auto
|
|
\fontscheme default
|
|
\graphics default
|
|
\paperfontsize default
|
|
\spacing single
|
|
\papersize default
|
|
\use_geometry false
|
|
\use_amsmath 1
|
|
\cite_engine basic
|
|
\use_bibtopic false
|
|
\paperorientation portrait
|
|
\secnumdepth 3
|
|
\tocdepth 3
|
|
\paragraph_separation skip
|
|
\defskip medskip
|
|
\quotes_language swedish
|
|
\papercolumns 1
|
|
\papersides 1
|
|
\paperpagestyle default
|
|
\tracking_changes false
|
|
\output_changes true
|
|
\end_header
|
|
|
|
\begin_body
|
|
|
|
\begin_layout Title
|
|
Hinweise zur Erstellung von Lyx-Dokumenten
|
|
\end_layout
|
|
|
|
\begin_layout Author
|
|
für Lyx 1.4.x
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\begin_inset LatexCommand \tableofcontents{}
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Section
|
|
Dokumenteigenschaften
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Einstellungen für latex2html
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Damit der latex2html-Konverter ein tex-Dokument korrekt umwandelt (inklusive
|
|
deutscher Übersetzung der Begriffe), muss zuerst in Lyx-Menü
|
|
\emph on
|
|
Dokument --> Einstellung --> LaTeX-Vorspann
|
|
\emph default
|
|
folgendes eingetragen werden:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
|
|
\backslash
|
|
usepackage{html}
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
|
|
\backslash
|
|
usepackage{hyperref}
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
|
|
\backslash
|
|
usepackage{german}
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Sonstiges
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Die Sprache des Dokumentes auf Deutsch stellen:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Im Lyx-Menü:
|
|
\emph on
|
|
Dokument
|
|
\emph default
|
|
->
|
|
\emph on
|
|
Einstellungen
|
|
\emph default
|
|
->
|
|
\emph on
|
|
Sprache
|
|
\end_layout
|
|
|
|
\begin_layout Section
|
|
Dokumentformatierung
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Nachfolgend ist beschreiben, wie ein Lyx-Dokument aufgebaut ist.
|
|
Bitte beachte, dass du die Reihenfolge der Formatierungen beibehältst.
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Kopf: Die Titelleiste
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Ein Lyx-Dokument beginnt mit dem Einfügen der Datei
|
|
\emph on
|
|
titlebar.inc.
|
|
|
|
\emph default
|
|
Das geht so:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Im Lyx-Menü:
|
|
\emph on
|
|
Einfügen
|
|
\emph default
|
|
->
|
|
\emph on
|
|
Datei
|
|
\emph default
|
|
->
|
|
\emph on
|
|
Unterdokument
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Der Dateiname ist
|
|
\emph on
|
|
titlebar.inc
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Im Eingabefeld darf nur der Dateiname auftauchen - keine Pfadangaben!
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Die Art der Einbindung ist ''Input''
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Beispiel:
|
|
\begin_inset Include \input{titlebar.inc}
|
|
preview false
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Kopf: Das Menü
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Die eingefügte Datei
|
|
\emph on
|
|
menue.inc
|
|
\emph default
|
|
ist dafür verantwortlich, dass das Menü dargestellt wird.
|
|
Änderungen am Menü musst du also in dieser Datei vornehmen.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Das Einfügen geht so:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Im Lyx-Menü: Einfügen -> Datei -> Unterdokument
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Der Dateiname ist
|
|
\emph on
|
|
menue.inc
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Im Eingabefeld darf nur der Dateiname auftauchen - keine Pfadangaben!
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
die Art der Einbindung ist ''Input''
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Beispiel:
|
|
\begin_inset Include \input{menue.inc}
|
|
preview false
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Kopf: css-Tag
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Unterhalb des Menüs kommt ein Abschnitt mit sogenannten
|
|
\emph on
|
|
Evil Red Text (ERT)
|
|
\emph default
|
|
.
|
|
Klicke im Lyx-Menü auf den Button mit den roten Buchstaben
|
|
\emph on
|
|
TEX
|
|
\emph default
|
|
und füge den folgenden Code ein:
|
|
\end_layout
|
|
|
|
\begin_layout Quotation
|
|
\begin_inset ERT
|
|
status open
|
|
|
|
\begin_layout Standard
|
|
|
|
|
|
\backslash
|
|
begin{rawhtml}
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
<!-- main starts here -->
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
<div id="main">
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
|
|
\backslash
|
|
end{rawhtml}
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Hauptteil: Titel
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Der Hauptteil beginnt immer mit einem Titel.
|
|
Denke dir was schönes aus.
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Hauptteil: Autor (optional)
|
|
\end_layout
|
|
|
|
\begin_layout Enumerate
|
|
Die optionale Formatierung
|
|
\emph on
|
|
Autor
|
|
\emph default
|
|
kannst du für eine weitere Beschreibung des Dokumentes benutzen.
|
|
Üblich ist es dort den Namen des Hauptdokumentes anzugeben.
|
|
Ein Beispiel:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Title: Thunderbird installieren
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Autor: Verschlüsselt Mailen
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Hauptteil: Inhaltsverzeichnis (optional)
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Bei umfangreichen Dokumenten kannst du nun ein Inhaltsverzeichnis einfügen.
|
|
Das geht so:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Im Lyx-Menü:
|
|
\emph on
|
|
Einfügen
|
|
\emph default
|
|
->
|
|
\emph on
|
|
Liste / Inhaltsverzeichnis
|
|
\emph default
|
|
->
|
|
\emph on
|
|
Inhaltsverzeichnis
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Überschriften werden nicht in das Inhaltsverzeichnis aufgenommen, wenn sie
|
|
mit der Sternchen-Variante (bspw:
|
|
\emph on
|
|
Unterabschnitt*
|
|
\emph default
|
|
) gekennzeichnet wurden.
|
|
In den html-Dokumenten tauchen die Nummern vor den Überschriften nicht
|
|
auf.
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Hauptteil: sonstiges
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Alle weiteren Überschriften werden als 'Subsection' formatiert
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Zitate werden als 'Quote' formatiert.
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Im html wird daraus <blockquote>
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Hervorhebungen werden mit '!' markiert
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
\emph on
|
|
Eigennamen usw.
|
|
am besten mit '!' formatieren.
|
|
Im html wird daraus <class=
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
textit
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
>
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Bilder zentriert mit Beschreibung darstellen
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Bilder werden normalerweise im html-Dokument linksbündig dargestellt.
|
|
Um dieses Verhalten zu ändern oder um dem Bild eine Beschreibung hinzuzufügen,
|
|
muss es innerhalb eines
|
|
\emph on
|
|
Gleitobjekts
|
|
\emph default
|
|
liegen.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\begin_inset Float figure
|
|
wide false
|
|
sideways false
|
|
status open
|
|
|
|
\begin_layout Standard
|
|
\begin_inset Graphics
|
|
filename /home/phil/daten/sao/svn/cryptocd/trunk/documents/winpt/winpt_systray.png
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Caption
|
|
dies ist eine Beschreibung
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Folgende Schritte sind notwendig:
|
|
\end_layout
|
|
|
|
\begin_layout Enumerate
|
|
Im Lyx-Menü:
|
|
\emph on
|
|
Einfügen
|
|
\emph default
|
|
->
|
|
\emph on
|
|
Gleitobjekt
|
|
\emph default
|
|
->
|
|
\emph on
|
|
Abbildung
|
|
\end_layout
|
|
|
|
\begin_layout Enumerate
|
|
Hinter
|
|
\emph on
|
|
Abbildung #
|
|
\emph default
|
|
: die Beschreibung einfügen
|
|
\end_layout
|
|
|
|
\begin_layout Enumerate
|
|
Den Cursor an den Satzanfang der Beschreibung bringen dann 'Enter' - nun
|
|
ist über der Beschreibung Platz für das Bild
|
|
\end_layout
|
|
|
|
\begin_layout Enumerate
|
|
Im Lyx-Menü:
|
|
\emph on
|
|
Einfügen
|
|
\emph default
|
|
->
|
|
\emph on
|
|
Grafik...
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Das Bild wird im html innerhalb einer Tabelle dargestellt - diese ist genauso
|
|
breit wie das Bild selber.
|
|
Lange Beschreibungen werden also umgebrochen, was mitunter unschön aussieht.
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Screenshots - Nachbearbeitung
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
maximale Pixelbreite: 600
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
mit Gimp um den Wert 30 schärfen
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Hervorhebungen
|
|
\end_layout
|
|
|
|
\begin_deeper
|
|
\begin_layout Itemize
|
|
neue Ebene anlegen,
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Stelle mit dem Auswahlwerkzeug markieren,
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Auswahl mitFüllwerzeug und Farbe rot füllen
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Tranzparenz der Ebene auf Wert 30 setzen
|
|
\end_layout
|
|
|
|
\end_deeper
|
|
\begin_layout Itemize
|
|
falls ein großer Teil des Randes des Bildes aus weißen Flächen besteht,
|
|
dann wäre ein schwarzer Rand hilfreich:
|
|
\end_layout
|
|
|
|
\begin_deeper
|
|
\begin_layout Itemize
|
|
Gimp: Skript-Fu -> Dekoration -> Rand hinzufügen
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
vertikal 1px
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
horizontal 1px
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Farbe: schwarz
|
|
\end_layout
|
|
|
|
\end_deeper
|
|
\begin_layout Itemize
|
|
das GTK-Theme für die Linux-Screenshots ist Clearlooks (der Standard ab
|
|
Gnome 2.12)
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Böser roter Tex
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Bestimmte Formatierungen werden nur umgewandelt, wenn sie dem Konverter
|
|
direkt übergeben werden.
|
|
Das erfordert die Eingabe von sogenannten
|
|
\emph on
|
|
Evil Red Text (ERT)
|
|
\emph default
|
|
.
|
|
Dieses Erfolgt über das Menü und den Button
|
|
\emph on
|
|
TEX
|
|
\emph default
|
|
.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Eine Dokumentation zu den latex2html-Befehlen findest du unter
|
|
\emph on
|
|
http://www-texdev.mpce.mq.edu.au/l2h/docs/manual/
|
|
\emph default
|
|
.
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Links einfügen
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Links werden mit einer
|
|
\emph on
|
|
ERT
|
|
\emph default
|
|
-Formatierung eingefügt:
|
|
\end_layout
|
|
|
|
\begin_deeper
|
|
\begin_layout Itemize
|
|
\begin_inset ERT
|
|
status open
|
|
|
|
\begin_layout Standard
|
|
|
|
|
|
\backslash
|
|
htmladdnormallink{Beschreibung}{Adresse}
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Falls du auf eine Seite auf der CryptoCD verweist, gilt folgendes Schema
|
|
zur Angabe der Adresse:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
../$VERZEICHNIS/DOKUMENT.LYX
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Jedes Dokument liegt in einem gesonderten Verzeichnis, das genauso bezeichnet
|
|
ist, wie das Dokument selbst.#
|
|
\end_layout
|
|
|
|
\end_deeper
|
|
\begin_layout Itemize
|
|
E-Mail-Adressen verlinken:
|
|
\end_layout
|
|
|
|
\begin_deeper
|
|
\begin_layout Itemize
|
|
\begin_inset ERT
|
|
status open
|
|
|
|
\begin_layout Standard
|
|
|
|
|
|
\backslash
|
|
htmladdnormallink{Adresse}{mailto: Adresse}
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\end_deeper
|
|
\begin_layout Standard
|
|
Enthält ein Link ein Prozentzeichen, muss dieses maskiert werden:
|
|
\backslash
|
|
% statt %.
|
|
Angezeigt wird dann ein normales %-Zeichen.
|
|
Anderfalls wird der Link von latex als Kommentar interpretiert.
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Eine horizontale Linie einfügen
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Die Dokumentation enthält zusätzliche Optionen zur Formatierung einer Linie.
|
|
Ohne Optionen wird sie wie folgt dargestellt:
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\begin_inset ERT
|
|
status open
|
|
|
|
\begin_layout Standard
|
|
|
|
|
|
\backslash
|
|
htmlrule
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Verweise auf Menüpunkte der Programme
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Falls du im Text auf einen Menüpunkt eines Programmes (z.B.
|
|
Thunderbird) verweist, wir die entsprechende Stelle wie folgt formatiert:
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
\begin_inset ERT
|
|
status open
|
|
|
|
\begin_layout Standard
|
|
|
|
|
|
\backslash
|
|
begin{rawhtml}
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
<span class="kbd">
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
|
|
\backslash
|
|
end{rawhtml}
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
$MENÜPUNKT
|
|
\begin_inset ERT
|
|
status open
|
|
|
|
\begin_layout Standard
|
|
|
|
|
|
\backslash
|
|
begin{rawhtml}
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
</span>
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
|
|
|
|
\backslash
|
|
end{rawhtml}
|
|
\end_layout
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Subsubsection
|
|
Fussnoten
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Problem: Eine Fussnote fehlt in der Auflistung am Ende der html-Seite -
|
|
nur das Verweis-Wort aus dem Text ist aufgeführt! Eventuell beinhaltet
|
|
die Fussnote einen Link mit "%"-Zeichen.
|
|
Die Lösung findest du im Abschnitt
|
|
\begin_inset Quotes srd
|
|
\end_inset
|
|
|
|
Links einfügen
|
|
\begin_inset Quotes erd
|
|
\end_inset
|
|
|
|
.
|
|
\end_layout
|
|
|
|
\begin_layout Subsection
|
|
Ende: Der Fortschrittsbalken (optional)
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Am Ende der meisten Dokumente erscheint ein Fortschrittsbalken.
|
|
Er zeigt auf, welche Seiten in der Dokumentation bereits bearbeitet wurden
|
|
und welche noch folgen.
|
|
Falls du einen neuen Fortschrittsbalken erstellen willst, nimm die Formatierung
|
|
eines Bestehenden als Vorlage.
|
|
Dies ist wichtig, weil bei einem make durch die Datei mod_html_files.py
|
|
Änderungen vorgenommen werden, die auf der aktuellen Formatierung der Fortschri
|
|
ttsbalken aufbauen.
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Das Einfügen geht so:
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Im Lyx-Menü: Einfügen -> Datei -> Unterdokument
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Der Dateiname ist: $TITEL.inc, der Speicherort ist: progress/
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Im Eingabefeld muss es dann so lauten: progress/$TITEL.inc
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
die Art der Einbindung ist ''Input''
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Beispiel:
|
|
\begin_inset Include \input{progress/policy_formatierung.inc}
|
|
preview false
|
|
|
|
\end_inset
|
|
|
|
|
|
\end_layout
|
|
|
|
\begin_layout Section
|
|
Verzeichnisstruktur und Dateinamen
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Zum Speichern stehen dir einige Verzeichnisse unterhalb von trunk/documents
|
|
zur Verfügung:
|
|
\end_layout
|
|
|
|
\begin_layout Enumerate
|
|
common/ -- Hier kommen allgemeine Dokumente rein
|
|
\end_layout
|
|
|
|
\begin_layout Enumerate
|
|
windows/, linux/, macos/ -- Hier werden jeweils die betriebssystemspezifischen
|
|
Anleitungen gespeichert
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
progress/ -- Hier werden die Fortschrittsbalken gespeichert
|
|
\end_layout
|
|
|
|
\begin_layout Standard
|
|
Beim Speichern gilt folgendes (dies ist wichtig für die Verlinkung innerhalb
|
|
der Lyx-Dokumente):
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
Lege innerhalb eines der o.g.
|
|
Verzeichnisse ein neues Verzeichnis an,
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
das neue lyx-Dokument in diesem Verzeichnis sollte denselben Namen tragen,
|
|
\end_layout
|
|
|
|
\begin_layout Itemize
|
|
speichere das Lyx-Dokument ab.
|
|
\end_layout
|
|
|
|
\end_body
|
|
\end_document
|