search

arkivverket / noark5-standard

Noark 5 versjon 5.0 – innspill før versjonering til Noark 5 versjon 5.1
Other
3 stars 5 forks source link

Bytt til RST list-table i stedet for RST table? #17

Closed petterreinholdtsen closed 4 years ago

petterreinholdtsen commented 4 years ago

Dagens RST-filer bruker RSTs 'grid tables'. Disse er litt knotete å oppdatere, samt at det er utfordrende å manuelt styre relativ cellestørrelse i tabellen (gjøres ved å endre størrelsen på tabellene.

Jeg kom i dag over et alternativ som kan forenkle jobben for mange av tabellene. Sjekk ut <URL: https://sublime-and-sphinx-guide.readthedocs.io/en/latest/tables.html > og <URL: https://github.com/jgm/pandoc/issues/4564 >.

Med den varianten kan vi styre relativ bredde med :widths:.

Jeg er usikker på om det lar seg enkelt gjøre maskinelt å bytte, men ser det finnes et endringsforslag til pandoc vi kan teste ut. https://github.com/italia/pandoc/commit/3de11f63e60a31a3bb0196d0936aaa4935f79b50

petterreinholdtsen commented 4 years ago

Testet ut ideen i https://github.com/petterreinholdtsen/noark5-standard/blob/test-list-table/kapitler/030-noark-5-datamodell.rs og oppdaget at HTML-omformingen på github ikke forstår :widths: og :header-rows:, som dukker opp bak tabelltittelen.

Omforming med xmlto til HTML på min Debian Stretch-maskin har ikke samme problem. Mistenker årsaken er at github enten bruker en eldre omformer eller et annet program. Min utgave av rst2html har samme problem som på github.

Er ulempen akseptabel, eller bør vi avstå fra å bruke list-table på grunn av dette?

petterreinholdtsen commented 4 years ago

Som avtalt har jeg omformet tabellene til list-table og sjekket inn som endring 8154aa7717876fdeb40e5aac5491fb832c879ce2 i master. Glemte lukke denne mangelmeldingen med innsjekk-meldingen.

Fikk ikke brukt pandoc, men justerte utskriften fra krav-rst2csv slik at den ga et godt utgangspunkt.

petterreinholdtsen commented 4 years ago

https://docutils.sourceforge.io/docs/ref/rst/directives.html har forresten mer detaljer om list-table-formatet.