Re: [Docutils-develop] Forcing line breaks

[David G. <go...@us...>]

Adam Chodorowski wrote:
> Is there any way to force line breaks? Example of usage::
> 
>   :Name:    Adam Chodorowski
>   :Address: The Street
>             11111 The Town
>             The Country
>   :Phone:   +11-111111

If you're using a recent snapshot, it's already taken care of for you.
The "Address" field should produce the equivalent of a line_block
element, which is exactly what you describe.

I suspect that this is a document *fragment* you're showing us though.
In that case,

- You shouldn't really be using field lists in the first place.
  They're for extension syntax (docinfo & directive options).  I'll
  make this more explicit in the docs.  Perhaps a table or a
  definition list would be better?

- You could use the "line-block" directive:

      =======  =================
      Address  .. line-block::
                  The Street
                  11111 The Town
                  The Country
      =======  =================

> I looked through the documentation, but couldn't find any mention
> of it...

http://docutils.sf.net/spec/rst/directives.html#line-block

-- 
David Goodger  <go...@us...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/