Message 288120 - Python tracker

➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author	cocoatomo
Recipients	JDLH, cocoatomo, docs@python, jaysinh.shukla, methane, ncoghlan
Date	2017-02-19.08:35:28
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1487493328.94.0.30441064939.issue29520@psf.upfronthosting.co.za>
In-reply-to

Content
As for CPython documents, these uses only one assignment statement (``{% set ... %}``) [1]_, one h1 element and one p element [2]_ of defindex.html. These fragments are used to generate following sentences:: Python 3.6.0 documentation Welcome! This is the documentation for Python 3.6.0, last updated Feb 19, 2017. .. [1] https://github.com/sphinx-doc/sphinx/blob/8ecd7ff08249739bbc6d900527fe9306592456ab/sphinx/themes/basic/defindex.html#L11 .. [2] https://github.com/sphinx-doc/sphinx/blob/8ecd7ff08249739bbc6d900527fe9306592456ab/sphinx/themes/basic/defindex.html#L13-L18 Therefore, I suggest that we should make indexcontent.html extend layout.html directly and insert the jinja2 code into indexcontent.html in order to generate the sentences above (which is much the same option as mixture of JDLH's option 1 and 3). After I wrote this comment, I notice inada.naoki had created `pull request #165 <https://github.com/python/cpython/pull/165>`_.

As for CPython documents, these uses only one assignment statement (``{% set ... %}``) [1]_, one h1 element and one p element [2]_ of defindex.html.
These fragments are used to generate following sentences::

   Python 3.6.0 documentation

   Welcome! This is the documentation for Python 3.6.0, last updated Feb 19, 2017. 

.. [1] https://github.com/sphinx-doc/sphinx/blob/8ecd7ff08249739bbc6d900527fe9306592456ab/sphinx/themes/basic/defindex.html#L11

.. [2] https://github.com/sphinx-doc/sphinx/blob/8ecd7ff08249739bbc6d900527fe9306592456ab/sphinx/themes/basic/defindex.html#L13-L18


Therefore, I suggest that we should make indexcontent.html extend layout.html directly and insert the jinja2 code into indexcontent.html in order to generate the sentences above
(which is much the same option as mixture of JDLH's option 1 and 3).

After I wrote this comment, I notice inada.naoki had created `pull request #165 <https://github.com/python/cpython/pull/165>`_.

History
Date	User	Action	Args
2017-02-19 08:35:29	cocoatomo	set	recipients: + cocoatomo, ncoghlan, methane, docs@python, jaysinh.shukla, JDLH
2017-02-19 08:35:28	cocoatomo	set	messageid: <1487493328.94.0.30441064939.issue29520@psf.upfronthosting.co.za>
2017-02-19 08:35:28	cocoatomo	link	issue29520 messages
2017-02-19 08:35:28	cocoatomo	create