一个简单的“mkdocs”插件,它解析`pom.xml文件`文件并将其值作为模板环境变量公开

mkdocs-pom-parser-plugin的Python项目详细描述


mkdocs pom解析器插件

一个简单的mkdocs插件,它解析pom.xml文件并将其值作为模板环境变量公开。 当正在文档化的项目使用maven时,这很方便。在

注意:不支持多个pom.xml文件,但如果您感兴趣-请随意投稿。在

安装

pip install mkdocs-pom-parser-plugin

使用

将插件添加到您的mkdocs.yml

^{pr2}$

默认情况下,插件将导出所有常用的标记作为模板环境变量:

pom.xmltemplate 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

发展

  1. 运行./build.sh
  2. docker-compose up并检查localhost:8000

本地安装

1.pip install -e . && mkdocs build --config-file tests/resources/mkdocs.yml(仍可编辑)

或者

  1. pip install ./.tox/dist/mkdocs*.tar.gz && mkdocs build --config-file tests/resources/mkdocs.yml

释放

  1. ./create-release.sh创建标记。在
  2. Github操作将完成其余的工作。在

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
java如何将jaxb插件扩展与gradlejaxbplugin一起使用   java Hibernate列表<Object[]>到特定对象   java使用多态性显示arraylist的输出   java水平堆叠卡,带有一定偏移量   java错误:找不到符号方法liesInt()   java客户机/服务器文件收发中的多线程流管理   在java中可以基于访问重载方法吗?   包含空元素的java排序数组   swing Java按钮/网格布局   java BottomNavigationView getmaxitemcount   java空指针异常字符串生成器   java Xamarin升级导致“类文件版本错误52.0,应为50.0”错误   java我正在尝试打印它,而不只是对每一行进行println   Tomcat7中的java是否需要复制上下文。将xml转换为conf/Catalina/locahost以使其生效   带有注入服务的java REST端点在何处引发自定义WebServiceException?   在Java中使用GPS数据   java如何将JFreeChart ChartPanel导出到包含添加的CrosshairOverlay的图像对象?   内置Eclipse期间的Java 8堆栈溢出   java在GWT编译的JavaScript中如何表示BigDecimal