Updated Format description layout

This commit is contained in:
Austin Marino 2019-10-13 11:45:33 -07:00 committed by GitHub
parent 294b3cdb8c
commit 4f0a2b78a3
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -48,25 +48,28 @@ Configuration
To configure the plugin, make a ``export:`` section in your configuration
file. Under the ``json``, ``csv``, and ``xml`` keys, these options are available:
- **ensure_ascii**: Escape non-ASCII characters with ``\uXXXX`` entities.
- **JSON Formatting**
- **ensure_ascii**: Escape non-ASCII characters with ``\uXXXX`` entities.
- **indent**: The number of spaces for indentation.
- **indent**: The number of spaces for indentation.
- **separators**: A ``[item_separator, dict_separator]`` tuple.
- **separators**: A ``[item_separator, dict_separator]`` tuple.
- **sort_keys**: Sorts the keys in JSON dictionaries.
- **sort_keys**: Sorts the keys in JSON dictionaries.
- **delimiter**: Used as the separating character between fields. The default value is a comma (,).
- **CSV Formatting**
- **delimiter**: Used as the separating character between fields. The default value is a comma (,).
- **dialect**: A dialect, in the context of reading and writing CSVs, is a construct that allows you to create, store, and re-use various formatting parameters for your data.
- **dialect**: A dialect, in the context of reading and writing CSVs, is a construct that allows you to create, store, and re-use various formatting parameters for your data.
- **encoding**: Use encoding="unicode" to generate a Unicode string (otherwise, a bytestring is generated).
- **XML Formatting**
- **encoding**: Use encoding="unicode" to generate a Unicode string (otherwise, a bytestring is generated).
- **xml_declaration**: Controls if an XML declaration should be added to the file. Use False for never, True for always, None for only if not US-ASCII or UTF-8 or Unicode (default is None).
- **xml_declaration**: Controls if an XML declaration should be added to the file. Use False for never, True for always, None for only if not US-ASCII or UTF-8 or Unicode (default is None).
- **method**: Can be either "xml", "html" or "text" (default is "xml")
- **method**: Can be either "xml", "html" or "text" (default is "xml")
- **short_empty_elements**: Controls the formatting of elements that contain no content. If True (the default), they are emitted as a single self-closed tag, otherwise they are emitted as a pair of start/end tags.
- **short_empty_elements**: Controls the formatting of elements that contain no content. If True (the default), they are emitted as a single self-closed tag, otherwise they are emitted as a pair of start/end tags.
These options match the options from the `Python json module`_.