delta/python-packages/docutils.git/docs, branch docutils-0.20

Documentation update.

2023-05-03T11:01:03+00:00

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9370 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

Revert addition of `io.OutString` and the "auto_encode" argument.

2023-05-02T23:04:27+00:00

We need a review of the "string output" interface and a consensus
on the "clean" end-state before starting with the implementation.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9369 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

Add output encoding error handler to the parts provided by all writers.

2023-04-28T21:26:36+00:00

The new generic part "errors" returned by default
contains the `output_encoding_error_handler` setting,
which may make-or-break encoding ``parts['whole']``.

Allows use of `core.publish_parts()` to get the document as `str`,
post-process it and encode with user configurated encoding and
encoding-error handler.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9368 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

Documentation fix/update.

2023-04-26T21:00:10+00:00

The return value of `io.FileOutput` (and hence of `core.publish_cmdline()`
and `core.publish_file()`) is a `str` instance (except for
binary output document formats) and has always been under Python 3.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9366 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

Next iteration of "directives" documentation refactoring.

2023-04-20T23:04:43+00:00

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9361 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

Review rST "directives" documentation.

2023-04-19T23:31:23+00:00

Unify content type descriptions.
Add cross-links.
Reword for better clarity.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9359 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

Update documentation for the "csv-table" directive.

2023-04-18T23:50:48+00:00

Document current behaviour and the roadmap to bring it in line
with the specification.

Add deprecation warnings for to-be-removed objects.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9356 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

Announce change of "math-output" setting default for HTML5 to "MathML".

2023-04-14T00:11:56+00:00

MathML is supported by Chrome since January 2023.

Use MathML in documentation pages generated with the HTML5 writer already now.

Update "LaTeX syntax for mathematics" documentation.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9347 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

Do not decode OpenDocument zip packages with `publish_string()`.

2023-04-13T14:27:23+00:00

The ODF writer produces output in binary format.
Raise an exception if `publish_string()` is called with
this writer and ``auto_encode=False``.

Update documentation, add cross-links.

TODO:
In future, the ODF writer may return a "flat XML" version of the
"OpenDocument Text" document as `str`.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9345 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

Fix typo.

2023-04-12T16:52:19+00:00

Reported by Adam Turner.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@9344 929543f6-e4f2-0310-98a6-ba3bd3dd1d04