[Live-demo] Re: overview images?

[Jody Garnett]

I am not up with the limitations on the different implementations of sphinx; if possible I would like to steer towards
a subset that works for everyone.  The various builders do not support several aspects of RST and we will 
learn over time what does not work.

As an example the latex build cycle does not allow bullet points in tables.

Jody

On 02/08/2010, at 1:13 PM, Hamish wrote:

> Jody wrote:
>> Sorted out the issue; depending on the version of sphinx used the use of :
>> 
>> .. image:: images/screenshots/1024x768/udig-overview.png
>>  :scale: 50 %
>>  :alt: udig workshop
>>  :align: right
>> 
>> Will result in a warning and the image won't be used.
>> 
>> Simply remove the "%" and everything will work...
>> 
>> .. image:: images/screenshots/1024x768/udig-overview.png
>>  :scale: 50
>>  :alt: udig workshop
>>  :align: right
>> 
>> If this change can be made to the RST files everything
>> should be fine.
> 
> fwiw the version in Ubuntu 10.04 doesn't mind the "%" sign, and the "%"
> sign is officially optional in the reSt spec. (I've no idea about the
> timing, I suspect that sphinx is playing catch up instead of reSt adding
> new features, but that's just a guess)
> 
> Rather than removing the % signs in svn, I suggest if you want to try
> running the sphinx build outside of the xU 10.04 environment that you
> strip away those % manually+locally:
> 
>  cd doc/overview
>  sed -i -e 's/:scale:\([^%]*\) %/:scale:\1/' *.rst                          
> 
> 
> 
> regards,
> Hamish
> 
> 
> 
>