<div dir="ltr"><div>Hi,<br></div>Richard, do you still plan on this? <br></div><div class="gmail_extra"><br><div class="gmail_quote">2015-06-09 10:29 GMT+02:00 DelazJ <span dir="ltr"><<a href="mailto:delazj@gmail.com" target="_blank">delazj@gmail.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>Hi,<br></div>I have no skills on this but I think it'll indeed be very helpful to 
display images while writing/updating documentation files in github<br>So, if it's easy to do and there is no side effect, +1 from me<div><div class="h5"><br><br><br><div class="gmail_extra"><div class="gmail_quote">2015-06-08 11:50 GMT+02:00 Richard Duivenvoorde <span dir="ltr"><<a href="mailto:richard@duif.net" target="_blank">richard@duif.net</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>
Hi List,<br>
<br>
if you look at the rst files in our documentation repo, you will only<br>
see text, NOT the images:<br>
<br>
<a href="https://github.com/qgis/QGIS-Documentation/blob/master/source/docs/training_manual/forestry/map_georeferencing.rst" target="_blank">https://github.com/qgis/QGIS-Documentation/blob/master/source/docs/training_manual/forestry/map_georeferencing.rst</a><br>
<br>
It appears that this is because we keep our images at /resource/en/...<br>
and copy them into /static during the build, to be able to have<br>
localized images....<br>
<br>
But after seeing the foss4glabs (markdown) sources in their github repo:<br>
<br>
<a href="https://github.com/FOSS4GAcademy/GST101FOSS4GLabs/blob/master/Module%205%20Lab/QGIS%202.8/Module%205%20Lab.md" target="_blank">https://github.com/FOSS4GAcademy/GST101FOSS4GLabs/blob/master/Module%205%20Lab/QGIS%202.8/Module%205%20Lab.md</a><br>
<br>
I wondered if it would also be possible that we showed our images in the<br>
rst-view of github.<br>
<br>
It indeed is easy: just copy the english (en) image directory to a<br>
directoy 'static' and all images which are referenced like:<br>
<br>
.. image:: /static/training_manual/forestry/f_1.png<br>
<br>
are viewable now at github (this is a temporary fork to be able to<br>
fiddle a little with this, note only foresty images are copied):<br>
<br>
<a href="https://github.com/rduivenvoorde/QGIS-Documentation/blob/master/source/docs/training_manual/forestry/map_georeferencing.rst" target="_blank">https://github.com/rduivenvoorde/QGIS-Documentation/blob/master/source/docs/training_manual/forestry/map_georeferencing.rst</a><br>
<br>
as you can see, it is only plain images you see, the images which are<br>
'shortcuts' from conf.py you will not see.<br>
<br>
But I think it is valuable to see the images immediately in Github, it<br>
makes spotting 'old' images much easier for doc writers/editors.<br>
<br>
The only reason the images currently are not in '/static' dir/tree is<br>
that we want the building process to be able to FIRST copy the<br>
english(original) images in the /static dir during build and THEN copy<br>
(optional) localized images over it during a localized build.<br>
<br>
But there is not reason to not put the english images already in the<br>
'/static' dir (so moving them from /resource/en/... to /static) and<br>
change some steps in the build proces<br>
<br>
So please comment on the following proposal:<br>
- we move the resource/en directory to /static<br>
- change some steps in the build scripts<br>
- we could do the same for the website...<br>
<br>
Comments?<br>
<br>
Regards,<br>
<br>
Richard Duivenvoorde<br>
_______________________________________________<br>
Qgis-community-team mailing list for organizing community resources such as documentation, translation etc..<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org" target="_blank">Qgis-community-team@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/qgis-community-team" target="_blank">http://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>
</blockquote></div><br></div></div></div></div>
</blockquote></div><br></div>