delta/python-packages/docutils.git/docutils/docs/howto, branch master

Improve internationalisation documentation

2022-07-29T11:56:58+00:00

Add links to documentation of translated terms.

Sort mappings to better match documentation
and keep related terms together.

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

Minimalistic menu bar for documentation pages.

2022-04-02T21:59:06+00:00

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

Documentation update and re-organisation.

2022-04-01T08:21:42+00:00

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

Fix trailing whitespace (non-Python files).

2022-01-29T22:26:10+00:00

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

Update URLs in the docs.

2022-01-21T13:45:42+00:00

Mostly http: -> https:, based on a patch by Adam Turner

Remove/update some dead links.

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

Change http://docutils.sourceforge.net -> https://docutils.sourceforge.io

2022-01-20T10:11:44+00:00

Patch by Adam Turner.

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

Change http://docutils.sf.net -> https://docutils.sourceforge.io

2022-01-20T10:10:25+00:00

Patch by Adam Turner.

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

Avoid mutables as function argument defaults.

2021-12-29T00:01:16+00:00

Mutable default values for functions are considered an anti-pattern
(cf. bug #430 and
https://docs.python-guide.org/writing/gotchas/#mutable-default-arguments).

Mutable default values (empty lists and dictionaries) were used
in the "interpreted role function" API:
Interpreted role functions must accept (optional)
"options" and "content" arguments and must not modify passed values.

OTOH, the actual default value is irrelevant for the API, so there is
no need to use mutable defaults in the specification.
As a precaution and example for robust coding, mutable defaults
are replaced with None in the function definitions.

The documentation is updated to the current implementation (including
changes in [r8254] to apply feature request #63).

Fixes bug #430.

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

Fix spelling

2021-10-22T16:39:59+00:00

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

Fix spelling errors.

2021-10-21T22:59:24+00:00

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