[Bf-docboard] Figure image inconsistency

[Glen Larsen]

Some figure:: directives specify a scaling option (with :width:, :height:,
or :scale:), some do not. There is a distinct difference between this:
without a scaling option sphinx will generate a simple IMG directive, with
scaling a CLASS directive is used with an HREF to the image.

Good examples of this are the first two large Example images in Compositing
-> Node Types -> Converter Nodes -> Combine/Separate Nodes. The first has
scale specified to 600px, the second no scale.

Normally, I would advocate the second un-scaled figure --- it fills the
page width which makes it look nicer. The problem is that, even on a large
workstation screen, I cannot read the textual detail of the nodes. Because
the first image contains an HREF to the image, I can simply click on it to
get the full image. I cannot do that on the second (non-scaled image) and
must resort to browser zooming.

For usability we should do this one way or the other. The markup style
guide gives good information regarding image creation but makes no
recommendation on scaling.

-glen
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.blender.org/pipermail/bf-docboard/attachments/20171224/fd23e82a/attachment.html>