diff --git a/core/modules/help_topics/help_topics/book.about.html.twig b/core/modules/help_topics/help_topics/book.about.html.twig new file mode 100644 index 000000000000..c689dec71abe --- /dev/null +++ b/core/modules/help_topics/help_topics/book.about.html.twig @@ -0,0 +1,28 @@ +--- +label: 'Managing books' +top_level: true +--- +{% set user_topic = render_var(url('help.help_topic', {'id': 'user.overview'})) %} +

{% trans %}What is a book?{% endtrans %}

+

{% trans %}A book is a structured group of content pages, arranged in a hierarchical structure called a book outline. A book hierarchy can be up to nine levels deep, and a book can include Book page content items or other content items. Every book has a default book-specific navigation block, which contains links that lead to the previous and next pages in the book and to the level above the current page in the book's structure.{% endtrans %}

+

{% trans %}What are the permissions for books?{% endtrans %}

+

{% trans %}The following permissions are needed to create and manage books; see Managing user accounts and site visitors and its related topics for more about permissions.{% endtrans %}

+
+
{% trans %}Create new books{% endtrans %}
+
{% trans %}Allows users to add new books to the site.{% endtrans %}
+
{% trans %}Add content and child pages to books and manage their hierarchies{% endtrans %}
+
{% trans %}Allows users to add configured types of content to existing books.{% endtrans %}
+
{% trans %}Administer book outlines{% endtrans %}
+
{% trans %}Allows users to add any type of content to a book, use the book overview administration page, and rearrange the pages of a book from the book outline page.{% endtrans %} +
{% trans %}Administer site configuration (in the System module section){% endtrans %}
+
{% trans %}Allows users to do many site configuration tasks, including configuring books. This permission has security implications.{% endtrans %} +
+
{% trans %}View printer-friendly books{% endtrans %}
+
{% trans %}Allows users to click the printer-friendly version link to generate a printer-friendly display of the page, which includes pages below it in the book outline.{% endtrans %} +
+
{% trans %}Book page content permissions (in the Node module section){% endtrans %}
+
{% trans %}Like other content types, the Book page content type has separate permissions for creating, editing, and deleting a user's own and any content items of this type.{% endtrans %} +
+
+

{% trans %}Managing books{% endtrans %}

+

{% trans %}Book management is handled by the core Book module. The topics listed below will help you create, edit, and configure books.{% endtrans %}

diff --git a/core/modules/help_topics/help_topics/book.adding.html.twig b/core/modules/help_topics/help_topics/book.adding.html.twig new file mode 100644 index 000000000000..8100782d9bfd --- /dev/null +++ b/core/modules/help_topics/help_topics/book.adding.html.twig @@ -0,0 +1,20 @@ +--- +label: 'Adding content to a book' +related: + - book.about + - book.configuring + - book.creating + - book.organizing +--- +{% set node_add = render_var(url('node.add_page')) %} +{% set config = render_var(url('help.help_topic', {'id': 'book.configuring'})) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Add a page to an existing book.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Content > Add content > Book page. If you have configured additional content types that can be added to books, you can substitute a different content type for Book page (see the Configuring books topic for more information).{% endtrans %}
    2. +
  2. {% trans %}Enter a title for the page and some text for the body of the page.{% endtrans %}
    3. +
  3. {% trans %}In the vertical tabs area, click Book Outline. Select the book you want to add the page to in the Book select list. If you want to insert this page into the book hierarchy, also select the desired parent page in the Parent item select list.{% endtrans %}
    4. +
  4. {% trans %}Select the desired weight for the page in the Weight select list (pages with the same parent item are ordered from lowest to highest weight).{% endtrans %}
    5. +
  5. {% trans %}Click Save to add the page to the book.{% endtrans %}
    6. +
diff --git a/core/modules/help_topics/help_topics/book.configuring.html.twig b/core/modules/help_topics/help_topics/book.configuring.html.twig new file mode 100644 index 000000000000..e92143fc6955 --- /dev/null +++ b/core/modules/help_topics/help_topics/book.configuring.html.twig @@ -0,0 +1,18 @@ +--- +label: 'Configuring books' +related: + - book.about + - book.adding + - book.creating + - book.organizing +--- +{% set settings = render_var(url('book.settings')) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Configure settings related to books.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Structure > Books > Settings.{% endtrans %}
    2. +
  2. {% trans %}Check all of the content types that you would like to use as book pages in the Content types allowed in book outlines field.{% endtrans %}
    3. +
  3. {% trans %}In the Content type for the Add child page link field, select the content type that will be created from the Add child page link on a book page.{% endtrans %}
    4. +
  4. {% trans %}Click Save configuration.{% endtrans %}
    5. +
diff --git a/core/modules/help_topics/help_topics/book.creating.html.twig b/core/modules/help_topics/help_topics/book.creating.html.twig new file mode 100644 index 000000000000..30cd656d1f61 --- /dev/null +++ b/core/modules/help_topics/help_topics/book.creating.html.twig @@ -0,0 +1,17 @@ +--- +label: 'Creating a book' +related: + - book.about + - book.adding + - book.organizing + - book.configuring +--- +

{% trans %}Goal{% endtrans %}

+

{% trans %}Create a new book.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Content > Add content > Book page. If you have configured additional content types that can be added to books, you can substitute a different content type for Book page.{% endtrans %}
    2. +
  2. {% trans %}Enter a title for the book, and if desired, some text for the body of the book's title page.{% endtrans %}
    3. +
  3. {% trans %}In the vertical tabs area, click Book Outline. Select - Create a new book - from the Book select list.{% endtrans %}
    4. +
  4. {% trans %}Click Save to create the book.{% endtrans %}
    5. +
diff --git a/core/modules/help_topics/help_topics/book.organizing.html.twig b/core/modules/help_topics/help_topics/book.organizing.html.twig new file mode 100644 index 000000000000..a07774b4c28b --- /dev/null +++ b/core/modules/help_topics/help_topics/book.organizing.html.twig @@ -0,0 +1,19 @@ +--- +label: 'Changing the outline of a book' +related: + - book.about + - book.adding + - book.creating + - book.configuring +--- +{% set overview = render_var(url('book.admin')) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Change the order and titles of pages within a book.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Structure > Books.{% endtrans %}
    2. +
  2. {% trans %}Click Edit order and titles for the book you would like to change.{% endtrans %}
    3. +
  3. {% trans %}Drag the book pages to the desired order.{% endtrans %}
    4. +
  4. {% trans %}If desired, enter new text for one or more of the page titles within the book.{% endtrans %}
    5. +
  5. {% trans %}Click Save book pages.{% endtrans %}
    6. +