* Entwicklungsleitfaden ausgebaut

- Hochladen zu Eduforge
    - Aktualisierung von cryptocd.org
This commit is contained in:
phil 2006-06-11 10:05:43 +00:00
parent 300d9bb7c3
commit 973555ceb9

View file

@ -1,139 +1,295 @@
#LyX 1.3 created this file. For more info see http://www.lyx.org/ #LyX 1.4.1 created this file. For more info see http://www.lyx.org/
\lyxformat 221 \lyxformat 245
\begin_document
\begin_header
\textclass article \textclass article
\begin_preamble
\usepackage{hyperref}
\usepackage{html}
\usepackage{german}
\end_preamble
\language english \language english
\inputencoding auto \inputencoding auto
\fontscheme default \fontscheme default
\graphics default \graphics default
\paperfontsize default \paperfontsize default
\papersize Default \spacing single
\paperpackage a4 \papersize default
\use_geometry 0 \use_geometry false
\use_amsmath 0 \use_amsmath 1
\use_natbib 0 \cite_engine basic
\use_numerical_citations 0 \use_bibtopic false
\paperorientation portrait \paperorientation portrait
\secnumdepth 3 \secnumdepth 3
\tocdepth 3 \tocdepth 3
\paragraph_separation indent \paragraph_separation indent
\defskip medskip \defskip medskip
\quotes_language english \quotes_language english
\quotes_times 2
\papercolumns 1 \papercolumns 1
\papersides 1 \papersides 1
\paperpagestyle default \paperpagestyle default
\tracking_changes false
\output_changes true
\end_header
\layout Title \begin_body
\begin_layout Title
EntwicklerInnen-Leitfaden für die CryptoCD EntwicklerInnen-Leitfaden für die CryptoCD
\layout Section \end_layout
\begin_layout Standard
\begin_inset LatexCommand \tableofcontents{}
\end_inset
\end_layout
\begin_layout Section
Vorbereitung Vorbereitung
\layout Subsection \end_layout
\begin_layout Subsection
erforderliche Software erforderliche Software
\layout Standard \end_layout
\begin_layout Standard
Die folgenden Programme benötigst du zur Weiterentwicklung der CryptoCD. Die folgenden Programme benötigst du zur Weiterentwicklung der CryptoCD.
In Klammern ist jeweils (als Beispiel) das dazugehörige Debian-Paket angegeben. In Klammern ist jeweils (als Beispiel) das dazugehörige Debian-Paket angegeben.
\layout Itemize \end_layout
\begin_layout Itemize
make [make] make [make]
\layout Itemize \end_layout
\begin_layout Itemize
lyx [lyx-qt | lyx-xforms] lyx [lyx-qt | lyx-xforms]
\layout Itemize \end_layout
\begin_layout Itemize
latex2html [latex2html] latex2html [latex2html]
\layout Itemize \end_layout
\begin_layout Itemize
python [python] python [python]
\layout Itemize \end_layout
mkisofs [mkisofs \begin_layout Itemize
\layout Itemize mkisofs [mkisofs]
\end_layout
\begin_layout Itemize
zip [zip] zip [zip]
\layout Itemize \end_layout
\begin_layout Itemize
tar [tar] tar [tar]
\layout Itemize \end_layout
\begin_layout Itemize
bzip2 [bzip2] bzip2 [bzip2]
\layout Itemize \end_layout
\begin_layout Itemize
subversion [subversion] subversion [subversion]
\layout Itemize \end_layout
\begin_layout Itemize
linkchecker [linkchecker] linkchecker [linkchecker]
\layout Itemize \end_layout
\begin_layout Itemize
wdg-html-validator [wdg-html-validator] wdg-html-validator [wdg-html-validator]
\layout Itemize \end_layout
\begin_layout Itemize
unix2dos [tofrodos] unix2dos [tofrodos]
\layout Subsection \end_layout
\begin_layout Subsection
Herunterladen der Entwickler-Version Herunterladen der Entwickler-Version
\layout Standard \end_layout
\begin_layout Standard
Wir verwalten die Quell-Dateien der CryptoCD mit der Versionsverwaltung Wir verwalten die Quell-Dateien der CryptoCD mit der Versionsverwaltung
\emph on \emph on
subversion subversion
\emph default \emph default
. .
Mit dem folgenden Kommando erstellst du eine lokale Arbeitskopie der aktuellen Mit dem folgenden Kommando erstellst du eine lokale Arbeitskopie der aktuellen
Revision: Revision:
\layout Quote \end_layout
\begin_layout Quote
svn checkout https://svn.systemausfall.org/svn/cryptocd svn checkout https://svn.systemausfall.org/svn/cryptocd
\layout Section \end_layout
\begin_layout Section
Bearbeitung der Anleitungstexte Bearbeitung der Anleitungstexte
\layout Standard \end_layout
Hier sollte die Formatierungspolicy reinkommen - Menue, ... \begin_layout Standard
\layout Section 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 Release
\layout Subsection \end_layout
\begin_layout Subsection
Anpassung der Versionsnummer Anpassung der Versionsnummer
\layout Itemize \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 cover
\layout Itemize \end_layout
\begin_layout Itemize
footer footer
\layout Subsection \end_layout
\begin_layout Subsection
Changelog Changelog
\layout Subsection \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 Finales Testen
\layout Quote \end_layout
\begin_layout Quote
make check make check
\layout Quote \end_layout
\begin_layout Quote
make validate make validate
\layout Subsection \end_layout
\begin_layout Subsection
Erstellung der Release-Dateien Erstellung der Release-Dateien
\layout Subsection \end_layout
Hochladen \begin_layout Subsection
\layout Itemize Hochladen zu eduforge.org
\end_layout
eduforge - download \begin_layout Subsubsection
\layout Itemize Pakete
\end_layout
eduforge - online-Variante \begin_layout Standard
\layout Subsection 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 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
Anschliessend wird die Datei per sftp (Zugangsdaten siehe 3.5.1) in das Verzeichni
s
\emph on
/home/groups/cryptocd/htdocs
\emph default
hochgeladen.
\end_layout
\begin_layout Subsection
Werbung Werbung
\layout Standard \end_layout
\begin_layout Standard
Ankündigung auf der mailingliste ... Ankündigung auf der mailingliste ...
\the_end \end_layout
\end_body
\end_document