You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Asciidoc与Maven环境中通过asciidoctor-tabs和asciidoctor-maven-plugin启用标签页功能?

如何在Asciidoc与Maven环境中通过asciidoctor-tabs和asciidoctor-maven-plugin启用标签页功能?

嘿,我来帮你搞定这个标签页的问题!你说得没错,目前官方的asciidoctor-tabs扩展确实没有发布到Maven Central,所以没法直接通过标准GAV引用。不过有两个可行的办法来解决这个问题:

方法一:手动构建并安装到本地Maven仓库

如果你的项目只在本地或者内部团队使用,手动构建是最直接的方式:

  • 先把asciidoctor-tabs的源码拉取到本地(从官方代码仓库获取即可)
  • 进入源码目录,执行Maven命令完成构建并安装到本地仓库:
    mvn clean install
    
  • 之后在你的项目的asciidoctor-maven-plugin配置中,添加这个扩展的GAV和类名:
    <plugin>
      <groupId>org.asciidoctor</groupId>
      <artifactId>asciidoctor-maven-plugin</artifactId>
      <version>你的插件版本号</version>
      <configuration>
        <extensions>
          <extension>
            <groupId>org.asciidoctor</groupId>
            <artifactId>asciidoctor-tabs</artifactId>
            <version>你构建的版本号</version>
            <className>org.asciidoctor.extension.tabs.TabsExtension</className>
          </extension>
        </extensions>
      </configuration>
    </plugin>
    
    注意替换其中的你的插件版本号和你构建的版本号为实际值。

方法二:使用JitPack仓库获取依赖

如果不想手动构建,你可以借助JitPack这个第三方仓库,它能直接从GitHub仓库构建并提供Maven依赖:

  • 首先在你的项目pom.xml中添加JitPack仓库配置:
    <repositories>
      <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
      </repository>
    </repositories>
    
  • 然后在asciidoctor-maven-plugin的扩展配置中引用该依赖,GAV格式为com.github.asciidoctor:asciidoctor-tabs:标签或提交哈希,比如用最新的稳定标签:
    <extension>
      <groupId>com.github.asciidoctor</groupId>
      <artifactId>asciidoctor-tabs</artifactId>
      <version>v1.0.0</version>
      <className>org.asciidoctor.extension.tabs.TabsExtension</className>
    </extension>
    

验证标签页功能

配置完成后,你就可以在Asciidoc文件中使用标签页语法了,示例如下:

[tabs]
====
tab::Java[]
这是Java代码示例
```java
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
}

tab::Python[]
这是Python代码示例

print("Hello World!")

====

备注:内容来源于stack exchange,提问作者Geoffrey De Smet
相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.20 11:23:03