Replace some XXXs on the index page.

Port the download page, still needs to be populated.

Doc-26/conf.py

@@ -46,3 +46,6 @@ use_smartypants = True
 
 # If true, '()' will be appended to :func: etc. cross-reference text.
 add_function_parentheses = True
+
+# The base URL for download links.
+download_base_url = 'http://docs.python.org/ftp/python/doc/'

Doc-3k/conf.py

@@ -47,3 +47,6 @@ use_smartypants = True
 
 # If true, '()' will be appended to :func: etc. cross-reference text.
 add_function_parentheses = True
+
+# The base URL for download links.
+download_base_url = 'http://docs.python.org/ftp/python/doc/'

sphinx/builder.py

@@ -441,6 +441,14 @@ class StandaloneHTMLBuilder(Builder):
         )
         self.handle_file('modindex.rst', modindexcontext, 'modindex')
 
+        # the download page
+        downloadcontext = dict(
+            pathto = relpath_to(self, self.get_target_uri('download.rst')),
+            current_page_name = 'download',
+            download_base_url = self.config['download_base_url'],
+        )
+        self.handle_file('download.rst', downloadcontext, 'download')
+
         # the index page
         indexcontext = dict(
             pathto = relpath_to(self, self.get_target_uri('index.rst')),

sphinx/templates/index.html

@@ -1,6 +1,5 @@
 {% extends "layout.html" %}
 {% set title = 'Overview' %}
-{% set current_page_name = 'index' %}
 {% set page_links = [
   (pathto('@rss/recent'), 'application/rss+xml', 'Recent Comments')
 ] %}

sphinx/templates/sidebar.html

@@ -28,13 +28,24 @@
           {% endif %}
           {% if current_page_name == "index" %}
             <h3>Download</h3>
-            <p>
-              XXX: Add download links here.
-            </p>
-            <h3>Old docs</h3>
-            <p>
-              XXX: Add links to old docs/essays/etc. here.
-            </p>
+            <p><a href="{{ pathto('download.rst')|e }}">Download these documents</a></p>
+            <h3>Other resources</h3>
+            <ul>
+              {# XXX: many of these should probably be merged in the main docs #}
+              <li><a href="http://www.python.org/doc/faq/">FAQs</a></li>
+              <li><a href="http://www.python.org/doc/intros/">Introductions</a></li>
+              <li><a href="http://www.python.org/doc/essays/">Guido's Essays</a></li>
+              <li><a href="http://www.python.org/doc/newstyle/">New-style Classes</a></li>
+              <li><a href="http://www.python.org/dev/peps/">PEP Index</a></li>
+              <li><a href="http://wiki.python.org/moin/BeginnersGuide">Beginner's Guide</a></li>
+              <li><a href="http://www.python.org/topics/">Topic Guides</a></li>
+              <li><a href="http://wiki.python.org/moin/PythonBooks">Book List</a></li>
+              <li><a href="http://www.python.org/doc/av/">Audio/Visual Talks</a></li>
+              <li><a href="http://www.python.org/doc/other/">Other Doc Collections</a></li>
+              <li>&nbsp;</li>
+              <li><a href="http://www.python.org/doc/versions/">Previous versions</a></li>
+              <li>&nbsp;</li>
+            </ul>
           {% endif %}
           {% if current_page_name != "search" %}
             <h3>{{ builder == 'web' and 'Keyword' or 'Quick' }} search</h3>