diff options
author | Georg Brandl <georg@python.org> | 2014-01-12 17:01:22 +0100 |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2014-01-12 17:01:22 +0100 |
commit | b4c916811a5522976d4ae483230fe76296a38b4e (patch) | |
tree | 82c9f5c41d7299984c2f0bd3352be63d52c2bcc3 /doc/ext | |
parent | 280f2c665a9c687cf408b4209aee40045d2a2271 (diff) | |
download | sphinx-b4c916811a5522976d4ae483230fe76296a38b4e.tar.gz |
Closes #1174: Fix smart quotes being applied inside roles like :rst:role:`program` or :rst:role:`makevar`.
Diffstat (limited to 'doc/ext')
-rw-r--r-- | doc/ext/appapi.rst | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/doc/ext/appapi.rst b/doc/ext/appapi.rst index a6393d40..156dede8 100644 --- a/doc/ext/appapi.rst +++ b/doc/ext/appapi.rst @@ -199,10 +199,13 @@ the following public API: .. index:: pair: function; directive The reference node will be of class ``literal`` (so it will be rendered in a - proportional font, as appropriate for code) unless you give the *ref_nodeclass* - argument, which must be a docutils node class (most useful are - ``docutils.nodes.emphasis`` or ``docutils.nodes.strong`` -- you can also use - ``docutils.nodes.generated`` if you want no further text decoration). + proportional font, as appropriate for code) unless you give the + *ref_nodeclass* argument, which must be a docutils node class. Most useful + are ``docutils.nodes.emphasis`` or ``docutils.nodes.strong`` -- you can also + use ``docutils.nodes.generated`` if you want no further text decoration. If + the text should be treated as literal (e.g. no smart quote replacement), but + not have typewriter styling, use ``sphinx.addnodes.literal_emphasis`` or + ``sphinx.addnodes.literal_strong``. For the role content, you have the same syntactical possibilities as for standard Sphinx roles (see :ref:`xref-syntax`). |