cryptocd/ccd-infos/policy_formatierung.lyx

#LyX 1.4.1 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 english
\papercolumns 1
\papersides 1
\paperpagestyle default
\tracking_changes false
\output_changes true
\end_header

\begin_body

\begin_layout Title
Hinweise zur Formatierung der Lyx-Dokumente
\end_layout

\begin_layout Author
f<EFBFBD>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 <20>bersetzung der Begriffe), muss zuerst in Lyx-Men<65> 
\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<65>: 
\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<65>lst.
\end_layout

\begin_layout Subsection
Kopf: Die Titelleiste
\end_layout

\begin_layout Standard
Ein Lyx-Dokument beginnt mit dem Einf<6E>gen der Datei 
\emph on
titlebar.inc.
 
\emph default
Das geht so:
\end_layout

\begin_layout Itemize
Im Lyx-Men<65>: 
\emph on
Einf<EFBFBD>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<65>
\end_layout

\begin_layout Standard
Die eingef<65>gte Datei 
\emph on
menue.inc
\emph default
 bzw.
 
\emph on
menue_email.inc
\emph default
 oder 
\emph on
menue_chat.inc
\emph default
 ist daf<61>r verantwortlich, dass das Men<65> dargestellt wird.
 <20>nderungen am Men<65> musst du also in dieser Datei vornehmen.
\end_layout

\begin_layout Standard
Das Einf<6E>gen geht so:
\end_layout

\begin_layout Itemize
Im Lyx-Men<65>: Einf<6E>gen -> Datei -> Unterdokument
\end_layout

\begin_layout Itemize
Der Dateiname ist 
\emph on
menue.inc
\emph default
 bzw.
 
\emph on
menue_xyz.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_chat.inc}
preview false

\end_inset


\end_layout

\begin_layout Subsection
Kopf: css-Tag
\end_layout

\begin_layout Standard
Unterhalb des Men<65>s kommt ein Abschnitt mit sogenannten 
\emph on
Evil Red Text (ERT)
\emph default
.
 Klicke im Lyx-Men<65> 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<63>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.
 <20>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<68>sselt Mailen
\end_layout

\begin_layout Subsection
Hauptteil: Inhaltsverzeichnis (optional)
\end_layout

\begin_layout Standard
Bei umfangreichen Dokumenten kannst du nun ein Inhaltsverzeichnis einf<6E>gen.
 Das geht so:
\end_layout

\begin_layout Itemize
Im Lyx-Men<65>: 
\emph on
Einf<EFBFBD>gen
\emph default
 -> 
\emph on
Liste / Inhaltsverzeichnis
\emph default
 -> 
\emph on
Inhaltsverzeichnis
\end_layout

\begin_layout Standard
<EFBFBD>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 <20>berschriften nicht
 auf.
\end_layout

\begin_layout Standard
\begin_inset Note Note
status open

\begin_layout Standard
Bis zu dieser Stelle ist die Policy aktuell!
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Alle weiteren <20>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<73>ndig dargestellt.
 Um dieses Verhalten zu <20>ndern oder um dem Bild eine Beschreibung hinzuzuf<75>gen,
 muss es innerhalb eines Floats 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
Men<EFBFBD> 'Insert - Floats - Figure' damit erscheint der Float-Rahmen
\end_layout

\begin_layout Enumerate
Hinter 'Figure#' die Beschreibung einf<6E>gen
\end_layout

\begin_layout Enumerate
Den Cursor an den Satzanfang der Beschreibung bringen dann 'Enter' - nun
 ist <20>ber der Beschreibung Platz f<>r das Bild
\end_layout

\begin_layout Enumerate
Men<EFBFBD> 'Insert - Graphics...'
\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<63>n aussieht.
\end_layout

\begin_layout Subsubsection
Screenshots - Nachbearbeitung
\end_layout

\begin_layout Itemize
maximale Pixelbreite: 509
\end_layout

\begin_layout Itemize
mit Gimp um den Wert 30 sch<63>rfen
\end_layout

\begin_layout Itemize
f<EFBFBD>r rote Hervorhebungen: rot mit Transparenz 30
\end_layout

\begin_layout Itemize
das GTK-Theme f<>r die Linux-Screenshots ist Clearlooks (der Standard ab
 Gnome 2.12)
\end_layout

\begin_layout Subsubsection
Beginn des Dokumentes - mehr Code
\end_layout

\begin_layout Standard
\begin_inset ERT
status collapsed

\begin_layout Standard


\backslash
begin{rawhtml}
\end_layout

\begin_layout Standard

\end_layout

\begin_layout Standard

<!-- main starts here -->
\end_layout

\begin_layout Standard

\end_layout

\begin_layout Standard

<div id="main">
\end_layout

\begin_layout Standard

\end_layout

\begin_layout Standard


\backslash
end{rawhtml}
\end_layout

\end_inset


\end_layout

\begin_layout Standard
Dieser html-Code wird direkt unter den 
\emph on
<BODY>
\emph default
-tag eingef<65>gt.
 Er sorgt daf<61>r, dass der Inhalt als 
\emph on
main
\emph default
 gekennzeichnet wird, um ihn dann sp<73>ter per css zu formatieren.
 
\end_layout

\begin_layout Standard
Nach den obigen Tags kann mit dem eigentlichen Schreiben des Dokuments begonnen
 werden.
\end_layout

\begin_layout Subsubsection
Links einf<6E>gen
\end_layout

\begin_layout Standard
\begin_inset ERT
status open

\begin_layout Standard


\backslash
htmladdnormallink{Beschreibung}{Adresse}
\end_layout

\end_inset


\end_layout

\begin_layout Subsubsection
Eine horizontale Linie einf<6E>gen
\end_layout

\begin_layout Standard
Die Dokumentation enth<74>lt zus<75>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 Section
TODO
\end_layout

\begin_layout Standard
Bestimmte Formatierungen werden nur umgewandelt, wenn sie dem Konverter
 direkt <20>bergeben werden.
 Das erfordert die Eingabe von sogenannten 
\emph on
Evil Red Text (ERT)
\emph default
.
 Dieses Erfolgt <20>ber das Men<65> 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 Enumerate
alle <20>berschriften im Text sind 'Subsection', 'Subsubsection' usw.
\end_layout

\begin_layout Enumerate
Wenn du eine neue Seite erstellt hast, die in der Navigationsleiste auftauchen
 soll, dann kannst du sie in der 
\begin_inset Quotes erd
\end_inset

menue.inc
\begin_inset Quotes erd
\end_inset

 wie die anderen Links hinzuf<75>gen.
\end_layout

\end_body
\end_document