টেমপ্লেট:তাক:পাতা/নথি-এর উৎস দেখুন

{{নথির উপপাতা}}
{{possible-risk}}
<!-- Please add categories and interwikis to the bottom of this page, and also add interwikis to Wikidata. -->

=== Usage ===
Use this template on a shelf page in the [[{{BOOKNAME}}]]; everything on the shelf page ''other'' than the template call should be <code>noinclude</code>d.

The template primarily performs one of two functions.  It can provide a detailed display of information about the shelf, including its description, its parents, its children (immediate subshelves), and all the books on the shelf or any of its descendants classified by stage of completion; or, it can provide a [[Module:Wikilisp|wikilisp]]-formatted list of parents of the shelf.  The parentage function is performed whenever the shelf page is transcluded onto any page whose <code>PAGENAME</code> does not have prefix <code>Shelf:</code>, and also when invoked by unnamed parameter (below).  Only if <code>PAGENAME</code> has the prefix ''and'' is not overridden by parameter, the template performs its display function.

Parents can be either shelves or departments (the top-level classifications of books in the Wikibooks Stacks).  The corresponding template for departments is {{tl|Department:Page}}.

===Parameters===
*<code>parent</code>: specifies a parent shelf or department, of which this shelf is a subset.
*<code>parent2</code>: optional, specifies a second parent shelf or department.
*<code>description</code>: specifies the description of the subject matter the shelf covers.
*<code>namespace</code>: optional, specifies which namespace should be searched through for books; defaults to the main namespace.
*<code>1</code>: needs to be passed through from the shelf page to this template, otherwise it would not be possible for a transcluding page to override the display function.
Cosmetic parameters, less often used:
*<code>maxcount</code>: optional, specifies a requested maximum length of the book lists; default is the maximum supported directly by the extension (as of this writing, 200); request a larger number if it may be required for this shelf; see {{tl|DPL}}.
*<code>theme</code>: optional, specifies the {{tl|Robox}} theme for the description box; defaults to 15.
*<code>theme2</code>: optional, specifies the {{tl|Robox}} theme for the books box; defaults to 3.
*<code>icon</code>: optional, specifies the logo displayed in the description box without the <code>File:</code> included; defaults to the Wikibooks logo.
*<code>iconwidth</code>: optional, specifies the width of the logo displayed in the description box with <code>px</code> included; defaults to 45px.

===Copy-paste===
{| class="wikitable"
!Commonly-used || Full
|- style="vertical-align:top;"
|<pre>
{{Shelf:Page
 |parent=
 |description=
 |1={{{1|}}}
}}
</pre>
|<pre>
{{Shelf:Page
 |parent=
 |parent2=
 |description=
 |namespace=
 |1={{{1|}}}
 |maxcount=
 |theme=
 |theme2=
 |icon=
 |iconwidth=
}}
</pre>
|}

===Internals===
This template itself determines which sort of information request is being made, and either provides information directly, or delegates the display function to {{nowrap|{{tl|Shelf:Page/display}}}}.  Delegation is done using [[Module:TScope#override]], so that the subtemplate can tell which parameters were not provided, in order to supply default values for them.

When the transcluding page has <code>PAGENAME</code> prefix <code>Shelf:</code> and is not overridden by a non-blank first unnamed parameter, this template delegates to produce a full display.  If the first unnamed parameter is <code>ping</code>, this template returns <code>Shelf:Page</code>.  Otherwise, it produces a list of quoted strings, suitable for parsing via {{tl|evalx}}.  Before attempting to extract the parents this way, a calling page should verify correct format of the result by checking that {{tl|evalx}} recognized the result as a non-empty list; if the format doesn't verify, the caller should report the problem to {{nowrap|[[:{{BOOKCATEGORY}}/Attention needed]]}}.

The maximum number of parents per shelf is meant to be hardcoded only into this template and its subtemplates; if one ever needed to adjust that maximum, they ''should'' be the only templates directly involved.  See also {{tl|Shelf:Map}}.
<includeonly>
<!-- Categories and interwikis go here, and interwikis also go on Wikidata. -->

{{BookCat}}
</includeonly>