You are here

Contributing Material

LoneBear's picture
Submitted by LoneBear on Sun, 02/23/2014 - 12:46

This is a step-by-step guide to creating book content for the Central Information library or the Virtual Monastery.

The software being used is Drupal, which is a content management system. The book content provides a collection of pages in a book format, with a "cover page" (a new book) and child pages (parts, chapters, sections, etc.). Every child page can have other child pages, so you can define a book with part, the parts with chapters, the chapters with sections... and this can be rearranged dynamically, so you are not fixed to a particular structure.

Create a New Book

  1. Go to the Navigation menu and select "Add content," then "Book page." A "Create Book page" form will be displayed.
  2. Enter a title; this will be the title of your book that will appear in menus and listings.
  3. In the Body, enter what will be the "front matter" of your book; it is best to include the title again with a "Heading 1" format, author, year and a brief summary of what the book is about. This page will show up in News feeds and search engines (if public).
  4. Under the Body area, your "Text format" should read, "Full HTML."
  5. You can attach images (gif, jpg, png) and files (pdf) in the Attachment section, which can be either shown at the bottom of the page (the default), or placed inline by selecting the point in the body to insert the image, and clicking the "Inline" button next to an uploaded file. There is no limit as to the number of images that can be attached.
  6. The bottom block contains several fill-in areas, selected by tabs.
    1. "Menu settings" is not normally used, as book menus are automatially created.
    2. "Domain access options" tells Drupal where to place the new book. If you are uploading a book by someone else, check "Central Information." If this is new content for the Monastery, check "Kheb Monastery." Only ONE of the "Publish to" boxes should be checked. (CI and Monastery should always be visible; if not, let me know.)
    3. In "Book outline," select "<create a new book>."
    4. "Revision information" is only used when you edit a page, and wish to annotate the changes you made.
    5. "URL path setting" is not used (except for site-wide content such as Terms of Service).
    6. "Domain Specific Paths" allows you to provide a unique URL for the book, which is primiarily used for search engine indexing. The default is "node/#" where # is a number assigned by Drupal--not very meaningful. I normally use a short form of the book name, followed by the chapter name (the new book would be "index.html", which is the common index. For example, the book, "Lost Horizon" would have a Domain-specific path of "losthorizon/index.html" which results in the URL being sent to search engines as:
  7. Click on the Preview button. If you've made a mistake somewhere, an error will show at the top of the screen so you can correct it.
  8. Click on the Save button to save your content.

Setting Book Access

After your book has been created, you need to tell Drupal who can access it. This is done by a set of role permissions, or usernames.

  1. Click on the "Book access" tab.
  2. Under the "View this book" column, check or uncheck boxes to allow this access:
    1. "anonymous user" checked will make the book public, so that anyone can read it without logging in and search engines will index it.
    2. "authenticated user" checked will allow only people that have logged in to read the book. Uncheck "anonymous user" to block public access and only allow logged-in people to read.
    3. "administrator" should always be checked.
    4. "monastery" checked will only allow people that have been accepted to the Kheb Virtual Monastery, by applying for the role. Uncheck "anonymous user" and "authenticated user" to use this private access level.
    5. The "guide-username" roles are used to by guides to limit access to the people within their group. Just leave as-is.
    6. "librarian" checked will allow any librarian (users that help with site management) to access content.
    7. You can add a username to the bottom field, and check the appropriate boxes to have someone else share the creation and editing of your book.
  3. Click "Save configuration" and the access will be applied to your book.

Edit an Existing Book

Click on the book title in the menu, book listing, or anywhere it appears as a link, then click the "Edit" tab.

Adding Child Pages

When reading a page, click the "Add child page" link at the bottom, to add more book content (chapters, sections, etc). Normally, books are organized as a chapter-per-book page. When creating a "Domain-specific alias" for chapters, use your abbreviated book name and the chapter number, name, or both, such as, "losthorizon/02.html" for chapter 2, or "losthorizon/prologue.html" for the prologue.

Child pages can be rearranged at any time. In the "Book outline" tab, you can pick the parent page. If there are multiple pages with the same parent, the default uses a "weight" to sort by. The default is zero, so using a negative number will make the page higher in the book page list, and positive puts it more towards the bottom.

Book contents can be rearranged graphically by clicking on the "Outline" tab when a book page is displayed, and clicking on "reorder an entire book." This will display a list of books you can edit, click on "edit order and titles" and all the book pages will be displayed, with a "drag and drop" arrow to arrange them. You can slide the arrow right/left to make subsections.