テンプレート:Markup/docのソースを表示

{{Documentation subpage}}
<!-- カテゴリは最下部へ -->
このテンプレートは、マークアップやコードの横に並べて、描画されたその出力結果を示します。

== 引数 ==
* '''title''': タイトルを表示します。
* '''t1''':「マークアップ」の文字列を置き換えます。
* '''t2''':「描画」の文字列を置き換えます。
* '''pre''':「pre」タグの有無を設定します。
* '''Style''': CSSを指定します。
* '''Noheaders''': {{para|noheaders|on}}でカラムの見出しとタイトルを表示しません。

引数は[[:en:Template:Markup]]を参照。

== 使い方 ==

最初のカラム（「マークアップ」）における各々のセルは、{{tag|pre|o}}が使われ、改行と空白をそのままにします。ただし、その内容によっては変化します。そのマークアップは、{{xtag|nowiki}}内でそのマークアップを囲うことによって表示されるように、通常はそれらのセルの内容がエスケープされるのが望ましいでしょう。この機能の追加は技術的に不可能です。

2番目のカラム（「描画」）における各々のセルは、対応した「マークアップ」のセルに一致する、通常はエスケープされていないマークアップです。これは異なる場合があり、例を以下に示します。
* もし最初の行が、#, * などのようなウィキマークアップを含んでいるなら、最初の行の前に{{tag|nowiki|s}}を使います。例を参照。
* {{code|1===}} のような見出しマークアップは、そのページの目次として表示されます。代わりに{{tlx|fake heading}}を使用します。
* 一部のテンプレートは、不要に整備用カテゴリに分類するでしょう。
** {{tlx|要出典}}の代わりに、{{tlx|Fake}}を使います。
* 一部のテンプレートは、整備用カテゴリにそのページが分類されているかのエラーチェックをするでしょう。そのようなカテゴリはできるだけ抑制してください。
** {{cs1}} テンプレートは{{para|template doc demo|true}}の設定によって整備用カテゴリを抑制します。

=== 制限 ===

==== {{xtag|nowiki}} ====
もし、マークアップ・セルの内容を{{xtag|nowiki}}にて囲まないなら、テンプレートのマークアップもエスケープされず、展開されます。

<nowiki>{{tl|tag}}</nowiki>のためのマークアップの例を挙げます。
{{Markup
|t1=展開されてしまいます |t2=nowiki使用
| {{tl|tag}} | <nowiki>{{tl|tag}}</nowiki>
}}

==== HTML実体 ====
nowiki中のマークアップ・セル中のHTML実体は解析されます。

{{Markup
|t1=nowikiを使ったマークアップ |t2=マークアップを回避する以下置換記法の使用
| <nowiki>&nbsp;&ndash;</nowiki> | &amp;nbsp;&amp;ndash;
}}

これを避けるには、<code>&</code> を <code>&amp;amp;</code>に置き換えてエスケープすることで、<code>&amp;amp;nbsp;</code> とします。これは <code>&amp;nbsp;</code> と表示されます。

==== リストと字下げマークアップ ====
もし最初の行が、#, * などのようなウィキマークアップを含んでいるなら、{{tag|nowiki|s}}を使います。

{{Markup |title={{tag|nowiki|s}}なし
| <nowiki># Item 1
# Item 2
# Item 3
# Item 4</nowiki>
|
# Item 1
# Item 2
# Item 3
# Item 4
}}

{{Markup |title={{tag|nowiki|s}}使用
| &lt;nowiki />
<nowiki># Item 1
# Item 2
# Item 3
# Item 4</nowiki>
| <nowiki />
# Item 1
# Item 2
# Item 3
# Item 4
}}

===例===

==== 簡単なもの ====
{{Markup
| <nowiki>'''ボールド体の言葉'''</nowiki> | '''ボールド体の言葉'''
| <nowiki>''イタリック体の言葉''</nowiki> | ''イタリック体の言葉''
}}

==== より複雑なもの ====
以下のような例の2番目のカラムでは {{tl2|fake heading}} と {{tl2|fake citation needed}}を使うことでカテゴリに分類されてしまうのを避けます。

{{Markup
| <nowiki>寿命を100年延ばす効果があったといいます{{#tag:ref|控えめな説によると5年ほど。<ref>『未開の秘術』</ref>|group=nb}}。飛ぶように売れました{{要出典}}。

== 注釈 ==
{{reflist|group=nb}}

== 出典 ==
{{reflist}}
</nowiki>
| 寿命を100年延ばす効果があったといいます{{#tag:ref|控えめな説によると5年ほど。<ref>『未開の秘術』</ref>|group=注釈}}。飛ぶように売れました{{fake}}。

{{fake heading|sub=2|注釈}}
{{reflist|group=注釈}}

{{fake heading|sub=2|出典}}
{{reflist|close}}
}}

==== 複数のペア ====
{{Markup
| 山から尼が4人踊りながら歩いてきたというのです。| 山から尼が4人踊りながら歩いてきたというのです。
| 山から尼が4人踊りながら歩いてきたというのです。| 山から尼が4人踊りながら歩いてきたというのです。
| 山から尼が4人踊りながら歩いてきたというのです。| 山から尼が4人踊りながら歩いてきたというのです。
| 山から尼が4人踊りながら歩いてきたというのです。| 山から尼が4人踊りながら歩いてきたというのです。
}}

==== 題名をつける ====
{{para|title}}を使います。

{{Markup |title=Foxes and dogs
| The quick brown fox jumps over the lazy dog. | The quick brown fox jumps over the lazy dog.
}}

==== 描画されたHTMLを表示する ====
あるテンプレートが {{tl|code}} に囲まれた場合、描画されたHTMLを表示します。

{{Markup
 | <nowiki>{{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}</nowiki>
 | {{cite book |last=White |first=T. H. |title=The Book of Merlyn |year=1977}}

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

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"1": {
			"label": "マークアップ1",
			"type": "string",
			"required": true
		},
		"2": {
			"label": "描画結果1",
			"type": "string",
			"required": true
		},
		"3": {},
		"4": {},
		"5": {},
		"6": {},
		"7": {},
		"8": {},
		"9": {},
		"10": {},
		"11": {},
		"12": {},
		"13": {},
		"14": {},
		"15": {},
		"16": {},
		"17": {},
		"18": {},
		"19": {},
		"20": {},
		"21": {},
		"22": {},
		"23": {},
		"24": {},
		"25": {},
		"26": {},
		"27": {},
		"28": {},
		"29": {},
		"30": {},
		"31": {},
		"32": {},
		"33": {},
		"34": {},
		"35": {},
		"36": {},
		"37": {},
		"38": {},
		"39": {},
		"40": {},
		"width": {},
		"margin-left": {},
		"margin": {},
		"style": {},
		"title": {
			"label": "題名",
			"type": "line",
			"suggested": true
		},
		"noheaders": {},
		"notitle": {},
		"colheaderstyle": {},
		"col1headerstyle": {},
		"col1": {},
		"t1": {
			"label": "左列名",
			"type": "line",
			"default": "マークアップ",
			"suggested": true
		},
		"col2headerstyle": {},
		"col2": {},
		"t2": {
			"label": "右列名",
			"type": "line",
			"default": "描画",
			"suggested": true
		},
		"col1style": {},
		"codestyle": {},
		"markupstyle": {},
		"col2style": {},
		"outputstyle": {},
		"pre": {}
	},
	"description": "マークアップのコードを例示するためのテンプレート",
	"format": "block",
	"paramOrder": [
		"title",
		"t1",
		"t2",
		"1",
		"2",
		"3",
		"4",
		"5",
		"6",
		"7",
		"8",
		"9",
		"10",
		"11",
		"12",
		"13",
		"14",
		"15",
		"16",
		"17",
		"18",
		"19",
		"20",
		"21",
		"22",
		"23",
		"24",
		"25",
		"26",
		"27",
		"28",
		"29",
		"30",
		"31",
		"32",
		"33",
		"34",
		"35",
		"36",
		"37",
		"38",
		"39",
		"40",
		"width",
		"margin-left",
		"margin",
		"style",
		"noheaders",
		"notitle",
		"colheaderstyle",
		"col1headerstyle",
		"col1",
		"col2headerstyle",
		"col2",
		"col1style",
		"codestyle",
		"markupstyle",
		"col2style",
		"outputstyle",
		"pre"
	]
}
</templatedata>

== 関連項目 ==
* {{tl|Markup2}} 点と字下げによってマークアップを示す。
* {{tl|Markupv}} 縦に並べてマークアップ/コードとその出力結果を提示します。
* {{tl|Automarkup}} コードを2度づつ書く必要がありません。

<includeonly>{{Sandbox other||
<!-- カテゴリはここへ -->
[[Category:入力支援テンプレート]]
}}</includeonly>