Note: You are currently viewing documentation for Moodle 3.8. Up-to-date documentation for the latest stable version of Moodle may be available here: Book settings.

Book settings: Difference between revisions

From MoodleDocs
(starting to update Book module screenshots and info→‎Enable or disable printing)
m (→‎Adding chapters and subchapters: removing new in 3.7)
 
(26 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Book}}
{{Book}}
==Adding a book==
==Adding a book==
* A teacher can add a book by choosing it from the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu in course.
* A teacher can add a book by choosing it from the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu in course.) All settings may expanded by clicking the "Expand all" link top right.


=== Give your book a name and a summary ===
==General==
{|
|[[File:bookgeneral252.png|thumb|General settings expanded by default]]
|}


Tell your students what your book is called and provide a brief description of its content. Keep in mind that ''the name you give your book will become the text for the link to it'' on your main course page. This is true of all the activities you create in Moodle.
===Name ===
Use a descriptive name for your book as it will form the link the students will click on to access it.
===Description===
Provide information for your students here so they are clear what the book is about. Click "Show editing tools" to display the rich text editor and drag the bottom right of the text box out to expand it.
===Display description on course page===
Enabling this will display the description on the course page just below the link to the book.


[[Image:book23.png|frame|none|add name and summary]]
==Appearance==
(These settings are collapsed by default.)
{|
|[[File:bookappearance.png|thumb|Appearance settings expanded]]
|}


=== Indicate how you want chapters numbered ===
===Chapter formatting===


There are several predefined numbering types:  
The options are:


* None - chapter and subchapter titles are not formatted at all, use if you want to define special numbering styles. For example letters: in chapter title type "A First Chapter", "A.1 Some Subchapter",...
* None - chapter and subchapter titles are not formatted at all, use if you want to define special numbering styles. For example letters: in chapter title type "A First Chapter", "A.1 Some Subchapter",...
Line 21: Line 33:
* Indented - subchapters are indented.
* Indented - subchapters are indented.


[[Image:Book3.png|frame|none|define numbering]]
===Style of navigation===


Note that the width of the table of contents is set by the administrator of your site.
Choose between having navigation as images (1) or text links (2) or no navigation, simply the TOC (3)


=== Printing books ===
{|
| [[File:bookimagenav.png|thumb|(1) Images]]
| [[File:booktextnav.png|thumb|(2) Text links]]
| [[File:booktoc.png|thumb|(3) Just the TOC]]
|}


Whole books and individual chapters may be printed by selecting the relevant link in ''Settings>Book administration:''
===Custom titles===
If you disallow custom titles, the chapter title (the one that appears on the table of contents)  will appear as a header at the top of your content (''1 below'') If you enable custom titles, you will be able to create a title different from the one that appears in the ToC or display no title at all (''2 below'') If you enable custom titles, you will need to enter the chapter title as part of the page content.
{|
|[[File:customtitles.png|thumb|Example of a custom title.]]
|}


==Common module settings==
(These settings are collapsed by default.)
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)


[[File:printbook.png]]
These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.


If you do not wish certain roles to be able to print books (eg students) then you can remove this capability via ''Settings>Book administration>Permissions>booktool/print:print''
==Site administration settings==


=== Allow or disallow custom titles ===
The administrator can set the default values for chapter formatting and navigational links in  ''Administration > Site administration > Plugins > Activity modules > Book.''


If you disallow custom titles, the chapter title (the one that appears on the table of contents)  will appear as a header at the top of your content. If you enable custom titles, you will be able to create a title different from the one that appears in the ToC or display no title at all. If you enable custom titles, you will need to enter the chapter title as part of the page content.
==Adding chapters and subchapters==


[[Image:Book5.png|frame|none|permit custom titles?]]
Titles of chapters appear as links in the table of contents to the left of your content. It is recommended to keep your titles short.


[[Image:Custom_title.jpg|frame|none|Custom Titles Enabled: The custom title (red arrow) is different than the title in the table of contents (green arrow).]]
To add a chapter:


[[Image:Custom_title2.jpg|frame|none|Custom Titles Disabled: The titles in the table of contents and in the chapter are the same.]]
# Turn editing on via the link in the Book administration or, in Moodle 3.1.3 onwards, by clicking the 'Turn editing on' button at the top right of the page.
# Click on the  '''+''' icon in the Table of Contents or first chapter. The new chapter will be inserted directly after the chapter whose title is on the same line as the red cross you click (Screenshot 1).


== Add a chapter ==
Note that the sub chapter box is checked. A chapter may have many sub chapters, but sub chapters cannot have further sub chapters. In order to keep this resource simple, you are limited to two levels (Screenshot 2).


Titles of chapters appear as links in the table of contents to the left of your content. Keep your titles short.
You now see a chapter and a sub chapter. Because we did not elect to number chapters, the fact that the second chapter is a sub chapter cannot be seen in the table of contents. Note that you do, however, see this in the title above the content.


[[Image:Book6.png|frame|none|add a chapter]]
By the way, the items in the table of contents are neither numbered nor are they indented only because that is the option we chose when setting up the book. We can always go back and change that (Screenshot 3).


=== View work to date ===
{|
|[[File:addnewchapter.png|thumb|(1) Adding a new chapter]]
|[[File:subchapter.png|thumb|(2) Adding a subchapter]]
|[[File:viewofsubchapter.png|thumb|(3) View of subchapter]]
|}


So far, you see the table of contents on the left and the content on the right. Note the print icons near the top.
When you have finished adding chapters and subchapters, you can turn editing off.


To add another chapter, click on the red cross in the Table of Contents or first chapter. The new chapter will be inserted directly after the chapter whose title is on the same line as the red cross you click.
===Tags===


[[Image:Book7.png|frame|none|so far, so good]]
A teacher (or any other user with editing rights) can tag book chapters.


== Add a sub chapter ==
Tags can be managed by a site administrator in [[Managing tags|Manage tags]] in the Site administration. Book chapter tags may be added to a specified tag collection and standard tags may be suggested or forced. If desired, book chapter tagging may be disabled completely.


Note that the sub chapter box is checked. A chapter may have many sub chapters, but sub chapters cannot have subchapters. In order to keep this resource simple, you are limted to two levels.
==Importing chapters==


[[Image:Book8.png|frame|none|add a sub chapter]]
To import chapters
 
You now see a chapter and a sub chapter. Because we did not elect to number chapters, the fact that the second chapter is a sub chapter cannot be seen in the table of contents. Note that you do, however, see this in the title above the content.


By the way, the items in the table of contents are neither numbered nor are they indented only because that is the option we chose when setting up the book. We can always go back and change that.
*Create a zip file of HTML files and optional multimedia files and folders. If you wish to upload subchapters, add "_sub" to the end of HTML file or folder names.
*Go to Administration > Book administration > Import chapter
*Choose whether each HTML file or folder represents one chapter
*Browse for and select the zip file, either using the Add button or the drag and drop method:
{|
|[[File:importbook.png|thumb|Import book]]
|}
*Click the import button


[[Image:Book9.png|frame|none|better and better]]
Note: Relative file links are converted to absolute chapter links. Images, Flash and Java are re-linked too. Remember to upload images and multimedia files as well as HTML files.


==Importing chapters==
===Importing chapters from existing content===


To import chapters
There are a number of contributed plugins which support importing content into books from other formats.
 
*[https://moodle.org/plugins/booktool_importepub Lucimoo epub import] supports importing content from ePub files.
# Create a zip file of HTML files and optional multimedia files and folders. If you wish to upload subchapters, add "_sub" to the end of HTML file or folder names.
*[https://moodle.org/plugins/booktool_wordimport Word import] supports importing content from Word (''.docx'') files.
# Go to Settings > Book administration > Import chapter
# Choose whether each HTML file or folder represents one chapter
# Browse for and select the zip file
# Click the import button
 
Note: Relative file links are converted to absolute chapter links. Images, Flash and Java are relinked too. Remember to upload images and multimedia files as well as HTML files.


==Book capabilities==
==Book capabilities==
Line 90: Line 119:
*[[Capabilities/booktool/importhtml:import|Import chapters]]
*[[Capabilities/booktool/importhtml:import|Import chapters]]
*[[Capabilities/booktool/print:print|Print book]]
*[[Capabilities/booktool/print:print|Print book]]
*[[Capabilities/mod/book:addinstance|Add a new book]]
[[de:Buch konfigurieren]]
[[es:Configuraciones de libro]]

Latest revision as of 18:04, 17 November 2019

Adding a book

  • A teacher can add a book by choosing it from the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu in course.) All settings may expanded by clicking the "Expand all" link top right.

General

General settings expanded by default

Name

Use a descriptive name for your book as it will form the link the students will click on to access it.

Description

Provide information for your students here so they are clear what the book is about. Click "Show editing tools" to display the rich text editor and drag the bottom right of the text box out to expand it.

Display description on course page

Enabling this will display the description on the course page just below the link to the book.

Appearance

(These settings are collapsed by default.)

Appearance settings expanded

Chapter formatting

The options are:

  • None - chapter and subchapter titles are not formatted at all, use if you want to define special numbering styles. For example letters: in chapter title type "A First Chapter", "A.1 Some Subchapter",...
  • Numbers - chapters and subchapters are numbered (1, 1.1, 1.2, 2, ...)
  • Bullets - subchapters are indented and displayed with bullets.
  • Indented - subchapters are indented.

Style of navigation

Choose between having navigation as images (1) or text links (2) or no navigation, simply the TOC (3)

(1) Images
(2) Text links
(3) Just the TOC

Custom titles

If you disallow custom titles, the chapter title (the one that appears on the table of contents) will appear as a header at the top of your content (1 below) If you enable custom titles, you will be able to create a title different from the one that appears in the ToC or display no title at all (2 below) If you enable custom titles, you will need to enter the chapter title as part of the page content.

Example of a custom title.

Common module settings

(These settings are collapsed by default.) See Common module settings

Restrict access/Activity completion

(These settings are collapsed by default)

These settings are visible if Conditional activities and Activity completion have been enabled in the site and the course.

Site administration settings

The administrator can set the default values for chapter formatting and navigational links in Administration > Site administration > Plugins > Activity modules > Book.

Adding chapters and subchapters

Titles of chapters appear as links in the table of contents to the left of your content. It is recommended to keep your titles short.

To add a chapter:

  1. Turn editing on via the link in the Book administration or, in Moodle 3.1.3 onwards, by clicking the 'Turn editing on' button at the top right of the page.
  2. Click on the + icon in the Table of Contents or first chapter. The new chapter will be inserted directly after the chapter whose title is on the same line as the red cross you click (Screenshot 1).

Note that the sub chapter box is checked. A chapter may have many sub chapters, but sub chapters cannot have further sub chapters. In order to keep this resource simple, you are limited to two levels (Screenshot 2).

You now see a chapter and a sub chapter. Because we did not elect to number chapters, the fact that the second chapter is a sub chapter cannot be seen in the table of contents. Note that you do, however, see this in the title above the content.

By the way, the items in the table of contents are neither numbered nor are they indented only because that is the option we chose when setting up the book. We can always go back and change that (Screenshot 3).

(1) Adding a new chapter
(2) Adding a subchapter
(3) View of subchapter

When you have finished adding chapters and subchapters, you can turn editing off.

Tags

A teacher (or any other user with editing rights) can tag book chapters.

Tags can be managed by a site administrator in Manage tags in the Site administration. Book chapter tags may be added to a specified tag collection and standard tags may be suggested or forced. If desired, book chapter tagging may be disabled completely.

Importing chapters

To import chapters

  • Create a zip file of HTML files and optional multimedia files and folders. If you wish to upload subchapters, add "_sub" to the end of HTML file or folder names.
  • Go to Administration > Book administration > Import chapter
  • Choose whether each HTML file or folder represents one chapter
  • Browse for and select the zip file, either using the Add button or the drag and drop method:
Import book
  • Click the import button

Note: Relative file links are converted to absolute chapter links. Images, Flash and Java are re-linked too. Remember to upload images and multimedia files as well as HTML files.

Importing chapters from existing content

There are a number of contributed plugins which support importing content into books from other formats.

Book capabilities