[Qgis-community-team] Updating images in Documentation

Yves Jacolin yjacolin at free.fr
Mon Jun 1 12:39:40 PDT 2015


Hello,


thanks for your answer about default path on english image, i didn't know 
that.

About my issu when building the doc is not important. I will try to fix it 
later.

Thanks,

Y.
Le lundi 1 juin 2015, 21:18:59 DelazJ a écrit :
> Hi
> Yves,That's weird. My PR just remove some localised screenshots and if I'm
> not wrong, english screenshots are supposed to be the default path. So that
> shouldn't raise an issue.
> Which documentation were you trying to build? 2.8? I can see that online
> Testing Documentation is already up to date.
> 
> And by the way, Thanks Richard for the "fix me" link at the bottom of the
> pages
> 
> 2015-06-01 14:13 GMT+02:00 Yves Jacolin <yjacolin at free.fr>:
> > Hello
> > 
> > I merged the 2 PR but I wondered if this not breaks picture path when
> > building
> > documentation?
> > 
> > I am building the doc in my laptop but I get some errors link to
> > jinja2glue.py
> > file.
> > 
> > Y.
> > 
> > On Monday, June 01, 2015 13:04:52 DelazJ wrote:
> > > Hi,
> > > Following this discussion, I opened an issue (
> > > https://github.com/qgis/QGIS-Documentation/issues/487) and now added
> > 
> > two PR
> > 
> > > (for 2.8 and master) that aim to remove from localized documentation all
> > > the outdated screenshots.
> > > If someone can merge them, it'd really help (generating QGIS2.8
> > > documentation with screenshots from 1.x version is not really good..)
> > > 
> > > Thanks...
> > > 
> > > 2015-03-09 17:57 GMT+01:00 Richard Duivenvoorde <richard at duif.net>:
> > > > On 09-03-15 17:41, Junior Delaz wrote:
> > > > > Thanks Richard, I think it's clear.
> > > > > My main "problem" is that we have in documentation many images from
> > > > > earlier releases.
> > 
> > http://docs.qgis.org/2.6/fr/docs/user_manual/working_with_vector/supported
> > 
> > > > _data.html#figure-vector-3
> > 
> > http://docs.qgis.org/2.6/fr/docs/user_manual/working_with_vector/vector_pr
> > 
> > > > operties.html#figure-symbology-2>
> > > > 
> > > > > ...
> > > > > and this concern most of the localized images, as they have been
> > 
> > added
> > 
> > > > > two years ago. Many things have changed since...
> > > > > 
> > > > > I think, instead of having wrong images in another language with the
> > > > > risk that may confuse the reader, it's better to keep english
> > > > > images.
> > > > > Then if i want to purge outdated images from the documentation, I
> > 
> > just
> > 
> > > > > have to find them in
> > 
> > https://github.com/qgis/QGIs-Documentation/tree/master/resources/otherlang
> > 
> > > > uagethanEN>
> > > > 
> > > > > and delete them. Right?
> > > > 
> > > > Yep, but even better, do it on the currently translated branch too
> > 
> > (that
> > 
> > > > is: manual_en_v2.6)
> > > > 
> > > > And this actually makes me think that I think we should actually
> > > > remove
> > > > ALL non-english resources from the master(!) branch. Just like we do
> > > > with the translation (i18n folder)...
> > > > 
> > > > Because I think IF people create localized screenshot, they will
> > > > probably do that in the translation branch we have at that moment.
> > > > In this case it is always clear where the 'latest' localized images
> > > > are
> > > > (on the 'translation' branch).
> > > > 
> > > > Right?
> > > > 
> > > > Regards,
> > > > 
> > > > Richard

-- 
Yves Jacolin


More information about the Qgis-community-team mailing list