本项目是 技术文档编写指南的示例项目,用于演示使用asciidoctor-maven插件以及对应的spring扩展生成spring风格的html文档以及使用GitHub Action构建CI/CI流程将文档自动发布到GitHub Pages
重点包括:
-
src/main/asciidoc下存放原始的asciidoc文档
-
pom.xml中配置asciidoctor-maven插件
-
.github/workflows下存放GitHub Action配置
-
执行mvn clean package后target/generated-docs目录下会生成原始asciidoc文档转换后的html文件
-
git push后会触发CI/CD流程执行,将修改后的页面自动部署到GitHub Pages
-
访问GitHub Pages的地址为 https://pxzxj.github.io/asciidoc-cicd-demo
Tip
|
对GitHub Action和GitHub Pages不熟悉的读者参考 GitHub Actions 入门教程和 GitHub Pages |