7 Bücher erstellen

{{DISPLAYTITLE:BlueSpiceBookshelf (2)}}

{{Textbox|boxtype=note|header=BlueSpice 4.5:|text=This help page applies to the book functionality for BlueSpice 4.5+. For earlier versions, go to the previous documentation.|icon=yes}}<bookshelf src="Book:User manual" />

{{DISPLAYTITLE:Books}}

In ''BlueSpice pro'' können Wikiseiten als strukturiertes Buch mit Kapitelnavigation angezeigt werden. Ein Buch kann auch als PDF-Datei mit einem Deckblatt gedruckt werden.

==Merkmale von Büchern==
Bücher haben die folgenden Eigenschaften:

*Auf Buchseiten wird die Buchnavigation anstelle der Hauptnavigation angezeigt.
*Eine Wikiseite kann in mehreren Büchern enthalten sein. Wenn eine Seite in mehreren Büchern enthalten ist, zeigt die Buchnavigation ein Dropdown-Menü an, mit dem zwischen diesen Büchern gewechselt werden kann.
*Bücher können ganz oder teilweise als PDF mit einem Deckblatt gedruckt werden.
*Bücher können in einzelnen Bücherregalen gruppiert werden.

==Unterschiede zu früheren Versionen==
*Eine Seite kann nun in mehreren Büchern enthalten sein.
*Die Bücher werden als Miniaturansichten angezeigt und können in verschiedenen "Regalen" organisiert werden.
*Es gibt keine privaten oder temporären Bücher mehr, da es sich hierbei um Randanwendungen handelt.
*Es gibt keine Möglichkeit mehr, ein Buch zu duplizieren, da dies ebenfalls eine Randanwendung war.
*Es gibt keinen separaten Buchmanager mehr. Alle Bücher können nun direkt auf der Seite Bücher verwaltet werden.

==Erstellen eines Buches==
Bücher werden über die Seite ''Spezial:Bücher'' erstellt. 
[[File:Bookshelf create book action.png|alt=Page Special:Books with actions menu|center|thumb|650x650px|"Neues Buch erstellen" ]] 

'''Um ein Buch zu erstellen:'''
#'''Klicken Sie''' im Aktionsmenü der Seite Werkzeuge'''auf''' ''Neues Buch erstellen''. Daraufhin öffnet sich ein Dialogfenster.
#Geben Sie einen Buchtitel'''ein'''.
#Geben Sie einen Untertitel'''ein''' (optional).
#'''Wählen Sie''' ein Bücherregal (optional). Dadurch wird das Buch in eine Gruppe von Büchern eingeordnet. Wenn Sie kein Bücherregal auswählen, wird das Buch unter der Rubrik ''Verschiedene Bücher'' aufgeführt.
#'''Hochladen oder Auswählen''' eines Titelbildes (optional)'''.''' Wenn Sie kein Titelbild hochladen oder auswählen, wird ein zufälliges Titelbild verwendet.
#'''Klicken Sie auf''' ''Speichern''.  Das Buch wird nun in seiner Bücherregalgruppe angezeigt und kann bearbeitet werden.
#'''Klicken Sie auf''' ''Fertig''. Der Bucheditor wird als nächstes geladen.
===Ein Buch bearbeiten===
Um in den Buchbearbeitungsmodus zu wechseln, '''klicken Sie''' in der Buchvorschau auf der Seite Bücher auf ''Bearbeiten''. 

Dadurch wird der Bucheditor geöffnet.
===Hinzufügen von Elementen===
So fügen Sie eine Wikipage zu einem Buch hinzu:

#'''Klicken Sie auf .''' ''Element hinzufügen.''
#'''Wählen Sie''' den Knotentyp ''Wikiseite Kapitel.''
#'''Geben''' Sie den Namen der Wikiseite, die Sie hinzufügen möchten, in das Feld ''Ziel'' ein.
#Geben Sie in das Feld ''Text'' die Bezeichnung'''ein''', die Sie für die Seite anzeigen möchten.
#'''Klicken Sie auf''' ''Fertig''. Die Seite wird am Ende des Buches hinzugefügt.
#'''Ziehen''' Sie die Seite'''per Drag-and-Drop''' in den gewünschten Abschnitt.
#'''Wiederholen Sie''' die Schritte 1-6, wenn Sie eine weitere Seite hinzufügen möchten.
#'''Klicken Sie auf''' ''Speichern'', wenn Sie fertig sind.

===Bearbeiten von Metadaten===
Bei der Bearbeitung eines Buches (Hinzufügen oder Entfernen von Seiten) können Metadaten für das Buch hinzugefügt werden. Verweise auf diese Metadaten können in die PDF-Vorlage aufgenommen werden.  Die folgende Tabelle zeigt, welche der Parameter standardmäßig Teil des PDF-Ausdrucks sind. Alle Parameter sind Teil der benutzerdefinierten Dokumenteigenschaften des gedruckten PDFs.  
{| class="wikitable" style="width: 100%;"
|+Metadaten und ihre Funktionalität
!Parameter
!Beschreibung
! style="width:100px;" |in Standard-Vorlagen
|-
|Autor 1
|Benutzerdefinierte Eigenschaft eines PDF-Dokuments. Nicht in PDF-Seiten enthalten.
| style="width:100px;" |keine
|-
|Autor 2
|Benutzerdefinierte PDF-Dokumenteneigenschaft. Nicht in PDF-Seiten enthalten.
| style="width:100px;" |nein
|-
|Bücherregal
|Listet das Buch auf der Seite Bücher des Wikis unter einem bestimmten Bücherregal auf.  Hat keine Bedeutung für das gedruckte PDF.
| style="width:100px;" |keine
|-
|Bild im Bücherregal
|Bild, das als Vorschaubild angezeigt wird. Es kann als [[Manual:Extension/BlueSpiceUniversalExport/Customization#Book cover|Titelbild des gedruckten PDFs in der Cloud]] verwendet werden.
| style="width:100px;" |ja (nur Cloud)
|-
|Abteilung
|Benutzerdefinierte Eigenschaft des PDF-Dokuments. Nicht in PDF-Seiten enthalten.
| style="width:100px;" |nein
|-
|Dokumenttyp
|Benutzerdefinierte Eigenschaft eines PDF-Dokuments. Nicht in PDF-Seiten enthalten.
| style="width:100px;" |nein
|-
|Dokument-ID
|Manuell vergebene Dokument-ID.
| style="width:100px;" |nein
|-
|Untertitel
|Wird auf dem Deckblatt gedruckt.
| style="width:100px;" |ja
|-
|Inhaltsverzeichnisse
|''Nur Artikeltitel:''Das PDF-Inhaltsverzeichnis enthält nicht die einzelnen Seiten-Inhaltsverzeichnisse.
''Artikel-TOCs einbetten:'' Das PDF-Inhaltsverzeichnis enthält die einzelnen Seitenverzeichnisse.
| style="width:100px;" |ja
|-
|Vorlage (PDF)
|Standardmäßig gibt es nur eine Buch-PDF-Vorlage (BlueSpice Book). Wenn benutzerdefinierte PDF-Vorlagen vorhanden sind (nur beim On-Premise-Hosting möglich), werden diese als Optionen aufgeführt.
|nein
|-
|Titel
|Wird auf dem Deckblatt gedruckt. Überschreibt den Buchtitel des Wikis für den PDF-Ausdruck. Er wird als PDF-Dateiname und Titel auf dem Deckblatt verwendet.
| style="width:100px;" |ja
|-
|Version
|Manuell vergebene Versionsnummer des Buches.
| style="width:100px;" |nein
|}

===Seiten massenhaft hinzufügen===
Nach Anklicken von "Massen hinzufügen" wird ein Dialog geöffnet. Er enthält verschiedene Kriterien für die Seitenauswahl:

*Alle Seiten einer Kategorie: Alle Seiten einer Kategorie werden am Ende des Buches hinzugefügt (unabhängig davon, ob einige der Seiten bereits im Buch vorhanden sind).
*Alle Unterseiten einer bestimmten Seite: Nach der Auswahl einer Seite werden alle ihre Unterseiten am Ende des Buches hinzugefügt.
*Aus einer Seitensammlung: Seitensammlungen sind Listen von Seiten, die sich im MediaWiki-Namensraum befinden. Sie können aus einem [[Manual:Extension/ImportOfficeFiles|Word-Import]] oder aus [https://en.wiki.bluespice.com/wiki/Manual:Extension/BlueSpiceExtendedSearch#Export Suchergebnissen] erstellt werden.
{{Textbox|boxtype=important|header=Moving chapters:|text=Currently, it is not possible to move multiple mass-added pages together to a different location in the book. To rearrange the chapters, you can open the book in source editing mode and copy-and-paste chapters to reorder the book pages.|icon=yes}}

==Exportieren eines Buches==
'''So laden Sie das Buch als PDF herunter:'''

'''Klicken Sie auf''' der Seite ''Bücher'''''auf''' ''Exportieren''. Dadurch wird das Buch sofort heruntergeladen.

'''Um einzelne Kapitel herunterzuladen:'''

#'''Gehen Sie zum''' Einstiegspunkt ''Seiten''. Wenn Ihr Wiki diesen Link nicht anzeigt, gehen Sie direkt auf die Seite ''Spezial:Seiten''.
#'''Klicken Sie''' auf den Namen eines Buches.
#'''Wählen''' Sie die Kapitel'''aus''', die Sie exportieren möchten.
#'''Klicken Sie''' oberhalb des Kapitelbaums'''auf'''''Exportieren''.

Das Buch wird dann heruntergeladen.

==Weitere Aktionen==
Mit der Schaltfläche "Weitere ''Aktionen'' " können Sie die Metadaten des Buches löschen, zuweisen oder bearbeiten.
[[File:bookshelf more actions.png|alt=expanded "more actions"  menu of a book|center|thumb|287x287px|Schaltfläche "Weitere Aktionen"]]

===Löschen===
Wenn Sie ein Buch löschen, entfernen Sie nur die Buchseite des Buches (d.h. das Inhaltsverzeichnis) im Namensraum "Buch". Die Wiki-Seiten des Buches werden nicht gelöscht und sind nicht mehr mit dem Buch verknüpft.

===Metadaten bearbeiten===
Dies bietet die gleiche Funktionalität wie die Schaltfläche [[Pagedraft:Manual:Extension/BlueSpiceBookshelf#Editing metadata|''Metadaten bearbeiten'' im Menü-Editor]].

===zuweisen===
Eine Buchseite kann wie jede andere Wikiseite einzelnen Benutzern oder Benutzergruppen zugewiesen werden. Das Buch wird dann unter den [[Manual:Extension/BlueSpicePageAssignments|Zuweisungen]] des Benutzers im Benutzermenü angezeigt.

==Einfügen eines Buchinhaltsverzeichnisses auf einer Seite {{Bsvs|bsvFrom=4.4}}==
Das [[Manual:Extension/ContentDroplets|Content-Droplet]] "Buch-Inhaltsverzeichnis" kann verwendet werden, um das gesamte Buch-Inhaltsverzeichnis oder eine einzelne Kapitelnavigation eines Buches auf einer beliebigen Wiki-Seite einzufügen.
[[File:droplet-BookTOC.png|alt=Chapter from an admin manual|center|thumb|650x650px|Content-Droplet "Buch-Inhaltsverzeichnis"]]

==Hinzufügen eines PDF-Download-Links zu einer Seite==
Das [[Manual:Extension/ContentDroplets|Content-Droplet]] "Buch-PDF-Link" kann verwendet werden, um einen Link auf einer Seite einzufügen, der ein Buch direkt als PDF herunterlädt.

==Berechtigungen==
Um Bücher zu erstellen und zu bearbeiten, benötigen Benutzer ''Bearbeitungsrechte'' im Namensraum Buch. Außerdem kann ein Benutzer nur Seiten zum Buch hinzufügen, die er auch lesen kann. Wenn ein Benutzer versucht, ein Buch in das PDF-Format zu exportieren, das Seiten enthält, für die der Benutzer keine Rechte hat, erhält er eine Fehlermeldung.

==Konfiguration==
===Anzeigeoptionen===
{{#dpl:title=Manual:Extension/BlueSpiceConfigManager|include=#BlueSpiceBookShelf}}

===Exportieren===
Wiki-Administratoren können die folgenden Einstellungen für den Buchexport vornehmen:
{{#dpl:title=Manual:Extension/BlueSpiceConfigManager|include=#Export}}

===Konfiguration der Dateigrößenbegrenzung (SERVER)===
Standardmäßig ist der Buchexport auf eine Dateigröße von 50 MB begrenzt. Um diesen Wert zu ändern, führen Sie die folgenden Schritte durch: 

#Öffnen Sie in Apache Tomcat die Datei ''web.xml'': <syntaxhighlight lang="c">
sudo -s
nano /opt/tomcat/webapps/manager/WEB-INF/web.xml
</syntaxhighlight>
#Suchen Sie die folgenden Zeilen und passen Sie den Wert an (z. B. für 250MB=26214400) <syntaxhighlight lang="c">
<max-file-size>262144000</max-file-size>
<max-request-size>262144000</max-request-size>
</syntaxhighlight>
#Die Web-App BShtml2PDF hat auch eine Einstellung, die angepasst werden muss: <syntaxhighlight lang="c">
nano /opt/tomcat/webapps/BShtml2PDF/WEB-INF
</syntaxhighlight>
#Geben Sie Ihre Werte in die folgenden Zeilen ein: <syntaxhighlight lang="c">
<param-name>maxMemSize</param-name> <param-value>26214400</param-value>
<param-name>maxFileize</param-name> <param-value>26214400</param-value>
</syntaxhighlight>
#Apache Tomcat neu starten  <syntaxhighlight lang="c">
service tomcat restart
</syntaxhighlight>


{{Box Links-en|Topic1=[[Manual:Extension/BlueSpiceUniversalExport/Customization|PDF Customization (Cloud only)]]}}
{{Translation}}

[[Kategorie:Organisation]]