Hello -
For my C code documentation, I like links to code (function names, struct
names, etc.) to look like code, i.e., be in a fixed-width font. I originally
put such links inside either `` (backticks) or <code></code> manually, but
that’s tedious. Since Doxygen allows tweaking of CSS via
HTML_EXTRA_STYLESHEET, I thought I’d try that.
By inspecting the generated HTML, I discovered that Doxygen uses the “el” HTML
class for links, e.g.:
<a class="el" href="structc__ast__pair.html">c_ast_pair_t</a>
The default CSS for “el” is:
a.el {
font-weight: bold;
}
so I just made it:
a.el {
font-family: monospace, fixed;
font-weight: bold;
}
instead. This works for the most part, but there are a couple of problems:
1. Doxygen also uses “el” for links to things that aren’t code which means
things that aren’t code end up using a fixed-width font — which isn’t what I
want.
2. If I use \ref with an alternate title like:
\ref c_ast_pair_t “AST pair”
then the text “AST pair” is fixed-width when it shouldn’t be.
So, ideally Doxygen should:
1. Use a specific CSS “code class" for things that are code and nothing else.
2. When using \ref to something that is code with an alternate title, do NOT
use the “code class”, i.e., providing an alternate title should suppress using
the “code class” and the generated HTML <a href> link will be class-less so the
text for the link just blends into the surrounding text.
Or: is there another way to get what I want (all code and links to code, but
nothing else, to be fixed-width)?
- Paul
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
