【问题标题】:DocBook to DokuWiki [closed]DocBook 到 DokuWiki [关闭]
【发布时间】:2009-03-09 02:55:12
【问题描述】:

有没有一种直接的方法来获取 docbook 内容并将其转换为 DokuWiki 内容?到目前为止,我只找到了DokuWiki plugin,它可以解释文档内容并将其输出为 XHTML,但每次页面加载都会发生这种情况。

我想找到一种方法将 docbook 内容直接转换为 DokuWiki 的本机格式化语法,因此我只需解释一次。有什么想法吗?

【问题讨论】:

    标签: php documentation phpdoc docbook dokuwiki


    【解决方案1】:

    另一个选择是

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

    【讨论】:

      【解决方案2】:

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

      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 作业或挂钩,以观察原始文档源的更改并调用脚本以重新生成静态版本。

      【讨论】:

        【解决方案3】:

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

        【讨论】:

          猜你喜欢
          • 1970-01-01
          • 1970-01-01
          • 1970-01-01
          • 2011-09-11
          • 1970-01-01
          • 1970-01-01
          • 1970-01-01
          • 1970-01-01
          • 1970-01-01
          相关资源
          最近更新 更多