Hi --

We've been using replacements to standardize references to downloadable 
PDFs and other media in our documentation, e.g.:

.. |whitepaper| replace:: :download:`our technical whitepaper 
</iReport-Technical-Whitepaper.pdf>`.

I've noticed that this results in some fairly involved markup being 
generated for the link text that is both verbose and IMHO unnecessarily 
uses monospace formatting in an old-school teletext tag:

<tt class="xref download docutils literal">
<span class="pre">our</span>
<span class="pre">technical</span>
<span class="pre">whitepaper</span>
</tt>

I can probably work around this with some CSS, but I was wondering if this 
was by design (using monospace fonts to label downloads) or a left-over 
from when most referenced downloads were likely OS filenames (vs Titles or 
other non-technical text)?

Similar, I'm curious if there is a benefit to splitting the title into 
separate spans vs one long one.

Ramon 

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To view this discussion on the web visit 
https://groups.google.com/d/msg/sphinx-dev/-/C48mA-pKe90J.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to