GNOME Bugzilla – Bug 330812
convert tables to variablelists
Last modified: 2011-04-24 15:53:08 UTC
At some point we need to convert the tables that are used in the user guide where variablelists would be clearer and simple. These are mainly in the description of UI elements of the preference tools. Low priority, something for someone with a wet afternoon who wants to play with XSTL or perl or something.
Created attachment 59452 [details] [review] changes table to variablelist for gconf command options Here is the first one: Convert the gconf command line options table to a variablelist Makes this section much more readable since the width isn't fixed... Let me know what you think. I've validated the system-admin-guide.xml after the patch. looks good
Yup, looks very good. We need to change the introductory paragraph and remove cross-reference and the heading. There is a problem with example commands getting justified, but that was present in the table already.
Created attachment 59717 [details] [review] another patch - same as last, except change <para> to <literallayout> to remove justification This is an updated patch to take care of the justification by replacing <para> with <literallayout> in the examples. Also a few other minor fixes.
Committed in HEAD. Leaving the bug open for other tables that should be converted to variable lists.
Created attachment 59734 [details] script to automate this This is a quick hack to do the conversion for you. It will only work on tables with two columns and assumes that the children of <entry> are valid children of <listitem> (which isn't always the case) The input file should be a file with <table> as the root element
Seems to work nicely. The biggest problem is that <entry> usually has a <para> in it, and <term> can't. Yelp doesn't mind, but xmllint does. If you have time to polish this, there's a few other minor points: could it work on <informaltable> root elements too? and could it either preserve indentation or create some? Something simple like one paragraph per varlistentry element would be fine, for example.
Brief update: I did some messing about with perl and I've got a text file of the converted tables. I just need to get round to replacing them all. Low priority.