Your message dated Mon, 5 Apr 2021 20:21:46 +0300
with message-id <YGtHKjIVltO/c...@mitya57.me>
and subject line Re: Bug#953686: Add support for list-table :widths: and
:header-rows: to rst2html?
has caused the Debian Bug report #953686,
regarding Add support for list-table :widths: and :header-rows: to rst2html?
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact ow...@bugs.debian.org
immediately.)
--
953686: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=953686
Debian Bug Tracking System
Contact ow...@bugs.debian.org with problems
--- Begin Message ---
Package: python3-docutils
Version: 0.14+dfsg-4
The rst2html tool in python3-docutils do not handle list-table the same
pandoc and xmlto, spesifically it do not understand the :widths: and
:header-rows: statements. I found the format documented in
<URL: https://sublime-and-sphinx-guide.readthedocs.io/en/latest/tables.html >,
and the PDFs I generate look good using these statements, but the HTML
edition generated by rst2html do not.
Here is an RST example:
.. list-table:: **Overordnede krav til arkivstrukturen**
:widths: 1 8 1 4
:header-rows: 1
* - Krav nr.
- Overordnede krav til arkivstrukturen
- Type
- Merknad
* - 2.1.1
- For at en løsning skal kunne godkjennes etter Noark 5 må den
koseptuelle modellen av arkivstrukturen og de funksjonelle
mulighetene den gir, kunne implemenenteres i det aktuelle
systemets (fysiske) datastrukturer.
- O
- Innebærer at det må implementeres slik at data skal kunne
presenteres og hentes ut på den måten.
* - 2.1.2
- Arkivdokumenter skal inngå i en arkivstruktur som minst
inneholder følgende arkivenheter:
*arkiv*, *arkivdel*, *registrering*, *dokumentbeskrivelse* og
*dokumentobjekt*.
- O
-
The generated HTML look like this:
<table border="1" class="docutils">
<caption><strong>Overordnede krav til arkivstrukturen</strong>
:widths: 1 8 1 4
:header-rows: 1</caption>
<colgroup>
<col width="25%" />
<col width="25%" />
<col width="25%" />
<col width="25%" />
</colgroup>
<tbody valign="top">
<tr><td>Krav nr.</td>
<td>Overordnede krav til arkivstrukturen</td>
<td>Type</td>
<td>Merknad</td>
</tr>
[...]
I expected the widths to be different and the first line to be handled
as a header.
--
Happy hacking
Petter Reinholdtsen
--- End Message ---
--- Begin Message ---
On Wed, Jun 03, 2020 at 11:54:17AM +0300, Dmitry Shachnev wrote:
> The specification also says [1]:
>
> | Several constructs begin with a marker, and the body of the construct
> | **must** be indented relative to the marker.
>
> (emphasis mine)
>
> | For constructs using simple markers (bullet lists, enumerated lists,
> | footnotes, citations, hyperlink targets, directives, and comments), the
> | level of indentation of the body is determined by the position of the
> | first line of text, which begins on the same line as the marker.
>
> If I read it correctly, this means that if your directive starts with
> ".. list-table::", the content should be aligned under the "l" letter,
> i.e. indented with three spaces.
>
> The directives syntax section [2] also has the following diagram:
>
> +-------+-------------------------------+
> | ".. " | directive type "::" directive |
> +-------+ block |
> | |
> +-------------------------------+
>
> which confirms my hypothesis. By chance, your table indented with two spaces
> does not cause syntax errors, but you should not rely on that.
>
> In any case, docutils/rst2html is the reference implementation, so I would
> say a valid markup is markup that is correctly parsed by docutils.
>
> Please close this bug if you agree with me.
No objections, so closing.
--
Dmitry Shachnev
signature.asc
Description: PGP signature
--- End Message ---
_______________________________________________
Python-modules-team mailing list
Python-modules-team@alioth-lists.debian.net
https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/python-modules-team
