Entwicklung(en) bei SELFHTML

Eine der zentralen Fragen der letzen Zeit, wenn es um SELFHTML ging, lautete: »Wie geht es weiter mit SELFHTML?«. Schon vor und erst recht nach dem wenig erfolgreichen Wiki‐Versuch haben uns viele Unterstützer ihre Mitarbeit angeboten. Wir mussten diese Helfer bislang immer wieder mit »Danke! Wir geben Bescheid, sobald wir so weit sind.« vertrösten.

Nun – wir sind so weit!

Es mussten viele Arbeiten erledigt werden, bis wir »so weit« waren. Erst haben wir die Server umstrukturiert, danach folgte die Umgestaltung des Redaktionsbereichs erst mit Tests, dann mit dem Online‐Gang von Trac (Version 0.10.4). Siehe auch: Was war … Was wird … hier im Blog.

Das war bei weitem nicht alles, was zuvor zu erledigen galt. Die Umstellung SELFHTMLs von HTML auf XML erforderte viele Tage Arbeit. In diesem Zusammenhang haben wir auch eine Layout‐Ausschreibung veranstaltet, um den Nutzern die Möglichkeit zu bieten, das künftige Layout der Dokumentation aktiv mitzugestalten.

Ergebnis der Layout‐Ausschreibung

An dieser Stelle möchten wir uns für die zahlreichen Wortmeldungen im Forum und für die Einreichungen zur Ausschreibung bedanken. Auch denjenigen möchten wir danken, die sich zwar nicht an der Ausschreibung beteiligten, aber ihre Vorschläge im Forum vorgestellt haben.

Jedes der eingesandten Layouts zeigt Ideen auf, die wir gerne für das Layout der Dokumentation übernehmen würden. Nach Besprechungen im Redaktionsforum und einer sehr intensiven Diskussion im Redaktionschat, die über drei Stunden dauerte, hat sich folgendes Bild herauskristallisiert:

Als Grundlage für das neue Layout werden wir Marcel Scherkamps Vorschlag nutzen und diesen um entsprechend adaptierte Ideen aus anderen Vorschlägen ergänzen bzw. erweitern.

Wie geht es nun weiter?

Wie schon erwähnt, dauerte die Umstellung von SELFHTML von HTML auf XML eine Weile. Die in das neue XML‐Format konvertierte Version von SELFHTML ist mittlerweile in das SVN‐Repository eingecheckt. Auch auf die Frage, wie Redakteure mit diesem XML‐Format – auch ohne Kenntnisse von XML – arbeiten können, haben wir eine Antwort in Form des XMLmind Editors gefunden. Redakteuren und auch anderen Interessierten steht ein an SDML (das XML‐Format für SELFHTML) angepasster Editor zur Verfügung. Wer sich etwas ausführlicher über SDML informieren möchte, ist eingeladen, die dazugehörige Informationsseite zu besuchen.

Der Konverter, den Christian Seiler geschrieben hat, leistete hervorragende Arbeit. Alle XML‐Dateien valideren gegen die DTD. Dennoch konnten angesichts des Umfangs von SELFHTML nicht alle Individualitäten oder Fehler des HTML‐Quellcodes restlos bei der Konvertierung beseitigt werden. Daher zählt zu den ersten Arbeiten mit dem neuen Format die Aufgabe, die nach der Konvertierung noch vorhandenen Fehler auszubessern. Nach diesem wichtigen Teil kann die »ganz normale« Autoren‐Schreibarbeit beginnen.

Die Doku im neuen Layout?

Auf die Frage: »Wann kann man die Dokumentation im neuen Layout betrachten?« gibt es zur Zeit nur die Antwort: »Sobald sie so weit ist.« Aktuell arbeiten wir daran, es den Redakteuren zu ermöglich, die Dokumentation online zu betrachten. Dazu dient ein Servlet, das die XMLs mittels XSLT transformiert. Es existieren zwei Gründe, weshalb diese Möglichkeit einstweilen nur Redakteuren zugänglich bleibt. Erstens ist die Generierung von großen, automatisch erstellten Seiten, wie z.B. dem Stichwort‐ oder Syntaxverzeichnis speicherintensiv, da dazu alle XML‐Dateien in einem Vorgang eingelesen und ausgewertet werden müssen. Zweitens gibt es zur Zeit nur ein sehr rudimentäres Layout, das nur minimales HTML und CSS aufweist. Erst jetzt, nach der Layout‐Auschreibung kann damit begonnen werden, die Vorschläge und Ideen in das XSLT zu übertragen. Geplant haben wir dennoch, ab einem späteren Zeitpunkt in regelmäßigen Abständen sogenannte Snap‐Shots oder »Momentaufnahmen« des Entwicklungsstandes als HTML zu generieren und online zu stellen.

6 Kommentare » Schreibe einen Kommentar

  1. @Daniel

    Wiki bei Meta‐Text: ja, was das Wiki als Entwiklungswerzeug von SELFHTML 9 betrifft. Es sind im Wiki schon Inhalte und Ideen, die auch in die XML‐Version übertragen werden. So lange das nicht passiert, bleibt das Wiki (mit den üblichen Modalitäten) offen. Was ich danach damit mache, habe ich noch nicht entschieden. Es war mal gedacht, dass man ein Wiki für Kommentare zu den einzelen Seiten haben könnte. Dies ist mit dem Trac‐Wiki nun viel einfacher möglich, siehe dazu den Trac‐Ticket 51).

    Bezüglich des Bug Trackers: irgendwann wird er ganz entfernt bzw. das Eintragen neuer Mledungen darin nicht mehr möglich sein. Wir sind schon jetzt dabei, die noch offene Bugs entweder zu schließen oder sie in das neue System zu übertragen. Userdaten werden nicht übertragen, da die aktuelle Version von Trac noch nicht über eine ausreichend fein einstellbare Rechteverwaltung verfügt (was für die nächste Version aber vorgesehen ist) und weil wir uns auch dann nicht mit damit abplagen wollen, zwischen den verschiedenen Systemen die Daten zu migrieren.

  2. Ich habe da einige Fragen, ich hoffe man kann sie mir hier beantworten.

    Da vom Wiki‐Versuch die Rede ist: Ist das Wiki bei Meta‐Text endgültig gescheitert? Wenn ja, wird es mit seinem Inhalt gelöscht?

    Bezüglich des Bug Trackers. Wird der alte gänzlich entfernt, oder werden die Daten (auch Benutzer) in das neue System übergeführt?

    Zum Layout möchte ich nur sagen, dass man eine gute Basis gewählt hat. Ich hoffe nur, dass die Standardschriftgröße erhöht wird und die wenigen kontrastlosen Farben verbessert werden.

  3. Schade, ihr habt das Layout gewählt, das mir am wenigsten gefällt. Was nicht heißen soll, dass es schlecht wäre. Aber mir gefiel das dritte Design in der Liste wesentlich besser.
    Egal, macht eine tolle neue Version und vor allem:

    Macht das, was ihr schon immer am besten konntet: Schlichtes Layout füllen mit hervorragendem Inhalt! ^^

  4. Hallo Thomas,

    beim Aufruf der „redation“-Links („Informationsseite“ und „angepasster Editor“) bekomme ich folgende Fehlermeldung:

    SSL‐Certificate Verify failed

  5. Das klingt doch vielversprechend! Ich persönlich freue mich auf Version 9!
    (Und ganz nebenbei habt ihr mein favorisiertes Layout als Basis genommen ;-))

    LG
    Dominik