Well,
using sections and subsection is what I do now. 

My use case is that I have some material that does not really deserve a 
section but perhaps a bullet list. I's like to point to that list entries, 
for instance
.. _enumAAA

Enumerarion AAA
---------------------------

.. enumAAA.item1:

* item1 : blah

.. enumAAA.item2:

* item2 : blah

.. enumAAA.item3:

* item3 : blah


The I'like to write something like

Please use :ref:`enumAAA.item1`, but I may want to use a different label, 
for instance upper case. 


The point is that I generate part of the docs automatically and I may want 
to change the layout. The part of the docs I write by hand should be kept 
almost untouched.




On Friday, June 5, 2015 at 11:16:10 AM UTC+2, Andrea Cassioli wrote:
>
> Hi,
> this may seems a stupid question, but....here it is!
>
> I would like to set some links around my docs in arbitrary position, i.e. 
> not linked to sections. I would like to refer to them just by reference 
> name and let the displayed text be defined along the label. For instance
>
> .. _`label <linkname>` 
>
>
> and somewhere else, possibly a different file, say
>
>
> Blah blah, :ref:`linkname`
>
>
> I would then expect to get
>
> Blah blah, label
>
>
>
> The reason is that some names and label docs may change in the future and 
> I would like the docs to be robust. 
>
> Any ideas?
>

-- 
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.
For more options, visit https://groups.google.com/d/optout.

Reply via email to