c3d2-wiki/C3D2-Web.mw

=Über C3D2-Web=

[[C3D2-Web]] ist die neue Website für http://www.c3d2.de/

Bevor zu viele Leute enttäuscht werden, soll diese erstmal testweise ''ausgerollt'' werden, damit an der Seite interessierte Leute damit rumexperimentieren können.

==Propaganda==
[[Bild:XML Sit-Ups.png|right|XML Sit-Ups sind gar nicht schwer]]

Wir verlassen uns hier nicht auf irgendein CMS, sondern verwenden standardisierte, etablierte Techniken. Für XSLT gibt es mehr als eine Implementation. Des weiteren ist es bereits so, dass das System schon von mehr als einer Person kapiert wird.

Als Side-effect sollte noch gesagt werden, dass sämtliche Seiten statisch sind. Wir sind also gegen XSS und xyz-Injection gefeit. Passwortabfragen können wir immernoch mit ''.htaccess'' lösen.

=Wo?=

==SVN==
[http://subversion.tigris.org/ Subversion] bietet uns praktisch Wiki-Funktionalität:
*Jeder darf bearbeiten
*Änderungen sind verfolgbar

Um mitzumachen kann man sich das ganze Paket mit folgendem Befehl holen:
 svn co svn://svn.cccv.de/c3d2-web/trunk c3d2-web

Danach hat man ein Verzeichnis [http://trac.cccv.de/c3d2-web/browser/trunk c3d2-web/] auf Platte, mit dem man herumexperimentieren kann.
Um es auf den neuesten Stand zu bringen, reicht es in diesem Verzeichnis den folgenden Befehl auszuführen:
 svn up

Für die aktive Beteiligung braucht man natürlich einen Account mit Schreibrechten. Für einen solchen muss man nur [[Benutzer:Sven|Sven]] benachrichtigen. Nach diesem Account wird beim nächsten '''svn ci''' gefragt.

==Web==
Stündlich gebaut: http://ωωω.c3d2.de/ (bzw. http://newwww.c3d2.de/)

Wenn zudem etwas in das SVN eingecheckt wird, dann werden Commit-Messages per Jabber empfangen. Ein spezieller Triggerbot empfängt diese ebenfalls, wird dann die Homepage sofort neubauen und publizieren.

Zu diesem Bot kann man sich auch subscriben, einfach [xmpp:c3d2-web-trigger@pentabarf.org c3d2-web-trigger@pentabarf.org] zum Roster hinzufügen. Einzige Funktion ist die Anzeige der letzten Neubauzeit.

=Bearbeiten=
Während das hier alles nach ''viel'' aussieht, gibt es den entscheidenden Vorteil: '''XML ist selbsterklärend!'''

==Grundlegendes zum Umgang==
{|
!Verzeichnis
!Bedeutung
|-
|''build''
|temporäres Verzeichnis, in dem alle erstellten html-Dateien landen
|-
|''content/datenspuren''
|Datenspuren-Seiten.
|-
|''content/pages''
|XML-Dateien mit einzelnen Seiten (Wiki, SILC, Mailingliste etc.)
|-
|''content/static''
|Statische Inhalte (Bilder, Styles etc.), mit Struktur, wie sie später unter www/ landen sollen. (Datenspuren-Sachen sind auch hier!)
|-
|''dtd''
|Dokumenttypdefinitionen aufgrund derer einen xmllint anmeckern wird, wenn man Tags falsch benutzt.
|-
|''scripts''
|Hilfsskripte zum Bauen
|-
|''xslfo''
|XSL:FO-Geraffel für den imaginären DS-Guide, für welchen kein Inhalt zustande kam
|-
|''www''
|Das ist nach dem Bauen das fertige Verzeichnis, in dem die Site liegt, wie sie ins htdocs exportiert werden kann.
|-
|''xsl''
|Hier residieren die Definitionen, aus dem XML-Inhalt XHTML-Webseiten und RSS-Feeds zu bauen.
|}

Den gewöhnlichen Autor interessieren eigentlich nur die Dateien in ''content/''. Dort kann er die XML-Dateien nach unten genannten Schemata bearbeiten. Wenn kein gültiges XML eingefüttert wird, spuckt '''xmllint''' (bzw. '''xsltproc''') schon erklärende Fehlermeldungen.

===Zeichensätze===
Die sind wichtig. Alle XML-Dateien werden als '''UTF-8''' kodiert. Für ''vim''-Benutzer mit ''ISO8859''-Terminal:
 :set termencoding=latin1
 :set fileencoding=utf8

===Build===
Um zu schauen, wie sich die eigenen Änderungen machen, gibt man im ''c3d2-web/''-Verzeichnis '''make''' (unter *BSD: '''gmake''') ein. Dann werden mithilfe '''xsltproc''' (oft in ''libxslt'' paketiert) in Windeseile in ''build/'' die html- und rss-Dateien gebaut. Wenn alles fertig ist kopiert rsync alles zusammen mit dem Inhalt von content/static nach www/, das ist ganz nützlich um zu sehen, welche Dateien sich tatsächlich verändert haben.

Beim Build-Prozess wird http://www.ccc.de/updates/chaosupdates.rdf für die Seitenleiste gesaugt. Das passiert aber nur einmal, bis man ''make clean'' ausführt.

==News schreiben==
#Irgendeine vorhandene News-Seite in c3d2-web/content/news auf '''c3d2-web/content/news/<dateiname>.xml''' kopieren.
#Der Dateiname sollte irgendetwas sinnvolles und noch nicht vorhanden sein.
#Inhalt eingeben und Attribute für <item/> setzen.
#'''make''' und im Browser anschauen
#'''svn commit'''

Das sieht dann z.B. so aus:

<pre><nowiki>
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE item SYSTEM "http://www.c3d2.de/dtd/c3d2web.dtd">
 <item title="TA: Ruby &amp; Ruby on Rails" date="2006-03-19T19:00:00" author="Astro" category="Themenabend">
   <image title="Ruby">http://www.rubygarden.com/ruby.jpg</image>
   <p>
     <dl>
       <dt>Termin</dt>
       <dd>10. März 2006, 19:00 Uhr</dd>
       <dt>Ort</dt>
       <dd>Berufsakademie Dresden, Raum G3, Heideparkstr. 8, 01099 Dresden</dd>
       <dt>Themen</dt>
       <dd>Einführung in Ruby</dd>
       <dd>Ruby-MediaWiki</dd>
       <dd>Einführung in Ruby on Rails</dd>
       <dd>Erstellen eines Wiki mit Rails</dd>
       <dd>Jabber-Library XMPP4R</dd>
     </dl>
   </p>
   <resource title="Vortragsfolien" size="234223" type="application/pdf">http://example.com/slides.pdf</resource>
 </item>
</nowiki></pre>

===<item/>-Attribute===
{|
!Attribut
!Beschreibung
|-
|''title'' || News-Titel
|-
|''date'' || News-Datum in standardisierter Form, z.B. für RSS-Feeds und automatisierte Verarbeitung. (Ausgabe von '''date +%FT%T'''.)
|-
|''author'' || Wer hat's geschrieben?
|-
|''category'' || Eine Kategorie (sowas hatte die alte Seite auch). Danach soll eventuell mal ein Bild eingefügt werden, wenn man kein's per Hand vergibt.
|}

===Inhalt===
Muss in ein ''<nowiki><p/></nowiki>'' einschlossen werden. Vorher darf noch ein einzelnes <image/> stehen, dieses wird dann automatisch linksbündig oder rechtsbündig angeordnet (aktuell deaktiviert). Für weitere, erlaubte Elemente, siehe [[C3D2-Web#Seiten bearbeiten|Seiten bearbeiten]].

===Erweiterter Inhalt===
Seit r324 wird für jede News noch eine Extraseite angelegt. Für Text, der dort erscheinen, aber nicht in der Übersicht stehen soll, darf in <item/> noch zusätzlich ein <addendum/> geschrieben werden. Dort kann alles rein, was auch in eine normale Seite kann.

===<resource/>===
Damit Downloads als enclosures in RSS und ATOM auftauchen (ein Podcast!11), gibt man sie als <resource/> an. Nebenbei erscheinen sie auch im HTML, schliesslich sollen alle Daten verwurstet werden.
{|
|''Inhalt'' || URL zum Download
|-
|''Attribut "title" || Ein Kurztitel nur fürs HTML, Fallback auf Inhalt
|-
|''Attribut "size"'' ||  Contentgröße in Bytes
|-
|''Attribut "type"'' || MIME-Type
|-
|''Attribute "hide"'' || Wenn "yes", so wird diese Ressource nicht auf der Nachrichtenübersichtsseite angezeigt. Das ist sinnvoll, wenn es eine Menge Dateien (wie bei DS-Mitschnitten) gibt, die man als Podcast anbieten möchte, jedoch in ihrem vollen Umfang auf der Übersichtsseite stören würden.
|}

'''TODO:''' [http://trac.cccv.de/c3d2-web/ticket/13 iTunes-Extensions]

==Neue Seite erstellen==
Siehe auch: [[C3D2-Web/Seite_anlegen|Schritt-für-Schritt-Anleitung]]

Zuerst erstellt man eine neue XML-Datei in ''content/pages'' nach folgendem Schema (oder man kopiert eine bereits vorhandene):
<pre><nowiki>
<page title="Kontakt" pagetitle="E-Mail">
 <p>
  Anfragen an den Chaostreff Dresden bitte an <link href="mailto:mail@c3d2.de">mail@c3d2.de</link>.
 </p>
 <p>
  Diese Adresse geht moderiert an unsere Mailingliste, d. h. an alle dort eingetragenen E-Mailadressen.
 </p>
</page>
</nowiki></pre>

Natürlich sind mehrere <nowiki><p/></nowiki>-Elemente möglich.

Diese Datei muss dann mit '''svn add''' dem Repository hinzugefügt werden, womit sie beim nächsten '''svn commit''' hochgeladen wird.

===<page/>-Attribute===
{|
!Attribut
!Beschreibung
|-
|''title'' || Allgemeiner Seitentitel
|-
|''pagetitle'' || Optionaler langer Seitentitel
|}

===Seite in Navigationsleiste aufnehmen===
Dazu bearbeitet man ''content/navigation.xml''. Dort erstellt man ein neues <file/>-Element mit dem Pfad zur Datei unter content aber ohne Erweiterung, z.B. <file>content/kontakt</file>. Als Linktitel wird automatisch das ''pagetitle''-Attribut der entsprechenden Seite verwendet.

==Seiten bearbeiten==
#'''c3d2-web/content/wasichbearbeitenwill.xml''' öffnen
#Gewünschte Änderungen vornehmen
#'''make''' und im Browser testen
#'''svn commit'''


In ''<page/>'' dürfen folgende Elemente auftauchen:

===<nowiki><pre/></nowiki>===
Hier werden Inhalte wie eingegeben formatiert. Geeignet für Skripte, Konsolenausgaben, ...
 <nowiki><pre>% uname -sr
 FreeBSD 6.0-STABLE</pre></nowiki>

'''Hinweis:''' Laut XHTML darf <''pre''/> '''nicht''' in <''p''/> vorkommen!

===<nowiki><p/></nowiki>===
 <'''p'''>Ein Absatz. Mindestens einer wird empfohlen.</'''p'''>

===<image/>===
 <'''image''' class="right" title="Linux-Unfug-Tag"><nowiki>http://www.linux-unfug-tag.de/logo.png</nowiki></'''image'''>

{|
!Attribut
!Beschreibung
|-
|''class'' || Art der Darstellung, entweder ''left'' oder ''right''
|-
|''title'' || Hinweis, wird in ''title'' und ''alt'' gesteckt
|}

====Bild hochladen====
 cp /home/hacker/bild.png www/images/bild_vom_hacker.png
 svn add www/images/bild_vom_hacker.png
 svn ci  # Braucht Account mit Schreibrechten

===<link/>===
 <'''link'''><nowiki>http://www.ccc.de/</nowiki></'''link'''>
 <'''link''' href="<nowiki>http://www.ccc.de/</nowiki>">CCC</'''link'''>

{|
!Attribut
!Beschreibung
|-
|''href'' || Linkziel, falls ausgelassen wird der Inhalt verwendet
|}

=Entwicklung=

Es gibt verschiedene Branches, in denen Testversuche ausgeführt werden. Diese werden dann in den Hauptentwicklungszweig ''trunk'' zurückgeführt.

Die Planung erfolgt unter http://trac.cccv.de/c3d2-web

Dort existiert auch ein [http://trac.cccv.de/c3d2-web Trac], wo man sich die aktuellen Bugreports per RSS zukommen lassen kann: http://trac.cccv.de/c3d2-web/report/1?format=rss

=Datenspuren-Schedule=

''content/datenspuren/schedule.xml'' kommt von https://pentabarf.cccv.de/~sven/schedule/DS2006/days