如何从反射和 xml 注释生成支持 mediawiki 的文档

Question

有人可以建议一个好的工作流程，

• 独立于可能需要的不同工具的数量
• 以及需要进行多少体力劳动，

可以让我将我的项目文档（反射 + xml 注释）合并到 mediawiki 语法中，然后我会用它来合并到我的开发团队 wikia 中吗？

Answer 1

将会涉及一些体力劳动，但使用下面列出的资源应该是可行的。

我的第一个想法就是做一些谷歌搜索，通过它我发现了http://www.mediawiki.org/wiki/Alternative_parsers。所有这些解析器似乎都获取数据并将其转换为 XML，而不是从 XML 转换，而且它们都不是基于 .NET 的，从长远来看，如果不涉及编码，这可能不是非常重要。谁知道呢，这里可能有一些值得一看的东西。

然后我找到了http://www.mediawiki.org/wiki/Manual:Importing_XML_dumps。我认为，如果您可以导入 XML 格式的数据，那么您真正需要知道的就是架构是什么，以便您可以以适当的方式重新格式化数据。最棒的是，此页面有一个指向http://www.mediawiki.org/wiki/Manual:XML_Import_file_manipulation_in_CSharp的链接，这是一个有关如何使用 Media Wiki XML 导入文件的 C# 示例。鉴于该示例，创建从头开始生成所需 xml 并转储数据所需的类似乎只是一小步。以下是官方模式文档的链接：http: //www.mediawiki.org/xml/导出-0.3.xsd。

根据您是否想编写 PHP，会出现另一个选项。您可以编写一个 XMLTransform 扩展，如下所述： http: //www.ehartwell.com/TechNotes/MediaWikiXmlExtension.htm。该网站似乎说您可以将 XML 保留为其本机格式，并编写自定义 XSL 表以所需格式显示内容。

祝你好运！