[Qgis-community-team] more rst conventions questions

[Otto Dassau]

Am Fri, 4 May 2012 11:58:30 +0200
schrieb Tim Sutton <tim at linfiniti.com>:

> Hi
> 
> On Fri, May 4, 2012 at 11:41 AM, Otto Dassau <dassau at gbd-consult.de> wrote:
> 
> > Hi,
> >
> > for 1.
> >
> > Until now we used to add a small hint to the figure caption, e.g. (KDE)
> > or (OSX) or (GNOME) .... Since we often work on QGIS Versions that are
> > not installed on the OSGeo Live DVD I am not sure, if it makes sense to
> > use that.
> >
> > for 3.
> >
> > This is a good idea. As for http://qgis.org/pyqgis-cookbook/ we could add
> > a
> > http://qgis.org/user-guide/. I can do that the next days.
> >
> >
> Once we get it in a standardised format (I didnt look maybe it already is)
> we can simply publish it to http://readthedocs.org and there is a commit
> hook in github that will trigger a rebuild with each push.

should we do the same for the pyqgis-cookbook, etc?

Regards
Otto

> Regards
> 
> Tim
> 
> 
> > Regards
> > Otto
> >
> > Am Fri, 4 May 2012 17:21:20 +0800
> > schrieb maning sambale <emmanuel.sambale at gmail.com>:
> >
> > > Hi,
> > >
> > > I have been editing several rst docs in the EN userguide the past
> > > week.  A couple of questions before continuing:
> > >
> > > 1. Updating screenshots - many of the screenshots needs to be updated
> > > since there are GUI changes made.
> > >   - What should be default OS for screenshots? Depending on the OS,
> > > some GUI appear different (especially with OSX).
> > >      I'm thinking we use Xubuntu/OSGeo Live DVD as the base OS for
> > > creating screenshots, this way, we have consistent
> > >      look of the screenshots within the user guide.
> > >
> > > 2. File location of icons and image screenshots - Each chapter has its
> > > own img directory for screenshots and icons,
> > >     however, the conf.py [0] contains global image aliases for some
> > > icons located in the user_guide/img directory.
> > >     - Is it possible to include all the commonly used icons in
> > > conf.py's rst_epilog so that these are available in all the chapters.
> > >       I am only using the English version of QGIS so, I'm not sure
> > > whether icons are different with the other languages.
> > >
> > > 3. Compiled rst available - do we have a regular build of the rst
> > > documentation available already? I do compile my own, but it would be
> > > good
> > >     if we have a daily build available in the qgis.org so that we can
> > > start linking QGIS questions to sections of the manual.  Even as a
> > > working draft.
> > >
> > > [0]
> > >
> > https://github.com/qgis/QGIS-Documentation/blob/master/user_guide/conf.py#L90
> > _______________________________________________
> > Qgis-community-team mailing list
> > Qgis-community-team at lists.osgeo.org
> > http://lists.osgeo.org/mailman/listinfo/qgis-community-team