عرض مصدر قالب:كاتلوج كتاب/شرح

{{Documentation subpage}}
<!-- من فضلك اضف التصانيف وروابط الويكي الأخرى أسفل الصفحة-->

يضع هذا القالب الصفحة التي يتم استخدامه فيها (<code><nowiki>{{FULLPAGENAME}}</nowiki></code>) إلى تصنيفات مناسبة، وذلك بناءً على اصطلاحات تسمية الصفحات وتصنيفها.

=== الاستخدام ===
عندما يُستخدم القالب بدون مُعلمات، فإنه:
* يضع الصفحات الفرعية للكتاب في تصنيف الكتاب ({{لا لف|<code>{{تصنيف كتاب|}}{{tlx|اسم كتاب}}</code>}}) ويصنفها حسب اسم الفصل.
*يضع قوالب الكتاب في تصنيف قوالب الكتاب ({{لا لف|<code>{{تصنيف كتاب|}}{{tlx|اسم كتاب}}/قوالب</code>}}).'' سيعمل هذا فقط إذا بدأت قوالب الكتاب بـ ''&nbsp; {{لا لف|<code>قالب:{{tlx|اسم كتاب}}</code>}}&nbsp;.
*يضع تصنيف قوالب الكتاب في تصنيف الكتاب الرئيسي وفي&nbsp; {{لا لف|<code>[[:تصنيف:قوالب خاصة بالكتب]]</code>}}&nbsp;.
*places any other category in its parent, sorted by the category's last name. The parent has the same name except removing everything from the last slash on; and the last name is the part that was removed after that last slash. For example, {{nowrap|<code>Category:My Book/Images</code>}}&nbsp; would go in&nbsp; {{nowrap|<code>Category:My Book</code>}}&nbsp; with sort key&nbsp; <code>Images</code>&nbsp;.

=== Parameters ===
Optional parameter&nbsp; {{nowrap|<code><nowiki>filing=deep</nowiki></code>}}&nbsp; changes the behavior on book pages, so that a book page with more than one slash in its name is placed in a subcategory of the category where its parent page would be placed, sorted by the page's last name. For example, using&nbsp; {{nowrap|<code><nowiki>{{BookCat|filing=deep}}</nowiki></code>}}&nbsp; on page&nbsp; {{nowrap|<code>My Book/Maps/Asia</code>}}&nbsp; would put that page in&nbsp; {{nowrap|<code>Category:My Book/Maps</code>}}&nbsp; with sort key&nbsp; <code>Asia</code>&nbsp;.

Optional parameter&nbsp; {{nowrap|<code><nowiki>template-filing=deep</nowiki></code>}}&nbsp; changes the behavior on template pages to deep filing (so&nbsp; {{nowrap|<code>Template:My book/Maps/Asia</code>}}&nbsp; would go in&nbsp; {{nowrap|<code>Category:My book/Templates/Maps</code>}}).

Optional parameter&nbsp; <code>sort</code> or <code>sortkey</code> specifies a sort key to be used for categorization instead of relying on {{tl|BOOKSORTKEY}}.

Optional first unnamed parameter is a full page name to use instead of the <code><nowiki>{{FULLPAGENAME}}</nowiki></code> of the current page.

An alternative template {{tl|كاتلوج كتاب/تشخيص}} reports the output of {{tl|كاتلوج كتاب}} (with or without parameters) as an inert string, rather than categorizing the current page.

=== Examples ===
{{magic word templates/book page examples|كاتلوج كتاب/تشخيص}}

=== Internals ===
This template itself only contains the logic to sort out the identity of the target page; deducing the appropriate categorization is then delegated to {{tl|كاتلوج كتاب/أساس}}. As of this writing, parameters assembled here are <code>namespace</code>, <code>pagename</code>, <code>fullpagename</code>, and <code>sortkey</code>; the first unnamed parameter is [[وحدة:TScope/doc#shiftLeft|removed]], and all other parameters are passed through to the subtemplate.

=== See also ===
* See [[Using Wikibooks/Shelves, Categories, and Classifications#Deep filing (advanced)]] for more information.
*Instances are listed at
:* [[:Category:Pages with deep filing]].
:* [[:Category:Pages passing sort key to BookCat]]
:* [[:Category:Pages passing page name to BookCat]]
* {{tl|تصنيف كتاب}} is closely related.
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[تصنيف:Catalogue templates|{{PAGENAME}}]]

</includeonly>