From c2d131c42bd7108c4885589f4f7aba45ba53a17e Mon Sep 17 00:00:00 2001 From: "Casey W. Stark" Date: Fri, 21 Jan 2011 20:50:18 -0800 Subject: [PATCH] Fixed up the sphinx theme to make it look like the current mathjax.org theme. Should change some links and add the logo to _static to work well offline --- docs/rst/conf.py | 6 +- docs/rst/mjtheme/layout.html | 196 +++++++++++++++++++++++++++++++ docs/rst/mjtheme/page.html | 67 +++++++++++ docs/rst/mjtheme/static/mj.css_t | 156 ++++++++++++++++++++++++ 4 files changed, 421 insertions(+), 4 deletions(-) create mode 100644 docs/rst/mjtheme/layout.html create mode 100644 docs/rst/mjtheme/page.html diff --git a/docs/rst/conf.py b/docs/rst/conf.py index f766cbfa8..001b2529f 100644 --- a/docs/rst/conf.py +++ b/docs/rst/conf.py @@ -22,9 +22,7 @@ sys.path.append(os.path.abspath('.')) # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. -extensions = ['sphinx.ext.pngmath'] -#extensions = ['sphinx.ext.jsmath'] -#jsmath_path = 'mathjax/MathJax.js' +extensions = [] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] @@ -40,7 +38,7 @@ master_doc = 'index' # General information about the project. project = u'MathJax' -copyright = u'2010 Design Science' +copyright = u'2011 Design Science' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the diff --git a/docs/rst/mjtheme/layout.html b/docs/rst/mjtheme/layout.html new file mode 100644 index 000000000..b325b5fdb --- /dev/null +++ b/docs/rst/mjtheme/layout.html @@ -0,0 +1,196 @@ +{# + basic/layout.html + ~~~~~~~~~~~~~~~~~ + + Master layout template for Sphinx themes. + + :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + :license: BSD, see LICENSE for details. +#} +{%- block doctype -%} + +{%- endblock %} +{%- set reldelim1 = reldelim1 is not defined and ' »' or reldelim1 %} +{%- set reldelim2 = reldelim2 is not defined and ' |' or reldelim2 %} +{%- set render_sidebar = (not embedded) and (not theme_nosidebar|tobool) and + (sidebars != []) %} +{%- set url_root = pathto('', 1) %} +{%- if url_root == '#' %}{% set url_root = '' %}{% endif %} + +{%- macro relbar() %} +
+

{{ _('Navigation') }}

+ +
+{%- endmacro %} + +{%- macro sidebar() %} + {%- if render_sidebar %} +
+
+ {%- block sidebarlogo %} + {%- if logo %} + + {%- endif %} + {%- endblock %} + {%- if sidebars != None %} + {#- new style sidebar: explicitly include/exclude templates #} + {%- for sidebartemplate in sidebars %} + {%- include sidebartemplate %} + {%- endfor %} + {%- else %} + {#- old style sidebars: using blocks -- should be deprecated #} + {%- block sidebartoc %} + {%- include "localtoc.html" %} + {%- endblock %} + {%- block sidebarrel %} + {%- include "relations.html" %} + {%- endblock %} + {%- block sidebarsourcelink %} + {%- include "sourcelink.html" %} + {%- endblock %} + {%- if customsidebar %} + {%- include customsidebar %} + {%- endif %} + {%- block sidebarsearch %} + {%- include "searchbox.html" %} + {%- endblock %} + {%- endif %} +
+
+ {%- endif %} +{%- endmacro %} + + + + + {{ metatags }} + {%- if not embedded and docstitle %} + {%- set titlesuffix = " — "|safe + docstitle|e %} + {%- else %} + {%- set titlesuffix = "" %} + {%- endif %} + {%- block htmltitle %} + {{ title|striptags|e }}{{ titlesuffix }} + {%- endblock %} + + + {%- for cssfile in css_files %} + + {%- endfor %} + {%- if not embedded %} + + {%- for scriptfile in script_files %} + + {%- endfor %} + {%- if use_opensearch %} + + {%- endif %} + {%- if favicon %} + + {%- endif %} + {%- endif %} +{%- block linktags %} + {%- if hasdoc('about') %} + + {%- endif %} + {%- if hasdoc('genindex') %} + + {%- endif %} + {%- if hasdoc('search') %} + + {%- endif %} + {%- if hasdoc('copyright') %} + + {%- endif %} + + {%- if parents %} + + {%- endif %} + {%- if next %} + + {%- endif %} + {%- if prev %} + + {%- endif %} +{%- endblock %} +{%- block extrahead %} {% endblock %} + + +
+{%- block header %}{% endblock %} + +{%- block relbar1 %}{{ relbar() }}{% endblock %} + +{%- block content %} + {%- block sidebar1 %} {# possible location for sidebar #} {% endblock %} + +
+ {%- block document %} +
+ {%- if render_sidebar %} +
+ {%- endif %} +
+ {% block body %} {% endblock %} +
+ {%- if render_sidebar %} +
+ {%- endif %} +
+ {%- endblock %} + + {%- block sidebar2 %}{{ sidebar() }}{% endblock %} +
+
+{%- endblock %} + +{%- block relbar2 %}{{ relbar() }}{% endblock %} + +{%- block footer %} +
+ {%- if show_copyright %} + {%- if hasdoc('copyright') %} + {% trans path=pathto('copyright'), copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %} + {%- else %} + {% trans copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %} + {%- endif %} + {%- endif %} + {%- if last_updated %} + {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %} + {%- endif %} + {%- if show_sphinx %} + {% trans sphinx_version=sphinx_version|e %}Created using Sphinx {{ sphinx_version }}.{% endtrans %} + {%- endif %} +
+{%- endblock %} +
+ + diff --git a/docs/rst/mjtheme/page.html b/docs/rst/mjtheme/page.html new file mode 100644 index 000000000..20e2bda2f --- /dev/null +++ b/docs/rst/mjtheme/page.html @@ -0,0 +1,67 @@ +{# + basic/page.html + ~~~~~~~~~~~~~~~ + + Master template for simple pages. + + :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + :license: BSD, see LICENSE for details. +#} +{% extends "layout.html" %} + +{% block header %} + +{% endblock %} + +{% block body %} + {{ body }} +{% endblock %} diff --git a/docs/rst/mjtheme/static/mj.css_t b/docs/rst/mjtheme/static/mj.css_t index 4f4087c53..9a723f3c4 100644 --- a/docs/rst/mjtheme/static/mj.css_t +++ b/docs/rst/mjtheme/static/mj.css_t @@ -5,6 +5,162 @@ @import url("basic.css"); +/* style copied over from http://mathjax.org/ for the header */ + +body { + background: #D2D3D3 !important; +} +#wrapper { + background: white; + padding: 0; + margin: 20px auto; + width: 980px; +} + +#header { + background: #ffffff; + padding: 20px; + height: 95px; +} +#branding { +} +#site-title { + float: left; + margin: 0; + width: 300px; +} +#branding img { + border: 0; +} +#site-description { + margin: 36px 0 0; + font-size: 18px; line-height: 18px; + float: left; + width: auto; + font-family: "Helvetica Neue", Arial, Helvetica, "Nimbus Sans L", sans-serif; + font-style: normal; + font-weight: bold; + letter-spacing: -1px; + color: #a5a5a5; +} + +#access { + margin: 10px 0; +} +#access ul { padding: 0; } +#access li { min-width: 20px; } +#access a { color: #dddddd; font-weight: bold; } +#access a:hover, #access ul li.current_page_item > a, #access ul li.current-menu-ancestor > a, +#access ul li.current-menu-item > a, #access ul li.current-menu-parent > a { + color: #ffffff; + font-weight: bold; +} +#access li:hover > a, #access ul ul :hover > a { + color:#fff; + background:#444; +} +#access ul ul a { + background:#444; +} + +#menu-item-1167 { + float: right !important; + background: #E18B16 !important; +} +#menu-item-1167:hover > a { + background: #ef9d32 !important; +} +#menu-item-1167 a, #menu-item-1167 a:visited { + color: #ffffff !important; +} + +#access { + font-family: 'Helvetica Neue', Arial, Helvetica, 'Nimbus Sans L', sans-serif; + background: #000; + margin: 20px auto 0; + width: 940px; + display:block; + float:left; +} +#access .menu-header, +div.menu { + font-size: 13px; + margin-left: 12px; +} +#access .menu-header ul, +div.menu ul { + list-style: none; + margin: 0; +} +#access .menu-header li, +div.menu li { + float:left; + position: relative; +} +#access a { + display:block; + text-decoration:none; + color: #DDD; + font-weight: bold; + padding:0 10px; + line-height:38px; +} +#access ul ul { + display:none; + position:absolute; + top:38px; + left:0; + float:left; + box-shadow: 0px 3px 3px rgba(0,0,0,0.2); + -moz-box-shadow: 0px 3px 3px rgba(0,0,0,0.2); + -webkit-box-shadow: 0px 3px 3px rgba(0,0,0,0.2); + width: 180px; + z-index: 99999; +} +#access ul ul li { + min-width: 180px; +} +#access ul ul ul { + left:100%; + top:0; +} +#access ul ul a { + background:#333; + height:auto; + line-height:1em; + padding:10px; + width: 160px; +} +#access li:hover > a, +#access ul ul :hover > a { + color:#fff; + background:#333; +} +#access ul li:hover > ul { + display:block; +} +#access ul li.current_page_item > a, +#access ul li.current-menu-ancestor > a, +#access ul li.current-menu-item > a, +#access ul li.current-menu-parent > a { + color: #fff; +} + +* html #access ul li.current_page_item a, +* html #access ul li.current-menu-ancestor a, +* html #access ul li.current-menu-item a, +* html #access ul li.current-menu-parent a, +* html #access ul li a:hover { + color:#fff; +} + +/* modify layout to match mathjax site */ + +.related, .document { + width: 940px !important; + margin: 0 auto; +} + /* -- page layout ----------------------------------------------------------- */ body {