Skip to main content

用于 Antlr4 语法的 Sphinx 域和自动文档

项目描述

Antlr4 的 Sphinx 插件

A4Doc 是一个用于记录 Antlr4 语法的 sphinx 插件。

它的主要目标是为 DSL 用户提供一些概述(生成的文档可能不包括编译器开发人员所必需的一些细微差别)。

A4Doc 的特点是:

  • 一个带有语法和规则指令的新域,称为a4
  • 绘制铁路图的指令;
  • .g4用于从源文件中提取文档注释并呈现文档和图表的指令。

资源

要求

  • 蟒蛇> = 3.7
  • 狮身人面像 >= 1.8.0

安装

pip3 install sphinx-a4doc

用例

变更日志

v1.2.5

v1.2.2、v1.2.3、v1.2.4

  • 没有功能更改,只需设置 CI 以自动推送 PyPI 版本。

v1.2.1

  • 修复了与 intersphinx 的集成。

v1.2.0

  • 重命名conf.py设置:a4_autodoc_*成为a4_autogrammar_*.
  • 添加了对语法文件中的部分注释的支持。
  • 添加了灵活的设置来控制文字词法分析器规则的呈现方式。
  • 添加了将规则名称从 转换为 的CamelCase设置dash-case
  • 在某些情况下,已修复的文档注释解析不正确。

v1.0.1

  • 修复.css了铁路图文件缺失的问题。

v1.0.0

  • 初始发行。

下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分布

sphinx-a4doc-1.3.0.tar.gz (96.9 kB 查看哈希)

已上传 source

内置分布

sphinx_a4doc-1.3.0-py3-none-any.whl (97.7 kB 查看哈希)

已上传 py3