- Tag fuer v1.2.1 gesetzt
This commit is contained in:
parent
2d76ea7cf8
commit
01f03ed978
171 changed files with 10170 additions and 0 deletions
1
v1.2.1/ccd-infos/eduforge_upload
Normal file
1
v1.2.1/ccd-infos/eduforge_upload
Normal file
|
|
@ -0,0 +1 @@
|
|||
upload files to shell.eduforge.org:/home/pub/cryptocd
|
||||
29
v1.2.1/ccd-infos/export_info.txt
Normal file
29
v1.2.1/ccd-infos/export_info.txt
Normal file
|
|
@ -0,0 +1,29 @@
|
|||
===== Informationen zur eigenen Erstellung von Releases der CryptoCD =====
|
||||
|
||||
notwendige Programme:
|
||||
- make
|
||||
- lyx
|
||||
- latex2html
|
||||
- python
|
||||
- mkisofs
|
||||
- zip/tar/bzip2
|
||||
- subversion (nur fuer das Erstellen eines "source"-Pakets notwendig)
|
||||
- link-checker
|
||||
- wdg-html-validator
|
||||
|
||||
|
||||
|
||||
===== Export eines Releases =====
|
||||
|
||||
Im Hauptverzeichnis (höchstwahrscheinlich trunk/) "make help" eingeben,
|
||||
dies listet die aktuellen Optionen auf.
|
||||
|
||||
Achtung: falls du keine lokale Arbeitskopie des subversion-Repositories
|
||||
verwendest, musst du die Release-Nummer im Makefile per Hand setzen
|
||||
(in den ersten Zeilen).
|
||||
|
||||
|
||||
===== Hinzufuegen eigener Anleitungen =====
|
||||
|
||||
Dies ist detailliert und inklusive Formatierungs-Policy in
|
||||
ccd-infos/policy_formatierung.lyx erläutert.
|
||||
466
v1.2.1/ccd-infos/policy_formatierung.lyx
Normal file
466
v1.2.1/ccd-infos/policy_formatierung.lyx
Normal file
|
|
@ -0,0 +1,466 @@
|
|||
#LyX 1.3 created this file. For more info see http://www.lyx.org/
|
||||
\lyxformat 221
|
||||
\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
|
||||
\paperpackage a4
|
||||
\use_geometry 0
|
||||
\use_amsmath 0
|
||||
\use_natbib 0
|
||||
\use_numerical_citations 0
|
||||
\paperorientation portrait
|
||||
\secnumdepth 3
|
||||
\tocdepth 3
|
||||
\paragraph_separation skip
|
||||
\defskip medskip
|
||||
\quotes_language english
|
||||
\quotes_times 2
|
||||
\papercolumns 1
|
||||
\papersides 1
|
||||
\paperpagestyle default
|
||||
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset ERT
|
||||
status Collapsed
|
||||
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
begin{rawhtml}
|
||||
\layout Standard
|
||||
<div id="container">
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
end{rawhtml}
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset Include \input{menue.inc}
|
||||
preview false
|
||||
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset ERT
|
||||
status Collapsed
|
||||
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
begin{rawhtml}
|
||||
\layout Standard
|
||||
<!-- main starts here -->
|
||||
\layout Standard
|
||||
<div id="main">
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
end{rawhtml}
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Title
|
||||
|
||||
Jedes Lyx Dokument beginnt mit Tex-Code, gefolgt von einem 'Title'
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset LatexCommand \tableofcontents{}
|
||||
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Subsection
|
||||
|
||||
Kurzanleitung zum Anlegen eines Dokuments
|
||||
\layout Enumerate
|
||||
|
||||
'Format' -> 'Dokument' -> 'Sprache' -> 'Deutsch'
|
||||
\layout Enumerate
|
||||
|
||||
unter 'Format' -> 'Dokument' -> 'Latex-Vorspann' folgende Zeilen einfügen:
|
||||
\begin_deeper
|
||||
\layout Enumerate
|
||||
|
||||
|
||||
\backslash
|
||||
usepackage{html}
|
||||
\layout Enumerate
|
||||
|
||||
|
||||
\backslash
|
||||
usepackage{hyperref}
|
||||
\layout Enumerate
|
||||
|
||||
|
||||
\backslash
|
||||
usepackage{german}
|
||||
\end_deeper
|
||||
\layout Enumerate
|
||||
|
||||
Der Titel des Dokuments ist ein 'Title'
|
||||
\layout Enumerate
|
||||
|
||||
alle Überschriften im Text sind 'Subsection', 'Subsubsection' usw.
|
||||
\layout Enumerate
|
||||
|
||||
Die Navigationsleiste am linken Rand der Internet-Seite bindest du folgendermaße
|
||||
n ein:
|
||||
\begin_deeper
|
||||
\layout Enumerate
|
||||
|
||||
''Einfügen''->''Datei einbinden''
|
||||
\layout Enumerate
|
||||
|
||||
der Dateiname ist ''menue.inc'' (exakt so! Die Datei ist nur bei der Übersetzung
|
||||
kurzzeitig vorhanden)
|
||||
\layout Enumerate
|
||||
|
||||
die Art der Einbindung ist ''Input''
|
||||
\layout Enumerate
|
||||
|
||||
unterhalb dieser Dateieinbindung musst du außerdem folgenden ERT-Abschnitt
|
||||
einfügen:
|
||||
\layout Quotation
|
||||
|
||||
|
||||
\backslash
|
||||
begin{rawhtml}
|
||||
\layout Quotation
|
||||
|
||||
<!-- main starts here -->
|
||||
\layout Quotation
|
||||
|
||||
<div id="main">
|
||||
\layout Quotation
|
||||
|
||||
|
||||
\backslash
|
||||
end{rawhtml}
|
||||
\end_deeper
|
||||
\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ügen.
|
||||
\layout Standard
|
||||
|
||||
Das Dokument, das du gerade liest, beinhaltet beispielhaft auch das Menü
|
||||
...
|
||||
\layout Subsection
|
||||
|
||||
Details
|
||||
\layout Subsubsection
|
||||
|
||||
Titel des Dokuments
|
||||
\layout Standard
|
||||
|
||||
Der html-Konverter wandelt 'Section' in <h1> um.
|
||||
Unser css formatiert diesen Tag mit einem gestrichelten Rahmen.
|
||||
Deshalb soll jedes Dokument mit einem 'Title' beginnen.
|
||||
\layout Subsubsection
|
||||
|
||||
TOC für umfangreiche Dokumente
|
||||
\layout Standard
|
||||
|
||||
Unter den 'Title' setzt du bei umfangreichen Dokumente eine Table of Contents
|
||||
(TOC).
|
||||
Überschriften werden nicht in das Inhaltsverzeichnis aufgenommen, wenn
|
||||
sie mit der Sternchen-Variante ('foo*') gekennzeichnet wurden.
|
||||
\layout Standard
|
||||
|
||||
Im html tauchen die Nummern vor den Überschriften nicht auf.
|
||||
\layout Subsubsection
|
||||
|
||||
Alle weiteren Überschriften werden als 'Subsection' formatiert
|
||||
\layout Quote
|
||||
|
||||
Zitate werden als 'Quote' formatiert.
|
||||
Im html wird daraus <blockquote>
|
||||
\layout Subsubsection
|
||||
|
||||
Hervorhebungen werden mit '!' markiert
|
||||
\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
|
||||
|
||||
>
|
||||
\layout Subsubsection
|
||||
|
||||
Bilder zentriert mit Beschreibung darstellen
|
||||
\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 Floats liegen.
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset Float figure
|
||||
wide false
|
||||
collapsed false
|
||||
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset Graphics
|
||||
filename /home/phil/daten/sao/svn/cryptocd/trunk/documents/winpt/winpt_systray.png
|
||||
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Caption
|
||||
|
||||
dies ist eine Beschreibung
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Standard
|
||||
|
||||
Folgende Schritte sind notwendig:
|
||||
\layout Enumerate
|
||||
|
||||
Menü 'Insert - Floats - Figure' damit erscheint der Float-Rahmen
|
||||
\layout Enumerate
|
||||
|
||||
Hinter 'Figure#' die Beschreibung einfügen
|
||||
\layout Enumerate
|
||||
|
||||
Den Cursor an den Satzanfang der Beschreibung bringen dann 'Enter' - nun
|
||||
ist über der Beschreibung Platz für das Bild
|
||||
\layout Enumerate
|
||||
|
||||
Menü 'Insert - Graphics...'
|
||||
\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.
|
||||
\layout Subsubsection
|
||||
|
||||
Screenshots - Nachbearbeitung
|
||||
\layout Itemize
|
||||
|
||||
maximale Pixelbreite: 509
|
||||
\layout Itemize
|
||||
|
||||
mit Gimp um den Wert 30 schärfen
|
||||
\layout Itemize
|
||||
|
||||
für rote Hervorhebungen: rot mit Transparenz 30
|
||||
\layout Itemize
|
||||
|
||||
das GTK-Theme für die Linux-Screenshots ist Clearlooks (der Standard ab
|
||||
Gnome 2.12).
|
||||
\layout Subsection
|
||||
|
||||
latex2html - Einstellungen und Formatierungen
|
||||
\layout Standard
|
||||
|
||||
Damit der latex2html-Konverter ein tex-Dokument korrekt umwandelt (inklusive
|
||||
deutscher Übersetzung der Begriffe), muss zuerst in Menü
|
||||
\emph on
|
||||
Layout --> Document --> Preamble
|
||||
\emph default
|
||||
folgendes eingetragen werden:
|
||||
\layout Itemize
|
||||
|
||||
|
||||
\backslash
|
||||
usepackage{html}
|
||||
\layout Itemize
|
||||
|
||||
|
||||
\backslash
|
||||
usepackage{hyperref}
|
||||
\layout Itemize
|
||||
|
||||
|
||||
\backslash
|
||||
usepackage{german}
|
||||
\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
|
||||
.
|
||||
\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
|
||||
.
|
||||
\layout Subsubsection
|
||||
|
||||
Beginn des Dokumentes - der erste ERT
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset ERT
|
||||
status Collapsed
|
||||
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
begin{rawhtml}
|
||||
\layout Standard
|
||||
<div id="container">
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
end{rawhtml}
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Standard
|
||||
|
||||
Ganz zu Beginn des Dokumentes den obigen Evil Red Text einfügen, damit die
|
||||
Formatierung in der exportierten Version klappt.
|
||||
\layout Subsubsection
|
||||
|
||||
Beginn des Dokumentes - Das Menü
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset Include \input{menue.inc}
|
||||
preview false
|
||||
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Standard
|
||||
|
||||
Die eingefügte Datei
|
||||
\emph on
|
||||
menue.inc
|
||||
\emph default
|
||||
ist dafuer verantwortlich, dass das Menü dargestellt wird.
|
||||
Das Makefile kopiert
|
||||
\emph on
|
||||
menue_online.inc
|
||||
\emph default
|
||||
in diese Datei.
|
||||
Änderungen am Menü musst du also in dieser Datei vornehmen.
|
||||
\layout Subsubsection
|
||||
|
||||
Beginn des Dokumentes - mehr Code
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset ERT
|
||||
status Collapsed
|
||||
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
begin{rawhtml}
|
||||
\layout Standard
|
||||
<!-- main starts here -->
|
||||
\layout Standard
|
||||
<div id="main">
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
end{rawhtml}
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Standard
|
||||
|
||||
Dieser html-Code wird direkt unter den
|
||||
\emph on
|
||||
<BODY>
|
||||
\emph default
|
||||
-tag eingefügt.
|
||||
Er sorgt dafür, dass der Inhalt als
|
||||
\emph on
|
||||
main
|
||||
\emph default
|
||||
gekennzeichnet wird, um ihn dann später per css zu formatieren.
|
||||
|
||||
\layout Standard
|
||||
|
||||
Nach den obigen Tags kann mit dem eigentlichen Schreiben des Dokuments begonnen
|
||||
werden.
|
||||
\layout Subsubsection
|
||||
|
||||
Links einfügen
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset ERT
|
||||
status Open
|
||||
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
htmladdnormallink{Beschreibung}{Adresse}
|
||||
\end_inset
|
||||
|
||||
|
||||
\layout Subsubsection
|
||||
|
||||
Eine horizontale Linie einfügen
|
||||
\layout Standard
|
||||
|
||||
Die Dokumentation enthält zusätzliche Optionen zur Formatierung einer Linie.
|
||||
Ohne Optionen wird sie wie folgt dargestellt:
|
||||
\layout Standard
|
||||
|
||||
|
||||
\begin_inset ERT
|
||||
status Open
|
||||
|
||||
\layout Standard
|
||||
|
||||
\backslash
|
||||
htmlrule
|
||||
\end_inset
|
||||
|
||||
|
||||
\the_end
|
||||
Loading…
Add table
Add a link
Reference in a new issue