merge with 0.6

CHANGES

@@ -49,6 +49,10 @@ Release 1.0 (in development)
 Release 0.6.4 (in development)
 ==============================
 
+* #293: line blocks are styled properly in HTML output.
+
+* #285: make the ``locale_dirs`` config value work again.
+
 * #303: ``html_context`` values given on the command line via ``-A``
   should not override other values given in conf.py.
 

EXAMPLES

@@ -6,9 +6,11 @@ experimenting with using it for their documentation.  If you like to be
 included, please mail to `the Google group
 <http://groups.google.com/group/sphinx-dev>`_.
 
+* Advanced Generic Widgets: http://xoomer.virgilio.it/infinity77/AGW_Docs/index.html
 * Applied Mathematics at the Stellenbosch University: http://dip.sun.ac.za/
 * APSW: http://apsw.googlecode.com/svn/publish/index.html
 * ASE: https://wiki.fysik.dtu.dk/ase/
+* Blender: http://www.blender.org/documentation/250PythonDoc/
 * boostmpi: http://documen.tician.de/boostmpi/
 * Calibre: http://calibre.kovidgoyal.net/user_manual/
 * Chaco: http://code.enthought.com/projects/chaco/docs/html/
@@ -86,6 +88,7 @@ included, please mail to `the Google group
 * SymPy: http://docs.sympy.org/
 * tinyTiM: http://tinytim.sourceforge.net/docs/2.0/
 * The Wine Cellar Book: http://www.thewinecellarbook.com/doc/en/
+* Total Open Station: http://tops.berlios.de/
 * TurboGears: http://turbogears.org/2.0/docs/
 * VOR: http://www.vor-cycling.be/
 * WebFaction: http://docs.webfaction.com/
@@ -94,3 +97,5 @@ included, please mail to `the Google group
 * WTForms: http://wtforms.simplecodes.com/docs/
 * Zope 3: e.g. http://docs.carduner.net/z3c-tutorial/
 * zc.async: http://packages.python.org/zc.async/1.5.0/
+
+.. XXX maybe regroup by interesting features used?

doc/ext/math.rst

@@ -191,10 +191,10 @@ value:
    JSMath.  There is no default.
 
    The path can be absolute or relative; if it is relative, it is relative to
-   the root of the built docs.
+   the ``_static`` directory of the built docs.
 
    For example, if you put JSMath into the static path of the Sphinx docs, this
-   value would be ``_static/jsMath/easy/load.js``.  If you host more than one
+   value would be ``jsMath/easy/load.js``.  If you host more than one
    Sphinx documentation set on one server, it is advisable to install jsMath in
    a shared location.
 

doc/extensions.rst

@@ -61,8 +61,8 @@ There are several extensions that are not (yet) maintained in the Sphinx
 distribution.  The `Wiki at BitBucket`_ maintains a list of those.
 
 If you write an extension that you think others will find useful, please write
-to the project mailing list (sphinx-dev@googlegroups.com) and we'll find the
+to the project mailing list (`join here <http://groups.google.com/group/sphinx-dev>`_)
-proper way of including or hosting it for the public.
+and we'll find the proper way of including or hosting it for the public.
 
 .. _Wiki at BitBucket: http://www.bitbucket.org/birkenfeld/sphinx/wiki/Home
 

sphinx/builders/__init__.py

@@ -186,7 +186,7 @@ class Builder(object):
                     if self.translator is None:
                         self.translator = trans
                     else:
-                        self.translator._catalog.update(trans.catalog)
+                        self.translator._catalog.update(trans._catalog)
                 except Exception:
                     # Language couldn't be found in the specified path
                     pass

sphinx/builders/html.py

@@ -664,7 +664,8 @@ class StandaloneHTMLBuilder(Builder):
                    baseuri=self.get_target_uri(pagename)):
             if not resource:
                 otheruri = self.get_target_uri(otheruri)
-            return relative_uri(baseuri, otheruri)
+            uri = relative_uri(baseuri, otheruri) or '#'
+            return uri
         ctx['pathto'] = pathto
         ctx['hasdoc'] = lambda name: name in self.env.all_docs
         ctx['customsidebar'] = self.config.html_sidebars.get(pagename)

sphinx/environment.py

@@ -931,7 +931,7 @@ class BuildEnvironment:
         """Return a TOC nodetree -- for use on the same page only!"""
         toc = self.tocs[docname].deepcopy()
         for node in toc.traverse(nodes.reference):
-            node['refuri'] = node['anchorname']
+            node['refuri'] = node['anchorname'] or '#'
         return toc
 
     def get_toctree_for(self, docname, builder, collapse):

sphinx/themes/agogo/static/agogo.css_t

@@ -44,6 +44,18 @@ a {
   float: right;
 }
 
+.line-block {
+    display: block;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.line-block .line-block {
+    margin-top: 0;
+    margin-bottom: 0;
+    margin-left: 1.5em;
+}
+
 h1, h2, h3, h4 {
   font-family: {{ theme_headerfont }};
   font-weight: normal;
@@ -257,7 +269,7 @@ div.footer .left {
 }
 
 
-/* Styles copied form basic theme */
+/* Styles copied from basic theme */
 
 /* -- search page ----------------------------------------------------------- */
 

sphinx/themes/basic/static/basic.css

@@ -332,6 +332,18 @@ dl.glossary dt {
     background-color: #ffa
 }
 
+.line-block {
+    display: block;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.line-block .line-block {
+    margin-top: 0;
+    margin-bottom: 0;
+    margin-left: 1.5em;
+}
+
 /* -- code displays --------------------------------------------------------- */
 
 pre {

sphinx/themes/scrolls/static/style.css_t

@@ -396,3 +396,15 @@ span.highlight {
 #toc ul li {
     margin: 2px 0 0 0;
 }
+
+.line-block {
+    display: block;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.line-block .line-block {
+    margin-top: 0;
+    margin-bottom: 0;
+    margin-left: 1.5em;
+}

sphinx/themes/traditional/static/traditional.css

@@ -636,6 +636,18 @@ tt.xref, a tt {
 
 .footnote:target  { background-color: #ffa }
 
+.line-block {
+    display: block;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.line-block .line-block {
+    margin-top: 0;
+    margin-bottom: 0;
+    margin-left: 1.5em;
+}
+
 h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
     background-color: transparent;
 }