[Python-modules-team] Bug#953686: Add support for list-table :widths: and :header-rows: to rst2html?

[Dmitry Shachnev]

Hi Petter!

On Thu, Mar 12, 2020 at 11:05:10AM +0100, Petter Reinholdtsen wrote:
> 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
>     -
>
> [...]
> 
> I expected the widths to be different and the first line to be handled
> as a header.

I think the problem here is the indentation. The example in documentation [1]
has the same indent level for directive options and for the content.

If you indent the table content by one more space, then it works fine:

.. 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.
   [...]

[1]: https://docutils.sourceforge.io/docs/ref/rst/directives.html#list-table

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/python-modules-team/attachments/20200602/96e1a626/attachment.sig>