使用高级 Markdown 生成 Maven 站点？

Question

我们在 Maven generated site. Works like a charm. AFAIK the plugin uses Flexmark under the hood, which supports the Admonition extensions 中使用 Markdown。

我们也想使用它们，信息框对文档很有帮助。我们在 pom.xml 中的站点配置如下所示：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-site-plugin</artifactId>
    <version>3.8.2</version>
</plugin>

我们如何配置它来识别额外的降价？

Answer 1

这个问题有点老了，但我一直在尝试解决这个问题，以便将 Gitlab 扩展用于数学方程式，简短的回答是我认为你不能开箱即用。

maven-site-plugin 使用 doxia-module-markdown 降价模块，它在内部使用 Flexmark，但它预先配置了用于此目的的扩展。

这是代码的 link 以及来自

的确切片段

// Initialize the Flexmark parser and renderer, once and for all
static
{
    MutableDataSet flexmarkOptions = new MutableDataSet();

    // Enable the extensions that we used to have in Pegdown
    flexmarkOptions.set( com.vladsch.flexmark.parser.Parser.EXTENSIONS, Arrays.asList(
            EscapedCharacterExtension.create(),
            AbbreviationExtension.create(),
            AutolinkExtension.create(),
            DefinitionExtension.create(),
            TypographicExtension.create(),
            TablesExtension.create(),
            WikiLinkExtension.create(),
            StrikethroughExtension.create()
    ) );

// ...
}

我认为您可以 fork 这个项目，添加您需要的扩展，并将其作为依赖项添加到 maven-site-plugin，它可能会像这样工作：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-site-plugin</artifactId>
    <version>3.8.2</version>
    <dependencies>
        <dependency>
            <groupId>${my-forked-groupId}</groupId>
            <artifactId>${my-forked-artifactId}</artifactId>
            <version>${my-forked-version}</version>
        </dependency>
    </dependencies>
</plugin>

我认为这不太理想，我可能会探索其他（非 Maven）选项以获得我正在寻找的结果，但可能仍会在第二天左右尝试这个，如果我让它工作我会向代码发送一个 link 以防其他人可以从中受益。

使用高级 Markdown 生成 Maven 站点？

Maven site generation using advanced Markdown?

markdown

doxia

maven

maven-site-plugin

flexmark