Beschreibung zum Hilfe-Review
Notwendige Hilfsmittel
Um das Hilfe-Review systematisch durchzuführen, ist es notwenig, durch zwei Daten die Hilfe-Dateien so zu verändern, dass immer erkennbar ist, in welcher Datei man sich gerade befindet.
Das erleichtert die genaue Beschreibung der fehlerhaften Hilfe-Seite für die Korrekturen.
Die dafür benötigten Dateien gehören zum Issue 56321, welches hier eingesehen werden kann: http://qa.openoffice.org/issues/show_bug.cgi?id=56321 mit dem Anhang (attachment): http://www.openoffice.org/nonav/issues/showattachment.cgi/30673/Help_review.tgz. In diesem Anhang befinden sich 2 Dateien:
- In das Verzeichnis "help" gehört die Datei main_transform.xsl.
- Diese Datei ermöglicht es, dass von jeder Hilfedatei der eindeutige Dateiname zu erkennen ist.
- In das Verzeichnis"help/de" gehört die Datei allfiles.tree.
- Die Datei erzeugt in der Inhaltsübersicht ein zusätzliches Verzeichnis, in dem dann alle Dateien so aufgelistet werden, dass ein strukturiertes Lesen möglich ist.
Seit dem 23.02.2006 gibt es eine modifizierte "main_transform.xsl"-Datei. Diese kann unter http://www.openoffice.org/nonav/issues/showattachment.cgi/34917/main_transform.xsl heruntergeladen werden.
Wiki
Das Wiki, in das wir die Ergebnisse eintragen, befindet sich unter http://ooowiki.de/ReviewOnlineHelp.
Das Wiki ist unentbehrlich für die Zusammenarbeit aller an dem Review Beteiligten. Man kann den aktuellen Stand des gemeinsamen Projektes erfahren und nachsehen, welche Hilfedateien noch nicht bearbeitet worden sind.
Einige nützliche Informationen
Hier sind noch ein paar Informationen, die zum größten Teil von Regina stammen und die Arbeit am Review erleichtern können.
Die Verzeichnisangaben beziehen sich auf die Linux-Version und sind unter Windows ähnlich.
- Um festzustellen, welche Datei sich unter der Bezeichnung EMB versteckt, ist es hilfreich, die Hilfedateien im Quelltext (Format ist XML) vorliegen zu haben. Diese liegen in openoffice.org2.0/help/de als *.jar Dateien vor. Es sind gezippte Dateien, die auf jedem Rechner entpackt werden können.
- Ein weitere Punkt sind die Symbolleisten. auch die sind in einer Datei gezippt und zwar openoffice.org2.0/share/config/images.zip. Dort findet man dann die einzelnen Icon-Dateien, die man sich mit einem Bildbetrachter anschauen kann.
Außerdem kann man auf specs.openoffice.org eine Datei herunterladen, die Toolbar_content_spec.sxw heißt.
Darin steht dann, welche Icons in welcher Symbolleiste in der Standardeinstellung zu finden sein sollten.
Diese Liste kann gerne weiter ergänzt werden.