Difference between revisions of "User:Nnino/ODT2Wiki"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (draft)
 
m (finished)
Line 1: Line 1:
−
== Vorgehen beim Migrieren der OOo-Dokumentation von ODT nach Wiki (also Wiki-Markup) ==
+
== Vorgehen beim Übertragen des Writer-Handbuches von ODT ins Wiki ==
  
−
Da die englische Doku bereits vollständig 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 (siehe die ersten 17 Einträge [http://wiki.services.openoffice.org/w/index.php?title=Special%3APrefixIndex&from=DE%2FDocumentation%2FW&namespace=10 dieser Liste])
+
Da die englische Doku von OOoAuthors bereits großteils in [[Documentation|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 [http://wiki.services.openoffice.org/w/index.php?title=Special%3APrefixIndex&from=DE%2FDocumentation%2FW&namespace=10 dieser Liste])
  
  
Line 10: Line 10:
 
#* alternativ könnte man auch die Grafiken aus dem entzippten ODT nutzen, das ging bei mir jedoch langsamer, da die Dateinamen erst mal durch sprechende Namen ersetzt werden mussten, was Bild für Bild einfach schneller ging.
 
#* alternativ könnte man auch die Grafiken aus dem entzippten ODT nutzen, das ging bei mir jedoch langsamer, da die Dateinamen erst mal durch sprechende Namen ersetzt werden mussten, was Bild für Bild einfach schneller ging.
 
# den '''Text exportieren'''  
 
# den '''Text exportieren'''  
−
#* mithilfe des eingebauten MediaWiki-Exportfilters unter '''Exportieren...''' Dateityp Mediawiki *.txt
+
#* mithilfe des eingebauten MediaWiki-Exportfilters unter '''Exportieren...''' Dateityp Mediawiki (*.txt)
 
# '''Text-Export nachbearbeiten'''
 
# '''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
 
#* 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
−
#* Erzeugen des Navigations-Templates aus den Kapitel-Überschriften
+
#* Wandeln der Anmerkungen- / Tipps- / Achtung-Kästchen ins Wikiformat (dafür gibt es die englischen Templates [[:Template:Documentation/Note|Template:Documentation/Note]], [[:Template:Documentation/Tip|/Tip]], [[:Template:Documentation/Caution|/Caution]]) mithilfe des [[User:TJFrazier/WikiBasic|OOoBasic-Macros von TJFrazier]]
−
#* Wandeln der Anmerkungen- / Tipps- / Achtung- Kästchen ins Wikiformat (dafür gibt es die englischen Templates [[:Template:Documentation/Note|Template:Documentation/Note]], [[:Template:Documentation/Tip|/Tip]], [[:Template:Documentation/Caution|/Caution]]) mithilfe des [[User:TJFrazier/WikiBasic|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) <br><table class="wikitable"><tr><td>Suche nach:</td><td><nowiki>Image:\|thumb\|( *'* *Abbildung *)(\d+):</nowiki></td></tr><tr><td>Ersetze durch:</td><td><nowiki>Image:abb\2.png|thumb|none|500px|\1\2:</nowiki></td></tr></table>
−
#* Eintragen der Abbildungsnamen in die jeweiligen "Image"-Links mit folgender Regex (ich habe die Bilder immer abb1.png, abb2.png usw. benannt)
+
#* Anpassen der "internen" Verweise auf andere Kapitel
−
{|
+
# Erzeugen des Kapitel-Navigations-Templates aus den Kapitel-Überschriften
−
|Suche:  
+
# Erzeugen sämtlicher Unterkapitel (hier: je Unterkapitel 1 Wikiseite) und Einfügen des Template-Aufrufs für das Navigationstemplate in die Seiten
−
|Image:\|thumb\|( *'* *Abbildung *)(\d+):
+
# Anpassen der Template-Aufrufe (Eintragen der korrekten Seitennamen, der jew. Vorgänger- und Nachfolger-Seite sowie des Interwiki-Links zur englischen Sprachversion)
−
|-
+
# Einfügen des Kapiteltextes aus der .txt-Datei, Vorschau, ggf. Feinpolitur
−
<br>Ersetze durch: "Image:abb\2.png|thumb|none|500px|\1\2:"
+
# Abspeichern der Kapitel

Revision as of 15:16, 27 September 2009

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 Praxis" hat sich nach ein paar Kapiteln herausgeschält:

  1. 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 ging bei mir jedoch langsamer, da die Dateinamen erst mal durch sprechende Namen ersetzt werden mussten, was Bild für Bild einfach schneller ging.
  2. den Text exportieren
    • mithilfe des eingebauten MediaWiki-Exportfilters unter Exportieren... Dateityp Mediawiki (*.txt)
  3. 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
    • 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:abb\2.png|thumb|none|500px|\1\2:
    • Anpassen der "internen" Verweise auf andere Kapitel
  4. Erzeugen des Kapitel-Navigations-Templates aus den Kapitel-Überschriften
  5. Erzeugen sämtlicher Unterkapitel (hier: je Unterkapitel 1 Wikiseite) und Einfügen des Template-Aufrufs für das Navigationstemplate in die Seiten
  6. Anpassen der Template-Aufrufe (Eintragen der korrekten Seitennamen, der jew. Vorgänger- und Nachfolger-Seite sowie des Interwiki-Links zur englischen Sprachversion)
  7. Einfügen des Kapiteltextes aus der .txt-Datei, Vorschau, ggf. Feinpolitur
  8. Abspeichern der Kapitel
Retrieved from "https://wiki.openoffice.org/w/index.php?title=User:Nnino/ODT2Wiki&oldid=141276"
Personal tools