Handbuch:Erweiterung/BlueSpiceBookshelf

Die Erweiterung Bookshelf ist wesentlicher Bestandteil der Buchfunktion von BlueSpice. Damit können mehrere Wikiseiten in einem strukturierten Buch mit Kapitelnavigation zusammengefasst werden. Das Buch kann auch als PDF-Datei mit Deckblatt gedruckt werden.

Eigenschaften von Büchern

Mit BlueSpice Pro können Sie einzelne Wiki-Seiten zu einem Buch zusammenstellen. Wenn Sie eine Seite laden, die Teil eines Buches ist, wird die Hauptnavigation durch die Buchnavigation ersetzt. Im Buchmodus können Sie eine Sammlung von Seiten linear durchblättern, indem Sie sich durch die Buchnavigation bewegen. Dies ist nützlich, wenn Sie viele verwandte Seiten haben, die in einer bestimmten Reihenfolge gelesen werden sollten. Die Buchfunktion macht es einfach, Dokumentationen zu schreiben und Dokumentationsstandards einzuhalten.

Alle Bücher, die im Wiki verfügbar sind, sind über den Reiter Buch in der Navigationsleiste erreichbar. Die Ansicht der Bücher kann zwischen Listen- und Rasteransicht umgeschaltet werden. Durch Klicken auf eines der Bücher wird das ausgewählte Buch geöffnet.

Bücheransicht

Sobald das Buch geöffnet ist, erscheint die Kapitelnavigation, die ein lineares Lesen der Seiten ermöglicht.

Kapitelnavigation

Bücherverwaltung

Der Menüpunkt Globale Aktionen > Bücherverwaltung lädt die Seite Spezial:Bücherverwaltung. Hier können Sie Bühcer erstellen und verwalten. Über die Plus-Schaltfläche erstellen Sie ein Buch.

Bücherverwaltung

Sie können folgende Aktionen für bestehende Bücher ausführen:

• Bearbeiten (1): Link zum Bucheditor, von wo Sie den Buchinhalt und die Metadaten bearbeiten können.
• Löschen (2): Löscht das Buch (das heißt, die Inhaltsseite des Buches im Namensraum I) Book, ohne die Wiki-Seiten selbst zu löschen.
• Duplizieren (3): Dupliziert dieses Buch, einschließlich aller Seiten des Buches.
• Exportieren (4): Exportiert die Wiki-Seiten in diesem Buch als PDF.
• Zuweisen (5): Weist das Buch bestimmten Benutzern zu.
  

Aktionen in der Bücherverwaltung

Ein Buch erstellen

Um ein neues Buch zu erstellen:

1. Gehen Sie zu Globale Aktionen> Bücherverwaltung.
2. Wählen Sie die Schaltfläche Erstellen (+).
3. Ein Buch erstellenGeben Sie einen Buchtitel und die Art des Buches ein.
   
   

   Buchtitel und Buchtyp eingeben
   
   
   • Allgemeine Bücher: Für alle Benutzer sichtbar. Es sollte eine Buchnavigation haben.
   • Eigene Bücher: Bücher, die nur für mich sichtbar sind.
4. Klicken Sie auf Fertig. Sie haben jetzt eine Seite im Namensraum Book erstellt, die die Links zu den Buchseiten enthält.

Nachdem Sie auf Fertig geklickt haben, öffnet sich der Bucheditor. Seiten können nacheinander hinzugefügt werden, indem Sie auf die Plus-Schaltfläche klicken. Es öffnet sich ein Dialogfeld, in das Sie den Namen der einzufügenden Seite eingeben können.

Eine Seite ins Buch einfügen

Massenhinzufügen von Seiten

Nach Anklicken von "Massenhinzufügen" wird ein Dialog geöffnet, in dem der verschiedene Kriterien zur Auswahl von Seiten ausgewählt werden könnenenthält:

• Alle Seiten einer Kategorie
• Alle Unterseiten einer bestimmten Seite
• Aus einer Seitensammlung - Seitensammlungen sind Seitenlisten im MediaWiki-Namensraum, die normalerweise über Suchergebnisse erstellt werden.
• Über eine semantische Eigenschaft - Seiten können basierend auf einem Wert einer bestimmten semantischen Eigenschaft ausgewählt werden.

Nachdem Sie die gewünschten Seiten zum Buch hinzugefügt haben, klicken Sie auf Speichern. Nun haben Sie eine Wikiseite im Namensraum Book, welche das verlinkte Seitenverzeichnis der im Buch enthaltenen Wikiseiten speichert.

Seitenverzeichnis des Buches speichern

Wichtig! Jede Wikiseite kann nur in einem Buch enthalten sein. Wenn eine Seite nachträglich zu einem zweiten Buch mit Kapitelnavigation hinzugefügt wird, führt die Wikiseite beim Laden immer automatisch in die Kapitelnavigation des Buches, das zuletzt seine Kapitelnavigation gespeichert oder aktualisiert hat.

Kapitelnavigation erstellen

Nach dem Speichern eines Buches haben Sie im Namensraum Book eine Wikiseite erstellt, die die Links zu den Buchseiten enthält. Die Kapitelnavigation muss anschließend noch separat erstellt werden.

Hierzu gehen Sie auf die Buchseite und generieren das Inhaltsverzeichnis über die Funktion Speichern und Kapitelnavigation in die Seiten einfügen der Speichern-Schaltfläche.

Kapitelnavigation zu Buchseiten hinzufügen

Dieser Vorgang fügt in den Quelltext aller Wikiseiten des Buches das bookshelf-Tag ein. Dieses Tag definiert, in welchem Buch die Seite enthalten ist: <bookshelf src="HandbuchBook:Mitarbeiterhandbuch" />.Das bookshelf-Tag im Quelltext

Hinweis: Wenn Sie einem Buch nachträglich Seiten hinzufügen, müssen Sie die Kapitelnavigation erneut generieren, damit die neuen Seiten in der Buchnavigation erscheinen. Wenn Sie nur ein oder zwei neue Seiten hinzugefügt haben, können Sie das bookshelf-Tag auch manuell in den Quelltext der neuen Seiten einfügen.

Bücher bearbeiten

Nachdem Sie ein Buch erstellt haben, klicken Sie auf den Namen des Buches. Dies öffnet den Bucheditor.

Beim Bearbeiten eines Buches wird im Wesentlichen das gleiche Verfahren wie beim Erstellen eines neuen Buches ausgeführt, wenn Sie dem Buch Seiten hinzufügen. Kapitel - und die allgemeine Buchstruktur - können durch Ziehen und Ablegen von Seiten in der Buchstruktur geändert werden. Durch Ziehen und Ablegen von Seite A über die Seite B wird Seite A unter der Seite B in der Buchhierarchie platziert.

Sie können Seiten auch löschen, indem Sie eine Seite in der Buchstruktur mit Rechtsklick auswählen und auf den Menüpunkt Löschen klicken.

Bucheditor

• 'Bücherverwaltung' (1): Link zur Hauptseite der Bücherverwaltung.
• 'Quellwikiseite öffnen' (2): Öffnet die Buchseite im Ansichtsmodus.
• 'Quellwikiseite bearbeiten' (3): Öffnet die Buchseite im Bearbeitungsmodus.
• 'Seite hinzufügen' (4): Schaltfläche zum Hinzufügen einer einzelnen Seite.
• 'Massenhinzufügen' (5): Schaltfläche zum Hinzufügen einer Reihe von Seiten (nach Kategorie, Unterseiten einer Seite, Seitensammlung oder semantischer Eigenschaft ).
• 'Seite entfernen' (6): Entfernt die ausgewählten Seiten.
• 'Metadaten verwalten' (7): Hinzufügen oder Entfernen von Metadaten.
• 'Auswahl exportieren' (8): Exportiert die ausgewählten Seiten in eine PDF-Datei.
• 'Buchinhalt' (9): Zeigt alle Seiten in der Buchhierarchie an. Seiten können per Drag & Drop angeordnet werden. Eine mehrstufige Organisation ist möglich.

Metadaten einfügen

Während der Bearbeitung eines Buches (Hinzufügen oder Entfernen von Seiten) können Metadaten für das Buch hinzugefügt werden. Um Metadaten zu bearbeiten, wählen Sie den obersten Knoten des Buches (erste Seite) aus und klicken Sie auf das Schraubenschlüssel-Symbol. Ein Dialog wird geöffnet, in dem verschiedene Metadaten hinzugefügt oder entfernt werden können. Zu den wichtigsten Metadaten gehören:

• Titel
• Untertitel
• Autor 1 und 2
• Dokument Identifikation
• Dokumentenart
• Abteilung
• Ausführung
• Vorlage (PDF)
• Inhaltsverzeichnis (Nur Artikelbezeichnungen oder Artikel einbetten TOCs)

Coverfoto hinzufügen

Fügen Sie ein Metadatenelement Bookshelf-Bild hinzu, um ein Cover-Foto für das Buch hinzuzufügen. Wählen Sie diese Option aus der Dropdown-Liste aus und klicken Sie auf Hinzufügen. Nachdem die Metadaten hinzugefügt wurden, geben Sie den Namen des Bildes in das Wertefeld ein. Jedes aktuell im Wiki hochgeladene Bild kann verwendet werden. Geben Sie den Namen ohne das Präfix "File:" ein, also nur den Namen und die Erweiterung des Bildes.

Bücher exportieren

Buch als PDF exportieren

Bücher, einzelne Kapitel oder sogar einzelne Buchseiten können als PDF-Dateien exportiert werden:

• Öffnen Sie das Buch im Bucheditor.
• Wählen Sie alle zu exportierenden Seiten oder Kapitel aus, indem Sie auf die entsprechenden Kontrollkästchen klicken. Unterkapitel werden automatisch ausgewählt.
• Klicken Sie auf das Dropdown-Menü "Auswahl exportieren", um eine Liste der verfügbaren Formate zu öffnen. Durch Klicken auf eines der angebotenen Formate wird der Buchexport gestartet.

Buch als PDF exportieren

Konfiguration des Buchexports

Wiki-Administratoren können folgende Anpassungen für den Buchexport vornehmen:

Die Exporteinstellungen wirken sich darauf aus, wie die Seiten eines Buches beim PDF-Export generiert werden.

• Bookshelf: Liste mit Freigabekommentaren zeigen: Zeigt am Anfang des PDFs eine Liste der PDF-Seiten an, die eine freigegebene Version haben. Wenn der Begutachter beim Akzeptieren der Seite keinen Kommentar angegeben hat, ist das Feld Freigabekommentar leer.

Liste freigegebener Seiten

• Bookshelf: Liste von nicht freigebenen Seiten zeigen: Zeigt am Anfang des PDFs eine Liste mit den PDF-Seiten an, die lediglich als Erstentwurf existieren und keine freigegebene Version haben.
  
  

  Seiten im Erstentwurf
  
  
• Bookshelf: Liste von Seiten ohne FlaggedRevs-Information zeigen: Zeigt am Anfang des PDFs eine Liste mit den PDF-Seiten an, die keinen Freigabemechanismus haben.
  
  

  Seiten ohne Freigabemechanismus
• UEModulePDF: Informationen über Freigabestatus unterhalb der Überschrift anzeigen: Druckt den Zeitstempel für die letzte freigegebene Version unter der Überschrift im PDF aus (Datum der Freigabe und Datum der letzten Bearbeitung vor der Freigabe).
  
  

  FlaggedRevs-Info unter der Überschrift

Ein Buch löschen

Wenn Sie ein Buch löschen, entfernen Sie nur die Buchinformationen aus dem Buchmanager. Die Wiki-Seiten im Buch werden jedoch nicht gelöscht. Bevor Sie das Buch löschen, werden Sie in einem Popup-Menü darüber informiert, dass das bookshelf-Tag nicht automatisch von den Seiten entfernt wird:

Removing a page from a book

Die bookshelf-Tags haben nach dem Löschen des Buches keine Auswirkung auf die Wiki-Seiten. Wenn Sie sie manuell entfernen möchten, können Sie zur Seite Spezial:Text ersetzen gehen und ein Suchen und Ersetzen durchführen.

Ein Buch duplizieren

Sie können eine vollständige Kopie des Buches erstellen, indem Sie es duplizieren:

So duplizieren Sie ein Buch:

1. Geben Sie einen Zielnamen ein: Der Standardwert ist der Buchname mit dem Suffix (Kopie). Ändern Sie dies, um einen anderen Buchtitel zu erstellen.
2. Wählen Sie einen Namensraum: Wählen Sie einen Namensraum aus, der sich vom ursprünglichen Namensraum unterscheidet.

Wenn Sie nicht aufpassen, kann dies zu unbeabsichtigten Konsequenzen führen. Wenn Sie ein neues Buch erstellen, erstellen Sie auch Kopien aller Wiki-Seiten im Originalbuch. Da ein Namensraum nicht zweimal dieselbe Seite enthalten kann, müssen Sie die Dateien in einen anderen Namensraum kopieren.

Duplicating a book

Über die duplizierten DateienSeiten:

• BuchdateiBuchseite: Eine neue Seite im Namensraum-Buch. Wenn Sie keinen neuen Titel eingeben, wird das Buch mit demselben Titel und dem Suffix (Kopie) erstellt. Z.B. Mitarbeiterhandbuch (Kopie). Diese Datei enthält eine Kopie der Struktur Ihres Originalbuchs mit den entsprechenden Links zu den duplizierten Seiten in der neuen Kopie.
• BuchseitenWikiseiten: Alle im Originalbuch enthaltenen Seiten werden dupliziert. Folgende Szenarien sind möglich:
  • Gleicher Namensraum: Wenn Sie ein Buch im gleichen Namensraum duplizieren, werden keine tatsächlichen Duplikate des tatsächlichen Wikis erstellt. Stattdessen wird das Bookshelf-Tag so aktualisiert, dass es auf die Kopie des Buches verweist. Wenn Ihr ursprüngliches Buch beispielsweise die Seite "HR:Qualitätssicherung" enthält (das Buch befindet sich im Namensraum HR), enthält die Seite "Qualitätssicherung" jetzt das Bookshelf-Tag <bs:bookshelf src="Buch:Mitarbeiterhandbuch (Kopie)"/>.
  • Anderer Namensraum: Wenn Sie die Buchkopie in einem anderen Namensraum erstellen, bleibt das Bookshelf-Tag in den Originaldateien unverändert. Die neuen Seiten im anderen Namensraum werden mit einem Bookshelf-Tag für die neue Buchkopie erstellt. Dies ist höchstwahrscheinlich das gewünschte Szenario.

Konfiguration

In der Konfigurationsverwaltung kann ein Administrator folgende Einstellungen vornehmen:

• Eine Blätterfunktion für Bücher nach dem Inhalt anzeigen: Zeigt vorwärts/zurück-Schaltflächen am Ende jeder Buchseite an.
• Eine Blätterfunktion für Bücher vor dem Inhalt anzeigen: Zeigt vorwärts/zurück-Schaltflächen am Beginn jeder Buchseite an.
  
  

  Umblättern von Buchseiten
  
  

• Den angezeigten Titel aus der Buchquelle für den Artikel verwenden: Zeigt den Titel aus der Buchnavigation als Seitentitel anstelle des Seitennamens an.
  

Buchtitel anzeigen

Hinweis: Wenn die Seite zusätzlich ein "Displaytitle"-Etikett enthält, wird anstelle des Buchtitels der Anzeigetitel der Seite angezeigt.

• Stellen Sie dem Inhaltsverzeichnis und den Überschriften des Artikels die Buchnummer voran
• Unterdrückt das Namespace-Präfix von Buchartikeln in der Ausgabe

Berechtigungen

Um Bücher erstellen und bearbeiten zu können, müssen Benutzer im Buch-Namensraum die Berechtigung zum Bearbeiten besitzen. Darüber hinaus kann der Benutzer dem Buch nur Seiten hinzufügen, die dieser Benutzer lesen kann.

oiArbeitstipps

Wenn ein Benutzer ein Buch exportieren will, das Seiten enthält, auf die dieser Benutzer keinen Zugriff hat, wird eine Fehlermeldung angezeigt.

Arbeitstipps

• Verwenden Sie ein kompetentes Team, um zu entscheiden, welche Inhalte in ein Online-Buch übertragen werden sollen.
• Entscheiden Sie, wie mit vorhandenen Zahlen oder Referenzen verfahren werden soll.
• Nutzen Sie die Gelegenheit: Beseitigen Sie unnötige Inhalte (oder fügen Sie diese nicht in Ihr Buch ein)
• Festlegen von Standards für Dokumente: Wann ist es sinnvoll, Dokumente im Wiki zu verknüpfen? Wann ist es sinnvoll, den Inhalt des Dokuments in einen Wiki-Artikel aufzunehmen?
• Entscheiden Sie sich für eine geeignete Vorgehensweise: Möchten Sie die Artikel zuerst im Wiki erstellen und anschließend in einer Buchstruktur zusammenstellen, oder möchten Sie zuerst die Buchstruktur erstellen und die enthaltenen Artikel schrittweise erstellen und bearbeiten?

Verwandte Themen

• Referenz:BlueSpiceBookshelf