New value "auto" for "initial_header_level" config setting.
Announce upcoming changes.
More detailled description of the restrictions on transition placement.
Proposed patch: -- a/docutils/docs/ref/rst/restructuredtext.rst +++ b/docutils/docs/ref/rst/restructuredtext.rst @@ -179,7 +179,10 @@ Here are examples of `body elements`_: - Footnotes_:: .. [1] A footnote contains body elements, consistently - indented by at least 3 spaces. + indented by at least 1 space. + + The least indented line sets the reference + indentation, so this is a nested block quote. - Citations_:: The attached patch also adds some more examples and moves the paragraph about paragraph...
Wrong statement in "reStructuredText Specification"
docutils.io.FileInput: ensure read() returns a `str`.
publish_file no longer works with "BytesIO-like" objects.
Thank you for the report. The issue is fixed in [r10267].
combining unicode chars count in grid tables
Fixed in Docutils 0.22.3.
rst2html incorrectly converts tables with Combining Diacritical Marks into HTML
Fixed in Docutils 0.22.3.
Documentation update and fixes.
Simplify `ClassAttribute` transform.
Fixes for the "responsive" CSS style sheet.
Future-proof the test for valid parents of topics or sidebars.
Problem is io.FileInput.read() It needs to be data = self.decode(self.source.read()) instead of data = self.source.read() which is bytes.
publish_file no longer works / crashes
add email
release 0.22.3
version 0.22.4b1
tagging release 0.22.3
version 0.22.3
Small edits in description of recent changes.
Relax test for valid parents of topics or sidebars.
Documentation update/fixes.
Better error message for substitution definitions.
Thank you for the contribution. Unfortunately, we cannot include the patch without a change in the Docutils specification, https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#standalone-hyperlinks, which limits the supported URI schemes to the ones listed in the Official IANA Registry of URI Schemes and the W3C's Retired Index of WWW Addressing Schemes. While I don't see a "gemini" URI scheme as a particular problematic case, adding non-registered schemes should be done with special...
Fix Unknown target name warning in roles.rst
Fixed in [r10249] (with different wording). Thanks for finding the broken link and the patch.
Documentation update/fixes.
version 0.22.3b1.dev
rst2html incorrectly converts tables with Combining Diacritical Marks into HTML
Fixed in [r10251].
combining unicode chars count in grid tables
Fixed, now also for grid tables, in [r10251].
rST parser: allow for combining characters in grid tables.
Simplify `utils.column_indices()`.
Even when adjusting the grid, the parser goes wrong. See [bugs:#512].
error installing v0.22.1 on MacOS
Fixed with release 0.22.2. Thank you for report, analysis, and testing.
Now it looks fine, thank you! https://github.com/Homebrew/homebrew-core/pull/245109
Documentation fixes.
Docutils 0.22.2 is out (without the *.swp file). @daeho-ro: Could you please try whether this solves the install problem?
release 0.22.2
version 0.22.3b1.dev
tagging release 0.22.2
version 0.22.2
The .__init__.py.swp file should definitely not be there... ... it seems this is not just another problem but the culprit.
Thanks for the additional info. It seems that install on MacOS (or just homebrew or snakemake, ...) trips over the spurious file while with Python's standard "pip" installment program or installing "by hand" the spurious file is just ignored. We will release a new version without the spurious file ASAP.
error installing v0.22.1 on MacOS
It seems that install on MacOS (or just homebrew or snakemake, ...) trip over the spurious file while with Python's standard "pip" installment program or installing "by hand" the spurious file is just ignored. We will release a new version without the spurious file ASAP.
MacOS with homebrew, during update some of packages. snakemake depends on this docutils and the ci build error is here. https://github.com/Homebrew/homebrew-core/actions/runs/17826985501/job/50682694634#step:3:4128 In this case, we keep the previous version and it passed the CI. docutils itself https://github.com/Homebrew/homebrew-core/actions/runs/17809144055/job/50651494614?pr=244510#step:3:51 Not sure how can I implement the patch.
Fix Unknown target name warning in roles.rst
I cannot reproduce the install problem here. Installing Docutils 0.22.1 with pip into a new created venv worked without problem, despite the spurious file. What is the OS? Which command was used for the install? Was there any output after Here's the output:? If you used pip, run it with increased verbosity and share the details: pip install <package-name> --verbose You may consider removing the spurious file /docutils-0.22.1/docutils/.__init__.py.swp from the wheel or tar.gz archive (or manually...
I cannot reproduce the install problem here. Installing Docutils 0.22.1 with pip into a new created venv worked without problem, despite the spurious file. What is the OS? Which command was used for the install? If you used pip, run it with increased verbosity and share the details: pip install <package-name> --verbose You may consider removing the spurious file /docutils-0.22.1/docutils/.__init__.py.swp from the wheel or tar.gz archive (or manually unpacking and then removing) and trying again.
rst2html incorrectly converts tables with Combining Diacritical Marks into HTML
The .__init__.py.swp file should definitely not be there.
Hi, echo on this thread - there also seem to be another issue with 0.22.1 wheel, it ships an swp file that should ideally not be there. $ python -m venv venv $ . venv/bin/activate (venv) $ pip install docutils --no-cache-dir Collecting docutils Downloading docutils-0.22.1-py3-none-any.whl.metadata (15 kB) Downloading docutils-0.22.1-py3-none-any.whl (638 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 638.5/638.5 kB 38.1 MB/s eta 0:00:00 Installing collected packages: docutils Successfully installed...
Hi, echo on this thread - there also seem to be another issue with 0.22.1 wheel, it ships an swp file that should ideally not be there. $ python -m venv venv $ . venv/bin/activate (venv) $ pip install docutils --no-cache-dir Collecting docutils Downloading docutils-0.22.1-py3-none-any.whl.metadata (15 kB) Downloading docutils-0.22.1-py3-none-any.whl (638 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 638.5/638.5 kB 38.1 MB/s eta 0:00:00 Installing collected packages: docutils Successfully installed...
error on v0.22.1
Give better messages on malformed tables
Fixed in Docutils 0.22.1. Thanks again.
Thank you for the fixes. Not sure if the following is worth a new ticket, so I thought I'd mention it here: The 0.22.1 tarball includes a backup file (that also gets installed): docutils/.__init__.py.swp
Test failure on Windows with embedded images
LaTeX writer fails to generate "labels" for some elements with "ids".
LaTeX writer fails to generate "labels" for some elements with "ids".
Fixed in Docutils 0.22.1.
errors for malformed tables do not indicate what the error is
Fixed in Docutils 0.22.1. Thanks again!
qemu build problem after docutils update to 0.22
Fixed in Docutils 0.22.1. Please reopen if there are still problems. Thank you for reporting and tests.
regression with docutils 0.22: unsupported operand type(s) for +: 'NoneType' and 'list'
Fixed in Docutils 0.22.1. Please reopen if there are still problems. Thank you for reporting and tests.
Release date for 0.22 is in the future
Fixed in Docutils 0.22.1. Thank you for reporting.
Fix: commented out py2 code
update version to 0.22.2b1.dev
0.22.1 release
version 0.22.2b1.dev
tagging release 0.22.1
release 0.22.1
Thanks, I’ll give it a try. 👍🏻
So I can think of any suitable tests, what would your definiton of safe be here? you should . there was a discussion on docutils lists recently (1y) on code injection some general unittests/functional tests are mandatory (was in aegis SCM) considerations remarks for the security documentation ?
things are speedier if there is documentation and tests (i assume you did test the patch so why not pass this on) in the patch. the real hard thing for me to check is ... is this safe ... loading directives into docutils any thoughts help ?
Supersedes [patches:#17].
Thank you for the report. Combining characters in grid tables are known to be problematic. See [bugs:#128] Mind, that the intended behaviour would be to get the "expected" result with the input +---+ | ç̌ | +---+ For simple tables, you can use the simple table syntax, where this problem is fixed: = == ç̌ OK = ==
Even when adjusting the grid, the parser goes wrong. See [bugs:512].
combining unicode chars count in grid tables
Announce change for label writing in latex writer.
“ç̌” is composed of two Unicode characters: a c-cedilla and a combining caron. U+00E7 : LATIN SMALL LETTER C WITH CEDILLA U+030C : COMBINING CARON {hacek, V above}
rst2html incorrectly converts tables with Combining Diacritical Marks into HTML
Document the `<target>` element.
Thank you for testing. so it should be fine with Docutils 0.22.1.rc1.