Difference between revisions of "Reference:BlueSpiceBookshelf"

(User manual)
(Tag: 2017 source edit)
 

Extension: BlueSpiceBookshelf


Overview
Description: enables you to combine different wiki articles to create books and also to export those as a pdf documentEnables BlueSpice to manage and export hierarchical collections of articles.
State: stable Dependency: BlueSpice
Developer: HalloWelt License:

GPL-3.0-onlyProperty "BSExtensionInfoLicense" (as page type) with input value "</br>GPL-3.0-only" contains invalid characters or is incomplete and therefore can cause unexpected results during a query or annotation process.

Type: BlueSpice Category: Book
Edition: BlueSpice pro, BlueSpice Farm, BlueSpice Cloud

Features

[edit source]Bookshelf is an extension of the package BlueSpice Bookmaker. Bookshelf enables you to combine different wiki articles

Description[edit | edit source]

Bookshelf combines wiki pages to create books and also to export those pages as a

pdf

PDF document.

Usage/ Features[edit | edit source]

Manage books[edit | edit source]

Click on "Manage books" in your WidgetBar and it leas you to the special page Special:BookManager, which provides an overview of all available books.
The following actions can be performed:

Button Action
Button Add.png

Add book: opens a dialogue for inserting the title of the new book.

Btn-BookCopy.png

Copy book: Copy an existing book and edit it afterwards.

Button Edit.png

Edit book: leads you to the book editor, where you can add articles to the book, delete them or change the position in the book structure with drag & drop.

Button Delete.png

Delete book: completely deletes the article collection (but not the articles).

Screenshot: Chapter navigation in the sidebar

Technical information[edit | edit source]

Configuration[edit | edit source]

Rights (permissions)[edit | edit source]

The right to create a book depends on the "write" permission in the "book" namespace.

Requirements[edit | edit source]

User manual[edit | edit source]

For detailed description and usage please visit our [manual.]

Try free our BlueSpice[edit | edit source]

BlueSpice Demo.

  • Sets of different pages (chapters) can be put together individually to a book.
  • The table of contents of the book is displayed in the left navigation bar.
  • The chapters are displayed in a collapsible tree structure.
  • The book or parts of the book can be exported to PDF.

Configuration manager

Some aspects of this extension can be configured on Special:BlueSpiceConfigManager. Here, wiki administrators can:

  • prepend the article table of contents and headlines of a page with book numeration.
  • supress the namespace prefix of book articles in the PDF output.
  • apply the display title from the book source to a wiki page.

Technical Information[edit source]

This information applies to BlueSpice 3 . Technical details for BlueSpice cloud can differ in some cases.

Requirements[edit source]

  • MediaWiki: 1.31
  • BlueSpiceFoundation: 3.1

Integrates into[edit source]

  • BlueSpiceBookshelf

Special pages[edit source]

  • Bookshelf
  • BookshelfBookEditor
  • BookshelfBookManager

Permissions[edit source]

Name Description Role
bookshelf-viewspecialpage Access the special page Special:Bookshelf reader
bookshelfbookmanager-viewspecialpage Access the special page Special:BookshelfBookManager reader

Configuration[edit source]

Name Value
BookShelfDefaultCoverImage 'resources/images/assets/coverimage/dummy.png'
BookShelfShowChapterNavigationPagerAfterContent false
BookShelfShowChapterNavigationPagerBeforeContent false
BookshelfPrependPageTOCNumbers true
BookshelfSupressBookNS true
BookshelfTitleDisplayText true

User options[edit source]

Name Value
bs-bookshelf-defaultview 'gridviewpanel'

API Modules[edit source]

  • bs-bookshelf-bookstore
  • bs-bookshelf-manage
  • bs-bookshelf-mass-add-page-store
  • bs-bookshelf-page-collection-store
  • bs-bookshelf-store

Hooks[edit source]


Attachments

Discussions