查看“︁Module:Flatten/doc”︁的源代码

__TOC__
此模块用于把多行wikitext压缩至一行。

== 用途 ==
此模块最初是为了{{tl|Hid}}编写的。由于MediaWiki的wikitext解析器存在问题，导致把多行wikitext放在列表（<code>*#</code>）缩进（<code>:;</code>）上时会出现错误的结果。

一个著名的例子就是{{tl|Hide}}不能与列表和缩进联用（参见[[Special:滥用过滤器/30]]）：
{{Example
|pre = <nowiki>
* {{Hide}}
* 文本
文本
</nowiki>
}}

由于{{tl|Hide}}展开后是多行wikitext，与列表或缩进连用会导致后续内容全部缩进。而此模块能够预先把多行wikitext压缩至一行，从而避免该问题。
{{Example
|pre = <nowiki>
* {{#invoke:Flatten|main| {{Hide}} }}
* 文本
文本
</nowiki>
}}

此模块同样适用于面临相同困扰的其他模板，例如{{tl|VersionHistory}}、{{tl|Clade}}等。

== 技术细节 ==
{{jk|{{see also|敌我同源}}}}
此模块用Lua部分重写了MediaWiki内置的wikitext解析器，能够事先将表格、列表以及段落解析为HTML，再将它们压缩至一行。

然而，此模块尚未经过相对充分的测试，其解析结果可能会与预期存在一定的差别。

=== 关于[[Special:版本#mw-version-parser-extensiontags|解析器扩展标签]] ===
<!-- lint-disable-next-line -->
MediaWiki原生的解析器标签（如<code><nowiki><ref></nowiki></code>）和各种扩展带来的扩展标签（如<code><nowiki><poem></nowiki></code>）在传入模块时会被替换为[[mw:Strip_marker|条状标记]]，这使得模块无法得知标签内部有什么内容。因此，此模块无法将这些标签压缩为一行。但这'''不'''包括<code><nowiki<nowiki/>></code>，因为Scribunto唯独提供了展开此条状标记的方法。<ref>实际上，低版本的Scribunto可以展开任何条状标记，但高版本移除了这一功能。</ref>

不过，由于<code><nowiki><poem></nowiki></code>使用较频繁且原理简单，此模块实现了<code><nowiki><poem></nowiki></code>的部分效果，可以利用<code>[poem]</code>标签来替代：
{{Example
|pre = <nowiki>
{{#tag:pre|{{#invoke:Flatten|main|1=
[poem style="color:red;"]
第一行文本
第二行文本
[/poem]
}}}}
</nowiki>
}}

目前，本模块检测<code><nowiki><categorytree></nowiki></code>、<code><nowiki><choose></nowiki></code>、<code><nowiki><dynamicpagelist></nowiki></code>、<code><nowiki><gallery></nowiki></code>、<code><nowiki><poem></nowiki></code>、<code>&lt;poll&gt;</code>这六个标签，若存在相关的条状标记则会报错。

== 注释 ==
<references/>