我正在尝试为Mediawiki开发一个简单的Tag Extension。到目前为止,我基本上输出了输入。当存在链式标签时会出现问题。例如,对于此示例:
function efSampleParserInit( Parser &$parser ) {
$parser->setHook( 'sample', 'efSampleRender' );
return true;
}
function efSampleRender( $input, array $args, Parser $parser, PPFrame $frame ) {
return "hello ->" . $input . "<- hello";
}
如果我在一篇文章中写这篇文章:
This is the text <sample type="1">hello my <sample type="2">brother</sample> John</sample>
仅处理第一个sample
标记。另一个不是。我想我应该使用我收到的$parser
对象,所以我返回解析后的输入,但我不知道该怎么做。
此外,Mediawiki的参考文献几乎不存在,如果有像Doxygen参考资料这样的东西会很棒。
答案 0 :(得分:3)
使用$parser->recursiveTagParse()
,如Manual:Tag_extensions#How do I render wikitext in my extension?所示。
这是一种笨重的界面,并没有很好的记录。这种看似自然的事情要做的根本原因是如此难以实现,它有点违背标签扩展的原始设计意图 - 它们最初被设想为低级过滤器,它接收原始未解析的文本并吐出HTML ,完全绕过正常的解析。因此,例如,如果您想在Wiki页面上包含一些用Markdown编写的内容(例如StackOverflow帖子),那么您的想法是可以安装合适的扩展名然后编写
<markdown>
**Look,** here's some Markdown text!
</markdown>
在页面上,MediaWiki解析器会在&lt; markdown&gt;之间留下所有内容。单独标记,然后将其交给扩展进行解析。
当然,事实证明,大多数编写MediaWiki标记扩展的人并不真的想要替换解析器,而只是对它进行一些调整。但是标记扩展接口的设置方式,唯一的方法是递归调用解析器。我有时会认为将新的解析器扩展类型添加到MediaWiki会很好,这些看起来像一样的标签扩展但不会以如此激烈的方式中断正常的解析。唉,我的动机和大量的空闲时间到目前为止还不足以真正做点什么。