Added page on website maintenance.
authorJan-Oliver Wagner <jan@intevation.de>
Thu, 9 Mar 2006 10:48:39 +0000 (10:48 +0000)
committerJan-Oliver Wagner <jan@intevation.de>
Thu, 9 Mar 2006 10:48:39 +0000 (10:48 +0000)
Logo no links the main page.
Added Sitemap link box.

doc/website/template_header.m4
doc/website/template_link_boxes_de.m4
doc/website/template_link_boxes_en.m4
doc/website/website-maintenance-de.htm4 [new file with mode: 0644]
doc/website/website-maintenance.htm4 [new file with mode: 0644]

index 8af82a9..25651da 100644 (file)
@@ -18,7 +18,8 @@ m4_ifdef(`__TMPL_PAGE_TITLE',,`m4_define(`__TMPL_PAGE_TITLE',`gpg4win - '__TITLE
   <body>
     <table id="navbar"><tr valign="bottom">
         <td style="width:172px; text-align: left; padding-bottom: 8px;">
-          <img src="pix/logo.png" alt="gpg4win">
+          <a href="I18N(`EN', `index.html') I18N(`DE', `index-de.html')"
+            ><img src="pix/logo.png" alt="gpg4win"></a>
         </td>
         <td style="text-align: left;">
           <h1>__TITLE</h1>
index 254a51c..5ec4719 100644 (file)
@@ -24,6 +24,9 @@ m4_dnl DONT USE THIS FILE DIRECTLY
 <div class="box">
   <h1>Mitmachen</h1>
   <a href="http://wald.intevation.org/projects/gpg4win/">Projektseite</a>
+  <p>Anleitungen:<br>
+  <a href="website-maintenance-de.html">Website pflegen</a>
+  </p>
 </div>
 <div class="box">
   <h1>Ähnliche Projekte</h1>
@@ -32,3 +35,8 @@ m4_dnl DONT USE THIS FILE DIRECTLY
   <a href="http://sourceforge.net/projects/winpt">Windows Privacy Tools</a> (veraltet)<br>
   <a href="http://www.gnupp.de/start.html">GnuPP</a> (veraltet)<br>
 </div>
+<div class="box">
+  <h1>Sitemap</h1>
+  <a href="index-de.html">Hauptseite</a><br>
+  &nbsp;&nbsp;<a href="website-maintenance-de.html">Website pflegen</a><br>
+</div>
index e11a293..20761cc 100644 (file)
@@ -24,6 +24,9 @@ m4_dnl DONT USE THIS FILE DIRECTLY
 <div class="box">
   <h1>Getting involved</h1>
   <a href="http://wald.intevation.org/projects/gpg4win/">Project Site</a>
+  <p>Howtos:<br>
+  <a href="website-maintenance.html">Maintaining Website</a>
+  </p>
 </div>
 <div class="box">
   <h1>Similar Projects</h1>
@@ -32,3 +35,8 @@ m4_dnl DONT USE THIS FILE DIRECTLY
   <a href="http://sourceforge.net/projects/winpt">Windows Privacy Tools</a> (outdated)<br>
   <a href="http://www.gnupp.de/start.html">GnuPP</a> (outdated)<br>
 </div>
+<div class="box">
+  <h1>Sitemap</h1>
+  <a href="index.html">Main page</a><br>
+  &nbsp;&nbsp;<a href="website-maintenance.html">Maintaining Website</a><br>
+</div>
diff --git a/doc/website/website-maintenance-de.htm4 b/doc/website/website-maintenance-de.htm4
new file mode 100644 (file)
index 0000000..14dc94f
--- /dev/null
@@ -0,0 +1,84 @@
+m4_dnl -*-html-*-
+m4_include(`template.m4')
+m4_dnl $Id$
+
+m4_define(`DE')
+m4_define(`EN_FILE', `website-maintenance.html')
+PAGE_START
+
+<h1>Website von gpg4win pflegen</h1>
+
+Die Pflege der Website ist eigentlich recht einfach, da
+vieles automatisiert ist.
+
+<p>
+Was man beherrschen sollte: Irgendeinen Text-Editor, HTML, ssh und
+Subversions.
+</p>
+
+<p>
+Typische Aufgaben:
+<ul>
+<li> Version von gpg4win aktualiseren (gelegentlich, ca. 15 Minuten)
+<li> Tippfehler beseitigen (immer wenn man selbst oder jemand anderes etwas findet, wenige Minuten)
+</ul>
+</p>
+
+<h2>Zunächst mal ganz anonym reinschnuppern</h2>
+
+<ol>
+<li> Die Quellen zur Website anonyme (also ohne Schreibrechte) holen:<br>
+     <em>svn checkout https://svn.wald.intevation.org/gpg4win/trunk/doc/website</em>
+
+<li> Die Website lokal bauen:<br>
+     <em>make -f buildhtml.mk</em><br>
+     und im Browser anschauen (z.B. Datei index-de.html).
+
+<li> Die Datei README lesen, nach belieben Änderungen vornehmen und die
+     Website dann wieder neu bauen und anschauen.
+</ol>
+
+<h2>Was man vorbereitend nur einmal machen muss um aktiver Mitentwickler zu werden</h2>
+
+Ein vorheriges "Hallo" auf einer der gpg4win Mailing Listen
+und dass man gerne mitmachen möchte ist natürlich immer sinnvoll.
+
+<ol>
+<li> Auf <a href="http://wald.intevation.de">wald.intevation.de</a> ein
+     <a href="http://wald.intevation.org/account/register.php">Benutzerkonto
+     einrichten</a>.<br>
+     Das geht schnell, denn es ist ein vollautomatischer Prozess.
+
+<li> Mitgliedschaft beim Projekt gpg4win
+     <a href="http://wald.intevation.org/project/request.php?group_id=11"
+       >beantragen</a>.<br>
+     Das dauert ein wenig, da einer der Projektadministoren den Antrag
+     persönlich bearbeitet.
+
+<li> Einen SSH-Schlüssel erzeugen und auf wald.intevation.de
+     <a href="http://wald.intevation.org/account/">hochladen</a>.
+
+<li> Die Quellen zur Website holen:<br>
+     <em>svn checkout svn+ssh://USER@svn.wald.intevation.org/gpg4win/trunk/doc/website</em><br>
+     wobei USER das Benutzerkonto auf wald.intevation.de ist.
+</ol>
+
+<h2>Wie man die Website aktualisiert und online schaltet</h2>
+
+<ol>
+<li> Gewünschte Änderungen in dem per SVN geholten Verzeichnis <em>website</em> durchführen.
+     Zum besseren Verständnis ggf. die dort liegende Datei <em>REAMDE</em> vorher
+     durchlesen.
+<li> Lokale Version zum Anschauen herstellen:<br>
+     <em>make -f buildhtml.mk</em><br>
+     und im Browser anschauen.
+<li> Sind die Änderungen in Ordnung, sollte man sie noch mal prüfen:<br>
+     <em>svn diff | less</em><br>
+     und können dann mit möglichst sinnvollen Kommentare ins SVN Repository
+     hochgeladen werden:<br>
+     <em>svn commit</em><br>
+<li> Der letzte Schritt ist das online schalten:<br>
+     <em>make -f buildhtml.mk online</em><br>
+</ol>
+
+PAGE_BOXES
diff --git a/doc/website/website-maintenance.htm4 b/doc/website/website-maintenance.htm4
new file mode 100644 (file)
index 0000000..9db1862
--- /dev/null
@@ -0,0 +1,88 @@
+m4_dnl -*-html-*-
+m4_include(`template.m4')
+m4_dnl $Id$
+
+m4_define(`EN')
+m4_define(`DE_FILE', `website-maintenance-de.html')
+PAGE_START
+
+<h1>Maintaining the gpg4win website</h1>
+
+The maintenance of the website is actually quite simply
+because many things are automized.
+
+<p>
+What you should be (or should become) familiar with: a text editor,
+HTML, ssh and Subversions.
+</p>
+
+<p>
+Typical tasks:
+<ul>
+<li> Update version of gpg4win (occasioanlly, ca. 15 minutes)
+<li> Fix typos (whenever you or someone else finds one, few minutes)
+</ul>
+</p>
+
+<h2>Anonymously take a first look</h2>
+
+<ol>
+<li> Get the sources for the website anonymously (without write access):<br>
+     <em>svn checkout https://svn.wald.intevation.org/gpg4win/trunk/doc/website</em>
+
+<li> Build the website locally:<br>
+     <em>make -f buildhtml.mk</em><br>
+     and open it in your browser (file index.html).
+
+<li> Read file README, make your changes, build the website
+     again and reopen it in your browser.
+</ol>
+
+<h2>What to do initially to become an active team member</h2>
+
+A prior "Hello" on one of the gpg4win mailing lists and your
+expression of interest to join the team is of course a good idea.
+
+<ol>
+<li> At <a href="http://wald.intevation.de">wald.intevation.de</a> you
+     should 
+     <a href="http://wald.intevation.org/account/register.php">create
+     a user account</a>.<br>
+     This is established quickly because it is an automatic process.
+
+<li> <a href="http://wald.intevation.org/project/request.php?group_id=11"
+       >Request</a> membership for project gpg4win.<br>
+     This takes a little time because one of the project administrators
+     has to answer the request.
+
+<li> Create a SSH key and
+     <a href="http://wald.intevation.org/account/">upload</a>
+     it to wald.intevation.de
+
+<li> Get the source for the website:<br>
+     <em>svn checkout svn+ssh://USER@svn.wald.intevation.org/gpg4win/trunk/doc/website</em><br>
+     where USER is the user account at wald.intevation.de.
+</ol>
+
+<h2>How to update the website and put it online</h2>
+
+<ol>
+<li> Apply your desired changes in the directory <em>website</em> which you retrieved
+     via SVN. The file <em>REAMDE</em> in this directory will provide you some
+     helpful hints.
+
+<li> Create local version:<br>
+     <em>make -f buildhtml.mk</em><br>
+     and open file index.html in your browser.
+
+<li> Are your changes complete, check them again:<br>
+     <em>svn diff | less</em><br>
+     and then upload them with some adequate comments
+     to the SVN repository:<br>
+     <em>svn commit</em><br>
+
+<li> The last step is to put the new version online:<br>
+     <em>make -f buildhtml.mk online</em><br>
+</ol>
+
+PAGE_BOXES