[Qgis-community-team] enumeration for figures

[Otto Dassau]

Hi, 

I would suggest, if we feel it is necessary to reference between rst files,
we use the chapter/Section/... as reference and not the figures. This way,
we only have 1 figure definition and keep it simple.

btw: I don't remember, if we ever referenced to figures from others files.

Would that be ok?

Regards
Otto

Am Wed, 17 Oct 2012 07:56:25 +0200
schrieb Diethard Jansen <diethard.jansen at gmail.com>:

> Hi,
> 
> Yesterday I have done this for all working_with vector/ogc/raster etc. and
> it looks great. However I found out there is a little disadvantage.
> Referring to figures from another rst document does not work anymore for
> html because the reference is not connected to the figure anymore. The
> solution is simple however.
> 
> Say in file file1.rst there is a reference to :ref:`figure_1` this will be
> replaced by the caption of the figure if the reference tag is just in front
> of the .. figure:: rst declaration not before the .. only:: rst
> declaration, then you will get a warning and a faulty reference.
> 
> I will solve them tomorrow and will include a comment on top of these
> figures with the warning:
> 
> .. do not change the order of reference-tag and only-tag, this figure has
> an external reference.
> 
> The only disadvantage is that you do not jump to the nice figure heading in
> those cases.
> 
> Regards, Diethard
> 
> 2012/10/16 Otto Dassau <dassau at gbd-consult.de>
> 
> > Hi Larissa and Diethard,
> >
> > Larissa, I saw your changes in qgis_browser/qgis_browser.rst and think we
> > should change all screenshots to your suggestion. What do you think? This
> > would then hopefully be the last big change for figures? Or is sth else
> > missing / not properly working?
> >
> > Regards
> > Otto
> >
> > Am Tue, 16 Oct 2012 10:23:24 +0200
> > schrieb Larissa Junek <junek at gbd-consult.de>:
> >
> > > Hi Diethard and Otto,
> > >
> > > using Diethards suggestion I found out that if we insert the expression
> > > later in case of linkage you are linked also to the headline of the
> > > figure:
> > >
> > > .. _figure_browser_import:
> > >
> > > .. only:: html
> > >
> > >    **Figure browser 1**
> > >
> > > .. figure:: /static/user_manual/qgis_browser/browser_import_shapes.png
> > >    :align: center
> > >    :width: 40em
> > >
> > >    Drag and drop shapefiles with QGIS browser |nix|
> > >
> > > This way you can call the reference and you will be linked to **Figure
> > > browser 1**.
> > > What do you think about my suggestion? If you agree with me I will
> > > insert it into the README.
> > > Kind regards, Larissa
> > >
> > > > Hi Diethard and Larissa,
> > > >
> > > > the solution for html and pdf figures works well I think. It is of
> > > > course again some work to adapt it, but I would suggest we change it.
> > > >
> > > > Regards
> > > > Otto
> > > >
> > > > Am Tue, 9 Oct 2012 23:02:29 +0200
> > > > schrieb Diethard Jansen <diethard.jansen at gmail.com>:
> > > >
> > > > > Hi,
> > > > >
> > > > > There is a directive for conditional output!
> > > > >
> > > > > .. only:: html
> > > > >
> > > > >    This text will only be printed in HTML not in PDF!!
> > > > >
> > > > > We can use this as follows:
> > > > >
> > > > > .. only:: html
> > > > >
> > > > >    Figure Subject 1
> > > > >
> > > > > .. _figure_subject_1
> > > > >
> > > > > .. figure:: /static/user_manual/subject/a_figure.png
> > > > >    :align: center
> > > > >    :width: 30em
> > > > >
> > > > >    This is the caption of a figure (not preceded anymore with
> > > > >    Figure Subject 1:)
> > > > >
> > > > > I am pretty sure this is a working solution but also a lot of work
> > > > > to change!
> > > > >
> > > > > I think I just have managed to finish putting all figures & icons
> > > > > back in the manual since the reconstruction of the manual which
> > > > > took place in Essen.
> > > > >
> > > > > Regards, Diethard Jansen
> > > > >
> > > > > 2012/10/9 Larissa Junek <junek at gbd-consult.de>
> > > > >
> > > > > > Hello Richard and all,
> > > > > >
> > > > > > I had a look a the build now and found a new issue.
> > > > > > Working on the pathes for the images I saw that the scripts
> > > > > > create a pdf with automatic numeration not only for the headlines
> > > > > > but also for the images. Now we have a doubled caption in there,
> > > > > > e.g.:
> > > > > >
> > > > > >  Figure 23.1: Figure Attributes 2: Field Calculator
> > > > > >
> > > > > > Figure Attributes 2 is the caption we inserted manually in the
> > > > > > rst-files, Figure 23.1. is created automatically.
> > > > > >
> > > > > > The problem is that we need the manually created caption for the
> > > > > > html where until now there's no enumeration neither for the
> > > > > > headlines nor for the images.
> > > > > > Will it be the best to use only a caption without a numeration
> > > > > > for the images? Or will there be another solution? This way we
> > > > > > don't have a numeration for the figures in html.
> > > > > >
> > > > > > Kind regards,
> > > > > > Larissa
> > > >
> > > > _______________________________________________
> > > > Qgis-community-team mailing list
> > > > Qgis-community-team at lists.osgeo.org
> > > > http://lists.osgeo.org/mailman/listinfo/qgis-community-team
> > >
> > >
> > >
> >
> >
> > --
> > Geoinformatik Büro Dassau - http://www.gbd-consult.de
> > FOSSGIS consulting , training , support  and analysis
> > Ackerstrasse 144c  ,  D - 40233 Düsseldorf  , Germany
> > Tel: +49-(0)211-47468178 , Mobil: +49-(0)171-4687540
> >
> > --
> > Community Advisor - QGIS Project Steering Committee
> > _______________________________________________
> > Qgis-community-team mailing list
> > Qgis-community-team at lists.osgeo.org
> > http://lists.osgeo.org/mailman/listinfo/qgis-community-team
> >


-- 
Geoinformatik Büro Dassau - http://www.gbd-consult.de
FOSSGIS consulting , training , support  and analysis
Ackerstrasse 144c  ,  D - 40233 Düsseldorf  , Germany
Tel: +49-(0)211-47468178 , Mobil: +49-(0)171-4687540

--
Community Advisor - QGIS Project Steering Committee