Wikibooks:Naming policy

From Wikibooks, the open-content textbooks collection

Jump to: navigation, search

Contents

[edit] The policy

Each chapter or page in a wikibook should start with the name of the book followed by a slash:

  • Book_Title/Chapter_Name.

After that, a book's authors are free to decide what structure is most suitable to the book. The only requirement is that if a hierarchical structure is used in the page names, a slash should be used as the divider:

  • Book_Title/Chapter_Name/Page_Name;
  • Book_Title/Chapter_Name/Page_Name/Sub-page_Name;
  • and so on.

[edit] Examples

You can see how the policy works on these two examples:

Generally, flat page structure is the most popular.

[edit] Grandfathering provision

The policy as noted above is enforced for all new books starting on or after 1 March 2006. Books started before that date may continue to use an alternative page naming structure they were using before 1 March 2006 provided that the book's name is always given in full at the front of the pagename. Books started before 1 March 2006 are, however, strongly encouraged to change their name structure to comply with the rules applying to new books.

[edit] Violation of this policy

One can mark pages which are in violation of this policy with templates:

  • Use {{Rename|[[bookname]]}} for page that needs to be moved.
  • Use {{Cleanup-NC}} at the top of the front page of a book that is not following the conventions of this policy.
  • Use {{Wikify}} for pages with red links that should be diverted to Wikipedia.

[edit] Automatic tools

tsca.bot is a bot used for fast renaming of whole books. If your book(s) need(s) change of naming convention but you don't have time to do it, visit bot's page and write a message to its operator. Bot will move all pages belonging to the book and fix all links to them. Remember that you should only request name change for books where there is consensus to perform such action.

[edit] Coming in to force of this policy

This policy came into force on 1 March 2006 after discussions and a vote on Wikibooks:Policy/Vote/Naming policy.

[edit] Tips

Note that pages with slashes in names automatically generate link up in the hierarchy. You can also use convenient linking style, especially useful in table of contents of your book

  • [[/Chapter/]] on Book page instead of [[Book/Chapter|Chapter]]
  • [[/Chapter|link title]] on Book page instead of [[Book/Chapter|link title]]
  • [[../Anotherchapter/]] on Book/Chapter page instead of [[Book/Anotherchapter|Anotherchapter]]


Many wikibookians prefer chapter names that describe what the chapter is about -- for example, "Chess/Notating_The_Game" is preferred over "Chess/Chapter_10". Numbered chapters make it unnecessarily difficult to insert a new chapter between existing chapters.

Some wikibookians suggest these common (but not yet mandatory policy) page names:

 Bookname                    -> use this for the main page, listing every chapter in the book.
 Bookname/Cover              -> use this for cover image
 Bookname/Authors            -> use this for authors
 Bookname/Introduction       -> introduction
 Bookname/Chapterdescription -> use this for chapters
 Bookname/Print version      -> the entire book at once for efficient printing (using "transclusion")
 (???FIXME: recommended location???)-> the entire book at once in a single PDF file

If someone creates a PDF version of a wikibook, it would be nice if that PDF file were mentioned at Wikibooks:PDF versions, and {{PDF version}} were placed on the table of contents to link to that PDF file.

Personal tools