View source for Help:Books/for experts

{{bookcreatorstatus}}{{Historical|date=May 2021}}
<!--
The original source of this page is at
http://meta.wikimedia.org/wiki/Book_tool/Help/Books/for_experts
Updates to the "book tool" will be documented on that page.
Please check above page for changes on regular basis.
Last checked: 17 Feb 2009

If you translate this page please make sure all links are working in your wiki.
Consider to translate the "book tool" navigation template also.
-->
[[File:Pedia-still-5.jpg|thumb|360px|Printed PediaPress books of Wikipedia content.]]
This page gives experienced users details on the advanced functions of the Book tool.  Among other things, it explains how the layout of books can be improved and how books are stored on Wikipedia.
__TOC__
{{clear}}

==Saving books==
;Format of stored book pages:
When you save a book, it is stored in the format shown below.

{|
|<pre style="font-size:90%">
{{saved book
 |title=
 |subtitle=
 |cover-image=
 |cover-color=
 |text-color=
}}

== Title ==
=== Subtitle ===

;Chapter 1
:[[First article]]
:[[Article 2|Second article]]
:[[Third article]]

;Chapter 2
:[[Fourth article]]
:[[5th article|Fifth article]]
:[[Sixth article]]
</pre>
|<pre style="font-size:90%">
<-- The template appearing at the top of the page
<-- This is only used to generate a preview of the cover
<-- This is only used to generate a preview of the cover
<-- The default cover image of the book
<-- The default cover color of the book
<-- This is only used to generate a preview of the cover


<-- Title of the book
<-- Subtitle of the book

<-- First chapter's name (starts with a semicolon)
<-- First article (starts with a colon)
<-- Second article (renamed)
<-- Third article

<-- Second chapter's name
<-- Fourth article
<-- Fifth article (renamed)
<-- Sixth article
</pre>
|-
|}

You can also manually create a book from scratch by using the same format. To create a book from scratch, start a new page such as <nowiki>[[User:Myusername/Books/Mybookname]]</nowiki>.

;Allowed syntax
Only the following syntax is allowed:
{| class="wikitable"
|-
| '''Title'''
| The title is contained in double equals signs.<br>
{{xt|<code><nowiki>== Title ==</nowiki></code>}}
|-
| '''Subtitle'''
| The subtitles is contained in three equals signs.<br>
{{xt|<code><nowiki>=== Subtitle ===</nowiki></code>}}
|-
| '''Cover image'''
| Simply append the name of the file, e.g. for https://en.wikipedia.org/wiki/File:Plato-raphael.jpg:<br>
{{xt|<code><nowiki>cover-image=Plato-raphael.jpg</nowiki></code>}}
|-
| '''Chapter headings'''
| Chapter headings are preceded with a semicolon.<br>
{{xt|<code>;Chapter name</code>}}
|-
| '''Adding an article'''
| An article is inserted as a wikilink after a colon.<br>
{{xt|<code><nowiki>:[[Article]]</nowiki></code>}}
|-
|'''Renaming an article'''
|You can use a pipe ('<nowiki>|</nowiki>') to rename the article in the book.<br>
{{xt|<code><nowiki>:[[Python (programming language)|Python]]</nowiki></code>}}
|-
|'''Formatting an article title'''
| You can use a pipe to add formatting to a title.<br>
{{xt|<code><nowiki>:[[The Life of Brian|''The Life of Brian'']]</nowiki></code>}}
|}

;Location of books
Books are saved in the user's namespace <nowiki>[[User:Name/Books/Bookname]]</nowiki>. Previously books could also be saved in a specific book namespace.

==Loading books==

To load a book, simply click on the 'Open in Book Creator' link in the banner at the top of each book. If the banner isn't present, then add {{tl|saved book}} at the top of the page.

==Improving the book layout==

Some wiki markup can lead to problems in the generation of PDF documents as part of the book feature.  This mainly applies to templates, which will be displayed differently compared to how they look in the online version of an article.  This can sometimes be fixed by either substituting the current template or removing the template from the content that cause problems in the PDF.  As a rule of thumb, all content (especially templates) that is not useful for an offline version of the document, should be excluded from the print version.

===Identifying problems===

The most efficient way to identify many problems is to go on the individual articles of your book and view the article as a PDF (click "Download as PDF" in the "print/export" box on the left hand side of your screen, towards the bottom). Preview the page, and if something doesn't look right, chances are there's a problem. While the printed books will differ from the PDF version, they share a lot of similarities. If something looks weird in the PDF version, chances are it will also look weird in the printed book.

Usually there are three kinds of problems:

* A template that is not content-related (such as [[WP:NAVBOX|a navigational box]]) is displayed. See below on how to fix this.
* Something looks weird, such as {{val|234|+23|-21}} looking like 234+23-21 in the PDF, or having superfluous whitespace. This is usually due to a template being coded in a non-standard way, or to a problem with the rendering software. You can try to fix this yourself if you know your way around templates. If you don't know how to fix it or are simply intimidated by templates, leave a message on the talk page of the template, and place a notice at [[Help:Books/Feedback]] and someone will look into it.
* Content and style problems, such as spelling, grammar, different varieties of English, poorly worded sentences, ...

This may not find all problems, as the article rendering engine and the book rendering engine will most likely have some differences.

===Exclude templates===
A template can be excluded from content by using {{tl|noprint}}. Support for this feature in various rendering services cannot be guaranteed.
:''Note:'' Many templates use other templates to function.  Therefore groups/types of templates (such as navboxes, sidebars and article message boxes) are excluded by adding the commonly used template to this category.

== Using a main and supporting articles book content style ==

One easily definable style of book, in terms of the content it contains, is to include the main article and all supporting articles that are referenced as major expansions of selected sections. Supporting article links typically are included at the top of a section using templates such as {{tl|Main}}, {{tl|See also}} and {{tl|See}}. Books using this content style offer a comprehensive coverage of the main article, usually within a reasonable number of pages.  Examples of this book style include ''[[Book:Cat]]'' and ''[[Book:Dog]]''.

[[Template:Book]] can be used to create a basic main article and supporting articles book. The template also creates links to start subpages for a table of contents plus a books category based on the main article.

{{Anchor|Hide and unhide book creator}}
== Hiding And Unhiding The Book Creator Toolbar ==
If you have clicked the [Hide] link by the Book Creator Toolbar and want to Unhide it then delete the cookie "dismissSiteNotice" for en.wikipedia.org from your browser cookies. The method for doing this depends on which browser you use. See example here http://www.digitaltrends.com/computing/how-to-delete-cookies-in-chrome-firefox-safari-and-ie/.

==Multi-wiki Books==
Using the extension it is [http://code.pediapress.com/wiki/ticket/408 currently impossible] to create a collection of content from multiple different wikis.  However, you can easily create books containing articles from multiple wikis using the experimental [[bookmarklet]] offered by [[Pedia Press]] on [http://pediapress.com/collection/ this page].

==See also==
* [[Help:Books]] for a step by step guide to creating a wiki book
* The [[Help:Books/Frequently Asked Questions|Book FAQ]]
* [[Help:Books/Feedback|Feedback]] - for reporting and tracking of bugs

[[Category:Wikipedia book tool]]