Re: [Docutils-users] questions about fieldlists

[G. M. <mi...@us...>]

On 30.09.08, Matthias Teege wrote:

> I use REST with Plone and have questions about field list. I'm not sure
> if this are REST or Plone Problems.

> 1. If the fieldname is longer then 14 characters the column is rendered
> with colspan=2 and the value is rendered in the next row. Is it possible
> to set the width of the fieldname?

Yes (at least with rst2html.py):

Command line option:

  --field-name-limit=<level>
                        Specify the maximum width (in characters) for one-
                        column field names.  Longer field names will span an
                        entire row of the table used to render the field list.
                        Default is 14 characters.  Use 0 for "no limit".

Configuration file option:

  field-name-limit: 0
  # See http://docutils.sourceforge.net/docs/user/config.html

> 2. There is a colon set after the fieldname. Is it possible to supress
> this colon?

Yes, but not easily. There are 2 alternatives:

1. Use the html4strict writer from the sandbox_ with a customized
   style-sheet. (the default html4css2.css style-sheet in this sandbox
   project add the colon with::
   
    dt.field-name:after {
    content: ":"; 
    }

   Commenting or deleting this rule should suffice.
   
2. Write your own HTML writer that does not write the colons into the
   html source. You can use the html4strict writer as a template.


> 3. If I put a fieldlist after a fieldlist separated by a linefeed the
> are rendered as one table. 

This is normal rest behaviour: list items can be seperated by blank
lines (this improves readability for long or complex lists). In nested
lists, the blank line is even mandatory.

> I put comments between to get two tables. How do I separate fieldlist?

I suppose this is "the right way".

Günter


.. _sandbox: http://docutils.sourceforge.net/sandbox/README.html
.. (currently down)

.. _html4strict:
   http://svn.berlios.de/viewcvs/docutils/trunk/sandbox/html4strict/