Disable Sphinx SmartyPants in HTML output
authorStephen Kitt <steve@sk2.org>
Fri, 28 Jun 2019 18:38:41 +0000 (20:38 +0200)
committerJonathan Corbet <corbet@lwn.net>
Sun, 30 Jun 2019 21:30:34 +0000 (15:30 -0600)
The handling of dashes in particular results in confusing
documentation in a number of instances, since "--" becomes an
en-dash. This disables SmartyPants wholesale, losing smart quotes
along with smart dashes.

With Sphinx 1.6 we could fine-tune the conversion, using the new
smartquotes and smartquotes_action settings.

Signed-off-by: Stephen Kitt <steve@sk2.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/conf.py

index a502bae..3b2397b 100644 (file)
@@ -201,7 +201,7 @@ html_context = {
 
 # If true, SmartyPants will be used to convert quotes and dashes to
 # typographically correct entities.
-#html_use_smartypants = True
+html_use_smartypants = False
 
 # Custom sidebar templates, maps document names to template names.
 #html_sidebars = {}