一个简单的“mkdocs”插件,它解析`pom.xml文件`文件并将其值作为模板环境变量公开
mkdocs-pom-parser-plugin的Python项目详细描述
mkdocs pom解析器插件
一个简单的mkdocs
插件,它解析pom.xml
文件并将其值作为模板环境变量公开。
当正在文档化的项目使用maven时,这很方便。在
注意:不支持多个pom.xml
文件,但如果您感兴趣-请随意投稿。在
安装
pip install mkdocs-pom-parser-plugin
使用
将插件添加到您的mkdocs.yml
默认情况下,插件将导出所有常用的标记作为模板环境变量:
pom.xml | template variable |
---|---|
^{ | ^{ |
^{ | ^{ |
^{ | ^{ |
^{ | ^{ |
^{ | ^{ |
^{ | ^{ |
^{ | ^{ |
^{ | ^{ |
在您的.md
文件中,您可以引用这些变量来生成文档中的dependency installation
部分:
<dependency>
<groupId>{{ POM_GROUP_ID }}</groupId>
<artifactId>{{ POM_ARTIFACT_ID }}</artifactId>
<version>{{ POM_VERSION }}</version>
</dependency>
如果您需要上面列表中缺少的字段-可以通过配置添加:
plugins:
- pom-parser-plugin:
path: ../pom.xml
additional:
# template key: valid xpath filter
# will become usable via {{ POM_SCM_CONNECTION }} in the template.
SCM_CONNECTION: ./scm/connection
发展
- 运行
./build.sh
或 docker-compose up
并检查localhost:8000
本地安装
1.pip install -e . && mkdocs build --config-file tests/resources/mkdocs.yml
(仍可编辑)
或者
pip install ./.tox/dist/mkdocs*.tar.gz && mkdocs build --config-file tests/resources/mkdocs.yml
释放
./create-release.sh
创建标记。在- Github操作将完成其余的工作。在
- 项目
标签: