Template:Root subject/doc

This template is used on top-level subject pages to list books within that subject's respective category. Used on a subject page, it also handles queries to the subject page from other pages. Use subject page for regular subjects.

Usage
Parameters, of which only the first is required:
 * : specifies the description of the subject area the page will cover
 * : alternative to an automatically generated list, specifies a list of featured books in the sub-subjects of this top-level subject as an HTML unordered list ( BookBook2 )
 * : optional, specifies which namespace should be searched through for books; defaults to the main namespace
 * : optional, specifies the Robox theme for the description box; defaults to 15
 * : optional, specifies the Robox theme for the book box; defaults to 3
 * : optional, specifies the logo displayed in the description box without the  included; defaults to the Wikibooks logo
 * : optional, specifies the width of the logo displayed in the description box with  included; defaults to 45px
 * : needs to be passed through from the calling subject page to this template, otherwise the subject category can't extra a subject description or full header
 * : optional, specifies how much information is allowed to be provided to the subject category; possible values are blank (no description or header),  (only provide a description) or   (provide a full header); note however that   does the same thing as omitting parameter , while blank does the same thing as omitting parameter

Internals
This template itself only determines which sort of information request is being made, and either provides the information (if it isn't asking for a full subject display); or delegates the request to root subject/core, which is responsible for generating a full display. Delegation is done using Module:TScope, so that the subtemplate can tell which parameters were not provided, in order to supply default values for them.

When the transcluding page is in  or   space, this template always delegates to produce a full display. In all other namespaces, ordinarily the template returns a string describing the parentage of the subject. The general form of the parentage string is described at subject page; here the string provided is fixed, there being no actual parent parameters by which to vary it, as /Books by subject/ &mdash; thus presenting each root subject as a child of single parent Subject:Books by subject. (Subject:Books by subject also uses this same parentage-string scheme, presenting itself as having no parents, i.e., // .)

Parameters  and   function as described at subject page.