senselab/cryptocd-archiv
4
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

* tag 1.3 gesetzt

Browse source
This commit is contained in:
phil 2006-08-13 08:37:45 +00:00
parent 62d4bf2cfc
commit 30e40d6bd6
352 changed files with 18633 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
v1.3/CHANGES Normal file
View file

@ -0,0 +1 @@
siehe cd-template/news.txt

154
v1.3/Makefile Normal file
View file

@ -0,0 +1,154 @@
########## Variablendefinitionen ###########
# Revisions-Variablen
REVISIONS_NR := $(shell if test -d .svn; then svn -R info | grep ^Revision | cut -f2 -d " " | sort | tail -1; else date +%Y%m%d; fi)
REVISIONS_SUFFIX = _r$(REVISIONS_NR)
# Verzeichnisse
ROOT_DIR := $(shell pwd)
# Ablage der erstellten zip/iso-Dateien
EXPORT_DIR = $(ROOT_DIR)/export
# so beginnt das export-Verzeichnis
EXPORT_PREFIX := cryptocd
# wird an das export-Verzeichnis und die Archiv/iso-Dateien angehaengt
EXPORT_FILE_SUFFIX :=
EXPORT_FILE = $(EXPORT_DIR)/$(EXPORT_PREFIX)$(REVISIONS_SUFFIX)$(EXPORT_FILE_SUFFIX)
# Zwischenlagerung
TMP_ROOT = $(ROOT_DIR)/tmp
CCD_BUILD_DIR = $(TMP_ROOT)/$(EXPORT_PREFIX)$(REVISIONS_SUFFIX)$(EXPORT_FILE_SUFFIX)
PROGRAMM_DIR = $(CCD_BUILD_DIR)/programme
# Verzeichnisse, die notfalls erstellt werden muessen
CREATE_DIRS = $(TMP_ROOT) $(EXPORT_DIR)
# Aktionen
ERZEUGE_TAR = tar cjhf $(EXPORT_FILE).tar.bz2 -C $(dir $(CCD_BUILD_DIR)) $(notdir $(CCD_BUILD_DIR))
ERZEUGE_ZIP = (cd $(dir $(CCD_BUILD_DIR)); zip -9rq - $(notdir $(CCD_BUILD_DIR))) >$(EXPORT_FILE).zip
ERZEUGE_ISO = mkisofs -quiet $(ISO_OPTS) -o $(EXPORT_FILE).iso $(CCD_BUILD_DIR) 2>&1 | $(EINRUECKEN)
# Sonstiges
# Optionen fuer mkisofs
ISO_OPTS = -iso-level 3 -J -joliet-long -relaxed-filenames -f -r -V $(EXPORT_PREFIX)$(REVISIONS_SUFFIX)
# Ausgabe-Filter zum Einruecken
EINRUECKEN = sed 's/^/\t/'
######### Variablen vererben ###########
export CCD_BUILD_DIR
########### Allgemeine targets ###########
.PHONY : clean clean-dist all documents linkcheck help website release source all cd-template kopiere_programme
help:
@echo "allgemeine Targets:"
@echo " help - diese Uebersicht"
@echo " doku - das Doku-Verzeichnis erneuern"
@echo " clean - unnoetige Dateien loeschen (ohne downloads)"
@echo " dist-clean - unnoetige Dateien loeschen (inklusive downloads)"
@echo " linkcheck - Pruefung der Links"
@echo " validate - Pruefung des html-Codes"
@echo
@echo "Export-Targets:"
@echo " source - die lyx-Quellen und Bilder"
@echo " website - fuer die Webseite: mit Programmen"
@echo " release - erstellt das iso-Image und das zip-Archiv"
@echo " all - erstellt alle Export-Formen"
clean:
-make -C documents clean
-rm -rf $(TMP_ROOT)/* 2>/dev/null
dist-clean: clean
@# runtergeladene Dateien loeschen
@downloads/get_files.sh programme clean
linkcheck: doku kopiere_programme
linkchecker -r 4 --ignore-url=^mailto: $(wildcard $(CCD_BUILD_DIR)/*.html)
validate:
make -C documents validate
# pruefe, ob alle notwendigen/empfohlenen Verzeichnisse existieren
verzeichnisstruktur: $(CREATE_DIRS)
$(CREATE_DIRS):
@if [ ! -e "$@" ] ;\
then echo -e "directory ($@) does not exist - I will create it" ;\
mkdir -p "$@" ;\
fi
######## die Werkzeuge #########
cd-template: verzeichnisstruktur
@rm -rf $(CCD_BUILD_DIR)
@# export local svn directory OR just copy the directories (for non-svn users)
@if test -d .svn ;\
then svn export cd-template "$(CCD_BUILD_DIR)" ;\
else mkdir -p $(dir $(CCD_BUILD_DIR)) ;\
cp -r cd-template $(CCD_BUILD_DIR) ;\
fi
find $(CCD_BUILD_DIR) -type f -name \*.html -exec unix2dos '{}' \;
find $(CCD_BUILD_DIR) -type f -name \*.txt -exec unix2dos '{}' \;
find $(CCD_BUILD_DIR) -type f -name \*.css -exec unix2dos '{}' \;
doku: cd-template
@echo "Aktualisiere das Doku-Verzeichnis ..."
@make -C documents
@#Kopieren der Dateien ins das Abbild-Verzeichnis
@make -C documents install
kopiere_programme: cd-template
@echo "Kopiere die Programme ..."
@downloads/get_files.sh programme download
@downloads/get_files.sh programme verify
@downloads/get_files.sh programme install "$(PROGRAMM_DIR)"
####### die Ausgabe-Formate ###########
website: EXPORT_FILE_SUFFIX := _website
website: doku kopiere_programme
@echo "Erzeuge Archiv der online-Dateien ..."
@# Gruppen-Schreibrecht setzen (fuer eduforge)
@chmod -R g+rw $(TMP_ROOT)
@$(ERZEUGE_TAR)
source: EXPORT_FILE_SUFFIX := _src
source:
rm -rf "$(CCD_BUILD_DIR)"
if test -d .svn ;\
then mkdir -p "$(dir $(CCD_BUILD_DIR))" ;\
echo "Exportiere die gewaehlte svn-Revision ($(REVISIONS_NR)) ..." ;\
svn export . "$(CCD_BUILD_DIR)" | $(EINRUECKEN) ;\
else mkdir -p "$(CCD_BUILD_DIR)" ;\
make -C documents clean ;\
cp -r $(shell ls | grep -v "$(notdir $(TMP_ROOT))" | grep -v "$(notdir $(EXPORT_DIR))") "$(CCD_BUILD_DIR)" ;\
fi
@echo "Erzeuge source-Archiv ..."
@$(ERZEUGE_TAR)
release: EXPORT_FILE_SUFFIX := _release
release: doku kopiere_programme
find -type f -name \*.html -exec unix2dos '{}' \;
find -type f -name \*.txt -exec unix2dos '{}' \;
find -type f -name \*.css -exec unix2dos '{}' \;
@echo "Erzeuge iso-Image ..."
@$(ERZEUGE_ISO)
@echo "Erzeuge zip-Archiv ..."
@$(ERZEUGE_ZIP)
all:
@make website
@make release
@make source

35
v1.3/README Normal file
View file

@ -0,0 +1,35 @@
===== Die CryptoCD =====
Dies ist ein Entwickler-Archiv der CryptoCD, einer einstiegsfreundlichen
Zusammenstellung von Anleitungen und Programmen zur Ver-
schluesselung von E-Mails und Chat-Nachrichten unter Linux, Windows
und Mac OS.
Informationen zum Erstellen einer eigenen CryptoCD findest du in der Datei
ccd-infos/export_info.txt.
Falls du die CryptoCD nur verwenden (also nicht weiterentwickeln) möchtest,
dann solltest du anstelle dieses Entwickler-Archivs ein zip-Archiv oder ein
iso-Image herunterladen.
Webseite: http://cryptocd.org
Subversion-Repository: (mit anonymem Lese-Zugriff)
- zum Browsen: https://systemausfall.org/trac/cryptocd/browser/
- fuer ein checkout: https://svn.systemausfall.org/svn/cryptocd/trunk
Kontakt: info@cryptocd.org
===== Die Verzeichnisstruktur =====
ccd-infos: Hinweise zur eigenen Erstellung und Modifikation von Inhalten
documents: Die Quelltexte und -bilder
export: Hier landen die zu veröffentlichen Endresultate eines make-
Aufrufes
cd-template: Die fixen Daten der CD (CSS-File usw.)
downloads: Nach dem entsprechenden make-Aufruf befinden sich hier die
heruntergeladenen Programme
tmp: das temporäre Verzeichnis, das beim build-Prozess genutzt wird
===== Lizenz =====
Alle Inhalte der CD stehen unter einer Creative-Commons-Lizenz.
(siehe Verzeichnis cd-template/auslese/cc)

2
v1.3/TODO Normal file
View file

@ -0,0 +1,2 @@
siehe: https://systemausfall.org/trac/cryptocd/report/3

13
v1.3/ccd-infos/eduforge_upload Normal file
View file

@ -0,0 +1,13 @@
1) release files
upload release files to shell.eduforge.org:/home/pub/cryptocd
(register these files afterwards)
2) online version
upload the current online version to:
shell.eduforge.org:/home/groups/cryptocd/htdocs/online_version/VERSION
update the symbolic link "aktuell" in the "online_version" directory
sftp shell.eduforge.org
cd /home/groups/cryptocd/htdocs/online_version/
rm aktuell
ln VERSION aktuell

341
v1.3/ccd-infos/entwicklungs-leitfaden.lyx Normal file
View file

@ -0,0 +1,341 @@
#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 english
\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 indent
\defskip medskip
\quotes_language english
\papercolumns 1
\papersides 1
\paperpagestyle default
\tracking_changes false
\output_changes true
\end_header
\begin_body
\begin_layout Title
EntwicklerInnen-Leitfaden für die CryptoCD
\end_layout
\begin_layout Standard
\begin_inset LatexCommand \tableofcontents{}
\end_inset
\end_layout
\begin_layout Section
Vorbereitung
\end_layout
\begin_layout Subsection
erforderliche Software
\end_layout
\begin_layout Standard
Die folgenden Programme benötigst du zur Weiterentwicklung der CryptoCD.
In Klammern ist jeweils (als Beispiel) das dazugehörige Debian-Paket angegeben.
\end_layout
\begin_layout Itemize
make [make]
\end_layout
\begin_layout Itemize
lyx [lyx-qt | lyx-xforms]
\end_layout
\begin_layout Itemize
latex2html [latex2html]
\end_layout
\begin_layout Itemize
python [python]
\end_layout
\begin_layout Itemize
mkisofs [mkisofs]
\end_layout
\begin_layout Itemize
zip [zip]
\end_layout
\begin_layout Itemize
tar [tar]
\end_layout
\begin_layout Itemize
bzip2 [bzip2]
\end_layout
\begin_layout Itemize
subversion [subversion]
\end_layout
\begin_layout Itemize
linkchecker [linkchecker]
\end_layout
\begin_layout Itemize
html-validator [wdg-html-validator]
\end_layout
\begin_layout Itemize
unix2dos [tofrodos]
\end_layout
\begin_layout Subsection
Herunterladen der Entwickler-Version
\end_layout
\begin_layout Standard
Wir verwalten die Quell-Dateien der CryptoCD mit der Versionsverwaltung
\emph on
subversion
\emph default
.
Mit dem folgenden Kommando erstellst du eine lokale Arbeitskopie der aktuellen
Revision:
\end_layout
\begin_layout Quote
svn checkout https://svn.systemausfall.org/svn/cryptocd
\end_layout
\begin_layout Section
Bearbeitung der Anleitungstexte
\end_layout
\begin_layout Standard
Die Richtlinien zur Erstellung von neuen Anleitungen findest du hier:
\begin_inset Include \input{policy_formatierung.lyx}
preview false
\end_inset
\end_layout
\begin_layout Section
Release
\end_layout
\begin_layout Subsection
Anpassung der Versionsnummer
\end_layout
\begin_layout Standard
Vor der Veröffentlichung einer neuen Version, müssen die Versionnummern
in folgenden Dokumenten angepasst werden:
\end_layout
\begin_layout Itemize
cover
\end_layout
\begin_layout Itemize
footer
\end_layout
\begin_layout Subsection
Changelog
\end_layout
\begin_layout Standard
Im Verzeichnis cd-template liegt die Datei
\emph on
news.txt
\emph default
- dort kannst du die Änderungen von Version zu Version erfassen.
\end_layout
\begin_layout Subsection
Finales Testen
\end_layout
\begin_layout Quote
make linkcheck
\end_layout
\begin_layout Quote
make validate
\end_layout
\begin_layout Subsection
Erstellung der Release-Dateien
\end_layout
\begin_layout Itemize
make all
\end_layout
\begin_deeper
\begin_layout Itemize
zip-Datei
\end_layout
\begin_layout Itemize
iso-Image
\end_layout
\begin_layout Itemize
source-bzip2
\end_layout
\end_deeper
\begin_layout Subsection
Hochladen zu eduforge.org
\end_layout
\begin_layout Subsubsection
Pakete
\end_layout
\begin_layout Standard
Um zu beobachten, wie häufig die CryptoCD heruntergeladen wurde, empfielt
es sich, alle Dateien über das sogenannte
\emph on
file release system (frs)
\emph default
anzubieten.
Da der Upload über die Weboberfläche nur für Dateien bis zu 2 MB Grösse
möglich ist, erfolgt der Upload per sftp.
Dazu benötigst du folgende Daten:
\end_layout
\begin_layout Itemize
Rechner: shell.eduforge.org
\end_layout
\begin_layout Itemize
Login: deinE eduforge NutzerIn
\end_layout
\begin_layout Itemize
Protokoll: ssh2 (sftp)
\end_layout
\begin_layout Itemize
Upload-Verzeichnis: sftp://ftp.eduforge.org/home/pub/cryptocd/
\end_layout
\begin_layout Standard
Es ist wichtig, dass du die hochgeladenen Dateien anschließend mit Gruppen-Schre
ibrechten versiehst.
\end_layout
\begin_layout Standard
Nun müssen die hochgeladenen Dateien im Eduforge-Download-Manager veröffentlicht
werden:
\end_layout
\begin_layout Itemize
im Web-Interface anmelden
\end_layout
\begin_layout Itemize
Projekt
\emph on
CryptoCD
\emph default
auswählen
\end_layout
\begin_layout Itemize
\emph on
Admin -> Admin FRS -> Add Release
\end_layout
\begin_layout Subsubsection
Online-Version
\end_layout
\begin_layout Standard
Um die Online-Version hochzuladen, loggst du dich erneut per sftp bei eduforge
ein (Daten siehe oben).
Anschliessend wechselst du in das Verzeichis /
\emph on
home/groups/cryptocd/htdocs/online_version
\emph default
und legst ein entsprechendes Unterverzeichnis für die jeweilige Version
an.
\end_layout
\begin_layout Subsection
Anpassen der cryptocd.org-Seite
\end_layout
\begin_layout Standard
Im svn befindet sich das Verzeichnis
\emph on
eduforge
\emph default
.
Die Datei
\emph on
index.html
\emph default
ist die Seite, die nach einem Aufruf von cryptocd.org angezeigt wird.
Erscheint eine neue Version, so müssen folgende Abschnitte angepasst werden:
\end_layout
\begin_layout Itemize
Menü: Link zur Online-Version anpassen
\end_layout
\begin_layout Itemize
Neues: kurzer Text zur neuen Version und changelog
\end_layout
\begin_layout Itemize
Download: die Links und Versionsnummern entsprechend anpassen
\end_layout
\begin_layout Itemize
Online-Version: Link anpassen
\end_layout
\begin_layout Standard
Anschließend wird die Datei per sftp (Zugangsdaten siehe 3.5.1) in das Verzeichnis
\emph on
/home/groups/cryptocd/htdocs
\emph default
hochgeladen.
\end_layout
\begin_layout Subsection
Werbung
\end_layout
\begin_layout Standard
Ankündigung auf der mailingliste ...
\end_layout
\end_body
\end_document

30
v1.3/ccd-infos/export_info.txt Normal file
View file

@ -0,0 +1,30 @@
===== 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
- unix2dos (Debian: im Paket 'tofrodos' enthalten)
===== 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.

794
v1.3/ccd-infos/policy_formatierung.lyx Normal file
View file

@ -0,0 +1,794 @@
#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 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älst.
\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
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 Fortschritssbalken (optional)
\end_layout
\begin_layout Standard
Am Ende der meisten Dokumente erscheint ein Fortschrittsbalken.
Er zeigt auf, welche Seite in der Dokumentation bereits bearbeitet wurden
und welche noch folgen.
Beim Erstellen eines neuen Fortschrittsbalken ist wichtig, dass du ihm
die Bezeichnung des Dokumentes übergibst, in das er eingefügt werden soll,
bpsw: progress_policy_formatierung.inc
\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: progress_$LYXDOKUMENT.inc, der Speicherort ist: progress/
\end_layout
\begin_layout Itemize
Im Eingabefeld muss es dann so lauten: progress/progress_$LYXDOKUMENT.inc
\end_layout
\begin_layout Itemize
die Art der Einbindung ist ''Input''
\end_layout
\begin_layout Itemize
Beispiel:
\begin_inset Include \input{progress/progress_policy_formatierung.inc}
preview false
\end_inset
\end_layout
\begin_layout Section
Das Dokument speichern
\end_layout
\begin_layout Standard
Zum Speichern stehen dir vier Verzeichnisse unterhalb von trunk/documents
zur Verfügung:
\end_layout
\begin_layout Enumerate
common/ -- Hier kommen für alle Betriebssysteme gültige Dokumente rein
\end_layout
\begin_layout Enumerate
windows/, linux/, macos/ -- Hier werden jeweils die spezifischen Dokumente
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 Verzeichniss an,
\end_layout
\begin_layout Itemize
benenne dieses Verzeichnis genauso, wie du das Lyx-Dokument benennest,
\end_layout
\begin_layout Itemize
speichere das Lyx-Dokument ab.
\end_layout
\end_body
\end_document

11
v1.3/cd-template/CryptoCD_Start.html Normal file
View file

@ -0,0 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="de">
<head>
<meta http-equiv="refresh" content="0; URL=doku/windows/index/index.html">
<title>Die CryptoCD</title>
</head>
<body>
Automatische Weiterleitung zur <a href="doku/windows/index/index.html" title="Dokumentation">Dokumentation</a> ...
</body>
</html>

2
v1.3/cd-template/autorun.inf Normal file
View file

@ -0,0 +1,2 @@
[autorun]
open=programme\shellopn.exe CryptoCD_Start.html

51
v1.3/cd-template/copyleft.txt Normal file
View file

@ -0,0 +1,51 @@
Copyleft:
Die CryptoCD unterliegt der Creative-Commons-Lizenz:
Namensnennung - NichtKommerziell - Weitergabe unter gleichen
Bedingungen 2.0 Deutschland.
http://creativecommons.org/licenses/by-nc-sa/2.0/deed.de
Abweichend davon gelten die folgenden Lizenzen:
Betriebssystem-Logos
Fuer die auf den Bildern pc_linux.png, pc_windows.png, pc_mac.png
zu sehenden Logos, gelten folgende Bedingungen:
Penguin
The copyright holder of this file allows anyone to use it for any
purpose, provided that the copyright holders Larry Ewing, Simon
Budig and Anja Gerwinski are mentioned.
Windows/Mac OS
Beide Logos koennen frei verwendet werden, sind aber
wahrscheinlich durch das deutsche Markengesetz oder vergleichbare
Gesetze geschuetzt.
Enigmail (Thunderbird-Erweiterung)
http://enigmail.mozdev.org/
Mozilla Public License Version 1.1
http://www.mozilla.org/MPL/MPL-1.1.html
GnuPG (Verschluesselungs-Programm)
http://www.gnupg.org/
GNU General Public License
http://www.gnu.org/copyleft/gpl.html
Gaim (Chat-Programm)
http://gaim.sourceforge.net/
GNU General Public License
http://www.gnu.org/copyleft/gpl.html
Gaim-Encryption (Gaim-Plugin)
http://gaim-encryption.sourceforge.net/
GNU General Public License
http://www.gnu.org/copyleft/gpl.html
Tango Desktop Project (Icons)
http://tango.freedesktop.org/Tango_Desktop_Project
Creativ Commons Attribution-ShareAlike 2.5
http://creativecommons.org/licenses/by-sa/2.5/
Thunderbird (E-Mail-Programm)
http://www.mozilla.com/thunderbird/
Mozilla Public License Version 1.1
http://www.mozilla.org/MPL/MPL-1.1.html

BIN
v1.3/cd-template/cover/cover.jpg Executable file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 339 KiB

BIN
v1.3/cd-template/cover/cover.odt Normal file
View file

Binary file not shown.

BIN
v1.3/cd-template/cover/cover.pdf Normal file
View file

Binary file not shown.

BIN
v1.3/cd-template/cover/cover_eduforge.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 4.5 KiB

BIN
v1.3/cd-template/cover/deed.gif Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 811 B

BIN
v1.3/cd-template/cover/deed2.gif Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 813 B

BIN
v1.3/cd-template/cover/deed3.gif Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 830 B

BIN
v1.3/cd-template/cover/logox.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 256 KiB

BIN
v1.3/cd-template/cover/logox_grau_hintergrund.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 72 KiB

BIN
v1.3/cd-template/doku/chat.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 4.4 KiB

372
v1.3/cd-template/doku/cryptocd.css Normal file
View file

@ -0,0 +1,372 @@
/*
HINWEISE
padding,margin Angaben: oben rechts unten links
*/
body {
margin: 0px;
padding: 0px;
font-size: 11pt;
font-family: helvetica, luxi sans, trebuchet ms, bitstream vera sans, sans-serif;
}
html>body {
font-family: luxi sans, trebuchet ms, bitstream vera sans, sans-serif;
}
h1, h2, h3, h4 {
font-family: georgia, times new roman, times, serif;
font-weight: normal;
background: none;
padding: 1.75em 0 0;
margin: 0;
line-height: 1.1em;
}
h1 {
font-size: 220%;
text-align: center;
color: #555753;
padding: 0 0 0.5em;
margin: 0.75em 0 1.5em 0;
}
h2 {
font-size: 150%;
color: #555753;
}
h3 {
font-size: 120%;
color: #888a85;
}
/* Seiten-Untertitel */
.author_info {
text-align: center;
color: #B7B7B7;
margin-top: -3.5em;
font-size: 110%;
}
a:link {
text-decoration: none;
color: #f57900;
background: none;
}
a:visited {
color: #ce5c00;
text-decoration: none;
}
a:active {
color: #f57900;
}
a:hover {
color: #fcaf3e;
text-decoration: underline;
}
hr {
height: 1px;
border: 1px solid silver;
border-bottom: none;
border-right: none;
border-left: none;
}
tt {
font-size: 90%;
text-decoration: underline;
}
#container {
padding: 0;
margin: 0;
}
#container hr {
width: 0px;
}
#container .externalLink {
background: url(externallink.png) center right no-repeat;
padding-right: 13px;
}
#titlenav {
position: absolute;
top: 20px;
left: 20px;
display: inline;
margin: 0;
padding: 0;
z-index: 5;
font-size: 110%;
}
#titlenav li {
color: #43598e;
float: left;
list-style-type: disc;
margin-left: 15pt;
padding: 5pt 10pt;
}
#titlenav li:first-child {
/*margin-left: 0;*/
padding-left: 0;
list-style: none;
}
#titlenav a {
color: #f57900;
display: block;
}
#titlenav a:hover {
color: #fcaf3e;
}
#titlebar {
background-color: #33436a;
text-shadow: 2px 2px 3px gray;
height: 54px;
padding-top: 1px;
padding-left: 16px;
padding-right: 16px;
border-bottom: 6px solid #f57900;
}
#titlebar .left {
text-align: left;
color: #f57900;
float: left;
}
#titlebar .right {
text-align: right;
color: #ffffff;
font-size: 44px;
}
/* #### Menue #### */
#nav {
float: left;
background-color: transparent;
text-align: left;
width: 180px;
margin: 0 0 0.5em 2em;
padding: 0.75em;
font-size: 90%;
border:1px solid #ccc;
background-color: #f6f6f6;
line-height: normal;
}
#nav a {
text-decoration: none;
}
#nav li {
margin: 0 0 0 -2em;
list-style-type: square;
color: #888a85;
padding-top: 1em;
}
#navtitle {
color: #888;
font-size: 90%;
}
.toclevel-2 {
color: #babdb6;
}
/* #### Hauptteil #### */
#main {
margin-left: 25%;
padding: 0 1em;
text-align: justify;
}
#main li {
margin: 0.5em;
}
#main ul li {
margin: 0.5em;
list-style-type: square;
list-style-position: inside;
}
/* Abstand von Bildern + Bildunterschrift zum folgenden Absatz */
#main table caption {
margin-bottom: 1.5em;
}
#main img {
margin-bottom: 1.5em;
border: 0;
}
#toctitle {
color: #888;
font-size: 90%;
}