Difference between revisions of "Template:MW file"

From RobotX
Jump to navigation Jump to search
m (Text replacement - "<translate>" to "")
m (Text replacement - "</translate>" to "")
Line 1: Line 1:
 
<noinclude>
 
<noinclude>
 
<languages/>
 
<languages/>
</noinclude>{{#switch:</translate>
+
</noinclude>{{#switch:
 
| =
 
| =
 
<includeonly><span style="display:none">{{#ifeq:{{PAGENAME}}|{{BASEPAGENAME}}|{{DISPLAYTITLE:{{NAMESPACE}}:{{{1}}}}}}}</span></includeonly>
 
<includeonly><span style="display:none">{{#ifeq:{{PAGENAME}}|{{BASEPAGENAME}}|{{DISPLAYTITLE:{{NAMESPACE}}:{{{1}}}}}}}</span></includeonly>
 
<table style="background: #fff; border:1px solid #a2a9b1; margin: 1em auto;" cellpadding="5" cellspacing="0" class="plainlinks">
 
<table style="background: #fff; border:1px solid #a2a9b1; margin: 1em auto;" cellpadding="5" cellspacing="0" class="plainlinks">
 
<tr style="background: #eaecf0; text-align:center;">
 
<tr style="background: #eaecf0; text-align:center;">
<th colspan="2">{{ll|Manual:Code|<!--T:1--> MediaWiki file:</translate>}} {{{1}}}</th>
+
<th colspan="2">{{ll|Manual:Code|<!--T:1--> MediaWiki file:}} {{{1}}}</th>
 
</tr><tr>
 
</tr><tr>
<td>'''<!--T:2--> Location:</translate>'''</td>
+
<td>'''<!--T:2--> Location:'''</td>
 
<td>{{{2|/}}}</td>
 
<td>{{{2|/}}}</td>
 
</tr><tr valign="top">
 
</tr><tr valign="top">
<td>'''<!--T:3--> Source code:</translate>'''</td>
+
<td>'''<!--T:3--> Source code:'''</td>
<td>{{#if: {{{NotInGit|}}}|<!--T:4--> not in Git</translate> ({{{NotInGit}}})|
+
<td>{{#if: {{{NotInGit|}}}|<!--T:4--> not in Git ({{{NotInGit}}})|
 
[https://phabricator.wikimedia.org/diffusion/MW/browse/master/{{trim|{{{2|}}}}}{{trim|{{{1|index.php}}}}} master]<!--
 
[https://phabricator.wikimedia.org/diffusion/MW/browse/master/{{trim|{{{2|}}}}}{{trim|{{{1|index.php}}}}} master]<!--
 
&bull; [https://phabricator.wikimedia.org/diffusion/MW/browse/{{MW pre-release release git}}/{{trim|{{{2|}}}}}{{trim|{{{1|}}}}} {{MW pre-release release number}}] --> &bull; [https://phabricator.wikimedia.org/diffusion/MW/browse/{{MW stable release git}}/{{trim|{{{2|}}}}}{{trim|{{{stable|{{{1|index.php}}}}}}}} {{MW stable release number}}] &bull; [https://phabricator.wikimedia.org/diffusion/MW/browse/{{MW legacy release git}}/{{trim|{{{2|}}}}}{{trim|{{{legacy|{{{stable|{{{1|index.php}}}}}}}}}}} {{MW legacy release number}}] {{ #ifeq: {{MW legacy release number}} | {{MW legacy lts release number}} || &bull; [https://phabricator.wikimedia.org/diffusion/MW/browse/{{MW legacy lts release git}}/{{trim|{{{2|}}}}}{{trim|{{{lts|{{{legacy|{{{stable|{{{1|index.php}}}}}}}}}}}}}} {{MW legacy lts release number}}] }}
 
&bull; [https://phabricator.wikimedia.org/diffusion/MW/browse/{{MW pre-release release git}}/{{trim|{{{2|}}}}}{{trim|{{{1|}}}}} {{MW pre-release release number}}] --> &bull; [https://phabricator.wikimedia.org/diffusion/MW/browse/{{MW stable release git}}/{{trim|{{{2|}}}}}{{trim|{{{stable|{{{1|index.php}}}}}}}} {{MW stable release number}}] &bull; [https://phabricator.wikimedia.org/diffusion/MW/browse/{{MW legacy release git}}/{{trim|{{{2|}}}}}{{trim|{{{legacy|{{{stable|{{{1|index.php}}}}}}}}}}} {{MW legacy release number}}] {{ #ifeq: {{MW legacy release number}} | {{MW legacy lts release number}} || &bull; [https://phabricator.wikimedia.org/diffusion/MW/browse/{{MW legacy lts release git}}/{{trim|{{{2|}}}}}{{trim|{{{lts|{{{legacy|{{{stable|{{{1|index.php}}}}}}}}}}}}}} {{MW legacy lts release number}}] }}
 
}}</td>
 
}}</td>
 
</tr><tr valign="top">
 
</tr><tr valign="top">
<td>'''<!--T:5--> Classes:</translate>'''</td>
+
<td>'''<!--T:5--> Classes:'''</td>
 
<td>{{#if: {{{class1|}}}| {{class doclink|{{trim|{{{class1}}}}}}} }}<!--
 
<td>{{#if: {{{class1|}}}| {{class doclink|{{trim|{{{class1}}}}}}} }}<!--
 
-->{{#if: {{{class2|}}}| &nbsp;&bull; {{class doclink|{{trim|{{{class2}}}}}}} }}<!--
 
-->{{#if: {{{class2|}}}| &nbsp;&bull; {{class doclink|{{trim|{{{class2}}}}}}} }}<!--
Line 28: Line 28:
 
-->{{#if: {{{interface2|}}}| &bull; {{class doclink|{{trim|{{{interface2}}}}}|type=interface}} }}<!--
 
-->{{#if: {{{interface2|}}}| &bull; {{class doclink|{{trim|{{{interface2}}}}}|type=interface}} }}<!--
 
-->{{#if: {{{interface3|}}}| &bull; {{class doclink|{{trim|{{{interface3}}}}}|type=interface}} }}<!--
 
-->{{#if: {{{interface3|}}}| &bull; {{class doclink|{{trim|{{{interface3}}}}}|type=interface}} }}<!--
-->{{#if: {{{NotInGit|}}}{{{class1|}}}{{{class2|}}}{{{class3|}}}{{{class4|}}}{{{class5|}}}{{{class6|}}}{{{interface1|}}}{{{interface2|}}}{{{interface3|}}}|| [https://phabricator.wikimedia.org/diffusion/MW/browse/master/?find={{{1|{{BASEPAGENAMEE}}}}} <!--T:29--> Find code</translate>] &bull; [https://doc.wikimedia.org/mediawiki-core/master/php/search.php?query={{{1|{{BASEPAGENAMEE}}}}} <!--T:30--> Find documentation</translate>] <includeonly>[[Category:MediaWiki code pages without class names{{#translation:}}]]</includeonly> }}</td>
+
-->{{#if: {{{NotInGit|}}}{{{class1|}}}{{{class2|}}}{{{class3|}}}{{{class4|}}}{{{class5|}}}{{{class6|}}}{{{interface1|}}}{{{interface2|}}}{{{interface3|}}}|| [https://phabricator.wikimedia.org/diffusion/MW/browse/master/?find={{{1|{{BASEPAGENAMEE}}}}} <!--T:29--> Find code] &bull; [https://doc.wikimedia.org/mediawiki-core/master/php/search.php?query={{{1|{{BASEPAGENAMEE}}}}} <!--T:30--> Find documentation] <includeonly>[[Category:MediaWiki code pages without class names{{#translation:}}]]</includeonly> }}</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
Line 42: Line 42:
 
<!--T:26-->
 
<!--T:26-->
 
Displays an informative box about a file in MediaWiki core, with links to its source code in master, stable, and legacy branches, and links to its classes and interfaces in the generated PHP documentation.
 
Displays an informative box about a file in MediaWiki core, with links to its source code in master, stable, and legacy branches, and links to its classes and interfaces in the generated PHP documentation.
</translate>
+
 
  
 
  <nowiki>{{</nowiki>MW file|''FILENAME''|''PATH''
 
  <nowiki>{{</nowiki>MW file|''FILENAME''|''PATH''
Line 55: Line 55:
 
  }}
 
  }}
  
* <!--T:8--> ''FILENAME'' is the name of the file, including extension.</translate>
+
* <!--T:8--> ''FILENAME'' is the name of the file, including extension.
** <!--T:9--> If the file has been recently renamed, you can use the <tvar|stable><code>stable=</code></> and the <tvar|legacy><code>legacy=</code></> parameters to provide the old name so links work; you'll need to update the template invocation as the release in which the file was renamed moves from master->stable->legacy.</translate>
+
** <!--T:9--> If the file has been recently renamed, you can use the <tvar|stable><code>stable=</code></> and the <tvar|legacy><code>legacy=</code></> parameters to provide the old name so links work; you'll need to update the template invocation as the release in which the file was renamed moves from master->stable->legacy.
* <!--T:10--> ''PATH'' is the path to the file; do not include a leading slash, include the trailing slash.</translate> <!--T:20--> Leave it blank for files in the root directory.</translate>
+
* <!--T:10--> ''PATH'' is the path to the file; do not include a leading slash, include the trailing slash. <!--T:20--> Leave it blank for files in the root directory.
* <!--T:11--> The class arguments are all optional, and if supplied will link to the generated documentation.</translate> <!--T:21--> ''CLASS'' should be the class name, as used in the URL.</translate> <!--T:12--> E.g. "Parser" would generate a link to "classParser.html".</translate> <!--T:27--> The template allows up to six class parameters, <code>class1</code>-<code>class6</code></translate>
+
* <!--T:11--> The class arguments are all optional, and if supplied will link to the generated documentation. <!--T:21--> ''CLASS'' should be the class name, as used in the URL. <!--T:12--> E.g. "Parser" would generate a link to "classParser.html". <!--T:27--> The template allows up to six class parameters, <code>class1</code>-<code>class6</code>
* <!--T:13--> ''INTERFACE'' is similar.</translate> <!--T:28--> The template allows up to three interface parameters</translate>
+
* <!--T:13--> ''INTERFACE'' is similar. <!--T:28--> The template allows up to three interface parameters
* <!--T:14--> The <code>NotInGit</code> argument is optional and should only be used if the file is not in [[<tvar|git>Special:MyLanguage/Git</>|Git]] for some reason (I think this only applies to LocalSettings.php).</translate> <!--T:24--> ''REASON'' is the reason that is displayed in the infobox.</translate> <!--T:25--> Note that <code>NotInGit</code> is case sensitive!</translate>
+
* <!--T:14--> The <code>NotInGit</code> argument is optional and should only be used if the file is not in [[<tvar|git>Special:MyLanguage/Git</>|Git]] for some reason (I think this only applies to LocalSettings.php). <!--T:24--> ''REASON'' is the reason that is displayed in the infobox. <!--T:25--> Note that <code>NotInGit</code> is case sensitive!
  
  
Line 67: Line 67:
  
 
== Examples == <!--T:17-->
 
== Examples == <!--T:17-->
</translate>
+
 
  
 
<pre>
 
<pre>
Line 86: Line 86:
 
<pre>
 
<pre>
 
{{MW file|LocalSettings.php|
 
{{MW file|LocalSettings.php|
|NotInGit=<!--T:18--> created during installation</translate>
+
|NotInGit=<!--T:18--> created during installation
 
}}
 
}}
 
</pre>
 
</pre>
 
{{MW file|LocalSettings.php|
 
{{MW file|LocalSettings.php|
|NotInGit=<!--T:19--> created during installation</translate>
+
|NotInGit=<!--T:19--> created during installation
 
|example=true
 
|example=true
 
}}
 
}}
Line 96: Line 96:
  
 
== See also == <!--T:31-->
 
== See also == <!--T:31-->
</translate>
+
 
* {{ll|Category:MediaWiki code pages without class names}} - <!--T:32--> incompletely filled pages are automatically listed by this template</translate>
+
* {{ll|Category:MediaWiki code pages without class names}} - <!--T:32--> incompletely filled pages are automatically listed by this template
  
 
----
 
----

Revision as of 04:21, 21 December 2019


Usage

Displays an informative box about a file in MediaWiki core, with links to its source code in master, stable, and legacy branches, and links to its classes and interfaces in the generated PHP documentation.


{{MW file|FILENAME|PATH
|class1=CLASS
|class2=CLASS
|class3=CLASS
|...
|interface1=INTERFACE
|interface2=INTERFACE
|interface3=INTERFACE
|NotInGit=REASON
}}
  • FILENAME is the name of the file, including extension.
    • If the file has been recently renamed, you can use the <tvar|stable>stable=</> and the <tvar|legacy>legacy=</> parameters to provide the old name so links work; you'll need to update the template invocation as the release in which the file was renamed moves from master->stable->legacy.
  • PATH is the path to the file; do not include a leading slash, include the trailing slash. Leave it blank for files in the root directory.
  • The class arguments are all optional, and if supplied will link to the generated documentation. CLASS should be the class name, as used in the URL. E.g. "Parser" would generate a link to "classParser.html". The template allows up to six class parameters, class1-class6
  • INTERFACE is similar. The template allows up to three interface parameters
  • The NotInGit argument is optional and should only be used if the file is not in [[<tvar|git>Special:MyLanguage/Git</>|Git]] for some reason (I think this only applies to LocalSettings.php). REASON is the reason that is displayed in the infobox. Note that NotInGit is case sensitive!


The [[<tvar|manual>Special:MyLanguage/Manual:Contents</>|Manual]] uses this template extensively.

Examples

{{MW file|index.php|}}

{{MW file|Article.php|includes/page/
|class1=Article
}}

{{MW file|LocalSettings.php|
|NotInGit=<!--T:18--> created during installation
}}


See also


Maintenance: noslash