User:Nnino/ODT2Wiki

Vorgehen beim Übertragen des Writer-Handbuches von ODT ins Wiki

Da die englische Doku von OOoAuthors bereits großteils in Wiki-Form vorlag, konnte auf die dabei gemachten Erfahrungen und Vorgehensweisen zurückgegriffen werden. Zum Beispiel die Verwendung von Wiki-Templates für die Kapitel-interne Navigation: Die englischen Templates mussten dabei nur "eingedeutscht" werden und liegen alle unter Template:DE/Documentation/Writer...TOC (siehe die ersten 17 Einträge dieser Liste)

Folgende best practice hat sich nach ein paar Kapiteln herausgeschält:

1. ODT-Dokument öffnen
2. sämtliche Bilder manuell exportieren
   • Rechtsklick aufs Bild -> Grafik speichern, Name manuell eintragen (etwa a1 für Abbildung 1)
   • alternativ könnte man auch die Grafiken aus dem entzippten ODT nutzen, das mag bei wenigen Bilder gehen, bei mir ist es bei Kapiteln mit vielen Bildern jedoch deutlich langsamer gegangen, da ich die Bilder erst mal identifizieren musste, um sie dann nach Bedarf umzubenennen.
3. die Bilder hochladen (Sehr hilfreich: die Extension MultipleUpload)
4. den Text exportieren
   • mithilfe des eingebauten MediaWiki-Exportfilters unter Exportieren... Dateityp Mediawiki (*.txt)
5. Text-Export nachbearbeiten
   • In der Regel waren jedes Mal einige Überschriften nicht korrekt gekennzeichnet (etwa weil Bilder darin vorkamen oder vermutlich Absatzformatierungen den Filter irritiert haben), so dass ich in der Regel die gesamte Überschriften-Hierarchie durchgegangen bin
   • auch viele Anleitungslisten (nummerierte Listen) hat der Filter zerschossen, sie mussten daher repariert werden
   • Wandeln der Anmerkungen- / Tipps- / Achtung-Kästchen ins Wikiformat (dafür gibt es die englischen Templates Template:Documentation/Note, /Tip, /Caution) mithilfe des OOoBasic-Macros von TJFrazier
   • Eintragen der Abbildungsnamen in die jeweiligen "Image"-Links mit folgender Regex (ich habe die Bilder immer a1.png, a2.png usw. benannt)
     

     Suche nach:	Image:\|thumb\|( *'* *Abbildung *)(\d+):
     Ersetze durch:	Image:a\2.png|thumb|none|500px|\1\2:

   • Anpassen der "internen" Verweise auf andere Kapitel
6. Erzeugen des Kapitel-Navigations-Templates aus den Kapitel-Überschriften
7. Anlegen der Wikiseiten für jedes Unterkapitel und Einfügen des Template-Aufrufs für das Navigationstemplate in die Seiten
8. Anpassen der Template-Aufrufe
   • Eintragen der korrekten Seitennamen, der jew. Vorgänger- und Nachfolger-Seite sowie des Interwiki-Links zur englischen Sprachversion
9. Einfügen des Kapiteltextes aus der .txt-Datei, Vorschau, ggf. Feinpolitur
10. Abspeichern der Kapitel