[Docutils-develop] Re: r3231 - in trunk/docutils: HISTORY.txt docs/ref/docutils.dtd docs/ref/rst/directives.txt docutils/parsers/rst/directives/images.py docutils/writers/html4css1.py test/functional/expected/standalone_rst_html4css1.html test/functional/expected/standalone_rst_pseudoxml.txt test/functional/input/data/standard.txt test/test_parsers/test_rst/test_directives/test_figures.py

[Felix W. <Fel...@gm...>]

go...@us... wrote:

> Log:
>
> "image" directive: added checks for valid values of "align" option,
> depending on context.

What about adding a default align attribute for inline images?  The
current default behavior of the writers is "bottom", which seems quite
reasonable.  So why not make sure that all writers use the same behavior
and add an attribute align="bottom" as a default (and add that in the
documentation), so that ::

    .. |img| image:: foo.png

gives ::

    <substitution_definition names="img">
        <image align="bottom" alt="img" uri="foo.png">

> "figure" directive: added specialized "align" option and attribute on
> "figure" element.

Great.

> Added HTML support for ``align`` attribute on ``figure`` elements.

LaTeX support will be implemented in the new writer.  (The writer is
about 50% completed now.)

> Modified: trunk/docutils/docs/ref/rst/directives.txt
> ===================================================================
>  
> +``align`` : "left", "center", or "right"
> +    The horizontal alignment of the figure, allowing the image to
> +    float and have the text flow around it.  The specific behavior
> +    depends upon the browser or rendering software used.

What does the last sentence mean?  I think the behavior is quite
predictable, isn't it?

-- 
For private mail please ensure that the header contains 'Felix Wiemann'.

http://www.ososo.de/