Word-Dokumente in Dokuwiki-Format transformieren

Version	Status	Datum	Autor
0.1	Erste Pre-Alpha-Version	24.06.2021	Serjoscha Evci
0.2	Erster Entwurf	TT.MM.JJJJ	Vorname Nachname
0.3	Ergänzungen	TT.MM.JJJJ	Vorname Nachname
1.0	Review und Freigabe	TT.MM.JJJJ	Vorname Nachname

1. Kurzfassung

In diesem Tutorial wird erklärt, wie man Word-Dokumente in das Dokuwiki-Format transformieren kann.

2. Voraussetzungen

- Ein PC mit Internetanschluss, Bildschirm, Maus und Tastatur sowie der Möglichkeit portable .exe-Dateien auszuführen
- Html2DokuWiki.exe Auf Fileserver kopieren (~~läuft nicht, weil plötzlich entmappt~~ ist im gleichen Ordner wie das Testdokument)
- Notepad++ um HTML zu öffnen
- LibreOffice Writer um .docx-Dateien als HTML zu speichern
- Der Playground vom DokuWiki Playground
- Ein .docx-Testdokument ist auf dem Netzlaufwerk Rafisa-Data-Share T: im Unterordner DokuWiki-Anleitungszubehör gespeichert und heisst Testdokument_fuer_DokuWiki_Anleitung.docx

3. Tutorial

Schritt 1:
Das .docx-Dokument mithilfe von LibreOffice zu HTML konvertieren:
auf .docx rechtsklicken, dann auf öffnen mit und schliesslich auf LibreOffice Writer klicken und bei „Speichern unter“ HTML als Dateityp auswählen und in einen leeren Ordner speichern (Jeder eingebettete Inhalt wird in mehreren Formaten exportiert, darum wird es ohne separate Ordner für jedes Dokument sehr schnell sehr unübersichtlich)
Schritt 2:
Das HTML-Dokument mit Notepad++ öffnen und den Inhalt kopieren
Auf das HTML rechtsklicken, dann edit with Notepad++ anklicken, in Notepad++ ctrl+A um alles auszuwählen, und schlussendlich ctrl+C zum kopieren
Schritt 3:
Die Zwischenablage von Schritt 2 mit ctrl+V in Html2DokuWiki.exe einfügen und den Output mit ctrl+C und ctrl+V ins DokuWiki kopieren
Schritt 4:
Im Media Manager (oben rechts zwischen Recent Changes und Sitemap) dort wo die leeren Links der Bilder hinzeigen (vorher draufklicken und URL anschauen) die Bilder hochladen und die Website neu Laden
Schritt 5:
Das Layout korrigieren (wird einige kleine und mit Pech auch wenige grosse Layout-Fehler drin haben, siehe DokuWiki-Syntax-Hilfeseite)

4. Testing

4.1 Test 1

Testfall Nr.	#1
Beschreibung	Flurin Pudil (der Tester dieser Anleitung) kann die Anleitung befolgen (im Playground vom Wiki) und kommt zum Ziel ohne verwirrt oder aufgeschmissen zu sein
Vorgehen	ihm die Anleitung und ein Testdokument geben:
	für evtl. auftretende Rückfragen erreichbar sein (z.B. Teams)
	mit dem Tester nachbesprechen (persönlich)
Voraussetzung / Umfeld	Die Anleitung ist verständlich
Erwartetes Resultat	Das Testdokument ist im DokuWiki-Playground drin und das Layout ist nicht allzu defekt
OK / nicht OK	Noch unbekannt, weil das Testing noch nicht stattfand
Aufgetretene Fehler / Bemerkungen	Wie Oben schon gesagt, wissen wir noch nicht, ob die Anleitung verständlich ist, weil unser Tester noch nicht am Werk war

4.2 Test 2

Testfall Nr.	#2
Beschreibung
Vorgehen
Voraussetzung / Umfeld
Erwartetes Resultat
OK / nicht OK
Aufgetretene Fehler / Bemerkungen

4.3 Test 3

Testfall Nr.	#3
Beschreibung
Vorgehen
Voraussetzung / Umfeld
Erwartetes Resultat
OK / nicht OK
Aufgetretene Fehler / Bemerkungen

5. Auswertung

Was hat funktioniert[(ref note example)], was nicht, was waren die grössten Herausforderungen/Probleme, wie habe ich die Probleme gelöst, was mache ich beim nächsten Mal besser, Reflexion

6. Quellenverzeichnis

Playground
DokuWiki-Syntax-Hilfeseite
Platzhalter
für zukünftige
Zeilen
im
Quellenverzeichnis