Guenter, You are right it works 'silently'
I confess that I have dificulties understanding the docs. I find the mentions to 'reference' and 'target' very confusing. To me, I take a bow and an arrow and shoot to the target. So the 'target' is clearly the destination and the 'arrow' the action carrier (the click in our case). To me docs seam to mean the inverse, so I'm always confused when reading them. But thanks again (I'll have one or two more questions next week) Joaquim Quarta-feira, 20 de Março de 2013 20:23:18 UTC, Guenter Milde escreveu: > > On 2013-03-20, J Luis wrote: > > >> > Yes, I have duplicate target names on purpose. I need them. Why being > >> > warned about it as if I was doing something wrong? > > >> Usually an explicit target is inserted to be referenced using their > name. > >> Duplicate target names make it impossible to use them for this purpose > >> without ambiguity. What do you need these targets for? Maybe you can > use > >> `anonymous targets`__ or some other rst construct instead? > > >> __ > >> > http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#anonymous-hyperlinks > > > > > Sorry, but don't see how that can help on this. What I'm doing is to > have a > > table in one document that refers to many other different html files, > and > > because I don't want to create a different target for each call, I do it > > this way which causes all those warnings. > > > > +------------------------------------------------+---------------------------------------------------------------------+ > > > >| **grdmath** `(...) <grdmath.html>`_ | Mathematical > operations > > on grid files | > > > +------------------------------------------------+---------------------------------------------------------------------+ > > > >| **grdvolume** `(...) <grdvolume.html>`_ | Calculate volumes > under > > a surface within specified contour | > > > +------------------------------------------------+---------------------------------------------------------------------+ > > > > But this could easily be solved via anonymous links. With:: > > **grdmath** `(...) <grdmath.html>`__ Mathematical ... > **grdvolume** `(...) <grdvolume.html>`__ Calculate ... > > (watch the double underscore) the warnings go away. > > With two trailing underscores, the reference and target are both > anonymous, and the target cannot be referred to again. These are > "one-off" hyperlinks. For example:: > > `RFC 2396 <http://www.rfc-editor.org/rfc/rfc2396.txt>`__ and `RFC > 2732 <http://www.rfc-editor.org/rfc/rfc2732.txt>`__ together > define the syntax of URIs. > > Equivalent to:: > > `RFC 2396`__ and `RFC 2732`__ together define the syntax of URIs. > > __ http://www.rfc-editor.org/rfc/rfc2396.txt > __ http://www.rfc-editor.org/rfc/rfc2732.txt > > -- > http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#embedded-uris > > > > G?nter > > > > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users?hl=en. For more options, visit https://groups.google.com/groups/opt_out.
