DocBook到DokuWiki

时间:2009-03-09 02:55:13

标签: php documentation phpdoc docbook dokuwiki

是否有直接的方式来获取docbook内容并将其转换为DokuWiki内容?到目前为止,我只找到了解释docbook内容的DokuWiki plugin并将其输出为XHTML,但这种情况发生在每个页面加载上。

我想找到一种方法将docbook内容直接转换为DokuWiki的原生格式语法,所以我只需要解释一次。有什么想法吗?

3 个答案:

答案 0 :(得分:1)

我不熟悉你提到的工具,但我对你可能采用的一般策略有一些想法。

  1. 如果您对DocuWiki插件的输出感到满意,您可以在perl,sh,ruby等中编写某种脚本来执行插件并存储将来静态提供的内容

  2. 看来DocuWiki只是调用xsltproc程序并提供输出。如果插件正在运行,那么您应该能够直接从命令行或您自己的脚本调用xsltproc。看看DocuWiki

    中的这些行

    exec(“$ xsltproc -o $ tmpXhtmlFile $ docbookXsl $ tmpDocbookFile 2>& 1”,$ errors);

    $ returnXhtml = shell_exec(“$ xsltproc”.DOKU_PLUGIN。“/ docbook / xhtmlCleaner.xsl $ tmpXhtmlFile”);

  3. 选项1或2工作后。在修订控制系统中设置cron作业或挂钩,以监视对原始docbook源的更改,并调用脚本以重新生成静态版本。

答案 1 :(得分:1)

另一种选择是

  1. 使用'docbook2html' - [DocBook tools]将docbook转换为HTML,然后
  2. 使用类似Perl模块的东西将HTML转换为wiki标记。 http://metacpan.org/pod/HTML::WikiConverter

答案 2 :(得分:0)

一个小的(但可能很重要)注意:DokuWiki包含一个保存输出的HTML文件的缓存机制。这意味着通常插件很少会被执行(即,只在第一次查看页面的特定版本时)。