查看“︁帮助:转置扩展”︁的源代码

{{帮助头部}}
{{帮助页面导航}}
'''转置扩展'''是一个提供将多个数列转置显示功能的Mediawiki插件。

== 安装 ==
# 你需要最新版本（1.5.0）的<code>MultiArrayMap.zip</code>。
# 解压到<code>extensions</code>目录下。
# 在<code>LocalSettings.php</code>末尾加上<code>require_once( "$IP/extensions/MultiArrayMap/MultiArrayMap.php" );</code>。
# 安装完成。

== 配置 ==
此扩展的配置变量及说明（英文）均可以在<code>MultiArrayMap/MultiArrayMap.settings.php</code>中找到，以下是中文说明：
* '''$wgMultiArrayMapCountLimit'''，设定函数#countmap和#counttem可以生成的最大结果数，超出时将会直接输出直至超出前的结果，默认为100。

== 调用函数 ==
'''arraymap'''和'''arraymaptemplate'''函数原本出自[https://www.mediawiki.org/wiki/Extension:Page_Forms Extension:Page Forms]，是一个辅助'''表单编辑器'''的函数。不过本Wiki实在用不着'''表单编辑器'''，那表单编辑器效果也没有目前我们使用的'''输入提示'''好用。虽然表单没用，但附带的函数十分好用，基于“不用的扩展就不要留着拖慢系统”的原则，我就把这两个函数从Page Forms移植到Multi Array Map之中了。
=== arraymap ===
把输入字串以分隔符切开后逐个代入格式字串中求值，最后用输出分隔符串合输出。分隔符开头或结尾是空格时必须用nowiki包裹，输出分隔符也是如此，亦可以用\n表示换行。格式字串中可以随便使用模板和函数而不需要使用nowiki，所有运算都会在代入之后发生，只有使用管道符“{{!}}”的时候才必须使用“<nowiki>{{!}}</nowiki>”（花括号同理）。如需处理二维阵列请用[[#multimap]]。
;格式:<code><nowiki>{{#arraymap: 字串 | 分隔符（默认为“,”） | 代号 | 格式字串 | 输出分隔符（默认为“, ”，注意有空格） }}</nowiki></code>
;例子:
:<code><nowiki>{{#arraymap:花妈 紫妹妹 八意大妈 八坂老太 二妹 | &lt;nowiki&gt; &lt;/nowiki&gt; | @ | {{color:red|@}} | ， }}</nowiki></code> → <code>{{#arraymap:花妈 紫妹妹 八意大妈 八坂老太 二妹 | <nowiki> </nowiki> | @ | {{color:red|@}} | ， }}</code>

=== arraymaptemplate ===
[[#arraymap|arraymap]]的模板变体，切开后会输入模板再以分隔符串合输出。如需处理二维阵列请用[[#multitem]]。
;格式:<code><nowiki>{{#arraymaptemplate: 字串 | 模板名 | 分隔符（默认为“,”） | 输出分隔符（默认为“, ”，注意有空格） }}</nowiki></code>
;例子:
:<code><nowiki>{{#arraymaptemplate: Comic Market#88，Comic Market#89，Comic Market#90，Comic Market#91 | 展会作品列表链接 |，|，}}</nowiki></code> → <code>{{#arraymaptemplate: Comic Market#88，Comic Market#89，Comic Market#90，Comic Market#91 | 展会作品列表链接 |，|，}}</code>

=== multimap ===
把输入的多个字串以对应的分隔符切开后组合成一个二维阵列，转置后以对应的代号代入格式字串中求值，最后用输出分隔符串合输出。注意字串、分隔符和代号必须一组一组整齐地定义，即使是空字串。此函数比较高消耗，情况许可的话请尽量使用[[#multitem|multitem]]。阵列列数以第一行的数量为准，如果之后的行列数不足，则会自动以行内最后一个值补全，多出则无条件消去。分隔符开头或结尾是空格时必须用nowiki包裹，对输出分隔符也有效，空分隔符则表示逐字分开，亦可以用\n表示换行。如需只是处理一维阵列请用[[#arraymap]]。
;格式:<code><nowiki>{{#multimap: 空 | 格式字串 | 输出分隔符 | 字串1 | 字串1分隔符 | 字串1代号 | 字串2 | 字串2分隔符 | 字串2代号 | ... | 字串n | 字串n分隔符 | 字串n代号 }}</nowiki></code>
;例子:
<pre>{{#multimap:|on. @×m={{#expr:@*m}}
|<br />
|1，2，3，4|，|@ 
|10, 20, 30
|&lt;nowiki&gt;, &lt;/nowiki&gt;|m
|5678|
|n
|q
w
e
r|\n
|o
}}</pre>
;输出:{{#multimap:|on. @×m={{#expr:@*m}}|<br />
|1，2，3，4|，|@
|10, 20, 30|<nowiki>, </nowiki>|m
|5678|
|n
|q
w
e
r|\n
|o
}}

=== multitem ===
[[#multimap|multimap]]的模板变体，转置后会输入模板再以分隔符串合输出。如需只是处理一维阵列请用[[#arraymaptemplate]]。
;格式:<code><nowiki>{{#multitem: 模板名 | 自定义参数 | 输出分隔符 | 选项 | 字串1 | 字串1分隔符 | 字串1参数名 | 字串2 | 字串2分隔符 | 字串2参数名 | ... | 字串n | 字串n分隔符 | 字串n参数名 }}</nowiki></code>
;例子:
<pre>{{#multitem:{{!}}|n=x|&lt;br /&gt;|f0
|1，2，3|，|1
|10,20,30,40|,|2
}}</pre>
;输出:{{#multitem:{{!}}|n=x|<br />|f0
|1，2，3|，|1
|10,20,30,40|,|2
}}

=== countmap ===
变相的for loop，能更直接地运算并输出结果，生成的最大结果数由'''$wgMultiArrayMapCountLimit'''限制。
;格式:<code><nowiki>{{#countmap: 代号 | 格式字串 | 输出分隔符 | 起始值（默认为1） | 最终值（默认为1） | 增加值（默认为1） }}</nowiki></code>
;例子:
:<code><nowiki>{{#countmap:@|{{#expr:@*@}}|,|1|10}}</nowiki></code> → <code>{{#countmap:@|{{#expr:@*@}}|,|1|10}}</code>

=== counttem ===
[[#countmap|countmap]]的模板变体。
;格式:<code><nowiki>{{#counttem: 模板名 | 参数名 | 自定义参数 | 输出分隔符 | 起始值 | 最终值 | 增加值 }}</nowiki></code>
注意参数名均不能为空。
;输入:
:<pre>{{#counttem:{{!}}|1|#=1|&lt;br /&gt;|5|-5|-2}}</pre>
;输出:
{{#counttem:{{!}}|1|#=1|<br />|5|-5|-2}}

=== multisub ===
[[#multimap|multimap]]的子对象（Subobject）变体，转置后会输入SMW的Subobject函数。
;格式:<code><nowiki>{{#multisub: 子对象名称格式 | 序号代号 | 自定义属性 | 字串1 | 字串1分隔符 | 字串1属性名 | 字串2 | 字串2分隔符 | 字串2属性名 | ... | 字串n | 字串n分隔符 | 字串n属性名 }}</nowiki></code>
;输入:
<pre>{{#multisub:名称@{{!}}编号=@|@|固定属性=1
|1，2，3|，|属性名1
|10, 20, 30|&lt;nowiki&gt;, &lt;/nowiki&gt;|属性名2
}}</pre>
;输出:
<pre>与
{{#subobject:名称1|编号=1|属性名1=1|属性名2=10|固定属性=1}}
{{#subobject:名称2|编号=2|属性名1=2|属性名2=20|固定属性=1}}
{{#subobject:名称3|编号=2|属性名1=3|属性名2=30|固定属性=1}}
等效</pre>

=== stringunique ===
去掉一字串按特定分隔符分割后重复的段落。
;格式:<code><nowiki>{{#stringunique: 字串 | 分隔符（默认为回车） }}</nowiki></code>
;例子:
:<code><nowiki>{{#stringunique:1,1,2,3,4,5,9,9,2|,}}</nowiki></code> → <code>{{#stringunique:1,1,2,3,4,5,9,9,2|,}}</code>
:<code><nowiki>{{#stringunique:1 1 2 3 4 5 9 9 2|&lt;nowiki&gt; &lt;/nowiki&gt;}}</nowiki></code> → <code>{{#stringunique:1 1 2 3 4 5 9 9 2|<nowiki> </nowiki>}}</code>

=== redirect ===
获取文字标题经过重定向后的最终目标标题字串。可以通过使用分隔符参数同时输入多个标题，运算后会使用输出分隔符串合输出。分隔符开头或结尾是空格时必须用nowiki包裹，输出分隔符也是如此，亦可以用\n表示换行。
;格式:<code><nowiki>{{#redirect: 标题字串 | 分隔符（默认为空，即不分割） | 输出分隔符（默认为“|”） }}</nowiki></code>
;例子:
:<code><nowiki>{{#redirect: 红魔乡，妖妖梦，地灵殿，神灵庙|，|、}}</nowiki></code> → <code>{{#redirect: 红魔乡，妖妖梦，地灵殿，神灵庙|，|、}}</code>
:<code><nowiki>{{#redirect: cm88，例9|，|、}}</nowiki></code> → <code>{{#redirect: cm88，例9|，|、}}</code>

=== color ===
生成有颜色的文字，只能用于单行文字。颜色可以是HTML颜色名、#RRGGBB、rgba(rrr,ggg,bbb,a)等CSS能识别的字串。
;格式:<code><nowiki>{{color: 颜色 | 文字 }}</nowiki></code>
;例子:
:<code><nowiki>{{color: red | 红色文字 }}</nowiki></code> → <code>{{color: red | 红色文字 }}</code>
:<code><nowiki>{{color: #FFFF00 | 黄色文字 }}</nowiki></code> → <code>{{color: #FFFF00 | 黄色文字 }}</code>

=== nowrap ===
让浏览器不会在指定的文字内换行。
;格式:<code><nowiki>{{nowrap: 文字 }}</nowiki></code>
;例子:
:<code><nowiki>{{nowrap: 3.141592653589 7932384626 4338327950288 4197169399375 1058209749445 9230781640628 620899862803482 53421170679821480 8651328230664709384 46095505822317253594 0812848111745 02841027019385 }}</nowiki></code> → <code>{{nowrap: 3.141592653589 7932384626 4338327950288 4197169399375 1058209749445 9230781640628 620899862803482 53421170679821480 8651328230664709384 46095505822317253594 0812848111745 02841027019385 }}</code>
:<code><nowiki>只会在这里换行， 或是切开两段{{nowrap: 而不会在这里换行，即便有 空格和,逗号 }}后面跟随的文字</nowiki></code> → <code>只会在 这里 换行，或是切开 两段{{nowrap: 而不 会在这里 换行，即便有 空格和,逗号 }}后面跟 随的文字</code>

=== trimall ===
去掉字串里多余的分隔符。
;格式:<code><nowiki>{{#trimall: 字串 | 分隔符（默认为空格） }}</nowiki></code>
;例子:
:<code><nowiki>{{#trimall:,,1,3,,5,7,1,32,,|,}}</nowiki></code> → <code>{{#trimall:,,1,3,,5,7,1,32,,|,}}</code>
:<code><nowiki>{{#trimall:3,5,,7 ,, ,,1|,}}</nowiki></code> → <code>{{#trimall:3,5,,7 ,, ,,1|,}}</code>

=== collapsenum ===
使用“至分隔符”缩短数字列表，例如把“1,2,3,4,5”缩短成“1-5”，或者把“1,2,3,4-10”缩短成“1-10”。是[[#expandnum|expandnum]]的反向操作。
;格式:<code><nowiki>{{#collapsenum: 字串 | 及分隔符（默认为“,”） | 至分隔符（默认为“-”） }}</nowiki></code>
;例子:
:<code><nowiki>{{#collapsenum:1,2,3,7,65,67-78,45}}</nowiki></code> → <code>{{#collapsenum:1,2,3,7,65,67-78,45}}</code>
:<code><nowiki>{{#collapsenum:1及2及3及7及65及67至78|及|至}}</nowiki></code> → <code>{{#collapsenum:1及2及3及7及65及67至78|及|至}}</code>

=== expandnum ===
分析各种分隔符展开数字列表，例如把“1-5”展开成“1,2,3,4,5”，或者把“1,2,3,4-10”缩短成“1,2,3,4,5,6,7,8,9,10”。是[[#collapsenum|collapsenum]]的反向操作。
;格式:<code><nowiki>{{#expandnum: 字串 | 及分隔符（默认为“,”） | 至分隔符（默认为“-”） }}</nowiki></code>
;例子:
:<code><nowiki>{{#expandnum:1-3,7,65,67-78,45}}</nowiki></code> → <code>{{#expandnum:1,2,3,7,65,67-78,45}}</code>
:<code><nowiki>{{#expandnum:1 to 3 and 7 and 65 and 67 to 78|&lt;nowiki&gt; and &lt;/nowiki&gt;|&lt;nowiki&gt; to &lt;/nowiki&gt;}}</nowiki></code> → <code>{{#expandnum:1 to 3 and 7 and 65 and 67 to 78|<nowiki> and </nowiki>|<nowiki> to </nowiki>}}</code>

=== hiragana ===
把日文字串转换成假名。汉字转假名的功能纯粹是小量智能加查字典，平均只能达到80%准确度。
;格式:<code><nowiki>{{#hiragana: 字串 }}</nowiki></code>
;例子:
{| class="wikitable"
|-
! 原文 !! 假名
|-
| 嫌われ者ばかりの旧地獄の中でも、群を抜いて嫌われている分類に入る妖怪、サトリである。人間や妖怪からも仲良くやっていける気がせず旧地獄に逃げ込んだが、結局、旧地獄の妖怪からも嫌われている。
|| {{#hiragana:嫌われ者ばかりの旧地獄の中でも、群を抜いて嫌われている分類に入る妖怪、サトリである。人間や妖怪からも仲良くやっていける気がせず旧地獄に逃げ込んだが、結局、旧地獄の妖怪からも嫌われている。}}
|-
| その理由は、彼女の心を読むという能力にある。誰だって心を読まれる相手と会いたくは無いだろう。心を読める事は丸裸で話し合う、という事では無い。会話がまるで出来なくなるということを意味する。彼女は旧地獄にあるという地霊殿に引き籠もり、完全に他人のコミュニケーションを放棄している。
|| {{#hiragana:その理由は、彼女の心を読むという能力にある。誰だって心を読まれる相手と会いたくは無いだろう。心を読める事は丸裸で話し合う、という事では無い。会話がまるで出来なくなるということを意味する。彼女は旧地獄にあるという地霊殿に引き籠もり、完全に他人のコミュニケーションを放棄している。}}
|-
| 地霊殿には来客は無い。わざわざ彼女を訪れる者は無いという。<br />　　しかし言葉を持たない動物には好かれている。心が読めるというのは、動物にとっては唯一無二の能力だからだ。その為、地霊殿には数多くの動物が棲んでいるという（＊１）。
|| {{#hiragana:地霊殿には来客は無い。わざわざ彼女を訪れる者は無いという。<br />　　しかし言葉を持たない動物には好かれている。心が読めるというのは、動物にとっては唯一無二の能力だからだ。その為、地霊殿には数多くの動物が棲んでいるという（＊１）。}}
|-
| 彼女は言葉を持たない霊魂の心も読める。それが理由で怨霊からも避けられている。怨霊は動物と違い、自分の思っている事を会話で伝えたいと欲しているのだ。その理由は言うまでもなく「言葉を用いる生き物は全て裏表がある」からだ。
|| {{#hiragana:彼女は言葉を持たない霊魂の心も読める。それが理由で怨霊からも避けられている。怨霊は動物と違い、自分の思っている事を会話で伝えたいと欲しているのだ。その理由は言うまでもなく「言葉を用いる生き物は全て裏表がある」からだ。}}
|-
| 怨霊に怖れられる事を有効利用し、彼女は灼熱地獄跡に残った怨霊を管理している。隠し事が出来ない彼女に逆らうものは居ないという寸法だろう。ちなみに地霊殿は灼熱地獄跡の真上に建っているそうだ。
|| {{#hiragana:怨霊に怖れられる事を有効利用し、彼女は灼熱地獄跡に残った怨霊を管理している。隠し事が出来ない彼女に逆らうものは居ないという寸法だろう。ちなみに地霊殿は灼熱地獄跡の真上に建っているそうだ。}}
|-
| 彼女には妹が居る。
|| {{#hiragana:彼女には妹が居る。}}
|-
| ペットのうちの一匹に火焔猫燐がいる。お燐と呼ばれているそうだ。<br />　　お燐は怨霊と会話が出来るので、彼女の右腕として頼りにされているようだ。前述のように怨霊は会話によるコミュニケーションに餓えているので、さとりではなくお燐に懐く。怨霊の実質的な管理はお燐が行っているという話だ。
|| {{#hiragana:ペットのうちの一匹に火焔猫燐がいる。お燐と呼ばれているそうだ。<br />　　お燐は怨霊と会話が出来るので、彼女の右腕として頼りにされているようだ。前述のように怨霊は会話によるコミュニケーションに餓えているので、さとりではなくお燐に懐く。怨霊の実質的な管理はお燐が行っているという話だ。}}
|-
| 管理と言っても、精々数の増減を見ている位で殆ど話し飼いである。
|| {{#hiragana:管理と言っても、精々数の増減を見ている位で殆ど話し飼いである。}}
|}

=== romaji ===
把假名字串转换成罗马字。
;格式:<code><nowiki>{{#romaji: 字串 }}</nowiki></code>
;例子:
:<code><nowiki>{{#romaji:きらわれものばかりのふるじごくのなかでも}}</nowiki></code> → <code>{{#romaji:きらわれものばかりのふるじごくのなかでも}}</code>
:<code><nowiki>{{#romaji:あねのさとりとおなじようかい、サトリだ。}}</nowiki></code> → <code>{{#romaji:あねのさとりとおなじようかい、サトリだ。}}</code>
:<code><nowiki>{{#romaji:ローマじ}}</nowiki></code> → <code>{{#romaji:ローマじ}}</code>
:<code><nowiki>{{#romaji:ふじさん}}</nowiki></code> → <code>{{#romaji:ふじさん}}</code>
:<code><nowiki>{{#romaji:おちゃ}}</nowiki></code> → <code>{{#romaji:おちゃ}}</code>
:<code><nowiki>{{#romaji:ちじ}}</nowiki></code> → <code>{{#romaji:ちじ}}</code>
:<code><nowiki>{{#romaji:ちぢむ}}</nowiki></code> → <code>{{#romaji:ちぢむ}}</code>
:<code><nowiki>{{#romaji:つづく}}</nowiki></code> → <code>{{#romaji:つづく}}</code>
:<code><nowiki>{{#romaji:ディストーション}}</nowiki></code> → <code>{{#romaji:ディストーション}}</code>

[[分类:扩展帮助文档]]