sphinx-doc/sphinx

opening double quote followed by punctuation character converted to curly right quotation mark

Open

#580 opened on Jan 2, 2015

View on GitHub
 (3 comments) (0 reactions) (0 assignees)Python (5,625 stars) (1,985 forks)batch import
builder:htmlhelp wantedtype:bug

Description

Sphinx 1.0.5 incorrectly converts e.g.

   Is there an equivalent of C’s "?:" ternary operator?

to

   Is there an equivalent of C’s ”?:” ternary operator?

(Example taken from http://docs.python.org/dev/faq/programming.html#is-there-an-equivalent-of-c-s-ternary-operator )

Contributor guide

Tech stack
python
Domain
documentation
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
basic Pythonfamiliarity with Sphinx
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
40
Research direction
The bug is in Sphinx's smartquotes transformation. Investigate the handling of punctuation after opening double quotes in `sphinx/transforms/smartquotes.py` or similar. Check if the issue persists in current version and identify the exact code causing the replacement.