跳转到主要内容

yaml/json模式到rst的解析器

项目描述

此项目旨在解析JSON模式或YAML模式,以创建RestructuredText文档。使用Sphinx等工具,可以从生成的文件(RST格式的文本)中创建易于阅读的文档。

生成的RST可以通过在csv中定义黑名单和使用自定义CSS文件进行定制,该CSS文件将继承Sphinx的CSS。对于后者,提供了一个示例。

使用方法

要从JSON模式(或YAML)创建RST文件,请运行以下命令

jsonschema2rst input_folder output_folder

此命令将取路径中所有JSON或YAML文件,包括子文件夹,并将创建一个新目录(如果已存在则将其删除),其中将放置所有解析的RST文件。

示例

假设您运行以下命令

jsonschema2rst json_folder rst_output_folder

假设文件夹json_folder包含文件url.json,其中包含以下模式

{
    "title": "URL of related document",
    "properties": {
        "description": {
            "type": "string"
        },
        "value": {
            "format": "url",
            "type": "string"
        }
    },
    "type": "object"
}

结果,jsonschema2rst将在rst_output_folder中创建一个名为url.rst的文件,其中将包含以下rst代码

.. contents:: Table of Contents
.. section-numbering::
.. container:: section-title
 url.json

.. container:: title

 URL of related document

**type** : ``object``

**Properties:** description_, value_


.. description:

description
+++++++++++

**type** : ``string``


.. value:

value
+++++


**type** : ``string``

**format** : ``url``

额外

如果您想使用Sphinx等工具生成HTML文档,我们建议您尝试在贡献文件夹中的自定义.css文件,以使您的模式文档看起来更好。您需要做的只是将Sphinx在conf.py文件中使用的默认CSS替换为提出的CSS,然后享受吧!

项目详情


下载文件

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

源分布

jsonschema2rst-0.1.6.tar.gz (27.8 kB 查看散列)

上传时间

构建分布

jsonschema2rst-0.1.6-py3-none-any.whl (33.3 kB 查看散列)

上传时间 Python 3

由...