Documentation: Allow the use of CSV
Allow the use of CSV files if properly referenced from markdown. Sphinx will parse the file and create a human readable table, allowing easy integration of autogenerated files. Change-Id: I6fa13acf67ff1c6c9e3985054405c5446808da03 Signed-off-by: Patrick Rudolph <patrick.rudolph@9elements.com> Reviewed-on: https://review.coreboot.org/c/coreboot/+/32251 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Paul Menzel <paulepanter@users.sourceforge.net>
This commit is contained in:
parent
bff6dc7b8c
commit
1e742217e6
|
@ -100,6 +100,20 @@ If you do only reference the document, but do not include it in any toctree,
|
||||||
you'll see the following warning:
|
you'll see the following warning:
|
||||||
**WARNING: document isn't included in any toctree**
|
**WARNING: document isn't included in any toctree**
|
||||||
|
|
||||||
|
## CSV
|
||||||
|
|
||||||
|
You can import CSV files and let sphinx automatically convert them to human
|
||||||
|
readable tables, using the following reStructuredText snipped:
|
||||||
|
|
||||||
|
```eval_rst
|
||||||
|
.. csv-table::
|
||||||
|
:header: "Key", "Value"
|
||||||
|
:file: keyvalues.csv
|
||||||
|
```
|
||||||
|
|
||||||
|
Of course this can only be done from a markdown file that is included in the
|
||||||
|
TOC tree.
|
||||||
|
|
||||||
[coreboot]: https://coreboot.org
|
[coreboot]: https://coreboot.org
|
||||||
[Documentation]: https://review.coreboot.org/cgit/coreboot.git/tree/Documentation
|
[Documentation]: https://review.coreboot.org/cgit/coreboot.git/tree/Documentation
|
||||||
[shpinx-autobuild]: https://github.com/GaretJax/sphinx-autobuild
|
[shpinx-autobuild]: https://github.com/GaretJax/sphinx-autobuild
|
||||||
|
|
Loading…
Reference in New Issue