Andrea,
maybe you can solve your use case using the `class` and
`attribute` directives. You can use these directives even if it is not
about a Python class.
Something like this::
.. class:: AAA
This is an enumeration of bla bla...
.. attribute:: item1
To be used when bla bla
.. attribute:: item2
To be used when bla bla
And then you can refer to it as :attr:`AAA.item1`.
As an example, when I write :attr:`TradeTypes.sales` in my blog, then it
would link to
<http://lino-framework.org/api/lino.modlib.ledger.choicelists#lino.modlib.ledger.choicelists.TradeTypes.sales>.
That's admittedly not as lightweight as a bullet list, but when I had
this kind of situation, I was satisfied by the layout.
hth,
Luc
On 10/06/15 11:13, Andrea Cassioli wrote:
> 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]
> <mailto:[email protected]>.
> To post to this group, send email to [email protected]
> <mailto:[email protected]>.
> Visit this group at http://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
--
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.
