View source for Template talk:Documentation subpage

{{Permanently protected}}
{{talkheader}}
{{copied|from1=Template:Documentation_subpage|from_oldid1=617432645|to1=:incubator:Template:Wp/nod/documentation_subpage|to_diff1=4241127
|from2=Template:Documentation_subpage/doc|from_oldid2=825680626|to2=:incubator:Template:Wp/nod/documentation_subpage/doc|to_diff2=4241688}}

== Merge into Template:Documentation subpage ==
This template is part of the {{tl|Documentation}} template set. The {{tl|Template doc}} merge proposal was discussed and decided [[Template talk:Template doc#Merge Template:Documentation and Template:Template doc|here]]. &ndash; [[User:ConradPino|Conrad T. Pino]] 07:15, 7 November 2007 (UTC)

== New lines removed ==
[[User:PEJL]] reported an extra blank line at [[WP:SONG#Infobox]] between "This documentation is transcluded from ..." line and the "Code" line. The extra line was caused by the combination of {{tl|Documentation}} and {{tl|Documentation subpage}}.  [[User:Patrick]] added new lines to {{tl|Documentation}} to deal with other issues and {{tl|Documentation subpage}} was already emitting some itself.  The prior count was low enough to not matter but 3 consecutive new lines generate
<pre><p> <br/> </p></pre>
in the [[HTML]] stream which I saw in test cases. I edited {{tl|Documentation subpage}} to emit less and the extra line was elminated. My examination of the HTML looked clean after {{tl|Documentation subpage}} ending <code><nowiki></div></nowiki></code>. &ndash; [[User:ConradPino|Conrad T. Pino]] 08:11, 7 November 2007 (UTC)

== Defaultsort does not work ==
e.g. {{tl|music}} is sorted under "T" instead of "M". --[[User:FordPrefect42|FordPrefect42]] ([[User talk:FordPrefect42|talk]]) 11:35, 10 February 2008 (UTC)

==Font size==
Can/should someone reduce the font size? —[[User talk:Markles|Markles]] 16:16, 14 March 2008 (UTC)
:Why? This box is only visible when you look at the doc pages themselves, not when you look at the documentation as displayed on the template pages. And when you look at the doc pages themselves then this box is very relevant.
:--[[User:Davidgothberg|David Göthberg]] ([[User talk:Davidgothberg|talk]]) 17:00, 14 March 2008 (UTC)
:*I think of it like the disclaimer at the top of {{tl|tfd}}, below. —[[User talk:Markles|Markles]] 00:40, 15 March 2008 (UTC) <div class="boilerplate metadata plainlinks" id="tfd" style="background-color: transparent; padding: 0; font-size:xx-small; color:#000000; text-align: center; border-bottom:1px solid #AAAAAA; ">&lsaquo; The [[Help:Template|template]] below {{#if:{{{1|}}}|(''[[Template:{{ucfirst:{{{1}}}}}|{{{1}}}]]'')|}} is being considered for deletion. See [[Wikipedia:Templates for deletion#{{{2|Template:{{ucfirst:{{{1|{{PAGENAME}}}}}}}}}}|templates for deletion]] to help reach a consensus. &rsaquo;</div>
:::Eh? The {{tl|tfd}} template uses that small font only because when used it is shown inside other templates. That is, it is shown in articles and pages when the template that is nominated to be deleted is used. If it used bigger font it would cause those nominated templates to grow too large on the article pages. The usage of {{tl|Documentation subpage}} is totally different.
:::--[[User:Davidgothberg|David Göthberg]] ([[User talk:Davidgothberg|talk]]) 02:02, 15 March 2008 (UTC)
*Suit yourself.  It was just an idea.—[[User talk:Markles|Markles]] 05:43, 15 March 2008 (UTC)

== Section 'Functions' is incorrect regarding category ==
[[Template:Documentation subpage#Functions]] states that this template places /doc subpages (into which it is transcluded) into category 'Documentation subpages'.  In fact, this template places such subpages into one of the 'SUBJECTSPACE documentation' categories, e.g. {{cat|Template documentation}}.  (A similar claim is made by {{cat|Template documentation}}.)  --[[User:AlastairIrvine|AlastairIrvine]] ([[User talk:AlastairIrvine|talk]]) 15:08, 18 March 2008 (UTC)
:Fixed.--[[User:Patrick|Patrick]] ([[User talk:Patrick|talk]]) 16:31, 18 March 2008 (UTC)

== Category revisited ==
*[[:Category:Wikipedia documentation]] - Even though it's currently a redlink, click on it and see the 14 current members. This is a bug in the code, or in unintended usage? Either way, could this please be fixed : ) - [[User:Jc37|jc37]] 06:54, 23 April 2008 (UTC)

: This is the problem:
<div style="margin-left:3em;"><pre>
[[Category:{{
      #if: {{SUBJECTSPACE}}
      | {{SUBJECTSPACE}}
      | Article
    }} documentation<noinclude>| </noinclude>]]
</pre></div>
: Do we really need separate categories for every even namespace? —<small>{[[WP:ADMIN|admin]]} [[User talk:Pathoschild/s|Pathoschild]] 08:39:25, 23 April 2008 (UTC)</small>
::Does it even need categorisation at all? - [[User:Jc37|jc37]] 15:56, 23 April 2008 (UTC)
::: Yes, it keeps pages out of [[Special:UncategorizedTemplates]] and is useful for getting a list of documentation pages for database queries. We only need one category to do that, though. —<small>{[[WP:ADMIN|admin]]} [[User talk:Pathoschild/s|Pathoschild]] 20:23:04, 23 April 2008 (UTC)</small>
::::Makes sense. Thanks for the information. At this point is it just a matter of removing the extra category code and replacing it with the single category? - [[User:Jc37|jc37]] 08:58, 24 April 2008 (UTC)
::::: Yes, if nobody objects I'll switch it back to "Documentation subpages". —<small>{[[WP:ADMIN|admin]]} [[User talk:Pathoschild/s|Pathoschild]] 09:25:01, 24 April 2008 (UTC)</small>

== "user template" instead of just "user" ==
{{tlx|editprotected}}
Currently, when this template is used from the {{lc:{{ns:User}}}} or {{lc:{{ns:User_talk}}}} space (i.e. [[Special:MyPage/Template/doc|{{ns:User}}:Example/Template/doc]]), it ouputs:

'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for [[Special:MyPage/Template|{{ns:User}}:Example/Template]]''' (see that page for the {{Fontcolor|black|yellow|user}} itself).
It contains usage information, [[Wikipedia:Categorization|categories]] and other content that is not part of the original {{Fontcolor|black|yellow|user page}}.

It should be changed to:

'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for [[Special:MyPage/Template|{{ns:User}}:Example/Template]]''' (see that page for the {{Fontcolor|black|yellow|user template}} itself).
It contains usage information, [[Wikipedia:Categorization|categories]] and other content that is not part of the original {{Fontcolor|black|yellow|user template page}}.

Given the example ([[Special:MyPage/Template/doc|{{ns:User}}:Example/Template/doc]]), [[Special:MyPage/Template|{{ns:User}}:Example/Template]] is not the user page. It is the user's user template page.

I have also added the ability for this template to accept two parameters (<code>{{tlx|Documentation subpage|text1<nowiki>=</nowiki><var>first optional text</var>|text2<nowiki>=</nowiki><var>second optional text</var>}}</code>) allowing the user to specify what text they'd like to use instead. If neither parameters are specified, the template will automatically use "user template" and "user template page" when used on pages on the {{lc:{{ns:User}}}} or {{lc:{{ns:User_talk}}}} space. If that isn't even the case, it will continue on with the original code that was there (i.e. whatever the <code><nowiki>{{SUBJECTSPACE}}</nowiki></code> is).

Just to note, this has been tested on my own personal template sandbox ([[User:Lightsup55/Template Sandbox]]) and an example /doc subpage ([[User:Lightsup55/Template Sandbox/doc]]).

So with that, please change this:
{{hidden begin|toggle=right|title=Old code|titlestyle=background:lightgrey;}}
<pre><nowiki>{{#if:{{{Original-recipe|}}}{{{Orig|}}}
|<!-- reconstruction of original  Template:Template doc page pattern (now the redirected to " Template:Documentation subpage") template... ca mid-November 2007 -->
<table  class="messagebox" style="line-height:1.1em;" style=" background:#f9f9b7;">
<tr> <td rowspan="3" style="width:60px;text-align:center;" > [[Image:Edit-paste.svg|40px]]</td>
<td> This is the [[Wikipedia:Template documentation|template documentation]]<!--
--> page for [[{{NAMESPACE}}:{{{1|{{BASEPAGENAME}}}}}]].</td></tr>
<tr><td><small>This page may not be intended to be viewed directly. <br/
>Links using [[Help:Variable|variable]]s may appear broken; do not replace these with [[hardcoded]] page names or URLs.</small></td></tr>
</table>{{#if:{{{inhib|x}}}{{{inhibit|}}}|<!-- skip --->|<includeonly>[[Category:Template documentation|{{PAGENAME}}]]</includeonly>
}}<!-- Please retain the above original template... 

There are templates formulated to [[WP:DPP]] that need this.

Of course, if you all want to start updating all the interwiki exported templates, go on making things more incompatible... queries to User:Fabartus.

--->
|<includeonly>{{#ifeq: {{lc:{{SUBPAGENAME}}}} | {{{override|doc}}}
  | <!-- doc page -->
</includeonly>{{
    #ifeq: {{{doc-notice|show}}} | show
    | {{mbox
      | type = notice
      | image = none
      | text = 
'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for {{{1|[[{{SUBJECTSPACE}}:{{BASEPAGENAME}}]]}}}''' <small>(see that page for the {{ #if: {{SUBJECTSPACE}} | {{lc:{{SUBJECTSPACE}}}} | article }} itself)</small>.<br />It contains usage information, [[Wikipedia:Categories|categories]] and other content that is not part of the original {{ #if: {{SUBJECTSPACE}} |{{lc:{{SUBJECTSPACE}}}} page|article}}. 
      }}
    }}{{DEFAULTSORT:{{PAGENAME}}}}{{
    #if: {{{inhibit|}}}
    | <!-- skip -->
    | [[Category:{{
      #if: {{SUBJECTSPACE}}
      | {{SUBJECTSPACE}}
      | Article
    }} documentation<noinclude>| </noinclude>]]
  }}<includeonly>
| <!-- if not on a /doc subpage, do nothing -->
}}</includeonly><noinclude>

{{pp-template|small=yes}}
{{documentation}}
<!-- Add categories and interwikis to the /doc subpage, not here! -->
</noinclude>
}}</nowiki></pre>{{hidden end}}

To this:
{{hidden begin|toggle=right|title=Updated code|titlestyle=background:lightgrey;}}
<pre><nowiki>{{#if:{{{Original-recipe|}}}{{{Orig|}}}
|<!-- reconstruction of original  Template:Template doc page pattern (now the redirected to " Template:Documentation subpage") template... ca mid-November 2007 -->
<table  class="messagebox" style="line-height:1.1em;" style=" background:#f9f9b7;">
<tr> <td rowspan="3" style="width:60px;text-align:center;" > [[Image:Edit-paste.svg|40px]]</td>
<td> This is the [[Wikipedia:Template documentation|template documentation]]<!--
--> page for [[{{NAMESPACE}}:{{{1|{{BASEPAGENAME}}}}}]].</td></tr>
<tr><td><small>This page may not be intended to be viewed directly. <br/
>Links using [[Help:Variable|variable]]s may appear broken; do not replace these with [[hardcoded]] page names or URLs.</small></td></tr>
</table>{{#if:{{{inhib|x}}}{{{inhibit|}}}|<!-- skip --->|<includeonly>[[Category:Template documentation|{{PAGENAME}}]]</includeonly>
}}<!-- Please retain the above original template... 

There are templates formulated to [[WP:DPP]] that need this.

Of course, if you all want to start updating all the interwiki exported templates, go on making things more incompatible... queries to User:Fabartus.

--->
|<includeonly>{{#ifeq: {{lc:{{SUBPAGENAME}}}} | {{{override|doc}}}
  | <!-- doc page -->
</includeonly>{{
    #ifeq: {{{doc-notice|show}}} | show
    | {{mbox
      | type = notice
      | image = none
      | text = 
'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for {{{1|[[{{SUBJECTSPACE}}:{{BASEPAGENAME}}]]}}}''' <small>(see that page for the {{ #if: {{{text1|}}} | {{{text1}}} | {{ #ifeq: {{SUBJECTSPACE}} | {{ns:User}} | {{lc:{{SUBJECTSPACE}}}} template | {{ #if: {{SUBJECTSPACE}} | {{lc:{{SUBJECTSPACE}}}} | article }}}}}} itself)</small>.<br />It contains usage information, [[Wikipedia:Categorization|categories]] and other content that is not part of the original {{ #if: {{{text2|}}} | {{{text2}}} | {{ #if: {{{text1|}}} | {{{text1}}} | {{ #ifeq: {{SUBJECTSPACE}} | {{ns:User}} | {{lc:{{SUBJECTSPACE}}}} template page | {{ #if: {{SUBJECTSPACE}} |{{lc:{{SUBJECTSPACE}}}} page|article}}}}}}}}. 
      }}
    }}{{DEFAULTSORT:{{PAGENAME}}}}{{
    #if: {{{inhibit|}}}
    | <!-- skip -->
    | [[Category:{{
      #if: {{SUBJECTSPACE}}
      | {{SUBJECTSPACE}}
      | Article
    }} documentation<noinclude>| </noinclude>]]
  }}<includeonly>
| <!-- if not on a /doc subpage, do nothing -->
}}</includeonly><noinclude>

{{pp-template|small=yes}}
{{documentation}}
<!-- Add categories and interwikis to the /doc subpage, not here! -->
</noinclude>
}}</nowiki></pre>{{hidden end}}

Thanks. --[[User:Lightsup55|<b style="font-family:Comic Sans MS; text-transform:lowercase; color:#008000;">Lightsup55</b>]] <span style="font-size: x-small">( [[User talk:Lightsup55|T]] | [[Special:Contributions/Lightsup55|C]] )</span> 22:59, 7 February 2009 (UTC)
:Why not just call everything a template? And what's up with the "article" case? This template should never be used in the mainspace. --- [[User:RockMFR|RockMFR]] 05:24, 9 February 2009 (UTC)
::The whole "article" thing wasn't my idea. It was there already, so don't look at me. But yeah... this shouldn't ever be used in the article namespace. Although I do agree with you, keep in mind that "templates" (not to be confused with pages that are just transcluded on another page, such as ''Wikipedia:Articles for deletion/Article name'' transcluded on the log page for the day when it was created) are generally found in the {{lc:{{ns:Template}}}} and {{lc:{{ns:User}}}} namespaces. --[[User:Lightsup55|<b style="font-family:Comic Sans MS; text-transform:lowercase; color:#008000;">Lightsup55</b>]] <span style="font-size: x-small">( [[User talk:Lightsup55|T]] | [[Special:Contributions/Lightsup55|C]] )</span> 06:33, 9 February 2009 (UTC)
:{{Done}} [[User:Ruslik0|Ruslik]] ([[User talk:Ruslik0|talk]]) 12:47, 9 February 2009 (UTC)

== Please add "userbox=yes" parameter ==
{{tl|editprotected}}

This change is to add the "<code>|userbox=yes</code>" parameter (case sensitive). I plan on using this with the <code>{{tl|Userbox documentation subpage}}</code> template (a shortcut that will load this template as <code>{{tlx|Documentation subpage|userbox<nowiki>=</nowiki>yes}}</code>).

Test pages:
*[[User:Lightsup55/Template Sandbox 3]]
*[[User:Lightsup55/Template Sandbox 3/doc]]

{{hidden begin|toggle=right|title=Change this:|titlestyle=background:lightgrey;}}
<pre><nowiki>{{#if:{{{Original-recipe|}}}{{{Orig|}}}
|<!-- reconstruction of original  Template:Template doc page pattern (now the redirected to " Template:Documentation subpage") template... ca mid-November 2007 -->
<table  class="messagebox" style="line-height:1.1em;" style=" background:#f9f9b7;">
<tr> <td rowspan="3" style="width:60px;text-align:center;" > [[Image:Edit-paste.svg|40px]]</td>
<td> This is the [[Wikipedia:Template documentation|template documentation]]<!--
--> page for [[{{NAMESPACE}}:{{{1|{{BASEPAGENAME}}}}}]].</td></tr>
<tr><td><small>This page may not be intended to be viewed directly. <br/
>Links using [[Help:Variable|variable]]s may appear broken; do not replace these with [[hardcoded]] page names or URLs.</small></td></tr>
</table>{{#if:{{{inhib|x}}}{{{inhibit|}}}|<!-- skip --->|<includeonly>[[Category:Template documentation|{{PAGENAME}}]]</includeonly>
}}<!-- Please retain the above original template... 

There are templates formulated to [[WP:DPP]] that need this.

Of course, if you all want to start updating all the interwiki exported templates, go on making things more incompatible... queries to User:Fabartus.

--->
|<includeonly>{{#ifeq: {{lc:{{SUBPAGENAME}}}} | {{{override|doc}}}
  | <!-- doc page -->
</includeonly>{{
    #ifeq: {{{doc-notice|show}}} | show
    | {{mbox
      | type = notice
      | image = none
      | text = 
'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for {{{1|[[{{SUBJECTSPACE}}:{{BASEPAGENAME}}]]}}}''' <small>(see that page for the {{ #if: {{{text1|}}} | {{{text1}}} | {{ #ifeq: {{SUBJECTSPACE}} | {{ns:User}} | {{lc:{{SUBJECTSPACE}}}} template | {{ #if: {{SUBJECTSPACE}} | {{lc:{{SUBJECTSPACE}}}} | article }}}}}} itself)</small>.<br />It contains usage information, [[Wikipedia:Categories|categories]] and other content that is not part of the original {{ #if: {{{text2|}}} | {{{text2}}} | {{ #if: {{{text1|}}} | {{{text1}}} | {{ #ifeq: {{SUBJECTSPACE}} | {{ns:User}} | {{lc:{{SUBJECTSPACE}}}} template page | {{ #if: {{SUBJECTSPACE}} |{{lc:{{SUBJECTSPACE}}}} page|article}}}}}}}}. 
      }}
    }}{{DEFAULTSORT:{{PAGENAME}}}}{{
    #if: {{{inhibit|}}}
    | <!-- skip -->
    | [[Category:{{
      #if: {{SUBJECTSPACE}}
      | {{SUBJECTSPACE}}
      | Article
    }} documentation<noinclude>| </noinclude>]]
  }}<includeonly>
| <!-- if not on a /doc subpage, do nothing -->
}}</includeonly><noinclude>
{{pp-template|small=yes}}
{{documentation}}
<!-- Add categories and interwikis to the /doc subpage, not here! -->
</noinclude>
}}</nowiki></pre>{{hidden end}}

{{hidden begin|toggle=right|title=To this:|titlestyle=background:lightgrey;}}
<pre><nowiki>{{#if:{{{Original-recipe|}}}{{{Orig|}}}
|<!-- reconstruction of original  Template:Template doc page pattern (now the redirected to " Template:Documentation subpage") template... ca mid-November 2007 -->
<table  class="messagebox" style="line-height:1.1em;" style=" background:#f9f9b7;">
<tr> <td rowspan="3" style="width:60px;text-align:center;" > [[Image:Edit-paste.svg|40px]]</td>
<td> This is the [[Wikipedia:Template documentation|template documentation]]<!--
--> page for [[{{NAMESPACE}}:{{{1|{{BASEPAGENAME}}}}}]].</td></tr>
<tr><td><small>This page may not be intended to be viewed directly. <br/
>Links using [[Help:Variable|variable]]s may appear broken; do not replace these with [[hardcoded]] page names or URLs.</small></td></tr>
</table>{{#if:{{{inhib|x}}}{{{inhibit|}}}|<!-- skip --->|<includeonly>[[Category:Template documentation|{{PAGENAME}}]]</includeonly>
}}<!-- Please retain the above original template... 

There are templates formulated to [[WP:DPP]] that need this.

Of course, if you all want to start updating all the interwiki exported templates, go on making things more incompatible... queries to User:Fabartus.

--->
|<includeonly>{{#ifeq: {{lc:{{SUBPAGENAME}}}} | {{{override|doc}}}
  | <!-- doc page -->
</includeonly>{{
    #ifeq: {{{doc-notice|show}}} | show
    | {{mbox
      | type = notice
      | image = none
      | text = 
'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for {{{1|[[{{SUBJECTSPACE}}:{{BASEPAGENAME}}]]}}}''' <small>(see that page for the {{ #ifeq: {{{userbox|}}} | yes | userbox | {{ #if: {{{text1|}}} | {{{text1}}} | {{ #ifeq: {{SUBJECTSPACE}} | {{ns:User}} | {{lc:{{SUBJECTSPACE}}}} template | {{ #if: {{SUBJECTSPACE}} | {{lc:{{SUBJECTSPACE}}}} | article }}}}}}}} itself)</small>.<br />It contains usage information, [[Wikipedia:Categorization|categories]] and other content that is not part of the original {{ #ifeq: {{{userbox|}}} | yes | userbox template page | {{ #if: {{{text2|}}} | {{{text2}}} | {{ #if: {{{text1|}}} | {{{text1}}} | {{ #ifeq: {{SUBJECTSPACE}} | {{ns:User}} | {{lc:{{SUBJECTSPACE}}}} template page | {{ #if: {{SUBJECTSPACE}} |{{lc:{{SUBJECTSPACE}}}} page|article}}}}}}}}}}. 
      }}
    }}{{DEFAULTSORT:{{PAGENAME}}}}{{
    #if: {{{inhibit|}}}
    | <!-- skip -->
    | [[Category:{{
      #if: {{SUBJECTSPACE}}
      | {{SUBJECTSPACE}}
      | Article
    }} documentation<noinclude>| </noinclude>]]
  }}<includeonly>
| <!-- if not on a /doc subpage, do nothing -->
}}</includeonly><noinclude>
{{pp-template|small=yes}}
{{documentation}}
<!-- Add categories and interwikis to the /doc subpage, not here! -->
</noinclude>
}}</nowiki></pre>{{hidden end}}

Thanks. --[[User:Lightsup55|<b style="font-family:Comic Sans MS; text-transform:lowercase; color:#008000;">Lightsup55</b>]] <span style="font-size: x-small">( [[User talk:Lightsup55|T]] | [[Special:Contributions/Lightsup55|C]] )</span> 18:47, 12 February 2009 (UTC)
:{{cross|18}} '''Not done''' - See my explanation over at your related editprotected request at [[Template talk:Documentation#Edit request]]. --[[User:Davidgothberg|David Göthberg]] ([[User talk:Davidgothberg|talk]]) 23:16, 12 February 2009 (UTC)
::This change makes:
:::'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for [[Special:MyPage/Template|{{ns:User}}:Example/Template]]''' (see that page for the {{Fontcolor|black|yellow|userbox}} itself).
:::It contains usage information, [[Wikipedia:Categorization|categories]] and other content that is not part of the original {{Fontcolor|black|yellow|userbox template page}}.
::Only when the "<code>|userbox=yes</code>" parameter is specified (i.e. <code>{{tlx|Documentation subpage|userbox<nowiki>=</nowiki>yes}}</code>). It is for the use on the /doc page of a [[Wikipedia:Userboxes|userbox]] template.<br /><br />
::The '''normal function''' (with the help of <code><nowiki>{{lc:{{SUBJECTSPACE}}}}</nowiki></code> [[mw:Help:Magic words|magic word]]s together), or <code>{{tl|Documentation subpage}}</code> without parameters, just makes:
:::'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for [[Special:MyPage/Template|{{ns:User}}:Example/Template]]''' (see that page for the {{Fontcolor|black|yellow|{{lc:{{SUBJECTSPACE}}}}}} itself).
:::It contains usage information, [[Wikipedia:Categorization|categories]] and other content that is not part of the original {{Fontcolor|black|yellow|{{lc:{{SUBJECTSPACE}}}} page}}.
::Test pages: [[User:Lightsup55/Template Sandbox 3]] and the [[User:Lightsup55/Template Sandbox 3/doc|/doc page]]
:: --[[User:Lightsup55|<b style="font-family:Comic Sans MS; text-transform:lowercase; color:#008000;">Lightsup55</b>]] <span style="font-size: x-small">( [[User talk:Lightsup55|T]] | [[Special:Contributions/Lightsup55|C]] )</span> 04:12, 13 February 2009 (UTC)
:I've given examples, made changes based on your recommendations, inserted the new code, and re-applied the {{tl|editprotected}} template. --[[User:Lightsup55|<b style="font-family:Comic Sans MS; text-transform:lowercase; color:#008000;">Lightsup55</b>]] <span style="font-size: x-small">( [[User talk:Lightsup55|T]] | [[Special:Contributions/Lightsup55|C]] )</span> 04:52, 13 February 2009 (UTC)
::I see from the previous section that you and Ruslik deployed the change from "user" to "user template". And as far as I can see that "user template" code is indeed in the deployed code of this template. So I believe your second example here is wrong. It is not "userbox" vs. "template", but rather it is "userbox" vs. "user template", right?
::--[[User:Davidgothberg|David Göthberg]] ([[User talk:Davidgothberg|talk]]) 07:40, 13 February 2009 (UTC)
::: "user template" is automatically given by the use <code><nowiki>{{lc:{{SUBJECTSPACE}}}} template</nowiki></code> (or <code><nowiki>{{lc:{{ns:User}}}} template</nowiki></code>) if the template is being used from the {{ns:User}} namespace, it takes the namespace and makes it lowercase. A user who uses this template on a page that documents the usage of a userbox might not want to say "user template". It is optional to specify the "userbox=yes" parameter. Alternatively, "text1=''your words''" and/or "text2=''your words''" can be used to have your own words displayed. Although you could manually type in "text1=userbox template" and "text2=userbox template page", it is a little much extra to type and I thought that having a shortcut to it might be preferred.
::: --[[User:Lightsup55|<b style="font-family:Comic Sans MS; text-transform:lowercase; color:#008000;">Lightsup55</b>]] <span style="font-size: x-small">( [[User talk:Lightsup55|T]] | [[Special:Contributions/Lightsup55|C]] )</span> 18:23, 13 February 2009 (UTC)
:Assuming I have correctly understood what it is you want to do:
:Ah, so ''that'' is what you want to do. You want to make it so when we view the /doc page of a userbox in user space you can make it so {{tl|documentation subpage}} display the word "userbox" instead of "user template". So that's what all this is about, two words? (Couldn't you have told us that from starters? Instead of making me spend hours reading your code and asking you questions?)
:So to make that possible you want to add code to use this: {{tlc|documentation subpage|2=userbox=yes}}. And have a special template {{tl|userbox documentation subpage}}, which should be put on a special preload page [[Template:Documentation/userbox preload]]. And add code to use {{tlc|documentation|2=userbox=yes}} to load that special preload page. And all this of course has to be explained in the documentation of those templates. Ouch, that is a lot of code, templates, pages and documentation to just change two words.
:But hang on, a userbox is a "user template", so that already is a pretty good name for it. But calling it a "userbox" is of course a bit more precise. So question is if it is worth ''that'' much trouble just to have the option to sometimes change those two words... 
:Now that we know what all this is about we can start to ponder and discuss how useful it is, if it is worth the added complexity, and if there is a better or simpler way.
:And I think I do know a better and simpler way:
:In your previous additions to this template you added the parameters "text1" and "text2". So you can already do {{tlc|documentation subpage|2=text1=userbox}} to achieve what you want. Or the deluxe variant {{tlc|documentation subpage|2=text1=userbox|3=text2=userbox page}}. (By the way, you haven't yet added those two parameters to the documentation of the {{tl|documentation}} template.)
:This means you can make a very simple and user friendly {{tl|userbox documentation subpage}} template that needs no parameters, and that in turn calls {{tlc|documentation subpage|2=text1=userbox|3=text2=userbox page}}. And I think that is a much better and simpler solution than all the "userbox=yes" stuff. To use this the users only need to do one edit to their /doc page to change {{tl|documentation subpage}} to {{tl|userbox documentation subpage}}. This needs no change to their template pages and no change in preload etc.
:So Lightsup55, it is your previous rather nifty additions to this template that made this simple solution possible! :))
:So my conclusion is: I recommend we do ''not'' add "userbox=yes", since we now have a simpler and better option.
:--[[User:Davidgothberg|David Göthberg]] ([[User talk:Davidgothberg|talk]]) 09:24, 13 February 2009 (UTC)
::As per your suggestion, I'm withdrawing this request. --[[User:Lightsup55|<b style="font-family:Comic Sans MS; text-transform:lowercase; color:#008000;">Lightsup55</b>]] <span style="font-size: x-small">( [[User talk:Lightsup55|T]] | [[Special:Contributions/Lightsup55|C]] )</span> 18:33, 13 February 2009 (UTC)

==Glitch at [[:Template:*mp/doc]]==
{{tlx|edit protected}}
Hi, in the above template's usage, the "*" in the template's name is not reading as a nowiki, instead it's making a bullet, that cancels out the link back to the main template page. Please help and fix this! Thanks --[[User:Funandtrvl|Funandtrvl]] ([[User talk:Funandtrvl|talk]]) 18:06, 26 June 2009 (UTC)
:{{fixed}} I think. &mdash;&nbsp;Martin <small>([[User:MSGJ|MSGJ]]&nbsp;·&nbsp;[[User talk:MSGJ|talk]])</small> 18:37, 26 June 2009 (UTC)

== Minor redirected link update ==
{{tl|edit protected}}
Please update this redirect: <nowiki>[[Wikipedia:Categories|categories]]</nowiki> to: <nowiki>[[Wikipedia:Categorization|categories]]</nowiki>  Thanks  --[[User:Funandtrvl|Funandtrvl]] ([[User talk:Funandtrvl|talk]]) 18:40, 14 July 2009 (UTC)
:[[File:Yes check.svg|20px|link=|alt=]] '''Done'''<!-- Template:EP --> - [[User:Rjd0060|Rjd0060]] ([[User talk:Rjd0060|talk]]) 20:09, 14 July 2009 (UTC)

== Table of contents ==

The Wikipedia default is that when a page has more than three sections, a table of contents (further: TOC) is displayed. A certain user told me that in documentation pages the use of a TOC is often disabled using <nowiki>__NOTOC__</nowiki>. (That is apart from the fact that many documentation pages don't have more than three sections, so a TOC is not displayed anyays.) If this is so then perhaps we should add <nowiki>__NOTOC__</nowiki> to this template. An editor who will want to use a TOC can always add it with <nowiki>__TOC__</nowiki>. What are your opinions. [[User:Debresser|Debresser]] ([[User talk:Debresser|talk]]) 15:43, 11 October 2009 (UTC)

:I disagree with automatically adding <nowiki>__NOTOC__</nowiki>. Yes, there are some documentation pages that use <nowiki>__NOTOC__</nowiki>, I myself used to use that on doc pages once upon a time. But long documentation pages need the table of contents, so nowadays I prefer to let the table of content automatically show like on any other page. And making template doc pages behave differently than what is standard would be confusing. It would be hard for a user to find out why a doc page does not show the table of content, since the <nowiki>__NOTOC__</nowiki> would be hidden inside this template.
:--[[User:Davidgothberg|David Göthberg]] ([[User talk:Davidgothberg|talk]]) 02:05, 2 February 2010 (UTC)

== When there is no documentation ==

Slightly ambiguous heading, but I am looking for a template to display at the top of /doc pages which are designed for categories and interwiki links rather than documentation. There are a few templates around which will transclude /doc for this purpose but do not encourage any specific documentation to be written. (Often it's a series of templates which are centrally documented.) A few spring to mind:
*[[Template:Asbox]]
*[[Template:Flag template documentation]]
*[[Template:Category interwiki]] (I created this one)
I'm wondering if it would be preferable to adapt this template, probably by feeding a parameter, or if it would be easier to write a new template. &mdash;&nbsp;Martin <small>([[User:MSGJ|MSGJ]]&nbsp;·&nbsp;[[User talk:MSGJ|talk]])</small> 19:31, 1 February 2010 (UTC)
:I'm not sure we need a whole new template.  Perhaps all that needs to be done is make the "usage information, " and "and other content" strings optionally disabled (i.e. so that this template reads "It contains [[Wikipedia:Categorization|categories]] and [[Help:Interlanguage links|interlanguage links]] that are not part of the original ...".  But I like those /doc pages to display ''something'', versus only having the <code><nowiki><includeonly>....</includeonly></nowiki></code> material and nothing else. — [[User:Andrwsc|Andrwsc]]&nbsp;([[User talk:Andrwsc|talk]]&nbsp;'''·''' [[Special:Contributions/Andrwsc|contribs]]) 19:41, 1 February 2010 (UTC)
::Okay, I agree we can adapt this one. But the first line would need to be changed as well because "This is a documentation subpage" makes no sense if the page is not for documentation ... &mdash;&nbsp;Martin <small>([[User:MSGJ|MSGJ]]&nbsp;·&nbsp;[[User talk:MSGJ|talk]])</small> 21:11, 1 February 2010 (UTC)

== Original recipe? ==

Is there really anything still using this deprecated style from three years ago? The comments mention it being for [[WP:DPP]], but that just redirects to {{tl|Documentation}}, and some of the other commentary leads me to believe it actually concerns [[Wikipedia:WikiProject template sharing]], which has been inactive for some time. Would anyone object to finally simply removing this? <span style=white-space:nowrap>「[[User:Dinoguy1000|<span style=color:#0000ff>ダイノ</span><span style=color:#008800>ガイ</span>]][[Special:Contributions/Dinoguy1000|<span style=color:#FF9900>千？！</span>]]」<sup>[[Help:IJP|?]] · [[User talk:Dinoguy1000#top|Talk⇒Dinoguy1000]]</sup></span> 21:15, 13 August 2010 (UTC)
:I wondered about this as well. I am imagine it could be safely removed now. &mdash;&nbsp;Martin <small>([[User:MSGJ|MSGJ]]&nbsp;·&nbsp;[[User talk:MSGJ|talk]])</small> 21:43, 13 August 2010 (UTC)

I have added a [[:Category:Template:Documentation subpage transclusions using original-recipe|tracking category]] to check for any uses of {{para|Original-recipe}} or {{para|Orig}}; here's hoping it's still empty once the edit clears the job queue. <span style=white-space:nowrap>「[[User:Dinoguy1000|<span style=color:#0000ff>ダイノ</span><span style=color:#008800>ガイ</span>]][[Special:Contributions/Dinoguy1000|<span style=color:#FF9900>千？！</span>]]」<sup>[[Help:IJP|?]] · [[User talk:Dinoguy1000#top|Talk⇒Dinoguy1000]]</sup></span> 22:25, 18 August 2010 (UTC)
:The tracking category was still empty after three days (more than long enough for the job queue to have cleared), so I went ahead and removed the "original-recipe" code... Feel free to yell at me if I somehow managed to muck it up. =) <span style=white-space:nowrap>「[[User:Dinoguy1000|<span style=color:#0000ff>ダイノ</span><span style=color:#008800>ガイ</span>]][[Special:Contributions/Dinoguy1000|<span style=color:#FF9900>千？！</span>]]」<sup>[[Help:IJP|?]] · [[User talk:Dinoguy1000#top|Talk⇒Dinoguy1000]]</sup></span> 23:35, 21 August 2010 (UTC)

== Update interwiki ==

Please, update interwiki from Russian Wikipedia: [[ru:Шаблон:Docpage]] , thanks. [[User:Andrew M. Vachin|Andrew M. Vachin]] ([[User talk:Andrew M. Vachin|talk]]) 20:02, 31 October 2010 (UTC)

== Redundant? ==

{{tlx|edit requested}}
"(see that page for the template itself)" seems redundant next to a wikilink to the parent page. Please delete it. If there are objections, I'd welcome a reversion and discussion. --[[User:Bsherr|Bsherr]] ([[User talk:Bsherr|talk]]) 21:08, 12 November 2010 (UTC)
:As no one has opposed this, I have made the edit. &mdash;&nbsp;Martin <small>([[User:MSGJ|MSGJ]]&nbsp;·&nbsp;[[User talk:MSGJ|talk]])</small> 09:36, 14 November 2010 (UTC)

== Small error at bottom of rendered page ==

Down near the very bottom of this template page, I see something like this:

<blockquote>Meta-Wiki &#123;{Documentation}} ancestor:

* [[meta:Template:Documentation]][[en:Template:Documentation subpage]]</blockquote>

Of course, that last link, being a self link, isn't actually rendered as a link there, but is instead just bold text. Unfortunately, I'm having trouble seeing where the last link comes from...
* [[Template:Documentation/see also]] has everything prior to that, but then ends with a <code>&lt;nowiki></code>.
* [[Template:Documentation subpage/doc]] might do it.
* And so might [[Template:Documentation subpage]]. (Or even [[Template:Documentation]], for all I know!)

''Very'' confusing.

&mdash;[[User:SamB|SamB]] ([[User talk:SamB|talk]]) 22:53, 7 June 2011 (UTC)
:{{fixed}} [http://en.wikipedia.org/w/index.php?title=Template:Documentation_subpage/doc&diff=433198723&oldid=423673569] &mdash;&nbsp;Martin <small>([[User:MSGJ|MSGJ]]&nbsp;·&nbsp;[[User talk:MSGJ|talk]])</small> 12:38, 8 June 2011 (UTC)

== Template adds portal doc pages to a non-existent cat ==

{{FPER|ans=yes}}
This template is used on nine pages in the portal space, which are then added to the non-existent category [https://secure.wikimedia.org/wikipedia/en/w/index.php?title=Category:Portal_documentation Portal documentation]. It's not clear to me that this category is needed; therefore, can the template be changed to prevent the addition of portal doc pages to the non-existent cat? [[User:Decstop|Decstop]] ([[User talk:Decstop|talk]]) 04:06, 17 October 2011 (UTC)
:Makes sense. I also took out "Article documentation" - because this would never be used in article space! &mdash;&nbsp;Martin <small>([[User:MSGJ|MSGJ]]&nbsp;·&nbsp;[[User talk:MSGJ|talk]])</small> 10:00, 17 October 2011 (UTC)
::Thank you [[User:Decstop|Decstop]] ([[User talk:Decstop|talk]]) 02:44, 18 October 2011 (UTC)

While we are here I think it would be good idea to rename the categories to "Wikipedia documentation ''pages''" and "User documentation ''pages''". We successfully did something similar with "Template documentation pages" a while ago (see [[Template talk:Documentation#Category for documentation pages]]), and this clears the other category to be of more use about finding pages related to documentation rather than the actual /doc pages. &mdash;&nbsp;Martin <small>([[User:MSGJ|MSGJ]]&nbsp;·&nbsp;[[User talk:MSGJ|talk]])</small> 10:33, 17 October 2011 (UTC)
:I got impatient and went ahead with this. I also had a little reorganisation of the category structure for template documentation. &mdash;&nbsp;Martin <small>([[User:MSGJ|MSGJ]]&nbsp;·&nbsp;[[User talk:MSGJ|talk]])</small> 21:29, 17 October 2011 (UTC)

== Edit request ==

{{FPER|ans=yes}}

Replace: 
<pre><nowiki><includeonly>[[Category:{{
      #switch: {{SUBJECTSPACE}}
      | Template  = Template
      | User      = User
      | #default  = Wikipedia
    }} documentation pages]]</includeonly>
</nowiki></pre>

with

<pre><nowiki><includeonly>{{#ifexist:{{BASEPAGENAME}}|[[Category:{{
      #switch: {{SUBJECTSPACE}}
      | Template  = Template
      | User      = User
      | #default  = Wikipedia
    }} documentation pages]]|[[Category:Documentation subpages without corresponding pages]]}}</includeonly>
</nowiki></pre>

Purpose: to check to make sure the page that is being documented actually exists. &mdash;&nbsp;[[User:Train2104|Train2104]]&nbsp;([[User talk:Train2104|talk]]&nbsp;• [[Special:Contributions/Train2104|contribs]]) 21:17, 17 December 2011 (UTC)
: [[File:Yes check.svg|20px|link=|alt=]] '''Done'''<!-- Template:EP --> Sensible. [[User:Anomie|Anomie]][[User talk:Anomie|⚔]] 04:09, 19 December 2011 (UTC)

::That actually needed to be <code><nowiki>{{NAMESPACE}}:{{BASEPAGENAME}}</nowiki></code> rather than  <code><nowiki>{{BASEPAGENAME}}</nowiki></code>, so I've fixed it. -- [[User:WOSlinker|WOSlinker]] ([[User talk:WOSlinker|talk]]) 07:54, 19 December 2011 (UTC)

== interwikis to Wikidata ==

{{FPER|answered=yes}}
Please update the template indicating the interwikis are now added in Wikidata. --[[User:Vivaelcelta|Vivaelcelta]] {[[User talk:Vivaelcelta|discussion]] &nbsp;<span style="font-weight:bold;">·</span>&#32; [[Special:Contributions/Vivaelcelta|contributions]]} 13:47, 6 March 2013 (UTC)
:Please, propose a specific change. [[User:Ruslik0|Ruslik]]_[[User Talk:Ruslik0|<span style="color:red">Zero</span>]] 19:02, 6 March 2013 (UTC)
::I'm guessing that something such as [[Template:Documentation subpage/sandbox]] would do. -- [[User:WOSlinker|WOSlinker]] ([[User talk:WOSlinker|talk]]) 19:22, 6 March 2013 (UTC)

== Text customization - With text1 and text2 ==

[[User:Sardanaphalus]] and [[User:Codename Lisa]], the 25 December 2014 [https://en.wikipedia.org/w/index.php?title=Template:Documentation_subpage/doc&diff=639568261&oldid=623006605 diff] for [[Template:Documentation subpage/doc]] leads me to believe that when I look at the first example for both text1 and text2, I should be seeing both text strings; all I see is the text2 string — both the first and second examples look the same to me. I see the same result when I look at the /doc transcluded on [[Template:Documentation subpage]]<br />FYI, I'm using Safari 5.0.6 on Mac OS X 10.5.8. Thanks. [[User:SBaker43|SBaker43]] ([[User talk:SBaker43|talk]]) 01:10, 20 January 2015 (UTC)
:Hi.

:That's not really the diff's fault; the code responsible for rendering those parameters is:
:<code><nowiki>{{#if:{{{text2|}}} |{{{text2}}} |{{#if:{{{text1|}}} |{{{text1}}} |{{#ifeq:{{SUBJECTSPACE}} |{{ns:User}} |{{lc:{{SUBJECTSPACE}}}} template page |{{#if:{{SUBJECTSPACE}} |{{lc:{{SUBJECTSPACE}}}} page|article}}}}}}}}.</nowiki></code>

:You know, assumptions backfire... sometimes.

:Best regards,
:[[User:Codename Lisa|Codename Lisa]] ([[User talk:Codename Lisa|talk]]) 01:18, 20 January 2015 (UTC)

:* If {{mono|text1}} ''and'' {{mono|text2}} are set, however, shouldn't {{mono|text1}} be visible somewhere – or have I confused myself..? [[User:Sardanaphalus|Sardanaphalus]] ([[User talk:Sardanaphalus|talk]]) 08:28, 20 January 2015 (UTC)
::* Well, join the club! Maybe we should ask someone who knows. But I am busy right now. My time, unfortunately, has grown scarce. Best regards, [[User:Codename Lisa|Codename Lisa]] ([[User talk:Codename Lisa|talk]]) 00:30, 21 January 2015 (UTC)

== [[:Category:Documentation subpages without corresponding pages]] ==

I believe [[:Category:Documentation subpages without corresponding pages]] shouldn't include user pages and propose to limit it to template and module namespaces. I'll leave this here and implement it if noone objects. ‑‑[[User:Trialpears|Trialpears]] ([[User talk:Trialpears|talk]]) 10:56, 16 January 2020 (UTC)

== Text customization (again) ==

Please explain the purpose and function of {{para|text1}}. 

Currently in the documentation, text1 appears to do nothing, so the approach of letting the example explain itself is not sufficient. [[User:CapnZapp|CapnZapp]] ([[User talk:CapnZapp|talk]]) 14:44, 27 October 2020 (UTC)

== One documentation page, many templates ==

How do I set up the documentation for a documentation page that is used by many templates?

(The documentation doesn't say)

For instance: {{tl|Chess diagram small}} uses [[Template:Chess diagram/doc]], but that documentation page's {{tl|Documentation subpage}} refers to {{tl|Chess diagram}}, not {{tl|Chess diagram small}}!

Regards, [[User:CapnZapp|CapnZapp]] ([[User talk:CapnZapp|talk]]) 14:50, 27 October 2020 (UTC)
: {{u|CapnZapp}}, see second line of the wikitext of the [[Template:Chess diagram small]]. It passes <code>Template:Chess_diagram/doc</code> as first parameter to transclusion of template {{tl|Documentation}}:
: <syntaxhighlight lang="moin">
{{#invoke:Chessboard|board|size=22}}<noinclude>
{{Documentation|Template:Chess_diagram/doc}}
</noinclude>
</syntaxhighlight>
: This functionality of the {{tl|Documentation}} template is documented at [[Template:Documentation#Usage]]. As for content of documentation, the template {{tl|Chess diagram small}} is described in section [[Template:Chess_diagram/doc#Small_diagram|"Small diagram"]]. —⁠[[User:Andrybak|andrybak]] ([[User talk:Andrybak|talk]]) 15:05, 27 October 2020 (UTC)
:I have also updated the banner at the top of [[Template:Chess diagram/doc]]: [[Special:Diff/985716832]]. I hope this helps. —⁠[[User:Andrybak|andrybak]] ([[User talk:Andrybak|talk]]) 15:12, 27 October 2020 (UTC)

== Discussion at [[MediaWiki talk:Scribunto-doc-page-header#Category:Module documentation pages]] ==

[[File:Symbol watching blue lashes high contrast.svg|25px|link=|alt=]]&nbsp;You are invited to join the discussion at [[:MediaWiki talk:Scribunto-doc-page-header#Category:Module documentation pages|MediaWiki talk:Scribunto-doc-page-header §&nbsp;Category:Module documentation pages]].  —⁠[[User:Andrybak|andrybak]] ([[User talk:Andrybak|talk]]) 09:27, 14 May 2024 (UTC)<!-- [[Template:Please see]] -->