Use "agogo" HTML theme (with some modifications) for the Sphinx documentation. Do...

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@25823 dc483132-0cff-0310-8789-dd5450dbe970

diff --git a/doc/rst_source/_static/kerb.css b/doc/rst_source/_static/kerb.css
new file mode 100644 (file)
index 0000000..93c1340
--- /dev/null
+++ b/doc/rst_source/_static/kerb.css
@@ -0,0 +1,62 @@
+/*
+ * kerb.css
+ * ~~~~~~~~~~~
+ *
+ * Sphinx stylesheet -- modification to agogo theme.
+ *
+ */
+div.body {
+  padding-right: 2em;
+  text-align: left;
+}
+
+/* Page layout */
+
+div.header-wrapper {
+  background: #59121e;
+  border-bottom: 3px solid #2e3436;
+  border-top: 3px solid #2e3436;
+}
+
+/* Header */
+
+div.header div.right a {
+  color: #fcaf3e;
+  letter-spacing: .1em;
+  text-transform: lowercase;
+  float: right;
+}
+
+/* Content */
+
+div.document div.section h1 {
+  margin-bottom: 20px;
+  padding: 1px;
+  line-height: 130%;
+}
+
+div.document div.section dl {
+  margin-top: 15px;
+  margin-bottom: 5px;
+  padding: 1px;
+  text-align: left;
+}
+
+/* Sidebar */
+
+div.sidebar ul {
+  list-style-type: none;
+  padding: 1px;
+  margin-left: 1em;
+}
+
+div.sidebar li.toctree-l3.current a {
+  border-right: 5px solid #fcaf3e;
+  font-weight: bold;
+}
+
+/* Other body styles */
+
+dt:target, .highlighted {
+  background-color: #c1c1c1;
+}

diff --git a/doc/rst_source/_templates/layout.html b/doc/rst_source/_templates/layout.html
index 6abea67dd6e0d996dba0dd770de91e99cb9dfb3e..e0a6adec184be8a587352bb55c3442e84f382627 100644 (file)
--- a/doc/rst_source/_templates/layout.html
+++ b/doc/rst_source/_templates/layout.html
@@ -1,8 +1,49 @@
 {% extends "!layout.html" %}
+{% set rellinks = rellinks +
+                  [('index', 'Full Table of Contents', 'C', 'Contents')] +
+                  [('search', 'Enter search criteria', 'C', 'Search')] %}
+{% set css_files = css_files + ["_static/kerb.css"] %}
 
-{% block relbaritems %}
-   <li class="right" id="krb5">
-     <a  href="mailto:krb5-bugs.mit.edu?subject=Documentation" style="color: #990000;" >feedback</a> {{reldelim2}}
-   </li>
+{% block relbar1 %}
+   <div class="header-wrapper">
+       <div class="header" >
+           <div class="right" >
+              <a href="mailto:krb5-bugs@mit.edu?subject=Documentation__{{ title }}";>
+                  feedback </a>
+           </div>
+           <br/>
+       </div>
+   </div>
 {% endblock %}
 
+{%- block content %}
+    <div class="content-wrapper" style="width: 97%;">
+        <div class="content">
+           {%- block sidebar1 %}
+               <div class="sidebar"
+                    style="float: right; margin: 5px; background: #F9F9F9">
+                  <h2>{{ _('On this page') }} </h2>
+                  {{ toc }}
+                  <br/>
+                  <h2>{{ _('Table of contents') }}</h2>
+                  {{ toctree(collapse=true, maxdepth=-1, titles_only=true) }}
+                  <br/>
+                  <h4><a href="{{ pathto('index') }}">Full Table of Contents</a></h4>
+                  <h4>{{ _('Search') }}</h4>
+                  <form class="search" action="{{ pathto('search') }}" method="get">
+                      <input type="text" name="q" size="18" />
+                      <input type="submit" value="{{ _('Go') }}" />
+                      <input type="hidden" name="check_keywords" value="yes" />
+                      <input type="hidden" name="area" value="default" />
+                  </form>
+               </div>
+           {%- endblock %}
+           <div class="document">
+              {%- block document %}
+                  {{ super() }}
+              {%- endblock %}
+           </div>
+           <div class="clearer"></div>
+        </div>
+    </div>
+{% endblock %}

diff --git a/doc/rst_source/conf.py b/doc/rst_source/conf.py
index 89d22e3c9e591607035bff290d1b42cc0af2f643..45d6d546e1ecdd8a84a68ec14e0b241de18b1a00 100644 (file)
--- a/doc/rst_source/conf.py
+++ b/doc/rst_source/conf.py
@@ -42,7 +42,7 @@ master_doc = 'index'
 
 # General information about the project.
 project = u'MIT Kerberos'
-copyright = u'2011, MIT'
+copyright = u'2012, MIT'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -93,19 +93,19 @@ pygments_style = 'sphinx'
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 # html_theme = 'default'
-html_theme = 'sphinxdoc'
+html_theme = 'agogo'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-#html_theme_options = {}
+html_theme_options = { "headerbg":  "#59121e", "linkcolor": "#a63019", "footerbg":  "#59121e", "bgcolor": "#59121e" }
 
 # Add any paths that contain custom themes here, relative to this directory.
 #html_theme_path = []
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
-#html_title = None
+html_title = "MIT Kerberos Documentation"
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
 #html_short_title = None
@@ -149,7 +149,7 @@ html_use_smartypants = True
 html_split_index = True
 
 # If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
+html_show_sourcelink = False
 
 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
 #html_show_sphinx = True