如何在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
相关产品推荐
相关产品推荐

