Templat:Asbox/doc: Perbedaan antara revisi

2.966 bita ditambahkan ,  1 tahun yang lalu
←Membuat halaman berisi '{{Documentation subpage}} <!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see Wikipedia:Wikidata) --> {{High-use}} {{Uses TemplateStyles|Template:Asbox/styles.css}} {{lua|Module:Asbox}} {{Mbox templates (small)}} Ini adalah [[WP:MTM|metatemplate] '''Asbox''' (['''A''']rticle ['''s''']tub ['''box''']) ]. Merupakan standar yang digunakan untuk membuat baru atau memperbarui kotak templat Wikipedia:Stubs|rint...'
dw>Hidayatsrf
(+ terjemah; transklusi: 300000+)
 
(←Membuat halaman berisi '{{Documentation subpage}} <!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see Wikipedia:Wikidata) --> {{High-use}} {{Uses TemplateStyles|Template:Asbox/styles.css}} {{lua|Module:Asbox}} {{Mbox templates (small)}} Ini adalah [[WP:MTM|metatemplate] '''Asbox''' (['''A''']rticle ['''s''']tub ['''box''']) ]. Merupakan standar yang digunakan untuk membuat baru atau memperbarui kotak templat Wikipedia:Stubs|rint...')
Baris 1: Baris 1:
{{documentation subpage}}
{{Documentation subpage}}
{{terjemah}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
<includeonly>{{high-risk|300000+}}</includeonly>
{{High-use}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{Uses TemplateStyles|Template:Asbox/styles.css}}
{{Mbox templates}}
{{lua|Module:Asbox}}
This is the '''asbox''' or '''article stub box''' meta template. It is the standard template used for creating new or updating existing ''article stub box'' templates. It supports most, if not all, stub template styles.
{{Mbox templates (small)}}


=== Basic usage ===
Ini adalah [[WP:MTM|metatemplate] '''Asbox''' (['''A''']rticle ['''s''']tub ['''box''']) ]. Merupakan standar yang digunakan untuk membuat baru atau memperbarui kotak templat [[Wikipedia:Stubs|rintisan artikel]] yang sudah ada. mendukung secara virtual dari semua style templat rintisan.
<pre>
{{asbox
| image    = just the name of the image, e.g. Image.png - will be sized at 40x30px
| subject  = given before "article", e.g. "this *biographical* article is a stub"
| qualifier = given after "article" e.g. "this article *about a musician* is a stub"
| category  = just the name of the category to place tagged pages in, e.g. History stubs
| name      = the full name of the stub template itself, used to reference itself internally
}}</pre>


This simple usage should suffice for a great many stub templates. Additional parameters are described below for advanced use.
==Penggunaan==
{{tj|Asbox
  | image:
  | subject:
  | qualifier:
  | category:
  | name:
}}


=== Full usage ===
===''image''===
<pre>
Hanya nama file dan tanpa awalan, misal "image.png" (tanpa tanda kutip). Akan diubah ukurannya menjadi 40x30px.
{{asbox
| image     = Ambox style.png
| pix      =
| subject  =
| article  =
| qualifier =
| category  =
| tempsort  =
| category1 =
| tempsort1 =
| note      =
| name      = {{subst:FULLPAGENAME}}
}}</pre>


=== Parameters ===
===''subject''===
==== <code>icon</code> or <code>image</code> ====
Akan tertulis sebelum kata "article" pada templat (misal "biographical", akan menghasilkan "Tulisan biografi ini adalah sebuah (...)").
If the image is called with an icon template, <code>icon</code> is set to the full syntax of the template; that's the name of the template, plus any arguments (separated with '''|''' ), including the <code>{{</code> and <code>}}</code> around it. Icon can also be used to provide the full image markup (include the opening and closing square brackets), if special image settings such as "border" are to be used. If the image is called explicitly <code>image</code> is the name of the image :- <code>pix</code> will likely be required as well, the default value for <code>pix</code> is 40x30.


<code>imagealt</code> may be used to override the default [[WP:Alternate text for images|alt text]] which is set to "Stub icon".
===''qualifier''===
Akan tertulis setelah kata "article" (contoh "tentang musisi", akan menghasilkan "artikel (...) tentang seorang musisi adalah (...)").


==== <code>pix</code> ====
===''category''===
The size of the image in pixels (no need to append px). Only ''required'' if <code>image</code> is used and this image requires a size different from the default maximum of 40x30 pixels. (Note that in the interests of standardising the formats of stub messages, images of size 40x30 are much preferred.)
Hanya menyebutkan kategori mengenai ke halaman mana templat ini digunakan yang ditambahkan (contoh "Rintisan sejarah").


==== <code>subject</code> and <code>qualifier</code> ====
===''name''===
This <code>subject</code> article <code>qualifier</code> is a stub...
Nama lengkap templat rintisan (hanya digunakan untuk referensi).


Examples:
Penggunaan di atas sudah cukup untuk menerapkan templat rintisan. Sedangkan paramater selanjutnya lebih ke penggunaan tingkat lanjut.


*This '''geography''' article '''about a place in Rohan''' is a stub...
==Full syntax==
*This '''elementary physics''' article is a stub...
<syntaxhighlight lang="wikitext">
*This article '''about Rudolph the Red-nosed reindeer''' is a stub...


==== <code>category</code> ====
{{Asbox
The stub category the articles should go in.
| image = Ambox style.png
| pix =  
| subject =  
| article =  
| qualifier =
| category =  
| tempsort =
| category1 =
| tempsort1 =  
| note =  
| name = {{subst:FULLPAGENAME}}
}}
</syntaxhighlight>


==== <code>tempsort</code> ====
==Parameters==
If exists the stub template (and any other templates) will be put in its own category sorted as " " (space) followed by <code>tempsort</code>, otherwise it will be sorted with the value of " " (space) followed by the template name.
===<code>icon</code> or <code>image</code>===
If the image is called with an icon template, <code>icon</code> is set to the full syntax of the template; that's the name of the template, plus any arguments (separated with '''|''' ), including the <code>{{</code> and <code>}}</code> around it. Icon can also be used to provide the full image markup (include the opening and closing square brackets), if special image settings such as "border" are to be used. If the image is called explicitly <code>image</code> is the name of the image :- <code>pix</code> will likely be required as well, the default value for <code>pix</code> is 40x30.


==== <code>category1</code> ====
<code>imagealt</code> may be used to override the default [[WP:Alternate text for images|alt text]] which is set to "Stub icon".
An optional second stub category the articles should go in.


==== <code>tempsort1</code> ====
===<code>pix</code>===
If exists the stub template (and any other templates) will be put in its own category sorted as " " (space) followed by <code>tempsort1</code>, otherwise it will be sorted with the value of " " (space) followed by the template name.
The size of the image in pixels (no need to append px). Only ''required'' if <code>image</code> is used and this image requires a size different from the default maximum of 40x30 pixels. (Note that in the interests of standardising the formats of stub messages, images of size 40x30 are much preferred.)


==== <code>category2</code> ====
===<code>subject</code> and <code>qualifier</code>===
An optional third stub category the articles should go in.
This <code>subject</code> article <code>qualifier</code> is a stub ...


==== <code>tempsort2</code> ====
Examples:
If exists the stub template (and any other templates) will be put in its own category sorted as " " (space) followed by <code>tempsort2</code>, otherwise it will be sorted with the value of " " (space) followed by the template name.
* This '''geography''' article '''about a place in Rohan''' is a stub ...
* This '''elementary physics''' article is a stub ...
* This  article '''about Rudolph the Red-nosed reindeer''' is a stub ...


==== <code>note</code> ====
===Other parameters===
If exists the value will be added, as a "small" note, to the stub template.
{| class="wikitable"
! scope=col | Parameter
! scope=col | Description
|-
| category  || The [[:Category:Stub categories|stub category]] the articles should go in.
|-
| tempsort  || If exists the stub template [?] (and any other templates) will be put in its own category sorted as "&nbsp;" (space) followed by <code>tempsort</code>, otherwise it will be sorted with the value of "&nbsp;" (space) followed by the template name.
|-
| category1 || An optional second stub category the articles should go in.
|-
| tempsort1 || If exists the stub template [?] (and any other templates) will be put in its own category sorted as "&nbsp;" (space) followed by <code>tempsort1</code>, otherwise it will be sorted with the value of "&nbsp;" (space) followed by the template name.
|-
| category# || {{Red|New}} (Jan 2015): Since the release of [[Module:Asbox|Asbox's module]], this template now supports an unlimited number of categories. Just replace '#' with a number, e.g. {{para|category2|Normal stubs}}, {{para|category99|Over-categorized stubs}}, etc. Traditionally, category2 was the max, so please only use more than 3 if the additional categories are unique, i.e. not sub or parent categories of the others.
|-
| tempsort# || {{Red|New}} (Jan 2015): Similar to the category params, you can have any number of tempsort params.
|-
| note      || If exists the value [?] will be added, as a "small" note, to the stub template.
|-
| name      || The full page name of the template itself.
|-
| demo      || Has no effect in article space. Prevents category output. Set to anything to enable. (Even 'no' or 'false' will enable it!)<br>{{Red|New}} (Jan 2015): If demo is set, it will show pseudo-categories. If {{para|demo|art}} then the pseudo-cats shown will only be those visible in article space (i.e. no error/hidden cats). Set {{para|demo|doc}} to preview the documentation page as well (and all cats). See:&nbsp;[[Template:Asbox/testcases]]
|}


==== <code>name</code> ====
==Examples==
The full page name of the template itself.
===Using <code>image</code>===
 
Based on {{tl|Viken-geo-stub}}:
=== Examples ===
{{demo|br=produces:|demo_kill_categories=yes
==== Using <code>image</code> ====
|<nowiki>{{asbox
Based on {{tl|Østfold-geo-stub}}:
| image    = Viken våpen.svg
<pre><nowiki>
| pix      = 30
{{Asbox
| subject  = [[Viken (county)|Viken]] location  
| image    = Østfold_våpen.svg
| qualifier =
| pix      = 30
| category  = Viken (county) geography stubs
| subject  = [[Østfold]] location
| tempsort  =  
| category  = Østfold geography stubs
| name      = Template:Viken-geo-stub
| tempsort  = *
| name      = Template:Østfold-geo-stub
}}
</nowiki></pre>
appears as:
{{Asbox
| image    = Østfold_våpen.svg
| pix      = 30
| subject  = [[Østfold]] location
| category  = Østfold geography stubs
| tempsort  = *
| name      = Template:Østfold-geo-stub
| demo      = yes
}}
}}
</nowiki>}}


==== Using <code>icon</code> and category1 ====
===Using <code>icon</code> and <code>category1</code>===
Using <code>icon</code> allows more flexibility in some circumstances than <code>image</code> and <code>pix</code>, since it can be used with templates. Based on {{tl|Wales-footy-bio-stub}}:
Using <code>icon</code> allows more flexibility in some circumstances than <code>image</code> and <code>pix</code>, since it can be used with templates. Based on {{tl|Wales-footy-bio-stub}}:
<pre><nowiki>
{{demo|br=produces:|demo_kill_categories=yes
{{asbox
|<nowiki>{{Asbox
| icon      = {{Soccer icon|Wales|50}}
| icon = {{soccer icon|Wales|50}}
| subject  = biographical
| subject = biographical
| qualifier = related to Welsh association football
| qualifier = related to Welsh association football  
| category  = Welsh football biography stubs
| category = Welsh football biography stubs
| tempsort  = *
| tempsort = *  
| name      = Template:Wales-footy-bio-stub
| name = Template:Wales-footy-bio-stub
}}
</nowiki></pre>
appears as:
{{asbox
| icon     = {{Soccer icon|Wales|50}}
| subject   = biographical
| qualifier = related to Welsh association football
| category = Welsh football biography stubs
| tempsort = *  
| name     = Template:Wales-footy-bio-stub
| demo      = yes
}}
}}
</nowiki>}}
==WhatLinksHere==
The page [{{fullurl:Special:WhatLinksHere/Template:Asbox|hideredirs=1&namespace=10&hidelinks=1}} here] should have a complete list of all templates using this template.  This list can be compared with existing list of stub templates to identify new stub templates created out of process. '''The last entries will also be the most recently created items.'''


=== Whatlinkshere ===
==Navbar==
The page [{{fullurl:Special:WhatLinksHere/Template:Asbox|hideredirs=1&namespace=10&hidelinks=1}} here] should have a complete list of all templates using this template. This list can be compared with existing list of stub templates to identify new stub templates created out of process. '''The last entries will also be the most recently created items.'''
This template contains...
<syntaxhighlight lang="wikitext">{{Navbar |{{{name}}} |mini=yes |style=position:absolute;right:15px;font-size:smaller;display:none;}}</syntaxhighlight>
...which allows the specification (with CSS) of the three stub-template links provided (see [[Special:PermaLink/313089738#Navbar|discussion]]). A side effect is that a non-existing talk page of the stub template may appear on [[Special:WantedPages]].


=== Navbar ===
==TemplateData==
This template contains:
{{TemplateData header}}
<nowiki>{{navbar|{{{name}}}|mini=yes|style=position:absolute; right:15px; font-size:smaller; display:none;}}</nowiki>
<templatedata>
allowing a user to specify with css that three links regarding the stub template are shown (see [{{fullurl:w:Template_talk:Asbox|oldid=313089738#Navbar}}]). A side effect is that a non-existing talk page of the stub template may show up on [[Istimewa:WantedPages]].
{
"description": "Standard template used for creating new or updating existing article stub box templates.",
"params": {
"category": {
"label": "Stub category",
"type": "wiki-page-name",
"description": "The category into which this stub template puts pages.",
"required": true
},
"subject": {
"label": "Subject",
"description": "The subject of the stub template's category.",
"suggested": true
},
"qualifier": {
"label": "Qualifier",
"description": "The sub-subject of the stub template's category."
},
"image": {
"label": "Icon image",
"type": "wiki-file-name",
"description": "Image to use as an icon in the template.",
"suggested": true
},
"imagealt": {
"label": "Icon at text",
"description": "Alt text for the icon, especially for screen readers.",
"default": "Stub icon",
"suggested": true
},
"pix": {
"label": "Icon size",
"description": "Size at which to display the icon."
},
"icon": {
"label": "Icon",
"description": "Icon to show in the template.",
"suggested": true
},
"article": {
"label": "Page name",
"description": "Different term instead of 'article' to use in the template."
},
"note": {
"label": "Note",
"description": "A small note about the stub shown underneath the main text."
},
"name": {
"label": "Template name",
"description": "The name of the template.",
"type": "string",
"autovalue": "{{subst:FULLPAGENAME}}"
},
"category1": {
"label": "Secondary stub category",
"type": "wiki-page-name",
"description": "A secondary category into which this stub template puts pages."
},
"category#": {
"label": "Tertiary stub category",
"type": "wiki-page-name",
"description": "A tertiary category into which this stub template puts pages."
},
"tempsort": {
"label": "Stub category sort prefix",
"description": "If set to a value other than 'no', a prefix for sorting pages in the category."
},
"tempsort#": {
"label": "Tertiary stub category sort prefix",
"description": "If set to a value other than 'no', a prefix for sorting pages in the tertiary category."
}
}
}
</templatedata>


=== See also ===
==See also==
* [[Pembicaraan Wikipedia:WikiProject Stub sorting/Archive11#Stub template standardisation]]
* [[Wikipedia talk:WikiProject Stub sorting/Archive11#Stub template standardisation]]


{{Mbox templates see also}}
{{Mbox templates see also}}


 
<includeonly>{{Sandbox other|
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
| <!-- Categories below this line, please; interwikis at Wikidata -->
<!-- PLEASE ADD CATEGORIES BELOW THIS LINE, THANKS. -->
[[Category:Mbox and messagebox templates]]
[[Kategori:Wikipedia metatemplates|{{PAGENAME}}]]
[[Category:Stub message templates| ]]
[[Kategori:Stub message boxes| ]]
 
<!-- PLEASE ADD INTERWIKIS BELOW THIS LINE, THANKS. -->
}}</includeonly>
}}</includeonly>