微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

Python Sphinx 验证和更新架构

如何解决Python Sphinx 验证和更新架构

我正在使用 Sphinx 来维护一个项目的文档,我正在从一个工具生成一个 jsonschema 文档,其中列出了对象的所有属性。 这些对象属性记录在 rst 文件中,我需要: 我已经成功读取了 doctree-resolved 事件中的第一个文件,并与 json 属性匹配,但我不确定这是否是最好的方法,因为我需要

a) 检查所有属性都记录在案,这几乎是donde,我可以在找到的 json 属性上进行标记,然后在最后检查 json。

b) 复制从 json 中的 doctree 对象检索的描述(向 json 添加属性)我需要的格式是标记,所以我需要弄清楚如何将 doctree 节点(集)转换为标记。 url 链接也应该在这个阶段工作。此外,如果 Markdown 无法将片段转换为 html,那么 Markdown 可能会更容易

我不知道我是否走在正确的道路上,还是应该写一个构建器?

谢谢

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。