add a local theme containing a customized sidebar

Author: seanjsong

README

@@ -3,5 +3,19 @@ Learning Linux C/C++ Programming from Scratch
 Prerequisite
 ============
 
-easy_install sphinx
+$ sudo apt-get install python-setuptools
+$ sudo easy_install sphinx
+
+Build
+=====
+
+$ make html
+$ make epub
+
+The build result will be generated under _build/html and _build/epub respectively.
+
+TODO
+====
+
+Generate images under images directory from dia files under dia directory automatically through Makefile, rather than manually.
 

conf.py

@@ -91,15 +91,15 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+html_theme = 'mytheme'
 
 # 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 = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
+html_theme_path = ['.']
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
@@ -131,7 +131,7 @@
 #html_use_smartypants = True
 
 # Custom sidebar templates, maps document names to template names.
-html_sidebars = { '**': ['localtoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html'] }
+html_sidebars = { '**': ['localtoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html', 'sidebarextra.html'] }
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.

en/preface.rst

@@ -14,7 +14,7 @@ So this is four years of college education vs. four months of vocational trainin
 
 .. crossreference for interpreter above
 
-Our training course is comprised of five sections::
+Our training course is comprised of five sections:
 
 #. Some basic Linux commands and operations. To be prepared for the next section, students will learn to do basic file and disk operations, work with an text editor and run a compiler.
 #. C programming. In this section students will gain a thorough understanding of C language syntax as well as the functioning of C compiler and linker.

images/normalize.py

@@ -0,0 +1,14 @@
+{#
+    default/layout.html
+    ~~~~~~~~~~~~~~~~~~~
+
+    Sphinx layout template for the default theme.
+
+    :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS.
+    :license: BSD, see LICENSE for details.
+#}
+{% extends "basic/layout.html" %}
+
+{% if theme_collapsiblesidebar|tobool %}
+{% set script_files = script_files + ['_static/sidebar.js'] %}
+{% endif %}

mytheme/layout.html

@@ -0,0 +1,19 @@
+<table border=0 cellspacing=0 style="color: white;">
+
+<tr><td>
+   请输入您的email订阅<a href="http://groups.google.com/group/learning-linux-c-cpp">本书的邮件列表</a><br/>
+   (Please enter your email to subscribe to <a href="http://groups.google.com/group/learning-linux-c-cpp">this book's mailing list</a>)<br/>
+   <form action="http://groups.google.com/group/learning-linux-c-cpp/boxsubscribe"><input type=text name=email><input type=submit name="sub" value="订阅(Subscribe)"></form>
+</td></tr>
+
+<tr><td><br/>关注<a href="http://weibo.com/sansoong">我的微博</a></td></tr>
+
+<tr><td><br/>Checkout the source from github: <a href="https://github.com/learning-linux-c-cpp/akabook">https://github.com/learning-linux-c-cpp/akabook</a></td></tr>
+
+<tr><td>
+   <br/>感谢您的慷慨捐赠！<br/>
+   Thanks for your generous donation!<br/>
+   <a href="http://me.alipay.com/songjinshan" target="_blank"><img src="_static/me.alipay.png" alt="捐赠"></a>
+</td></tr>
+
+</table>