In letzter Zeit war ich hier nicht rege - aber trotzdem für S9y unterwegs
So gibt es nun in meinem Blog das
Das fragmentarische Quer-durch-das-Web Serendipity/S9y Online Handbuch
Das kann kein richtiges Handbuch ersetzen, soll aber der erste Versuch sein all die kleinen Anleitungen und Hinweise im Netz zu sammeln. Für eine "Auflage 2" nehme ich gerne weitere Hinweise entgegen. Vielleicht können wir dies ja dann auch zentral im S9y Wiki anbieten.
Das fragmentarische .... Serendipity/S9y Online Handbuch
Das ich momentan keine Lust habe auch noch nach Feierabend Code zu hacken, ist vermutlich einigen schon (schmerzlich?) aufgefallen. Aber für eine anständige Dokumentation wäre ich schon interessiert. Hat jemand eine Idee oder Erfahrungen, wie man das am besten aufbauen könnte? Ich bin ja noch immer ein Freund von PDF-Dateien. Die kann man so schön am Bildschirm lesen, herunterladen und ausdrucken. Das kann wiederrum ein Wiki nicht.
@falk
Das du dzt. nicht codest ist wirklich schade, da ich deine Plugins etc. mehr als schätze.
Eine Online Ausgabe ist sicherlich nicht schlecht. Aus vielem kann man dann sowieso (mit ein bisschen Arbeit) ein PDF erstellen. Aber noch sind wir ein paar Schritte entfernt davon.
Ev. könnten wir uns ja mal aufteilen, wer welche Plugins etc. beschreibt - und dies wiederum in seinem Blog - mit Zentralverzeichnis auf alle.
Das du dzt. nicht codest ist wirklich schade, da ich deine Plugins etc. mehr als schätze.
Eine Online Ausgabe ist sicherlich nicht schlecht. Aus vielem kann man dann sowieso (mit ein bisschen Arbeit) ein PDF erstellen. Aber noch sind wir ein paar Schritte entfernt davon.
Ev. könnten wir uns ja mal aufteilen, wer welche Plugins etc. beschreibt - und dies wiederum in seinem Blog - mit Zentralverzeichnis auf alle.
-
- Regular
- Posts: 450
- Joined: Thu May 26, 2005 10:43 am
- Location: Bonn, Germany
- Contact:
Ich habe mir mal den Kopf etwas zerbrochen. Am einfachsten wäre XSLT. Das sind XML-Dateien, die ähnlich wie HTML strukturiert sind. Aus diesen XML-Dateien kann man dann HTML- oder PDF-Dateien machen. Das war mir gestern eingefallen, weil das Zend-Framework ja die Doku auf Basis dieser XML-Dateien aufbaut. Das wäre schonmal ein Anfang, was die Technik angeht.
Nun bleibt noch die Struktur übrig:
1) Anfangen sollte man natürlich bei einer Doku beim Urschleim: Was ist ein Blog, wozu dient er etc. Dann S9y einführen, einfache und erweiterte installation. Nutzung des Blogs. Anfängerbereich ende.
2) Fortgeschrittene sollten dann die Installationsarten erklären.
3) Programmiererteil: Wie ist die API aufgebaut.
4) Templatedesignerteil: Der Name sagt doch alles...
5) Plugin-Teil: Beschreibung der Plugins.
6) Glosar (wird gerne Vergessen, aber für Anfänger besonders wichtig!)
Sollten die XML-Dateien mit XSLT genutzt werden, brauchen wir am besten eine Versionsverwaltung und natürlich auch etwas Zeit uns in die Technik einzuarbeiten. Natürlich auch Leute die sich um ein Fachgebiet (Templates, Programmierung, ...) kümmern und Korrekturleser bzw. Qualitätssicherung. Bei letzterem sehe ich noch ein Problem: Wo fangen wir an? Aktuelles Realease oder müssen wir ältere Eigenheiten von S9y beachten? In wie weit können wir alte Artikel übernehmen? Ich glaube die Linksammlung von Robert ist auch schon mal ein erster Schritt uns "Überblick über das vorhandene Zeitungsmaterial"* zu beschaffen.
Ich denke ich habe erstmal wieder genug Denkanstöße gegeben .
* Frage: Aus welchem Film stammt das Teilzitat?
Nun bleibt noch die Struktur übrig:
1) Anfangen sollte man natürlich bei einer Doku beim Urschleim: Was ist ein Blog, wozu dient er etc. Dann S9y einführen, einfache und erweiterte installation. Nutzung des Blogs. Anfängerbereich ende.
2) Fortgeschrittene sollten dann die Installationsarten erklären.
3) Programmiererteil: Wie ist die API aufgebaut.
4) Templatedesignerteil: Der Name sagt doch alles...
5) Plugin-Teil: Beschreibung der Plugins.
6) Glosar (wird gerne Vergessen, aber für Anfänger besonders wichtig!)
Sollten die XML-Dateien mit XSLT genutzt werden, brauchen wir am besten eine Versionsverwaltung und natürlich auch etwas Zeit uns in die Technik einzuarbeiten. Natürlich auch Leute die sich um ein Fachgebiet (Templates, Programmierung, ...) kümmern und Korrekturleser bzw. Qualitätssicherung. Bei letzterem sehe ich noch ein Problem: Wo fangen wir an? Aktuelles Realease oder müssen wir ältere Eigenheiten von S9y beachten? In wie weit können wir alte Artikel übernehmen? Ich glaube die Linksammlung von Robert ist auch schon mal ein erster Schritt uns "Überblick über das vorhandene Zeitungsmaterial"* zu beschaffen.
Ich denke ich habe erstmal wieder genug Denkanstöße gegeben .
* Frage: Aus welchem Film stammt das Teilzitat?
Falks Idee haben wir leider noch nicht weiter verfolgt, aber:
Die 4. virtuelle Auflage meiner Sammlung ist nunmehr erschienen:
http://www.robertlender.info/blog/archi ... age-4.html
Ergänzungen, Korrekturen, etc. sind herzlich Willkommen. Solange Garvins Handbuch noch nicht da ist, soll dies zumindest eine kleine Hilfestellung sein.
Wenn Garvins Handbuch da ist, wird es sicherlich trotzdem immer wieder etwas geben, was dort noch nicht steht. Daher möchte ich auch 2008 das Fragmentarische... mit eurer Unterstützung ausbauen.
Liebe Grüße
Robert
Die 4. virtuelle Auflage meiner Sammlung ist nunmehr erschienen:
http://www.robertlender.info/blog/archi ... age-4.html
Ergänzungen, Korrekturen, etc. sind herzlich Willkommen. Solange Garvins Handbuch noch nicht da ist, soll dies zumindest eine kleine Hilfestellung sein.
Wenn Garvins Handbuch da ist, wird es sicherlich trotzdem immer wieder etwas geben, was dort noch nicht steht. Daher möchte ich auch 2008 das Fragmentarische... mit eurer Unterstützung ausbauen.
Liebe Grüße
Robert