Difference between revisions of "Template:Quote/doc"
m (71 revisions imported: Export Template:Quote from mediawiki.org) |
|||
(14 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
− | {{For|linking a subject to a collection of | + | {{For|linking a subject to a collection of quotes on [[Wikiquote]]|Template:Wikiquote}} |
== Usage == | == Usage == | ||
Line 26: | Line 26: | ||
;Wikitext: | ;Wikitext: | ||
− | <code><nowiki>{{Quote|text=Cry | + | <code><nowiki>{{Quote|text=Cry "Havoc" and let slip the dogs of war.|sign=[[William Shakespeare]]|source=''[[Julius Caesar (play)|Julius Caesar]]'', act III, scene I}}</nowiki></code> |
;Result: | ;Result: | ||
− | {{Quote|text=Cry | + | {{Quote|text=Cry "Havoc" and let slip the dogs of war.|sign=[[William Shakespeare]]|source=''[[Julius Caesar (play)|Julius Caesar]]'', act III, scene I}} |
=== Restrictions === | === Restrictions === | ||
Line 37: | Line 37: | ||
If any parameter's actual value contains an [[equals sign]] (=), you '''''must''''' use named parameters. (The equals sign gets interpreted as a named parameter otherwise.) | If any parameter's actual value contains an [[equals sign]] (=), you '''''must''''' use named parameters. (The equals sign gets interpreted as a named parameter otherwise.) | ||
− | If any parameter's actual value contains characters used for wiki markup syntax (such as [[vertical bar|pipe]], [[brackets]], single quotation marks, | + | If any parameter's actual value contains characters used for wiki markup syntax (such as [[vertical bar|pipe]], [[brackets]], single quotation marks, etc.), you may need to escape it. See [[Template:!]] and friends. |
Be wary of URLs which contain restricted characters. The equals sign is especially common. | Be wary of URLs which contain restricted characters. The equals sign is especially common. | ||
Line 44: | Line 44: | ||
{{Blockquote paragraphs}} | {{Blockquote paragraphs}} | ||
+ | |||
+ | == TemplateData == | ||
+ | {{TemplateDataHeader}} | ||
+ | <templatedata>{ | ||
+ | "description": "Adds a block quotation.", | ||
+ | "params": { | ||
+ | "text": { | ||
+ | "label": "text", | ||
+ | "description": "The text to quote", | ||
+ | "type": "string", | ||
+ | "required": false, | ||
+ | "aliases": [ "1", "quote" ] | ||
+ | }, | ||
+ | "sign": { | ||
+ | "label": "sign", | ||
+ | "description": "The person who is being quoted", | ||
+ | "type": "string", | ||
+ | "required": false, | ||
+ | "aliases": [ "2", "cite" ] | ||
+ | }, | ||
+ | "source": { | ||
+ | "label": "source", | ||
+ | "description": "A source for the quote", | ||
+ | "type": "string", | ||
+ | "required": false, | ||
+ | "aliases": [ "3" ] | ||
+ | } | ||
+ | } | ||
+ | }</templatedata> | ||
== See also == | == See also == | ||
Line 49: | Line 78: | ||
<includeonly> | <includeonly> | ||
− | |||
<!-- ADD CATEGORIES AFTER THIS LINE --> | <!-- ADD CATEGORIES AFTER THIS LINE --> | ||
− | [[Category:Quotation templates| | + | [[Category:Quotation templates|Quote]] |
− | + | [[Category:Semantic markup templates]] | |
− | |||
[[ar:قالب:اقتباس]] | [[ar:قالب:اقتباس]] | ||
[[as:Template:Quote]] | [[as:Template:Quote]] | ||
Line 97: | Line 124: | ||
[[sl:Predloga:Citatni blok]] | [[sl:Predloga:Citatni blok]] | ||
[[sv:Mall:Citat]] | [[sv:Mall:Citat]] | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
</includeonly> | </includeonly> |
Latest revision as of 21:40, 28 January 2018
{{#ifeq:doc |doc
|
{{#ifeq:show |show
| Template:Mbox }}{{#if: | | {{#ifexist:Template:Quote | [[Category:{{#switch:Template |Template=Template |Module=Module |User=User |#default=Wikipedia}} documentation pages]] | }} }} | }}
Contents
Usage[edit]
{{[[{{#if:|{{{SISTER}}}Template|Template}}:Quote|Quote]]{{#if:||{{{2}}}}}{{#if:||{{{3}}}}}{{#if:||{{{4}}}}}{{#if:||{{{5}}}}}{{#if:||{{{6}}}}}{{#if:||{{{7}}}}}{{#if:||...}}}} adds a block quotation to an article page.
This is easier to type and more wiki-like than the equivalent HTML {{#if:|
|
}}{{#switch:pair
|c|close = |s|single |o|open |p|pair = <blockquote{{#if:| {{{params}}}}}
}}{{#switch:pair
|c|close = |s|single = /> |o|open = > |p|pair = >...
}}{{#switch:pair
|s|single |o|open = |c|close |p|pair = </blockquote>
}}{{#if:|
|
}} tags, and has additional pre-formatted attribution and source parameters.
Note: Block quotes do not normally contain quotation marks. See MOS:QUOTE.
Synopsis[edit]
- Unnamed (positional) parameters
{{quote|phrase|person|source}}
This markup will fail if any parameter contains an equals sign (=).
- Numbered (positional) parameters
{{quote|1=phrase|2=person|3=source}}
- Named parameters
{{quote|text=phrase|sign=person|source=source}}
Example[edit]
- Wikitext
{{Quote|text=Cry "Havoc" and let slip the dogs of war.|sign=[[William Shakespeare]]|source=''[[Julius Caesar (play)|Julius Caesar]]'', act III, scene I}}
- Result
Cry "Havoc" and let slip the dogs of war.{{#if:William Shakespeare | }}
Restrictions[edit]
If you do not provide quoted text, the template generates a parser error message, which will appear in red text in the rendered page.
If any parameter's actual value contains an equals sign (=), you must use named parameters. (The equals sign gets interpreted as a named parameter otherwise.)
If any parameter's actual value contains characters used for wiki markup syntax (such as pipe, brackets, single quotation marks, etc.), you may need to escape it. See Template:! and friends.
Be wary of URLs which contain restricted characters. The equals sign is especially common.
Multiple paragraphs[edit]
The {{#if:|
|
}}{{#switch:o
|c|close = |s|single |o|open |p|pair = <blockquote{{#if:| {{{params}}}}}
}}{{#switch:o
|c|close = |s|single = /> |o|open = > |p|pair = >...
}}{{#switch:o
|s|single |o|open = |c|close |p|pair = </blockquote>
}}{{#if:|
|
}} element and any templates that use it do not honor newlines:
<blockquote> Line 1 Line 2 Line 3 Line 4 </blockquote> |
}}{{#if: | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}} | |
To resolve this, use the {{#switch:pair
|c|close = |s|single |o|open |p|pair = <{{#switch:poem |categorytree=categorytree |charinsert=charinsert |gallery=gallery |hiero=hiero |imagemap=imagemap |inputbox=inputbox |math=math |nowiki=nowiki |poem=poem |pre=pre |ref=ref |references=references |section=section |score=score |source=source |syntaxhighlight=syntaxhighlight |templatedata=templatedata |timeline=timeline |#default=tag
}}{{#if:| {{{params}}}}} }}{{#switch:open
|c|close = |s|single = /> |o|open = > |p|pair = >...
}}{{#switch:open
|s|single |o|open = |c|close |p|pair = </poem>
}} tag inside {{#if:|
|
}}{{#switch:o
|c|close = |s|single |o|open |p|pair = <blockquote{{#if:| {{{params}}}}}
}}{{#switch:o
|c|close = |s|single = /> |o|open = > |p|pair = >...
}}{{#switch:o
|s|single |o|open = |c|close |p|pair = </blockquote>
}}{{#if:|
|
}}:
<blockquote><poem> Line 1 Line 2 Line 3 Line 4 </poem></blockquote> |
<poem> }}{{#if: | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}}{{#if: | | |
}} | |
TemplateData[edit]
Quote
}} <templatedata>{
"description": "Adds a block quotation.", "params": { "text": { "label": "text", "description": "The text to quote", "type": "string", "required": false, "aliases": [ "1", "quote" ] }, "sign": { "label": "sign", "description": "The person who is being quoted", "type": "string", "required": false, "aliases": [ "2", "cite" ] }, "source": { "label": "source", "description": "A source for the quote", "type": "string", "required": false, "aliases": [ "3" ] } }
}</templatedata>
See also[edit]
Similar templates comparison:
- Template:Epigraph – quote without border, page-wide, normal-sized attribution
- Template:Quote – quote without border, page-wide, smaller-sized attribution
- Template:Quotation – quote with border, page-wide
- Template:Quote box – quote with border, in a reduced floating box
- Template:Cquote – pull-quote between graphic quotation marks, page-wide
- Template:Rquote – pull-quote between graphic quotation marks, in a reduced floating area
- Category:Quotation templates – more templates