====== Word-Dokumente in Dokuwiki-Format transformieren ====== ^ Version ^ Status ^ Datum ^ Autor ^ URL ^ | 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 [[https://wiki.rafisa.net/doku.php?id=playground:playground|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 [[https://wiki.rafisa.net/doku.php?id=wiki:syntax|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 ===== [[https://wiki.rafisa.net/doku.php?id=playground:playground|Playground]]\\ [[https://wiki.rafisa.net/doku.php?id=wiki:syntax|DokuWiki-Syntax-Hilfeseite]]\\ Platzhalter\\ für zukünftige\\ Zeilen\\ im\\ Quellenverzeichnis\\