Hello Ed,

now, looking again at your post:

> jira-objects.txt (compressed to jira-objects.inv)
> # Sphinx inventory version 2
> # Project: JIRA
> # Version: 
> # The remainder of this file is compressed using zlib.
> ABC-1234 std:label 1 #$ This is an example JIRA ticket reference. 
>
> conf.py includes this option:
> intersphinx_mapping = {'jira':
> ('https://example.atlassian.net/browse', 'jira-objects.inv')}
>
> Within a page I then tried a number of ways to reference ABC-1234 with
> no luck.
>
> Example 1:
> Reference to :ref:`ABC-1234`.


You almost got it right. What you have to write to create the link:

① :ref:`...`   <- this is the correct textrole.
② :ref:`ABC-123`  <- The label is correct. Would work if the label was
defined in the same project
③ :ref:`jira:ABC-123` <- This will really work. Prefix the label with
'jira:', because you chose 'jira' in the Intersphinx mapping

Line ③ will have 'This is an example JIRA tecket reference" as linktext.

④ :ref:`Feature 123 <jira:ABC-123>` will work and have linktext 'Feature
123'

Note:

- case of the label doesn't matter
- case of the prefix ('jira') may matter - I don't know by heart
- Don't forget one or more blanks before the '<' in ④.

Let me know if that works!

-- 
Martin Bless

-- 
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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/3bbbff01-49f5-649f-e773-a253aa904879%40gmail.com.

Reply via email to