Re: problem with image and section header

[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 <[email protected]>

[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

[email protected]:epa_n2o_project_team/aqmeii-na_n2o.git/wiki
https://[email protected]/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/

------------------------------------------------------------------------------
Transform Data into Opportunity.
Accelerate data analysis in your applications with
Intel Data Analytics Acceleration Library.
Click to learn more.
http://pubads.g.doubleclick.net/gampad/clk?id=278785231&iu=/4140
_______________________________________________
Docutils-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/docutils-users

Please use "Reply All" to reply to the list.