Java Wikitext 解析器 [已关闭]

Question

对于一个具有易于使用且可配置的 api 的漂亮解析器有什么想法吗？我希望向其提供数据，例如 http://wikitravel.org/wiki/en/api.php?format=xml&action=parse&prop=wikitext&page=San%20Francisco，选择我想要的数据部分，然后输出自定义html 为每个独特类型的元素？ Java 是首选，但如果有一个 php/js 解决方案与大多数（99%+）wikitext 兼容，那也可以。

Answer 1

Sweble 可能是维基文本最好的 Java 解析器。它声称 100% 兼容 wikitext，但我严重怀疑这一点。它将 wiki 文本解析为抽象语法树，然后您必须对其执行某些操作（例如将其转换为 HTML）。

mediawiki.org 上有一个页面列出了各种编程语言的维基文本解析器。但我认为他们中没有人能完成 99% 以上的维基文本。一般来说，解析维基文本是一个非常复杂的问题。 Wikitext 甚至没有在 MediaWiki 解析器本身之外的任何地方进行正式定义。

Answer 2

这个问题几年前就已得到解答，但我想为未来的访问者节省我必须花费的精力来弄清楚如何使用 Sweble。

您可以尝试他们网站上的文档，但我无法弄清楚。只需查看示例源代码即可。在

https://repo1.maven.org/maven2/org/sweble/wikitext/swc-example-basic/2.0.0/swc-example-basic-2.0.0- 下载 swc-example-basic 的源 jar resources.jar 并查看 App.java 和 TextConverter.java。

基本上，要解析页面并将其转换为另一种形式，首先将以下依赖项添加到您的项目中：

    <dependency>
        <groupId>org.sweble.wikitext</groupId>
        <artifactId>swc-engine</artifactId>
        <version>2.0.0</version>
    </dependency>

然后，执行以下操作：

public String convertWikiText(String title, String wikiText, int maxLineLength) throws LinkTargetException, EngineException {
    // Set-up a simple wiki configuration
    WikiConfig config = DefaultConfigEnWp.generate();
    // Instantiate a compiler for wiki pages
    WtEngineImpl engine = new WtEngineImpl(config);
    // Retrieve a page
    PageTitle pageTitle = PageTitle.make(config, title);
    PageId pageId = new PageId(pageTitle, -1);
    // Compile the retrieved page
    EngProcessedPage cp = engine.postprocess(pageId, wikiText, null);
    TextConverter p = new TextConverter(config, maxLineLength);
    return (String)p.go(cp.getPage());
}

TextConverter 是一个您可以在我上面提到的示例中找到的类。自定义它来做任何你想做的事情。例如，以下内容确保所有粗体文本都被“**”包围：

public void visit(WtBold b)
{
    write("**");
    iterate(b);
    write("**");
}

对于您将遇到的每种类型的元素，该类都有许多访问方法。

Answer 3

我刚刚在 Bliki 上取得了成功：

https://bitbucket.org/axelclk/info.bliki.wiki/wiki/Mediawiki2HTML

Bliki 是 XWiki 使用的，使用非常简单：

String htmlText = WikiModel.toHtml("This is a simple [[Hello World]] wiki tag"); 以下是下载列表：

https://oss.sonatype.org/content/repositories/snapshots/info/bliki/wiki/bliki-core/

但是与 Maven 一起使用要容易得多。

Answer 4

您还可以使用 XWiki 的渲染引擎 (

http://rendering.xwiki.org)。以下是如何解析某些 mediawiki 内容的示例：

// Initialize Rendering components and allow getting instances
EmbeddableComponentManager componentManager = new EmbeddableComponentManager();
componentManager.initialize(this.getClass().getClassLoader());

// Get the MediaWiki Parser
Parser parser = componentManager.getInstance(Parser.class, "mediawiki/1.0");

// Parse the content in mediawiki markup and generate an AST (it's also possible to use a streaming parser for large content)
XDOM xdom = parser.parse(new StringReader("... input here"));

// Perform any transformation you wish to the XDOM here
...

// Generate XHTML out of the modified XDOM
WikiPrinter printer = new DefaultWikiPrinter();
BlockRenderer renderer = componentManager.getInstance(BlockRenderer.class, "xhtml/1.0");
renderer.render(xdom, printer);

// The result is now in the printer object
printer.toString();

查看更多示例

http://rendering.xwiki.org/xwiki/bin/view/Main/GettingStarted

希望有帮助。