Перейти к содержанию

Ашаблон:Markup/doc

Аматериал Авикипедиа аҟынтә - зхы иақәиҭу аенциклопедиа


This template is used to present markup or code side by side with the output it renders.

Each pair of {{Markup}}'s arguments should be two copies of some wikitext markup, with the first of the pair enclosed in Ашаблон:Xtag tags. The template produces output in two columns, the first showing the markup and the second showing how it is rendered. The template accepts up to 40 unnamed parameters, resulting in up to 20 rows of examples.

This:

{{markup|<nowiki>'''Bold text'''</nowiki>|'''Bold text'''}}

Produces this:

Markup Renders as
'''Bold text'''

Bold text

In many cases, the markup for both columns are identical, but there are instances where this may need to differ. If none of these issues apply, then you may use {{mra}} to save yourself from copying the code twice.

  • Header markup such as == will show in the page table of contents; to avoid this, use {{fake heading}} in the markup for the second column (see example below).
  • Some templates will place the page in a maintenance category, which is usually undesired. For example.
  • Some templates may have error checking that places the page in a maintenance category.
    • Citation Style 1 templates with errors: add |template doc demo=true to the template in the second column.
    • To avoid this and the associated red error messages make sure that each example on the page uses different sources.
  • HTML entities are parsed in the first cell, even with Ашаблон:Xtag tags. To work around this, replace the & with &amp; in the first column (see example below).

It is advisable to begin both copies of the markup with a newline; this is necessary if the first line of the markup must start on a new line (such as #, * or ;).

Markup Renders as
'''Bold text'''

Bold text

''Italic text''

Italic text

[[Internal link]]
{{cite book|ref=none|last=Smith|year=2021|title=Smith's book}}

Smith (2021). Smith's book.

<score>\relative c' { c( b~ c b c b c b c~ c)}</score>
\relative c' { c( b~ c b c b c b c~ c)}

With custom title and column headers

[акод аредакциазура]
How to write about foxes and dogs in Wikipedia.
Write this in wikitext and this will appear in the article.
The quick brown [[fox]] jumps over the lazy [[dog]].

The quick brown fox jumps over the lazy dog.

In this example, {{Markup}}'s second argument here uses {{fake heading}} (to avoid headings appearing in the table of contents) and {{fake citation needed}} (to avoid adding this page to the maintenance list).

Markup Renders as
The quick brown fox jumps over the lazy dog.{{#tag:ref|A footnote.<ref>A reference for the footnote.</ref>|group=nb}} The cow jumped over the moon.{{fact}}

== Notes ==
{{reflist|group=nb}}

== References ==
{{reflist}}

The quick brown fox jumps over the lazy dog.[nb 1] The cow jumped over the moon.Ашаблон:Fake citation needed

Ашаблон:Fake heading

  1. A footnote.[1]

Ашаблон:Fake heading

  1. A reference for the footnote.

HTML entities are parsed in the markup cell. To work around this, replace the & with &amp; in the first column.

Markup Renders as
&ndash;

Markup Renders as
{{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}

White, T. H. (1977). The Book of Merlyn.

{{code|lang=html|{{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}}}

'"`UNIQ--templatestyles-00000030-QINU`"'<cite id="CITEREFWhite1977" class="citation book cs1">White, T. H. (1977). ''The Book of Merlyn''.</cite><span title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=book&rft.btitle=The+Book+of+Merlyn&rft.date=1977&rft.aulast=White&rft.aufirst=T.+H.&rfr_id=info%3Asid%2Fab.wikipedia.org%3A%D0%90%D1%88%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%3AMarkup%2Fdoc" class="Z3988"></span>

Typing aid: template {{mra}}

[акод аредакциазура]

{{mra}} will duplicate the source text automatically, saving you the trouble of copying the text and adding Ашаблон:Xtag tags to the first case.

This:

{{subst:mra|'''Bold text'''|''Italic text''}}

Will produce this:

{{markup|
<nowiki>'''Bold text'''</nowiki>|'''Bold text'''|
<nowiki>''Italic text''</nowiki>|''Italic text''}}

Which renders as:

Markup Renders as
'''Bold text'''

Bold text

''Italic text''

Italic text

  • {{Markup2}} for bulleted and indented markup.
  • {{Markupv}} for the vertical presentation (above/below) of markup/code and its output.
  • {{Automarkup}} does not require to write the code samples twice.
Здесь приведена документация в формате TemplateData для данного шаблона, которая используется в визуальном редакторе и прочих инструментах.

Документация TemplateData для шаблона: Markup

Параметры шаблона

ПараметрОписаниеТипСтатус
margin-leftmargin-left

To set a margin on the table's lefthand side.

По умолчанию
0
Строковый (без форматирования)необязательный
widthwidth

To set the table's overall width.

По умолчанию
auto
Строковый (без форматирования)необязательный
stylestyle

For CSS styles amending the table's overall appearance.

Строковый (без форматирования)необязательный
noheadersnoheaders

Set (as e.g. noheaders=on) to suppress the columns' headings and table's title.

Строковый (без форматирования)необязательный
titletitle

Title above table.

Строковый (без форматирования)необязательный
colheaderstylecolheaderstyle

For CSS styling to amend the appearance of each column's heading.

Строковый (без форматирования)необязательный
col1headerstylecol1headerstyle

For CSS styling to amend the appearance of the first column's heading. Overrides (but does not replace) colheaderstyle.

Строковый (без форматирования)необязательный
col1col1

First column (markup/code)'s heading.

По умолчанию
"Markup"
Строковый (без форматирования)необязательный
col2headerstylecol2headerstyle

For CSS styling to amend the appearance of the second column's heading. Overrides (but does not replace) colheaderstyle.

Строковый (без форматирования)необязательный
col2col2

Second column (output)'s heading.

По умолчанию
"Renders as"
Строковый (без форматирования)необязательный
Column 1 stylecodestyle markupstyle

Use CSS style code to change the look of content in the Markup column.

Пример
white-space: nowrap
Строковый (без форматирования)необязательный
Column 2 styleoutputstyle

Use CSS style code to change the look of content in the Renders-as column.

Строковый (без форматирования)необязательный
11

row 1, first column (markup/code)'s content.

Строковый (без форматирования)необязательный
22

row 1, second column (output)'s content.

Строковый (без форматирования)необязательный
33

row 2, first column's content (etc).

Строковый (без форматирования)необязательный
44

row 2, second column's content (etc).

Строковый (без форматирования)необязательный
3939

First column's content in last possible row.

Строковый (без форматирования)необязательный
4040

Second column's content in last possible row.

Строковый (без форматирования)необязательный