Difference between revisions of "Template:RU/documentation/mastertoc"

From Wiki
Jump to navigationJump to search
m (Book Icon in title of toc)
 
(31 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
<noinclude>{{CoreCriticalTemplate}}{{doc}}
 +
[[Category:RU/wiki templates]]
 +
</noinclude>
 +
<!--
 +
<noinclude>{{tlinks|lc=.|dislooklink=yes|dishistlink=yes|diswatchlink=yes|fontsize=16}}
 +
 +
 +
</noinclude>
 +
-->
 
<div id="tocwrapper" clear:both; class="docooo_tocwrapper" style="float:right;  width: 200px; padding: 0px; border: 3px solid #fff; border-left: 20px solid #fff; border-bottom: 20px solid #fff; margin-left: 40px; margin-bottom: 20px; margin-top: -5px;">
 
<div id="tocwrapper" clear:both; class="docooo_tocwrapper" style="float:right;  width: 200px; padding: 0px; border: 3px solid #fff; border-left: 20px solid #fff; border-bottom: 20px solid #fff; margin-left: 40px; margin-bottom: 20px; margin-top: -5px;">
 +
 
   <div id="icon" style="float:right; margin-right: -10px; margin-top: -10px;">[[Image:Book.png]]</div>
 
   <div id="icon" style="float:right; margin-right: -10px; margin-top: -10px;">[[Image:Book.png]]</div>
 +
 
   <div id="{{{bookid}}}" style="border:1px solid #9BC0F5; padding: 0px; font-size: xx-small; background-color: #FFF;">
 
   <div id="{{{bookid}}}" style="border:1px solid #9BC0F5; padding: 0px; font-size: xx-small; background-color: #FFF;">
 
     <div id="doc_toctitle" class="docooo_toctitle docsection">{{{booktitle}}}</div>
 
     <div id="doc_toctitle" class="docooo_toctitle docsection">{{{booktitle}}}</div>
Line 8: Line 19:
 
{|border=0 width=100%
 
{|border=0 width=100%
 
|-
 
|-
|style="text-align:left;"|<span style="display: {{{ShowPrevPart|none}}}">[[{{{PrevPart}}}|&lt; {{Documentation/TOC/TOC_{{{Lang|en}}}|Previous Section}}]]</span>
+
|style="text-align:left;"|<span style="display: {{{ShowPrevPart|none}}}">[[{{{PrevPart}}}|{{RU/documentation/toc/toc_ru|Previous Section}} - {{{PrevPartName}}}]]</span>
|style="text-align:right;"|<span style="display: {{{ShowNextPart|none}}}">[[{{{NextPart}}}|{{Documentation/TOC/TOC_{{{Lang|en}}}|Next Section}} &gt;]]</span>
+
|style="text-align:right;"|<span style="display: {{{ShowNextPart|none}}}">[[{{{NextPart}}}|{{RU/documentation/toc/toc_ru|Next Section}} - {{{NextPartName}}} ]]</span>
 
|}
 
|}
 
</div>
 
</div>
Line 19: Line 30:
 
{|border=0 width=100%
 
{|border=0 width=100%
 
|-
 
|-
|style="text-align:left;"|<span style="display: {{{ShowPrevPage|none}}}">[[{{{PrevPage}}}|&lt; {{Documentation/TOC/TOC_{{{Lang|en}}}|Previous Page}}]]</span>
+
|style="text-align:left;"|<span style="display: {{{ShowPrevPage|none}}}">[[{{{PrevPage}}}|{{RU/documentation/toc/toc_ru|Previous Page}}]]</span>
|style="text-align:right;"|<span style="display: {{{ShowNextPage|none}}}">[[{{{NextPage}}}|{{Documentation/TOC/TOC_{{{Lang|en}}}|Next Page}} &gt;]]</span>
+
|style="text-align:right;"|<span style="display: {{{ShowNextPage|none}}}">[[{{{NextPage}}}|{{RU/documentation/toc/toc_ru|Next Page}}]]</span>
 
|}
 
|}
 
</div>
 
</div>
Line 27: Line 38:
  
 
<noinclude>
 
<noinclude>
 +
 +
==Usage of Parameters==
 +
;ShowPrevPage:set to "block" to show the "previous page" link, set to "none" to hide it. This parameter is not set in the TOC based on this template, but rather in the file containing that TOC. So the parameter value is "passed through" the TOC to this template and therefore '''must explicitly''' be set to none to hide the link. The TOC must use <nowiki>{{{ShowPrevPage}}}</nowiki> as the parameter value to ensure passing along.
 +
;PrevPage:the path to the previous page (no surrounding "[")
 +
;ShowNextPage:set to "block" to show the "next page" link, set to "none" to hide it. This parameter is not set in the TOC based on this template, but rather in the file containing that TOC. So the parameter value is "passed through" the TOC to this template and therefore '''must explicitly''' be set to none to hide the link. The TOC must use <nowiki>{{{ShowNextPage}}}</nowiki> as the parameter value to ensure passing along.
 +
;NextPage:the path to the previous page (no surrounding "[")
 +
;bookid:The id for the book (not yet evaluated)
 +
;booktitle:The book title that appears at the top of the TOC in full wiki syntax (i.e. as a link: <nowiki>[[MyGuide|My Great Manual]]</nowiki>
 +
;ShowParttitle:set to "block" to show the part title. This will be used in Sub-TOCs. It will default to hidden when not specified.
 +
;parttitle:The title of the part that this Sub-TOC covers in full wiki syntax (i.e. as a link: <nowiki>[[MyGuide/MyPart|Part 1: My Great Part]]</nowiki>
 +
;toccontent:The content of the TOC as lists and divs.
 +
;ShowPrevPart:set to "block" in to show the "previous part" link at the bottom of the TOC. If this parameter is set at the TOC level (and not on the file level like the prev/next page parameter), it will default to hidden when not specified.
 +
;PrevPart:the path to the first page of the previous part (no surrounding "[")
 +
;ShowNextPart:set to "block" in to show the "previous part" link at the bottom of the TOC. If this parameter is set at the TOC level (and not on the file level like the prev/next page parameter), it will default to hidden when not specified.
 +
;NextPart:the path to the first page of the next part (no surrounding "[")
 +
 +
{{Note|The style classes are not yet created in the css file}}
 +
 +
=== Simulated example ===
 +
 +
* '''ShowPrevPage''' set to '''none'''
 +
* '''ShowNextPage''' set to '''block'''
 +
* '''NextPage''' set to '''The Next Page'''
 +
* '''bookid''' set to '''1234'''
 +
* '''booktitle''' set to '''<nowiki>[[My Manual]]</nowiki>'''
 +
* '''ShowParttitle''' set to '''block'''
 +
* '''parttitle''' set to '''<nowiki>[[The First Part]]</nowiki>'''
 +
* '''ShowPrevPart''' set to '''none'''
 +
* '''ShowNextPart''' set to '''block'''
 +
* '''NextPart''' set to '''The Second Part'''
 +
* '''toccontent''' set to '''* Chapter<br /> * Chapter<br /> * Chapter'''
 +
 +
<div style="border: 1px dotted #000; padding: 20px; width: 400px; margin: 20px;">
 +
 +
<div id="tocwrapper" class="docooo_tocwrapper" style="width: 200px; padding: 0px; border: 5px solid #fff;">
 +
  <div id="icon" style="float:right; margin-right: -10px; margin-top: -10px;">[[Image:Book.png]]</div>
 +
  <div id="1234" style="border:1px solid #9099a8; padding: 0px; font-size: xx-small; background-color: #FFF;">
 +
    <div id="toctitle" class="docooo_toctitle" style="background-color: #c5d0e1; border: 0px solid #9099a8; padding: 1px;font-weight: bold; text-align: left; font-size:120%;">[[My Manual]]</div>
 +
    <div id="parttitle" class="docooo_parttitle" style="padding: 1px;font-weight: bold; text-align: left; border-bottom: 1px solid #9099a8; display:block">
 +
: [[The First Part]]
 +
</div>
 +
<div id="tocfooter" class="docooo_tocfooter" style="padding: 1px;">
 +
{|border=0 width=100%
 +
|-
 +
|style="text-align:left;"|<span style="display: {{{ShowPrevPart|none}}}">[[{{{PrevPart}}}|&lt; Previous Part]]</span>
 +
|style="text-align:right;"|<span style="display: block">[[The Second Part|Next Part &gt;]]</span>
 +
|}
 +
</div>
 +
    <div id="tocbody" class="docooo_tocbody" style="padding: 6px;">
 +
* Chapter
 +
* Chapter
 +
* Chapter
 +
    </div>
 +
<div id="PrevNextPage" class="docooo_prevnextpage" style="font-size: small; margin-bottom: 10px;">
 +
{|border=0 width=100%
 +
|-
 +
|style="text-align:left;"|<span style="display: none">[[{{{PrevPage}}}|&lt; Previous Page]]</span>
 +
|style="text-align:right;"|<span style="display: block">[[The Next Page|Next Page &gt;]]</span>
 +
|}
 +
</div>
 +
</div>
 +
</div>
 +
 +
</div>
 +
 +
===Calculated example===
 +
(note: not usable in preview mode while editing this template):
 +
 +
<pre>{{Documentation/MasterTOC
 +
|ShowPrevPage=none
 +
|ShowNextPage=block
 +
|NextPage=The Next Page
 +
|bookid=1234'''
 +
|booktitle=[[My Manual]]
 +
|ShowParttitle=block
 +
|parttitle=[[The First Part]]
 +
|ShowPrevPart=none
 +
|ShowNextPart=block
 +
|NextPart=The Second Part
 +
|toccontent=* Chapter
 +
* Chapter
 +
* Chapter
 +
}}
 +
</pre>
 +
 +
will be:
 +
 +
<div style="border: 1px dotted #000; padding: 20px; width: 400px; height: 200px; margin: 20px;">
 +
 +
{{Documentation/MasterTOC
 +
|ShowPrevPage=none
 +
|ShowNextPage=block
 +
|NextPage=The Next Page
 +
|bookid=1234'''
 +
|booktitle=[[My Manual]]
 +
|ShowParttitle=block
 +
|parttitle=[[The First Part]]
 +
|ShowPrevPart=none
 +
|ShowNextPart=block
 +
|NextPart=The Second Part
 +
|toccontent=* Chapter
 +
* Chapter
 +
* Chapter
 +
}}
 +
</div>
 +
</noinclude>
 +
<!--
 +
<noinclude>
 +
[[Category:Documentation/Templates]]
 +
[[Category:Exclude in print|{{PAGENAME}}]]
 +
[[Category:Wiki Templates for Navigation]]
 +
</noinclude>
 +
-->
 +
<noinclude>
 +
[[Category:RU/wiki templates/TOC]]
 +
</noinclude>

Latest revision as of 12:12, 25 August 2011

CoreCriticalTemplate.png  Критически важный опорный шаблон    —    Core Critical Template.  

Необдуманное вмешательство в шаблон может повлечь за собой разрушение всего проекта! Unconsidered intervention in the template may result in the destruction of the entire project!
Документация Документация    —    Documentation
Этому шаблону не хватает документации (подстраницы ./doc).   This pattern is not enough documentation (subpage ./doc).
Вы можете помочь проекту, сделав описание шаблона: что он делает, как его использовать, какие параметры он принимает. Это поможет другим людям использовать его.
Для оформления можете воспользоваться {{doc}}. Не забывайте помещать описание внутрь <noinclude></noinclude>.
You can help by making the description of a template: what it does, how to use it, what parameters it takes. This will help other people to use it.
For decor you can use {{doc}}. Do not forget to put the description into <noinclude></noinclude>.




Book.png
{{{booktitle}}}

{{{toccontent}}}

[[{{{PrevPage}}}|←

Предыдущая страница ]]

[[{{{NextPage}}}|

Следующая страница →]]


Usage of Parameters

ShowPrevPage
set to "block" to show the "previous page" link, set to "none" to hide it. This parameter is not set in the TOC based on this template, but rather in the file containing that TOC. So the parameter value is "passed through" the TOC to this template and therefore must explicitly be set to none to hide the link. The TOC must use {{{ShowPrevPage}}} as the parameter value to ensure passing along.
PrevPage
the path to the previous page (no surrounding "[")
ShowNextPage
set to "block" to show the "next page" link, set to "none" to hide it. This parameter is not set in the TOC based on this template, but rather in the file containing that TOC. So the parameter value is "passed through" the TOC to this template and therefore must explicitly be set to none to hide the link. The TOC must use {{{ShowNextPage}}} as the parameter value to ensure passing along.
NextPage
the path to the previous page (no surrounding "[")
bookid
The id for the book (not yet evaluated)
booktitle
The book title that appears at the top of the TOC in full wiki syntax (i.e. as a link: [[MyGuide|My Great Manual]]
ShowParttitle
set to "block" to show the part title. This will be used in Sub-TOCs. It will default to hidden when not specified.
parttitle
The title of the part that this Sub-TOC covers in full wiki syntax (i.e. as a link: [[MyGuide/MyPart|Part 1: My Great Part]]
toccontent
The content of the TOC as lists and divs.
ShowPrevPart
set to "block" in to show the "previous part" link at the bottom of the TOC. If this parameter is set at the TOC level (and not on the file level like the prev/next page parameter), it will default to hidden when not specified.
PrevPart
the path to the first page of the previous part (no surrounding "[")
ShowNextPart
set to "block" in to show the "previous part" link at the bottom of the TOC. If this parameter is set at the TOC level (and not on the file level like the prev/next page parameter), it will default to hidden when not specified.
NextPart
the path to the first page of the next part (no surrounding "[")
Documentation note.png The style classes are not yet created in the css file

Simulated example

  • ShowPrevPage set to none
  • ShowNextPage set to block
  • NextPage set to The Next Page
  • bookid set to 1234
  • booktitle set to [[My Manual]]
  • ShowParttitle set to block
  • parttitle set to [[The First Part]]
  • ShowPrevPart set to none
  • ShowNextPart set to block
  • NextPart set to The Second Part
  • toccontent set to * Chapter
    * Chapter
    * Chapter
Book.png
[[{{{PrevPart}}}|< Previous Part]] Next Part >
  • Chapter
  • Chapter
  • Chapter
[[{{{PrevPage}}}|< Previous Page]] Next Page >

Calculated example

(note: not usable in preview mode while editing this template):

{{Documentation/MasterTOC
|ShowPrevPage=none
|ShowNextPage=block
|NextPage=The Next Page
|bookid=1234'''
|booktitle=[[My Manual]]
|ShowParttitle=block
|parttitle=[[The First Part]]
|ShowPrevPart=none
|ShowNextPart=block
|NextPart=The Second Part
|toccontent=* Chapter
* Chapter
* Chapter
}}

will be:

The First Part
[[{{{PrevPart}}}|<

Previous Section ]]

Next Section >
  • Chapter
  • Chapter
  • Chapter
[[{{{PrevPage}}}|<

Previous Page ]]

Next Page >