[issue27896] Allow passing sphinx options to Doc/Makefile

[Roundup Robot]

Roundup Robot added the comment:

New changeset 3b22c99535d0 by Victor Stinner in branch '2.7':
Issue #27896: Allow passing sphinx options to Doc/Makefile
https://hg.python.org/cpython/rev/3b22c99535d0

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue27896] Allow passing sphinx options to Doc/Makefile

[Roundup Robot]

Roundup Robot added the comment:

New changeset 87aced4a9cf5 by Victor Stinner in branch '3.5':
Issue #27896: Allow passing sphinx options to Doc/Makefile
https://hg.python.org/cpython/rev/87aced4a9cf5

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue27896] Allow passing sphinx options to Doc/Makefile

[STINNER Victor]

STINNER Victor added the comment:

I pushed your patch to the default branch (Python 3.7). Thanks Julien.

--
nosy: +haypo
resolution:  -> fixed
status: open -> closed
type:  -> enhancement
versions: +Python 3.7 -Python 3.6

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue27896] Allow passing sphinx options to Doc/Makefile

[Roundup Robot]

Roundup Robot added the comment:

New changeset 3884a7e3df1c by Victor Stinner in branch 'default':
Issue #27896: Allow passing sphinx options to Doc/Makefile
https://hg.python.org/cpython/rev/3884a7e3df1c

--
nosy: +python-dev

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue27896] Allow passing sphinx options to Doc/Makefile

[Julien]

New submission from Julien:

Context: 

 - Providing french translation to docs.python.rg/fr/: 
http://bugs.python.org/issue26546
 - Simplifying my first proposition of docsbuild-scripts: 
https://github.com/python/docsbuild-scripts/pull/1

Goals:

 - Simplify my modifications of docsbuild-scripts to make it more robust
 - Avoid executing external (~untrusted) Makefile on docs.python.org servers

To achieve this, I need the ``Doc/Makefile`` to be sufficient to build 
internationalized versions by passing sphinx options to it, I'd like to call, 
typically:

make autobuild-stable SPHINXOPTS='-D language=fr -D locale_dirs=./locale/'

Which work if `Doc/Makefile` don't erase but append to the `SPHINXOPTS` 
variable. Which is done by `allow_sphinxopts.diff`.

We may simplify it further by adding `locale_dirs` to `Doc/conf.py` which does 
not break the english build, but I'm not sure if it's of any interest.

We may abstract it further by accepting a new parameter like SPHINXLANG='fr', 
with a default of 'en', but in every case I think it's a good thing to allow 
passing arbitrary SPHINXOPTS so let's start with this?

--
assignee: docs@python
components: Documentation
files: allow_sphinxopts.diff
keywords: patch
messages: 273921
nosy: docs@python, sizeof
priority: normal
severity: normal
status: open
title: Allow passing sphinx options to Doc/Makefile
versions: Python 3.6
Added file: http://bugs.python.org/file44275/allow_sphinxopts.diff

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com