Difference between revisions of "Manual:Extension/BookshelfUI"

<bs:bookshelf src="Book:User manual" />
            
            
            
            __TOC__
            
            
            
            ==What is BookshelfUI?==
            
            
            
            '''BookshelfUI''' provides a graphical interface for creating, editing and managing books. It consists of a book editor, a book management and an integrated navigation.
            
            
            
            ==Where to find BookshelfUI?==
            
            
            
            '''Global actions''', '''BookManager''':
            
            
            
            ::: [[File:BookMngr1.jpg|500x298px]]
            
            
            
            '''Add''':
            
            
            
            ::: [[File:BookManager2.jpg|500x304px]]
            
            
            
            Add title of the book:
            
            
            
            ::: [[File:BookManager3.jpg|500x307px]]
            
            
            
            Book is created:
            
            
            
            ::: [[File:BookMngr3.jpg|500x302px]]
            
            
            
            
            
            ==Create Article/Page in the book==
            
            
            
            Too create article in the book, click '''Add''' and specified the title:
            
            
            
            ::: [[File:Book1b.jpg|500x307px]]
            
            
            
            All changes will only become active after clicking on the "Save" button.
            
            
            
            ::: [[File:Book1c.jpg|500x293px]]
            
            
            
            Right click to manage:
            
            
            
            ::: [[File:Book1d.jpg|500x303px]]
            
            
            
            ==Add next Article/Page==
            
            
            
            To add next page, mark book and then '''Add''' button.
            
            
            
            ::: [[File:Book1e.jpg|500x302px]]
            
            
            
            To add next page in the already existing page mark, that specific page where you want to add next one.
            
            
            
            ::: [[File:Book1f.jpg|500x299px]]
            
            
            
            Or add a page that already exists:
            
            
            
            ::: [[File:Book1g.jpg|500x298px]]
            
            
            
            ::: [[File:Book1h.jpg|500x298px]]
            
            
            
            ==Books management==
            
            * In the book management books can be created, copied and deleted.
            
            * When creating a title must be specified.
            
            * The already existing books are displayed in a list.
            
            
            
            ==Book Editor==
            
            * The book editor displays the contents of a book in a hierarchical folder structure.
            
            * Book chapters are added in the form of wiki articles. A selection dialog opens for this purpose.
            
            * Book chapters can be renamed.
            
            * Book chapters can be dragged into the desired order by Drag'n'Drop.
            
            * Book chapters can be deleted via an icon. It is not the article itself deleted, but only taken from the book.
            
            * Metadata can be inserted via a dialog.
            
            * All changes will only become active after clicking on the "Save" button.
            
            * When saving, the bookshelf tags in the articles are copied (if desired).
            
            * It is possible to mark individual chapters for export.
            
            * If the user clicks on "Export selection", he receives a document in the selected format. At least one export extension must be activated for this.
            
            
            
            
            
            
            
            ==Integrated navigation==
            
            * The navigation is a separate tab in the sidebar.
            
            * It consists of two areas
            
            ** Available Books shows a list of all the books stored in the system
            
            ** Chapter shows the chapter navigation of the currently selected book.
            
            * The two areas are represented by an accordion grid. This also means that only one area is open at a time.
            
            * The ad will be preserved the same way the user selected it when the page was changed.
            
            
            
            ==See also==
            
            
            
            Our [[BookshelfUI |reference page.#REDIRECT [[Manual:Extension/BlueSpiceBookshelf]]{{DISPLAYTITLE:Books}}
            
            __TOC__
            
            
            
            ==About books==
            
            With BlueSpice Pro, you can assemble individual wiki pages into a book. When you access a page that is part of a book, the main navigation is replaced by the book navigation:
            
            [[File:book-nav.png|alt=Screenshot:Book navigation|center|256x256px]]
            
            
            
            In book mode, you can read through a collection of pages in a linear fashion by moving through the book navigation. This is useful if you have lots of related pages that should be read in a particular order. And it makes it easy to write documentation and to comply with your documentation standards.
            
            ==Characteristics of books==
            
            Before you create a book from your wiki pages, consider the following main characteristics of books:
            
            
            
            *Each wiki page can only be part of one book
            
            *When a page is part of a book and a user navigates to it, it always jumps directly to the book navigation.
            
            *Books can easily be converted into PDF format
            
            
            
            Therefore, you want to create wiki pages that are exclusively part of a book if you use the book function of your wiki. 
            
            ==Creating a book==
            
            
            
            '''To create a book:'''
            
            
            
            #'''Go to''' ''Global actions > Book manager'':<br />[[File:Manual:create-book.png|link=https://en.wiki.bluespice.com/wiki/File:Manual:create-book.png|alt=Screenshot:create book|center|650x650px]]
            
            #'''Select''' the ''Create (+)'' button.
            
            #'''Enter''' a ''Book title'' and the ''Type of the book'':
            
            #*''General books'': Visible to all users. It should have a book navigation.
            
            #*''Own books'': Books only visible to me. Please note that pages in your own books can also only be in one book. If another user includes the same page in their own book, the page will "jump" to the book navigation of the user who last included the page in their book and saved it with the optional book navigation. It is therefore important to include only your own pages in your own books, unless you do not create the optional book navigation when you save your book. A good way of making your own books is by using subpages from your own user profile page in the namespace ''User''.
            
            #'''Click''' ''Done''. You now have created an empty book.
            
            
            
            You can take the following actions on a book:
            
            
            
            [[File:Manual:book-manager-actions.png|alt=Screenshot: Bookmanager actions|center|650x650px]]
            
            
            
            *[[Manual:Extension/BookshelfUI#Book editor|Edit]] (1): Links to the Book editor where you can edit the book contents and metadata.
            
            *[[Manual:Extension/BookshelfUI#Deleting a book|Delete]] (2): Deletes the book without deleting the wiki pages.
            
            *[[Manual:Extension/BookshelfUI#Duplicating a book|Duplicate]] (3): Duplicates this book, including all the pages of the book.
            
            *Export (4): Exports the wiki pages in this book to PDF.
            
            *Assign (5): Assigns the book to designated users.
            
            
            
            ==Editing a book==
            
            After you have created the book, click on the name of the book. This opens the ''Book Editor'':
            
            
            
            [[File:Manual:book-editor.png|alt=Screenshot: book editor|center|650x650px]]
            
            
            
            *'''Book Manager''' (1): Link to the main ''Book manager'' page.
            
            *'''Show source wikipage''' (2): Opens the book navigation page in view mode.
            
            *'''Edit source wikipage''' (3): Opens the book navigation page in edit mode.
            
            *'''Add page''' (4): Button for adding a page.
            
            *'''Mass-add pages''' (5): Button for adding a set of pages (by category, subpages of a page, [[Manual:Extension/ExtendedSearch#Export search|page collection]], or semantic property).'''Remove page''' (6): Removes the selected pages.
            
            *'''Manage metadata''' (7): Add or remove metadata.
            
            *'''Export selection''' (8): Exports the selected pages to a PDF file.
            
            *'''Book contents''' (9): Shows all pages in the book hierarchy Pages can be arranged by drag-and-drop. A multi-level organization is possible.
            
            
            
            After adding pages to your book, you save the changes. When you click on ''Save'', you have the option to also create the book navigation. If you want to add a book navigation tag to each wiki page, click ''Save and add book navigation to each wikipage'' instead:
            
            
            
            [[File:Manual:book-createnav.png|alt=Screenshot: save book navigation|center|650x650px]]
            
            
            
            When you add the book navigation to a wiki page, the corresponding ''bookshelf'' tag is added in its source code. In addition the page title now always includes the numbering from the book navigation:
            
            
            
            [[File:Manual:bookshelf-tag.png|alt=Screenshot: bookshelf tag|center|650x650px]]
            
            
            
            ==Deleting a book==
            
            When you delete a book, you only remove the book information from Book manager. The wiki pages in the book, however, are not deleted. Before you delete the book, you are informed in a pop-up menu that the bookshelf tag is not automatically removed from the pages:
            
            [[File:Manual:delete-book.png|alt=Screenshot: delete book menu|center|300x300px]]
            
            The bookshelf tags have no effect on the wiki pages after deleting the book. If you want to remove them manually, you can go to the page ''Special:ReplaceText'' and do a find and replace.
            
            
            
            ==Duplicating a book==
            
            You can create an entire copy of the book by duplicating it:
            
            
            
            [[File:Manual:duplicate-book.png|alt=Screenshot: Duplicate book|center|400x400px]]
            
            
            
            '''To duplicate a book:'''
            
            
            
            #'''Enter''' a ''target name'': The default vlaue is the book name with the suffix ''(copy)''. Change this to create a different book title.
            
            #'''Select''' a ''namespace'': Choose a namespace that is different from the original namespace.
            
            
            
            If you are not careful, you might experience some unintended consequences. By creating a new book, you also create copies of all the wiki pages in the original book. Since a namespace cannot contain the same page twice, you have to copy the files to a different namespace.
            
            
            
            '''About the duplicated files:'''
            
            
            
            *'''Book file:''' A new page in the namespace book. If you don't enter a new title, the book will be created with the same title and the suffix ''(Copy). E.g. Employee Manual (Copy).'' This file includes a copy of the structure of your original book with the corresponding links to the duplicated pages in the new copy.
            
            *'''Book pages''': All pages contained in the original book are duplicated. The following scenarios are possible:
            
            **'''Same namespace:''' If you duplicate a book in the same namespace, no actual duplicates of the actual wiki are created. Instead, the bookshelf tag is updated to point to the copy of the book. For example, if your original book contains the page ''HR:Quality assurance''  (the book is in the namespace HR), the ''Quality assurance'' page now contains the bookshelf tag <code><nowiki><bs:bookshelf src="Book:Employee Manual (Copy)" /></nowiki></code>.
            
            **'''Different namespace''': If you create the book copy in a different namespace, the bookshelf tag in the original files remains unchanged. The new pages in the different namespace are created with a bookshelf tag for the new book copy. This is most likely the scenario you want.<br />
            
            {{Box Links-en|Topic1=[[Reference:BookshelfUI]]}}
            
            [[en:{{FULLPAGENAME}}]]
            
            [[de:Handbücher_erstellen]]