Allow to specialize smart quotes in documentation translations

[JulienPalard]

BPO	31793
Nosy	@terryjreedy, @ezio-melotti, @merwok, @methane, @willingc, @JulienPalard
PRs	bpo-31793: Documentation: Specialize smart-quotes for japanese. #4006 [2.7] bpo-31793: Doc: Specialize smart-quotes for Japanese (GH-4006) #4324 [3.6] bpo-31793: Doc: Specialize smart-quotes for Japanese (GH-4006) #4325

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2018-11-05.21:20:59.395>
created_at = <Date 2017-10-15.09:49:48.934>
labels = ['3.7', 'docs']
title = 'Allow to specialize smart quotes in documentation translations'
updated_at = <Date 2018-11-05.21:20:59.394>
user = 'https://github.com/JulienPalard'

bugs.python.org fields:

activity = <Date 2018-11-05.21:20:59.394>
actor = 'mdk'
assignee = 'docs@python'
closed = True
closed_date = <Date 2018-11-05.21:20:59.395>
closer = 'mdk'
components = ['Documentation']
creation = <Date 2017-10-15.09:49:48.934>
creator = 'mdk'
dependencies = []
files = []
hgrepos = []
issue_num = 31793
keywords = ['patch']
message_count = 7.0
messages = ['304429', '304666', '305779', '305782', '305783', '305785', '314329']
nosy_count = 7.0
nosy_names = ['terry.reedy', 'ezio.melotti', 'eric.araujo', 'methane', 'docs@python', 'willingc', 'mdk']
pr_nums = ['4006', '4324', '4325']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue31793'
versions = ['Python 2.7', 'Python 3.6', 'Python 3.7']

[JulienPalard]

It would be great to allow each translation to specify their smart-quotes configuration, typically Japanese prefer no smart-quotes:

• smart quotes breaks API reference docsbuild-scripts#32

It's easily done by adding a Doc/docutils.conf file, I'm opening a PR.

[terryjreedy]

Patch is trivial two lines but needs review and merge from someone familiar with Sphinx stuff.

[Éric, https://docs.python.org/devguide/experts.html contains the invalid Eric.Araujo]

[methane]

New changeset 5a66c8a by INADA Naoki (Julien Palard) in branch 'master':
bpo-31793: Doc: Specialize smart-quotes for Japanese (GH-4006)
5a66c8a

[methane]

New changeset 47eaaa5 by INADA Naoki (Miss Islington (bot)) in branch '2.7':
bpo-31793: Doc: Specialize smart-quotes for Japanese (GH-4006)
47eaaa5

[methane]

New changeset 64f1049 by INADA Naoki (Miss Islington (bot)) in branch '3.6':
bpo-31793: Doc: Specialize smart-quotes for Japanese (GH-4006)
64f1049

[methane]

Thanks, Julien.

[JulienPalard]

Reopening as smart quotes is still a source of bugs in Japanese translation, see: python/docsbuild-scripts#32 (comment)