Template:Subjects/doc
This is a documentation subpage for Template:Subjects It contains usage information, categories and other content that is not part of the original template page. |
This template is used on 6,000+ pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template categorizes a book in up to 10 subject categories, plus the book category (this is automatic). The book category can be modified by setting the bookcategory
variable. You can also use this on subpages of a book and it will only add the book category; however, {{BookCat}} is recommended for subpages.
For non-subject categories (typically, descendants of Category:Books by type), use template {{categories}} instead of this template.
Usage
edit{{subjects|mathematics|science|etc}}
Internals
editThis template is responsible for adding books to the hidden allbooks categories, which allow automatic generation of lists of books belonging to a given subject or any of its sub-subjects. When this template detects that it is being used on the main page of a book, for each subject specified it calls {{subjects/leaf}}. This is why this template should only be used for subject categories: {{subjects/leaf}} uses subject pages to figure out which allbooks categories to add the book to, and if there are no subject pages to consult, it reports the problem to Category:Attention needed (allbooks). By using {{categories}} for non-subject categories, one avoids nuisance reports to Category:Attention needed (allbooks).
This template can be induced to display diagnostic messages, explaining why it has put the page in Category:Attention needed (allbooks), by specifying parameter diagnose=true
.
See also
edit- {{categories}} — adds book to non-subject categories
- {{alphabetical}} — adds book to alphabetical classification
- {{status}} — classifies book by completion status
- {{BOOKNAME}} — Returns the name of the book including the namespace