[Qgis-community-team] Fw: rst conversion: problem with references

[Larissa Junek]

On Tue, 17 Jul 2012 13:03:02 +0200
Larissa Junek <junek at gbd-consult.de> wrote:

> On Mon, 2 Jul 2012 14:02:35 +0200
> Paolo Corti <pcorti at gmail.com> wrote:
> 
> > On Mon, Jul 2, 2012 at 11:22 AM, Larissa Junek
> > <junek at gbd-consult.de> wrote:
> > > On Thu, 28 Jun 2012 16:26:18 +0200
> > > Paolo Corti <pcorti at gmail.com> wrote:
> > >
> > >> On Wed, Jun 27, 2012 at 4:03 PM, Larissa Junek
> > >> <junek at gbd-consult.de> wrote:
> > >> >
> > >> >
> > >> > Begin forwarded message:
> > >> >
> > >> > Date: Wed, 27 Jun 2012 15:59:57 +0200
> > >> > From: Larissa Junek <junek at gbd-consult.de>
> > >> > To: qgis-user at lists.osgeo.org
> > >> > Subject: rst conversion: problem with references
> > >> >
> > >> >
> > >> > Hi all,
> > >> >
> > >> > while the call for a reference works fine when I deal with
> > >> > figures, the link to a section doesn't work.
> > >> > For example in the plugins_gps.rst I defined:
> > >> >
> > >> > "... see section `defining-new-device`_" this is the call for
> > >> > the reference
> > >> > ".. _`defining-new-device`:" this is the reference
> > >> >
> > >> > Can somebody help? What did I do wrong.
> > >> >
> > >> > Kind regards,
> > >> > Larissa
> > >>
> > >> Larissa,
> > >> this is the correct syntax:
> > >>
> > >> a new type (see section :ref:`defining-new-device`).
> > >>
> > >> [......]
> > >>
> > >> .. _defining-new-device:
> > >>
> > >> Defining new device types
> > >> -------------------------
> > >>
> > >> cheers
> > >> p
> > >>
> > > Hi Paolo,
> > > the call for the reference still doesn't work.
> > > Maybe you have a look at the plugins_gps.rst I committed. I want
> > > to call the reference in the same page, not in another page.
> > > Therefore I thought that we might need another definition, like
> > > it is described in the README.rst
> > > I have this problem in other rst-files, too. Look forward to
> > > finding a solution.
> > > Cheers, Larissa
> > >
> > >
> > 
> > Hi Larissa
> > you need to leave an empty line just after the section declaration:
> > 
> > 
> > .. _defining-new-device:
> > (empty line here)
> > Defining new device types
> > -------------------------
> > 
> > cheers
> > p
> > 
> > 
> Hi Paolo,
> this convention works fine for sections as as well as for figures. I'd
> like to go on using it in the rst-files
> Can you document this subject in the README and the wiki? Then we all
> proceed the same way.
> Thanks,
> Larissa
> _______________________________________________
> Qgis-community-team mailing list
> Qgis-community-team at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/qgis-community-team

Hi Paolo and others,
how does the call for a reference work with tables? I checked out
several possibilities in the features_at_a_glance.rst but couldn't
find a solution that works fine e.g.:

 .. _table_figure_gps_tracking:

Live GPS tracking |nix| 

+----------------------------------+--------------------------------+-----------------------------+
| |gpstrack_main|                  |   |gpstrack_stren|
|    |gpstrack_polar|         |
+----------------------------------+--------------------------------+-----------------------------+
| (a) Position coordinates         | (b) GPS signal_strength        |
(c) GPS polar window        |
+----------------------------------+--------------------------------+-----------------------------+ 

Position coordinates
---------------------

|mActionToggleEditing| If the GPS is
receiving signals from satellites you will see your position in
latitude, longitude and elevation as you can see in
Figure :ref:`table_figure_gps_tracking`.

Can somebody help?

Kind regards,
Larissa