Quelltext der Seite Handbuch:Erweiterung/ImportOfficeFiles

{{DISPLAYTITLE:Word Import}}
{{BSVersion|bsvFrom=4.2|bsvTo=|bsvFeature=Der Word-Import ist}}
== Was ist der Word-Import? ==
Die Erweiterung '''ImportOfficeFiles''' ermöglicht es, Word Dokumente als Wikiseiten zu importieren.

Merkmale:

* Datei kann in eine Einzelseite oder in eine Seite mit Unterseiten umgewandelt werden.
* Bilddateien werden mit importiert
* Importierte Seiten können als Buch angelegt werden

== Vor dem Import ==
Bevor Sie ein Word-Dokument importieren, können Sie das Dokument auf Komplexität überprüfen. Während des Imports werden folgende Elemente ins Wiki übertragen und in Wikitext umgewandelt:

* '''Dokumententitel:''' 
** Das Dokument sollte '''nur einen Titel''' enthalten. Wenn mehrere Titel existieren, werden im Wiki an den entsprechenden Stellen Fehlermeldungen angezeigt.
* '''Text:''' 
** Textformatierung wird entfernt und in unformatierten Fließtext umgewandelt.  Einige Textformatierungen wie '''fett''' oder  ''kursiv'' werden übernommen.
** Textboxen werden in unformatierten Fließtext umgewandelt.
* '''Überschriften:''' 
** Das Dokument sollte korrekte Überschriftenlevels enthalten, wenn das Dokument im Wiki in mehrere Unterseiten umgewandelt werden soll.
* '''Bilder:'''
** Bilder werden ins Wiki importiert. Die Bezeichnung der Bilder erfolgt als <code>Wikiseitenname_image_<fortlaufende Nummer></code> .
** Überlagerungen auf Bildern werden nicht ins Wiki übernommen
** Bildbezeichnungen werden unterhalb des Bildes eingefügt. Fortlaufende Nummerierungen der Bilder können im Wiki nicht weitergeführt werden.
** Alle Bilder werden standardmäßig zentriert als Typ "Vorschaubild" eingefügt. 
{{Hinweisbox|boxtype=Hinweis|icon=|Note text=Beim Hochladen der Bilder wird nicht überprüft, ob das Bild im Wiki bereits existiert.|bgcolor=}}
* '''Tabellen:'''
** Tabellen werden in Wikitext-Tabellen umgewandelt.
* '''Aufzählungen:'''
** Aufzählungen benötigen in vielen Fällen eine Nacharbeite. 

== Word-Dokument importieren ==
So importieren Sie ein Word-Dokument:

# '''Klicken''' Sie ''Neu >  Word -Datei importieren'' in der Topleiste.[[Datei:wordimport-neu.png|alternativtext=Importieren-Schaltfläche|mini|166x166px|Importieren-Schaltfläche|zentriert]]
# '''Klicken''' Sie auf ''Eine Datei auswählen'' oder ziehen Sie die Word-Datei in den Hochladebereich.[[Datei:wordimport-dateiauswählen.png|alternativtext=Datei auswählen|zentriert|mini|350x350px|Datei auswählen]]
# '''Klicken''' Sie ''Weiter''.
# '''Wählen''' Sie die passenden Import-Einstellungen aus.[[Datei:wordimport-einstellungen.png|alternativtext=Einstellungen|zentriert|mini|350x350px|Einstellungen]]'''Einstellungen'''
##'''Titel:'''  Der Titel der Wikiseite, die durch den Import generiert wird. Wenn die Inhaltstruktur aufgebrochen wird, werden die Kapitel entsprechend als Unterseiten zu dieser Hauptseite angelegt.
## '''Inhaltsstruktur:'''  Wenn der Auswahlkasten "Inhalt auf Seiten aufteilen" aktiviert ist, werden aus den Überschrifts-Ebenen des Word-Dokuments Unterseiten erstellt. Dies ist bis zu 3 Ebenen tief möglich.
## '''Konflikte mit Seitentitel,''' wenn eine Wikiseite mit dem gewählten Namen bereits existierT:
##* ''Umbennen:'' Die importierte Seite wird als ''Seitenname (1)'' erstellt. Dies sollte jedoch gerade bei großen Word-Dateien, die auf weitere Ebenen aufgeteilt werden, vermieden werden. Am besten sollte hier  alternativ ein neuer Seitentitel angegeben werden. Ein Namenskonflikt wird in der Vorschau angezeigt. Klicken Sie in diesem Fall gegebenenfalls auf abbrechen, um den Import mit einem neuen Titel zu starten. Oder wählen Sie als Konfliktlösung "Überschreiben".[[Datei:importword-vorschau.png|alternativtext=Vorschau|zentriert|mini|550x550px|Vorschau]]
##* ''Überschreiben'': Die existierende Seite wird  mit einer neuen Version überschrieben.[[Datei:wordimport-überschreiben.png|alternativtext=Titel überschreiben|zentriert|mini|350x350px|Titel überschreiben]]
# '''Klicken''' Sie auf ''Weiter''. Die Vorschau zeigt:  (1) die Namen der Seiten, die angelegt werden  (2) über das Pfeil-Symbol: die Dateien, die für die einzelnen Seiten importiert werden  (3) über das Auge-Symbol: den Inhalt der einzelnen Wikiseiten.
# '''Klicken''' Sie ''Importieren''. Nach Abschluss des Imports werden die erstellten Seiten als Seitensammlung im Wiki angezeigt. Sie können von dieser Seite die Seiten ansehen, indem Sie auf den Link klicken.[[Datei:wordimport-abgeschlossen.png|alternativtext=Import abgeschlossen|zentriert|mini|450x450px|Import abgeschlossen]]{{Hinweisbox|boxtype=Hinweis|icon=|Note text=In einem Wiki, das mit "deutsch" als Inhaltssprache (contentlanguage) installiert wurde, beginnt der Pfad zur Seite mit ''MediaWiki:Seitensammlung''.|bgcolor=}}

== Buch erstellen ==
Aus den importierten Seiten können Sie leicht ein [[Handbuch:Erweiterung/BlueSpiceBookshelf|Buch erstellen]]:

# '''Gehen''' Sie im Menü ''Globale Aktionen'' zu ''Bücher.''
# '''Klicken''' Sie die ''Plus''-Schaltfläche.
# '''Geben''' Sie einen Buchtitel '''an''' und klicken Sie ''Fertig.''
# '''Klicken''' Sie auf die Schaltfläche ''Massenzufügen.''
# '''Wählen''' Sie als Quelle ''Seitensammlung.''
# '''Wählen''' Sie den Seitennamen der importierten Datei aus.[[Datei:wordimport-seitensammlung.png|verweis=https://de.wiki.bluespice.com/wiki/Datei:wordimport-seitensammlung.png|alternativtext=Seitensammlung wählen|zentriert|mini|450x450px|Seitensammlung wählen]]
# '''Wählen''' Sie im Speichern-Menü ''Speichern und Kapitelnavigation erstellen.''
[[Datei:wordimport-buchnav.png|alternativtext=Buchnavigation erstellen|zentriert|mini|650x650px|Buchnavigation erstellen]]
# '''Klicken''' Sie im Menü "Seitenzuordnungen ändern" auf ''Okay.''
[[Datei:wordimport-buch-bookshelftag.png|alternativtext=Buchnavigation bestätigen|zentriert|mini|200x200px|Buchnavigation bestätigen]]


Das Buch wurde nun erstellt und ist über das Bücherregal erreichbar. 

=== Anzeigetitel der Buchnavigation ändern ===
Da die Anzeigetitel der Buchseiten den Pfad der importierten Unterseiten anzeigt,  ist es sinnvoll, die Anzeigetitel nachträglich zu bearbeiten. Öffnen Sie hierzu die Buchseite im Quellbearbeitungs-Modus und entfernen Sie den Pfad  mit dem abschließenden "/".

[[Datei:importoffice-buchanzeigetitel.png|alternativtext=Buchanzeigetitel|zentriert|mini|750x750px|Buchanzeigetitel]]


Wenn das Buch sehr viele Seiten hat, können Sie den Quelltext in einen Editor wie Notepad++ kopieren und folgenden Text ersetzen:<syntaxhighlight lang="text">
|Mitarbeiterhandbuch/
</syntaxhighlight>ersetzen Sie den Text so, dass '''unbedingt noch die verticale "Pipe"''' übrig bleibt:<syntaxhighlight lang="text">
|
</syntaxhighlight>Kopieren Sie den Quelltext zurück ins Wiki uns speichern Sie die Buchseite.

[[Datei:Importoffice-anzeigetitel-neu.png|alternativtext=Neue Anzeigetitel speichern|zentriert|mini|750x750px|Neue Anzeigetitel speichern]]
{{Box Links|Thema1=[[Referenz:ImportOfficeFiles]]|Thema2=[[Handbuch:Erweiterung/BlueSpiceBookshelf|Bücher]]}}

{{translation}}