delta/python-packages/docutils.git/docs/user, 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

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

New general setting "output".

2023-02-07T14:24:37+00:00

This setting obsoletes the positional argument .
Cf. the announcement of command line pattern changes in the
RELEASE-NOTES.

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

Announce command-line usage pattern change.

2023-02-07T14:24:19+00:00

Cf. [feature-requests:#36].

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

Update documentation on planned changes.

2023-02-06T21:34:19+00:00

Announce target versions for imminent changes.

Announce raise of required minimal Python version to 3.9.

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

New functions for use as `rst2*` "console_scripts entry points".

2023-02-06T21:04:00+00:00

The new functions allow the installation of `rst2*` command line scripts
via standard `entry points`__ instead of the current "scripts" list in
``setup.py`` after a transition period (cf. [feature-requests:#88]).

+ Works also for Windows.
+ Allows shorter command names (drop the extension), already in use
  in Debian and Ubuntu.

__ https://packaging.python.org/en/latest/specifications/entry-points/

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

Always use POSIX path in macros loading stylesheets.

2023-01-16T09:19:08+00:00

Thanks to Alan G. Isaac for reporting the bug and proposing a patch.

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