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 查看散列)
关闭
jsonschema2rst-0.1.6.tar.gz 的散列
算法 | 散列摘要 | |
---|---|---|
SHA256 | fb41f9410a6a90fcdefec04d9a80396a637aca8b7d7b4e7e6621a4bf6742c019 |
|
MD5 | a599d642bf1552ecf66cd684dfcddb00 |
|
BLAKE2b-256 | f0d46cb1f48cedb4372522089cf7b8c20b87b7a26bddd484ebf25d1f88c41634 |
关闭
jsonschema2rst-0.1.6-py3-none-any.whl 的散列
算法 | 散列摘要 | |
---|---|---|
SHA256 | 0646afc2060ae1ec07be8af599edc9f847234cab7d5561c00575d7011de61011 |
|
MD5 | 57677775074476666ec480ac2ad75a22 |
|
BLAKE2b-256 | 333e52c9bf0f0f030636189508931a9f060658ced1fe61adc227649a8499f02e |