sphinx扩展,用于将数据文件呈现为漂亮的html
sphinxcontrib.datatemplates的Python项目详细描述
此包包含sphinxcontrolb.datatemplates,它是 sphinx从中的数据文件呈现部分重构的文本页 json、yaml和csv等格式。
- 回购:https://github.com/sphinxcontrib/sphinxcontrib.datatemplates
- 文件:http://sphinxcontribdatatemplates.readthedocs.io/
示例yaml输入
--- key1: value1 key2: - list item 1 - list item 2 - list item 3 nested-list: - ['a', 'b', 'c'] - ['A', 'B', 'C'] mapping-series: - cola: a colb: b colc: c - cola: A colb: B colc: C
样本模板
.. -*- mode: rst -*- Individual Item ~~~~~~~~~~~~~~~ {{ data['key1'] }} List of Items ~~~~~~~~~~~~~ {% for item in data['key2'] %} - {{item}} {% endfor %} Nested List Table ~~~~~~~~~~~~~~~~~ Rendering a table from a list of nested sequences using hard-coded headers. {{ make_list_table( ['One', 'Two', 'Three'], data['nested-list'], title='Table from nested lists', ) }} Mapping Series Table ~~~~~~~~~~~~~~~~~~~~ Rendering a table from a list of nested dictionaries using dynamic headers. {{ make_list_table_from_mappings( [('One', 'cola'), ('Two', 'colb'), ('Three', 'colc')], data['mapping-series'], title='Table from series of mappings', ) }}
渲染输出
请参阅联机sphinx output。