From: Guenter M. <mi...@us...> - 2015-04-15 23:10:56
|
On 2015-04-14, David Goodger wrote: > The tables in Docutils are CALS tables, which are well documented on the web. From docutils.dtd: > This DTD uses the Exchange subset of the CALS-table model (OASIS > Technical Memorandum 9901:1999 "XML Exchange Table Model DTD", > http://www.oasis-open.org/html/tm9901.htm). OK. Does <!ENTITY % tbl.tgroup.mdl "colspec*,thead?,tbody"> mean that colspecs are optional? If yes, is it a bug if a Docutils writer depends on colspecs? Günter |
From: David G. <go...@py...> - 2015-04-16 16:02:10
|
On Wed, Apr 15, 2015 at 6:10 PM, Guenter Milde <mi...@us...> wrote: > On 2015-04-14, David Goodger wrote: > >> The tables in Docutils are CALS tables, which are well documented on the web. From docutils.dtd: > >> This DTD uses the Exchange subset of the CALS-table model (OASIS >> Technical Memorandum 9901:1999 "XML Exchange Table Model DTD", >> http://www.oasis-open.org/html/tm9901.htm). > > OK. > > Does > > <!ENTITY % tbl.tgroup.mdl "colspec*,thead?,tbody"> > > mean that colspecs are optional? In the XML Exchange Table Model DTD, yes, colspec elements are optional. In the case of the current Docutils use of that model, no, colspec elements are not optional. I don't know how the recent move towards auto-column-widths affects this though. To document the requirement, we could add the following line to docutils.dtd in the table model customization section: <!ENTITY % tbl.tgroup.mdl "colspec+,thead?,tbody"> But this is such a minor, nit-picky thing that I don't see the point. I don't know if docutils.dtd has ever been used for anything other than documentation. And docutils.dtd is not being maintained. For example, the recent addition of a "colwidths" attribute (values of "given" or "auto") to the tgroup element is not documented there or anywhere else (e.g. doctree.txt). So if you choose to correct this error, please know that you're taking on a larger task, because who knows how many other omissions there are. > If yes, is it a bug if a Docutils writer depends on colspecs? Tables in a Docutils doctree should always contain colspec elements. It would be a bug for tables to be produced without colspec elements. Again, this is modulo any auto-column-widths changes. -- David Goodger <http://python.net/~goodger> |