[docs] [issue16331] Add a version switcher to python docs site

Yury Selivanov report at bugs.python.org
Fri Oct 26 19:34:21 CEST 2012


New submission from Yury Selivanov:

This patch adds a dropdown to python documentation top toolbar:
https://dl.dropbox.com/u/21052/python/p3_doc_dd.png

This patch version is for python 3.3 & 3.4 docs theme, but I can quickly make patches for 3.2-style and below.

JavaScript that monitors dropdown events is smart enough to:

1) Redirect users to the same documentation section, i.e. if the user is on 'atexit' module doc page for 3.3, and decides to switch to '2.7', he'll see 'atexit' module doc page for 2.7

2) Before making a redirect, is checks that the doc page exists for the selected python version, and if not, then it simply redirects to 'http://docs.python.org/{version}'

3) Users with JS disabled will see a plain-text current version (no drop down)

----------
assignee: docs at python
components: Documentation
files: py3_version_switch.patch
keywords: patch
messages: 173864
nosy: docs at python, georg.brandl, rhettinger, yselivanov
priority: normal
severity: normal
status: open
title: Add a version switcher to python docs site
versions: Python 3.1, Python 3.2, Python 3.3, Python 3.4
Added file: http://bugs.python.org/file27731/py3_version_switch.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16331>
_______________________________________


More information about the docs mailing list