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

{{صفحة توثيق فرعية}}
{{div-based-template}}
{{Uses TemplateStyles|{{Documentation subpage}}
{{div-based-template}}
{{Uses TemplateStyles|Template:Auxiliary Table of Contents/styles.css}}
<!-- PLEASE ADD TEMPLATE CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{اختصار قالب|AuxTOC}}
This template creates a special boxed table of contents within a mainspace page.  It is intended for adding tables of contents to works that did not originally feature such a navigation device.  For example, where a work has been broken into chapters or other subsections on subpages on Wikisource where the original document simply flowed from one section to the other.

This template uses the same class as {{tl|header}}, which separates the table of contents from the proofread text derived from the Page: and Index: space.

=== الاستعمال ===
==== أساسي====
<syntaxhighlight lang="wikitext">{{جدول المحتويات الإضافي|قائمة الصفحات الفرعية}}</syntaxhighlight>

==== متقدم====
<syntaxhighlight lang="wikitext">{{جدول المحتويات الإضافي|text=List of subpages|title=|comment=|width=}}</syntaxhighlight>

=== Parameters ===
*{{parameter|title}}: Inserts and new word or phrase in the top left of the table. Default: Chapters.
*{{parameter|comment}}: Inserts a new comment to the right of the title. Default: (not listed in original).
*{{parameter|width}}: Width of the table; default: 30em. Avoid using widths in px, as this can cause unexpectedly narrow results on export.<ref>See [[H:PXWIDTH]] for details. Using a pixel width will add the page to [[:Category:Pages using pixel widths]].</ref>
*{{parameter|nosummary}}: Do not add the contained links to exported file TOCs. This can be useful:
** If the AuxTOC is not the only TOC on the root page (e.g. an AuxTOC is used to add some sections not listed in the original TOC). By adding {{parameter|nosummary}}, the export will contain both the links in the AuxTOC ''and'' the links in the original TOC. Without it, the export may only contain the contents of the AuxTOC. If some links are repeated on the root page's TOCs, they will be repeated on the exported file's TOC. 
** If the same links are added elsewhere. For example, if the same links are presented on a subpage as well as on the main page, the entries from the subpage will be nested in the output file, so the subpage should be used and the main page table should use {{parameter|1=nosummary=y}}. E.g. ''[[Pierre and Jean (Bell, 1902)]]''.

=== Examples ===

Note: The choice of formatting of bullets, or numbered bullets, or without will be conducive to the work and its presentation, and readability. Typically we use unformatted bullets, though are guided by the contributor bringing the work to Wikisource within the scope of [[Wikisource:Style guide]] and the look of the book.

====bulleted presentation====
<syntaxhighlight lang="wikitext">{{جدول المحتويات الإضافي|
*[[/Chapter 1/]]
*[[/Chapter 2/]]
*[[/Chapter 3/]]
*[[/Chapter 4/]]
*[[/Chapter 5/]]
}}</syntaxhighlight>

{{جدول المحتويات الإضافي|
*[[/Chapter 1/]]
*[[/Chapter 2/]]
*[[/Chapter 3/]]
*[[/Chapter 4/]]
*[[/Chapter 5/]]
}}

====plainlist presentation====

<syntaxhighlight lang="wikitext">{{جدول المحتويات الإضافي|title=Foo|comment=Bar|width=20em|{{plainlist|
* [[/مقدمة /]]
* [[/الفصل 1/]]
* [[/الفصل 2/]]
* [[/الفصل 3/]]}}}}</syntaxhighlight>

{{جدول المحتويات الإضافي|title=Foo|comment=Bar|width=20em|{{plainlist|
* [[/مقدمة /]]
* [[/الفصل 1/]]
* [[/الفصل 2/]]
* [[/الفصل 3/]]}}}}

=== انظر أيضًا ===
{{#lst:Help:Templates|navigation templates}}

{{rule|class=__uirule}}
{{reflist}}

<includeonly>{{sandbox other||
<!-- TEMPLATE CATEGORIES HERE, THANKS -->
[[تصنيف:TOC templates]]
}}</includeonly>
}}
<!-- PLEASE ADD TEMPLATE CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{template shortcut|AuxTOC}}
This template creates a special boxed table of contents within a mainspace page.  It is intended for adding tables of contents to works that did not originally feature such a navigation device.  For example, where a work has been broken into chapters or other subsections on subpages on Wikisource where the original document simply flowed from one section to the other.

This template uses the same class as {{tl|header}}, which separates the table of contents from the proofread text derived from the Page: and Index: space.

=== Usage ===
==== Basic ====
<syntaxhighlight lang="wikitext">{{جدول المحتويات الإضافي|List of subpages}}</syntaxhighlight>

==== Advanced ====
<syntaxhighlight lang="wikitext">{{جدول المحتويات الإضافي|text=قائمة الصفحات الفؤعية|title=|comment=|width=}}</syntaxhighlight>

=== Parameters ===
*{{parameter|title}}: Inserts and new word or phrase in the top left of the table. Default: Chapters.
*{{parameter|comment}}: Inserts a new comment to the right of the title. Default: (not listed in original).
*{{parameter|width}}: Width of the table; default: 30em. Avoid using widths in px, as this can cause unexpectedly narrow results on export.<ref>See [[H:PXWIDTH]] for details. Using a pixel width will add the page to [[:Category:Pages using pixel widths]].</ref>
*{{parameter|nosummary}}: Do not add the contained links to exported file TOCs. This can be useful:
** If the AuxTOC is not the only TOC on the root page (e.g. an AuxTOC is used to add some sections not listed in the original TOC). By adding {{parameter|nosummary}}, the export will contain both the links in the AuxTOC ''and'' the links in the original TOC. Without it, the export may only contain the contents of the AuxTOC. If some links are repeated on the root page's TOCs, they will be repeated on the exported file's TOC. 
** If the same links are added elsewhere. For example, if the same links are presented on a subpage as well as on the main page, the entries from the subpage will be nested in the output file, so the subpage should be used and the main page table should use {{parameter|1=nosummary=y}}. E.g. ''[[Pierre and Jean (Bell, 1902)]]''.

=== أمثلة ===

Note: The choice of formatting of bullets, or numbered bullets, or without will be conducive to the work and its presentation, and readability. Typically we use unformatted bullets, though are guided by the contributor bringing the work to Wikisource within the scope of [[Wikisource:Style guide]] and the look of the book.

====bulleted presentation====
<syntaxhighlight lang="wikitext">{{جدول المحتويات الإضافي|
* [[/الفصل 1/]]
* [[/الفصل 2/]]
* [[/الفصل 3/]]
*[[/الفصل 4/]]
*[[/الفصل 5/]]
}}</syntaxhighlight>

{{جدول المحتويات الإضافي|
* [[/الفصل 1/]]
* [[/الفصل 2/]]
* [[/الفصل 3/]]
*[[/الفصل 4/]]
*[[/الفصل 5/]]
}}

====plainlist presentation====

<syntaxhighlight lang="wikitext">{{جدول المحتويات الإضافي|title=Foo|comment=Bar|width=20em|{{plainlist|
* [[/مقدمة /]]
* [[/الفصل 1/]]
* [[/الفصل 2/]]
* [[/الفصل 3/]]}}}</syntaxhighlight>

{{جدول المحتويات الإضافي|title=Foo|comment=Bar|width=20em|{{plainlist|
* [[/مقدمة /]]
* [[/الفصل 1/]]
* [[/الفصل 2/]]
* [[/الفصل 3/]]}}}}

=== See also ===
{{#lst:Help:Templates|navigation templates}}

{{rule|class=__uirule}}
{{reflist}}

<includeonly>{{sandbox other||
<!-- TEMPLATE CATEGORIES HERE, THANKS -->
[[تصنيف:TOC templates]]
}}</includeonly>