diff options
| author | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2021-12-23 14:54:26 +0000 |
|---|---|---|
| committer | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2021-12-23 14:54:26 +0000 |
| commit | f3db6cc68b2edf72015ccb4eccc54cea3b082c5b (patch) | |
| tree | 3928397a80b8843400d14b2a509b2881b7595241 /docutils/docs/user/config.txt | |
| parent | 7935fbe68da9d9b4278f07b2207d7dae2a915bae (diff) | |
| download | docutils-f3db6cc68b2edf72015ccb4eccc54cea3b082c5b.tar.gz | |
Small documentation updates and fixes.
Also change the priority of the SmartQuotes transform
to a level not already in use.
git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@8912 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/docs/user/config.txt')
| -rw-r--r-- | docutils/docs/user/config.txt | 26 |
1 files changed, 21 insertions, 5 deletions
diff --git a/docutils/docs/user/config.txt b/docutils/docs/user/config.txt index 8aac2c4e9..2d3b67ab2 100644 --- a/docutils/docs/user/config.txt +++ b/docutils/docs/user/config.txt @@ -812,13 +812,28 @@ Options: ``--trim-footnote-reference-space, --leave-footnote-reference-space``. The footnote space is trimmed if the reference style is "superscript", and it is left if the reference style is "brackets". -[markdown parser] ------------------ +[recommonmark parser] +--------------------- Experimental, based on recommonmark_. +Currently no configuration settings. .. _recommonmark: https://pypi.org/project/recommonmark/ +[myst parser] +------------- + +Provided by the 3rd party package `myst-docutils`_. +See `MyST with Docutils`_ and its `Sphinx configuration options`_ +(some settings are not available with Docutils). + +.. _myst-docutils: https://pypi.org/project/myst-docutils/ +.. _MyST with Docutils: + https://myst-parser.readthedocs.io/en/latest/docutils.html +.. _Sphinx configuration options: + https://myst-parser.readthedocs.io/en/latest/sphinx/reference.html#sphinx-config-options + + [readers] ========= @@ -954,8 +969,8 @@ Default: don't cloak (None). Option: ``--cloak-email-addresses``. compact_lists ~~~~~~~~~~~~~ -Remove extra vertical whitespace between items of bullet lists and -enumerated lists, when list items are all "simple" (i.e., items +Remove extra vertical whitespace between items of `bullet lists`_ and +`enumerated lists`_, when list items are all "simple" (i.e., items each contain one paragraph and/or one "simple" sub-list only). The behaviour can be specified directly via "class" attributes (values "compact" and "open") in the document. @@ -2140,7 +2155,7 @@ Option: ``--reader`` parser ~~~~~~ -Parser component name. One of "markdown", "recommonmark", or "rst" +Parser component name. Default: "rst". Option: ``--parser`` @@ -2272,6 +2287,7 @@ pep_template [pep_html writer] template ../ref/rst/restructuredtext.html#bibliographic-fields .. _block quote: ../ref/rst/restructuredtext.html#block-quotes .. _citations: ../ref/rst/restructuredtext.html#citations +.. _bullet lists: ../ref/rst/restructuredtext.html#bullet-lists .. _enumerated lists: ../ref/rst/restructuredtext.html#enumerated-lists .. _field lists: ../ref/rst/restructuredtext.html#field-lists .. _field names: ../ref/rst/restructuredtext.html#field-names |
