Remove index.html template and use markup in index.txt instead.

Using reStructuredText to build the front page is a bit easier to maintain.

doc/source/_templates/index.html

@@ -1,88 +0,0 @@
-{% extends "layout.html" %}
-{% set title = 'Home' %}
-{% block body %}
-
-   <h1>{{ docstitle }}</h1>
-   <p>This <a href="http://scikits.appsport.com">SciKit</a> is an
-   image processing toolbox for <a href="http://www.scipy.org">SciPy</a>.</p>
-
-   <h2>Sections</h2>
-   <table class="contentstable" align="center">
-      <tr valign="top"><td width="50%">
-      <p class="biglink">
-         <a class="biglink" href="{{ pathto('overview') }}">
-            Overview</a><br/>
-         <span class="linkdescr">
-            Introduction to {{project}}.
-         </span></p>
-
-      <p class="biglink">
-         <a class="biglink" href="{{ pathto('install') }}">
-            Installation Steps</a><br/>
-         <span class="linkdescr">
-            How to install {{project}}.
-        </span></p>
-
-      <p class="biglink">
-        <a class="biglink" href="{{ pathto('contribute') }}">
-            Contribute</a><br/>
-        <span class="linkdescr">
-            Take part in development.
-        </span></p>
-
-   </td><td width="50%">
-
-    <p class="biglink">
-         <a class="biglink" href="{{ pathto('api/api') }}">
-             API Reference</a> (<a href="{{ pathto('api_changes')
-             }}">changes</a>)<br/>
-         <span class="linkdescr">
-             Documentation for the functions included in {{project}}.
-         </span></p>
-
-     <p class="biglink">
-         <a class="biglink" href="{{ pathto('user_guide') }}">
-            User Guide</a><br/>
-         <span class="linkdescr">
-             Usage guidelines.
-         </span></p>
-
-     <p class="biglink">
-         <a class="biglink" href="{{ pathto('license') }}">
-            License Info</a><br/>
-         <span class="linkdescr">
-             Conditions on the use and redistribution of this package.
-         </span></p>
-
-   </td></tr></table>
-
-   <h2>Indices and Tables</h2>
-
-   <table class="contentstable" align="center">
-      <tr valign="top"><td width="50%">
-      <p class="biglink">
-         <a class="biglink" href="{{ pathto('contents') }}">
-            Table of Contents</a><br/>
-         <span class="linkdescr">
-            Lists all sections and subsections.
-         </span></p>
-
-      <p class="biglink">
-         <a class="biglink" href="{{ pathto('search') }}">
-            Search Page</a><br/>
-         <span class="linkdescr">
-            Search this documentation.
-         </span></p>
-
-      </td><td width="50%">
-
-      <p class="biglink">
-         <a class="biglink" href="{{ pathto('genindex') }}">
-            Index</a><br/>
-         <span class="linkdescr">
-            All functions, classes, terms.
-         </span></p>
-
-    </td></tr></table>
-
-{% endblock %}

doc/source/conf.py

@@ -148,7 +148,7 @@ html_static_path = ['_static']
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.
-html_additional_pages = {'index': 'index.html'}
+# html_additional_pages = {}
 
 # If false, no module index is generated.
 #html_use_modindex = True

doc/source/index.txt

@@ -1,3 +1,38 @@
-.. toctree::
+*************
+scikits.image
+*************
 
-   /api/api
+This SciKit_ is an image processing toolbox for SciPy_.
+
+.. _SciKit: http://scikits.appspot.com
+.. _SciPy: http://www.scipy.org
+
+
+Sections
+========
+
+`Overview <overview.html>`_
+   Introduction to scikits.image.
+`Installation Steps <install.html>`_
+   How to install scikits.image.
+`Contribute <contribute.html>`_
+   Take part in development.
+`API Reference <api/api.html>`_ (`changes <api_changes.html>`_)
+   Documentation for the functions included in scikits.image.
+`User Guide <user_guide.html>`_
+   Usage guidelines.
+`License Info <license.html>`_
+   Conditions on the use and redistribution of this package.
+
+
+Indices and Tables
+==================
+
+`Table of Contents <contents.html>`_
+   Lists all sections and subsections.
+
+:ref:`search`
+   Search this documentation.
+
+:ref:`genindex`
+   All functions, classes, terms.