Re: [Docutils-users] problem with image and section header

[Tom R. <Tom...@po...>]

[footnotes follow .sig]

Tom Roche[1]
>> I have a reST doc[2] with an image followed by a section header. I want the header to render below the image, but it sometimes renders {to the right of, on the same line as} the image[3]. How to fix?

Günter Milde[4]
> The recommended way for this is to style the output with CSS[, which] may become hard if the processing is done somewhere on the net,

That is indeed the target.

> You could define CSS rules in the source in an "raw" role. However, this is not nice,

... and moreover I know from previous experience[5] that Bitbucket ignores reST directive='raw'.

>> I'm not seeing options for this @ http://docutils.sourceforge.net/docs/ref/rst/directives.html#image : am I missing something?

> There is no provision in rST regarding this layout detail.

>> Alternatively, is this something for which I should make a DocUtils feature request? If so, where?

your assistance is appreciated, Tom Roche <Tom...@po...>

[1]: https://sourceforge.net/p/docutils/mailman/message/34938193/
[2]: The file's name=Home.rst; its full text can be seen by either

* `git clone`ing its Bitbucket (BB) repository, with either

gi...@bi...:epa_n2o_project_team/aqmeii-na_n2o.git/wiki
https://tl...@bi.../epa_n2o_project_team/aqmeii-na_n2o.git/wiki

* downloading the copy I uploaded to

https://drive.google.com/file/d/0BzDAFHgIxRzKcC1YNzFpQk0tLUk/view?usp=sharing

The relevant text (IIUC) is at the top of the file, through the second section header='overview'.

[3]: Bitbucket currently renders Home.rst as I want (see

https://bitbucket.org/epa_n2o_project_team/aqmeii-na_n2o/wiki/Home#rst-header-open-source-notice

) with an image (the AGPL3 badge) above the section header='overview', as if they were on separate lines of a page. By contrast, `restview`

https://mg.pov.lt/restview/

which seems more DocUtils-compliant, renders the image to the *left* of the header='overview', as if they were on the same line of the page: see, e.g.,

https://drive.google.com/file/d/0BzDAFHgIxRzKNEpKOWV6RVdDRnc/view?usp=sharing

[4]: https://sourceforge.net/p/docutils/mailman/message/34938375/
[5]: https://sourceforge.net/p/docutils/mailman/message/34894260/