Difference between revisions of "Template:Db-notice/doc"

From blackwiki
Jump to navigation Jump to search
imported>JJMC89
(should be at the top)
imported>JJMC89
(cleanup TemplateData)
Line 50: Line 50:
 
All of the speedy deletion notification templates that use the Wikipedia tool known as Twinkle are based on this template.  Twinkle will automatically add this message to a user's talk page whenever a page that user has created is nominated for Speedy Deletion. As such, users are unlikely to ever have cause to manually add this template to any page.  The information below is intended for users who are creating their own deletion templates and as reference for those interested in modifying existing templates.",
 
All of the speedy deletion notification templates that use the Wikipedia tool known as Twinkle are based on this template.  Twinkle will automatically add this message to a user's talk page whenever a page that user has created is nominated for Speedy Deletion. As such, users are unlikely to ever have cause to manually add this template to any page.  The information below is intended for users who are creating their own deletion templates and as reference for those interested in modifying existing templates.",
 
"params": {
 
"params": {
−
"first parameter": {
+
"namespace": {
−
"label": "namespace",
+
"label": "Namespace",
 
"description": "The namespace of the article proposed/ nominated for deletion. This should be passed through from the daughter template.",
 
"description": "The namespace of the article proposed/ nominated for deletion. This should be passed through from the daughter template.",
 
"required": false,
 
"required": false,
−
"suggested": false,
+
"example":"File:",
−
                        "example":"File:",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"second parameter": {
+
"target": {
−
"label": "target",
+
"label": "Target",
 
"description": "This is the name of the page targeted for deletion, given without brackets of any kind",
 
"description": "This is the name of the page targeted for deletion, given without brackets of any kind",
 
"required": true,
 
"required": true,
−
"suggested": false,
+
"example": "Ham sandwich with mustard and mayo",
−
                        "example": "Ham sandwich with mustard and mayo",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "wiki-page-name"
 
"type": "wiki-page-name"
 
},
 
},
−
"third parameter": {
+
"nowelcome": {
−
"label": "nowelcome",
+
"label": "No welcome",
 
"description": "This parameter automatically welcomes users with {{first article}} template if their user talk page was previously a red link (i.e., the deletion template is the first edit to the page). If this parameter is set to 'yes', then this welcome is omitted. This should usually be passed through from the daughter template, unless a welcome is never desired (for example for G10 'attack pages').",
 
"description": "This parameter automatically welcomes users with {{first article}} template if their user talk page was previously a red link (i.e., the deletion template is the first edit to the page). If this parameter is set to 'yes', then this welcome is omitted. This should usually be passed through from the daughter template, unless a welcome is never desired (for example for G10 'attack pages').",
−
"required": false,
+
"example": "yes",
−
"suggested": false,
 
−
                        "example": "yes",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "[blank]",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"fourth parameter": {
+
"header": {
−
"label": "header",
+
"label": "Header",
 
"description": "If this is set to 'no', no section heading is generated before the deletion notification. This should be passed through from the daughter template to give deletion template creators control over whether they want to include a section heading or not.  If left blank, a new section heading is generated.",
 
"description": "If this is set to 'no', no section heading is generated before the deletion notification. This should be passed through from the daughter template to give deletion template creators control over whether they want to include a section heading or not.  If left blank, a new section heading is generated.",
−
"required": false,
+
"example": "no",
−
"suggested": false,
 
−
                        "example": "no",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "[blank]",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"fifth parameter": {
+
"header-text": {
−
"label": "header-text",
+
"label": "Header text",
 
"description": "This allows users to specify custom text for the section heading before the deletion notice. This should usually be passed through from the daughter template.",
 
"description": "This allows users to specify custom text for the section heading before the deletion notice. This should usually be passed through from the daughter template.",
−
"required": false,
 
−
"suggested": false,
 
−
                        "example": "",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "",
 
−
"default": "",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"sixth parameter": {
+
"nothanks": {
−
"label": "nothanks",
+
"label": "No thanks",
 
"description": "If the page the notification template is used on was previously a red link, and this parameter contains any text, then the text 'thank you for your contributions' is omitted from the welcome message. This is used when the contributions are assumed not to be useful, such as in templates for vandalism or attack pages.",
 
"description": "If the page the notification template is used on was previously a red link, and this parameter contains any text, then the text 'thank you for your contributions' is omitted from the welcome message. This is used when the contributions are assumed not to be useful, such as in templates for vandalism or attack pages.",
−
"required": false,
+
"example": "yes",
−
"suggested": false,
 
−
                        "example": "yes",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "[blank]",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"seventh parameter": {
+
"icon": {
−
"label": "icon",
+
"label": "Icon",
 
"description": "The filename of the image used in the top-left-hand corner of the notice.  Most deletion notices are information notices (as opposed to warning notices), so the information icon4 is usually chosen.",
 
"description": "The filename of the image used in the top-left-hand corner of the notice.  Most deletion notices are information notices (as opposed to warning notices), so the information icon4 is usually chosen.",
−
"required": false,
+
"example": "Information icon4.svg",
−
"suggested": false,
 
−
                        "example": "Information icon4.svg",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "",
 
 
"type": "wiki-page-name"
 
"type": "wiki-page-name"
 
},
 
},
−
"eighth parameter": {
+
"wizard": {
−
"label": "wizard",
+
"label": "Wizard",
 
"description": "Optionally shows a message box with advice about creating new articles.",
 
"description": "Optionally shows a message box with advice about creating new articles.",
−
"required": false,
+
"example": "yes",
−
"suggested": false,
 
−
                        "example": "yes",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "yes",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"ninth parameter": {
+
"text": {
−
"label": "text",
+
"label": "Text",
 
"description": "The main text of the notice. This does not include the last paragraph, which is included automatically in every notice. Some aspects of the last paragraph can be changed with other parameters, however.",
 
"description": "The main text of the notice. This does not include the last paragraph, which is included automatically in every notice. Some aspects of the last paragraph can be changed with other parameters, however.",
−
"required": false,
 
−
"suggested": false,
 
−
                        "example": "",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"tenth parameter": {
+
"if you think that": {
−
"label": "if you think that",
+
"label": "If you think that",
 
"description": "If this parameter exists, it will replace the text 'the page was nominated in error' with the text it contains.",
 
"description": "If this parameter exists, it will replace the text 'the page was nominated in error' with the text it contains.",
−
"required": false,
+
"default": "this page should not be deleted for this reason",
−
"suggested": false,
 
−
                        "example": "",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"eleventh parameter": {
+
"button": {
−
"label": "button",
+
"label": "Button",
 
"description": "Setting this to 'no' removes the text about clicking on the button labelled 'Click here to contest this speedy deletion' in the speedy deletion tag. Useful if the related speedy deletion template doesn't have such a button.",
 
"description": "Setting this to 'no' removes the text about clicking on the button labelled 'Click here to contest this speedy deletion' in the speedy deletion tag. Useful if the related speedy deletion template doesn't have such a button.",
−
"required": false,
+
"example": "no",
−
"suggested": false,
 
−
                        "example": "no",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"twelfth parameter": {
+
"willprovide": {
−
"label": "willprovide",
+
"label": "Will provide",
 
"description": "By default, the template will include the sentence, 'If the page is deleted, and you wish to retrieve the deleted material for future reference or improvement, you can place a request here.' If willprovide is equal to 'no' then this sentence will be omitted. Template:Db-copyvio-notice, for instance, is set up to not include this sentence.",
 
"description": "By default, the template will include the sentence, 'If the page is deleted, and you wish to retrieve the deleted material for future reference or improvement, you can place a request here.' If willprovide is equal to 'no' then this sentence will be omitted. Template:Db-copyvio-notice, for instance, is set up to not include this sentence.",
−
"required": false,
+
"example": "no",
−
"suggested": false,
 
−
                        "example": "no",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"thirteenth parameter": {
+
"additionally": {
−
"label": "additionally",
+
"label": "Additionally",
 
"description": "This optional text will be appended to the very end of the notice.",
 
"description": "This optional text will be appended to the very end of the notice.",
−
"required": false,
 
−
"suggested": false,
 
−
                        "example": "",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"fourteenth parameter": {
+
"rfudlink": {
−
"label": "rfudlink",
+
"label": "RFUD link",
 
"description": "If this parameter exists, the text prompting the user to go to WP:RFUD won't display. Useful as an alternative to the willprovide parameter if one can contact the deleting administrator to retrieve the article but for some reason can't place a request on that page (such as when the user in question has been blocked from editing Wikipedia). Template:Db-notability-notice, for example, is set up to omit this part of the sentence.",
 
"description": "If this parameter exists, the text prompting the user to go to WP:RFUD won't display. Useful as an alternative to the willprovide parameter if one can contact the deleting administrator to retrieve the article but for some reason can't place a request on that page (such as when the user in question has been blocked from editing Wikipedia). Template:Db-notability-notice, for example, is set up to omit this part of the sentence.",
−
"required": false,
+
"example": "yes",
−
"suggested": false,
 
−
                        "example": "yes",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "[blank]",
 
 
"type": "string"
 
"type": "string"
 
}
 
}

Revision as of 06:02, 28 October 2018

Template:SubstitutedTemplate:Speedy deletion notices

This template is a meta-template used to create speedy deletion notifications. It is typically transcluded into another template.

All of the speedy deletion notification templates that Twinkle uses are based on this template. Twinkle will automatically add this message to a user's talk page whenever a page that user has created is nominated for Speedy Deletion. As such, users are unlikely to ever have cause to manually add this template to any page.

Usage

Basic usage:

{{<includeonly>safesubst:</includeonly>db-notice
|namespace     = {{{namespace|}}}
|target        = {{{1}}}
|nowelcome     = {{{nowelcome|}}}
|header        = {{{header|}}}
|header-text   = {{{header-text|}}}
|text          = 
}}<!-- Template:Db-XX-notice --> <noinclude>
{{documentation}}
</noinclude>

All fields:

{{<includeonly>safesubst:</includeonly>db-notice
|namespace         = {{{namespace|}}}
|target            = {{{1}}}
|nowelcome         = {{{nowelcome|}}}
|header            = {{{header|}}}
|header-text       = {{{header-text|}}}
|nothanks          = 
|icon              = 
|wizard            = 
|text              = 
|if you think that = 
|button            = 
|willprovide       = 
|additionally      = 
}}<!-- Template:Db-XX-notice --> <noinclude>
{{documentation}}
</noinclude>

The template should usually be used with safesubst, so that the template can be both transcluded and substituted. In most cases templates made with this meta-template will be substituted on user talk pages, but sometimes transclusion is necessary, for example when creating template documentation.

Syntax error in JSON.

See also