如何解决Python Sphinx 验证和更新架构
我正在使用 Sphinx 来维护一个项目的文档,我正在从一个工具生成一个 jsonschema 文档,其中列出了对象的所有属性。
这些对象属性记录在 rst 文件中,我需要:
我已经成功读取了 doctree-resolved
事件中的第一个文件,并与 json 属性匹配,但我不确定这是否是最好的方法,因为我需要
a) 检查所有属性都记录在案,这几乎是donde,我可以在找到的 json 属性上进行标记,然后在最后检查 json。
b) 复制从 json 中的 doctree 对象检索的描述(向 json 添加属性)我需要的格式是标记,所以我需要弄清楚如何将 doctree 节点(集)转换为标记。 url 链接也应该在这个阶段工作。此外,如果 Markdown 无法将片段转换为 html,那么 Markdown 可能会更容易
我不知道我是否走在正确的道路上,还是应该写一个构建器?
谢谢
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。