gollum 1.1.1 → 1.2.0

data/lib/gollum/frontend/public/javascript/MathJax/docs/html/_sources/typeset.txt

@@ -0,0 +1,229 @@
+.. _typeset-math:
+
+**************************
+Modifying Math on the Page
+**************************
+
+If you are writing a dynamic web page where content containing
+mathematics may appear after MathJax has already typeset the rest of
+the page, then you will need to tell MathJax to look for mathematics
+in the page again when that new content is produced.  To do that, you
+need to use the :meth:`MathJax.Hub.Typeset()` method.  This will cause
+the preprocessors (if any were loaded) to run over the page again, and
+then MathJax will look for unprocessed mathematics on the page and
+typeset it, leaving unchanged any math that has already been typeset.
+
+You should not simply call this method directly, however.  Because
+MathJax operates asynchonously (see :ref:`Synchronizing with MathJax
+<synchronization>` for details), you need to be sure that
+your call to :meth:`MathJax.Hub.Typeset()` is synchronized with the
+other actions that MathJax is taking.  For example, it may already be
+typesetting portions of the page, or it may be waiting for an output
+jax to load, etc., and so you need to queue to typeset action to be
+performed after MathJax has finished whatever else it may be doing.
+That may be immediately, but it may not, and there is no way to tell.
+
+To queue the typeset action, use the command
+
+.. code-block:: javascript
+
+   MathJax.Hub.Queue(["Typeset",MathJax.Hub]);
+
+This will cause MathJax to typeset the page when it is next able to do
+so.  It guarantees that the typesetting will synchronize properly
+with the loading of jax, extensions, fonts, stylesheets, and other
+asynchornous activity, and is the only truely safe way to ask MathJax
+to process additional material.
+
+The :meth:`MathJax.Hub.Typeset()` command also accepts a parameter
+that is a DOM element whose contents is to be typeset.  That could be
+a paragraph, or a ``<div>`` element, or even a MathJax math
+``<script>`` tag.  It could also be a the DOM `id` of such an object, in
+which case, MathJax will look up the DOM element for you.  So
+
+.. code-block:: javascript
+
+   MathJax.Hub.Queue(["Typeset",MathJax.Hub,"MathExample"]);
+
+would typeset the mathematics contained in the element whose `id` is
+``MathExample``.  This is equivalent to
+
+.. code-block:: javascript
+
+   var math = document.getElementById("MathExample");
+   MathJax.Hub.Queue(["Typeset",MathJax.Hub,math]);
+
+If no element or element `id` is provided, the whole document is
+typeset.
+
+Note that the :meth:`MathJax.Hub.Queue()` method will return
+immediately, regardless of whether the typesetting has taken place or
+not, so you can not assume that the mathematics is visible after you
+make this call.  That means that things like the size of the container
+for the mathematics may not yet reflect the size of the typeet
+mathematics.  If you need to perform actions that depend on the
+mathematics being typeset, you should push *those* actions onto the
+``MathJax.Hub.queue`` as well.  
+
+This can be quite subtle, so you have to think carefully about the
+structure of your code that works with the typeset mathematics.  Also,
+the things you push onto the queue should be `Callback` objects that
+perform the actions you want when they are called, not the *results*
+of calling the functions that do what you want.
+
+
+Manipulating Individual Math Elements
+=====================================
+
+If you are not changing a complete DOM structure, but simply want to
+update the contents of a single mathematical equation, you do not need
+to use ``innerHTML`` and :meth:`MathJax.Hub.Typeset()` to preprocess
+and process an elements new content.  Instead, you can ask MathJax to
+find the `element jax` for the math element on the page, and use its
+methods to modify and update the mathematics that it displays.
+
+For example, suppose you have the following HTML in your document
+
+.. code-block:: html
+
+    <div id="MathDiv">
+      The answer you provided is: ${}$.
+    </div>
+
+and MathJax has already preprocessed and typeset the mathematics
+within dollar signs (it will be blank).  A student has typed
+something elsewhere on the page, and you want to typeset their answer
+in the location of the mathematics that is already there.  You could
+replace the entire contents of the `MathDiv` element and call
+:meth:`MathJax.Hub.Typeset()` as described above, but there is more
+efficient approach, which is to ask MathJax for the element jax for
+the mathematics, and call its method for replacing the formula shown
+by that element.  For example:
+
+.. code-block:: javascript
+
+    var math = MathJax.Hub.getAllJax("MathDiv")[0];
+    MathJax.Hub.Queue(["Text",math,"x+1"]);
+
+This looks up the list of math elements in `MathDiv` element (there is
+only one) and takes the first one (element 0) and stores it in
+``math``.  This is an `element jax` object (see the :ref:`Element Jax
+<api-element-jax>` specification for details), which has a
+:meth:`Text()` method that can be used to set the input text of the
+math element, and retypeset it.
+
+Again, since the typesetting should be synchronized with other actions
+of MathJax, the call should be pushed onto the ``MathJax.Hub.queue``,
+as shown above, rather than called directly.  The example above
+performs the equivalent of ``math.Text("x+1")`` as soon as MathJax is
+able to do so.  Any additional actions the rely on the equation
+``x+1`` actually showing on screen should also be pushed onto the
+queue so that they will not occur before the math is typeset.
+
+The actions you can perform on an element jax include:
+
+    .. describe:: Text(newmath)
+
+        to set the math text of the element to `newmath` and typeset.
+
+    .. describe::  Reprocess()
+
+        to remove the output and reproduce it again (for
+        example, if CSS has changed that would alter the spacing of the
+        mathematics).
+
+    .. describe:: Remove()
+
+        to remove the output for this math element (but not
+        the original ``<script>`` tag).
+
+    .. describe:: SourceElement()
+
+        to obtain a reference to the original
+        ``<script>`` object that is assocaited with this element jax.
+
+
+Note that once you have located an element jax, you can keep using it
+and don't have to look it up again.  So for the example above, if the
+student is going to be able to type several different answers that you
+will want to typeset, you can look up the element jax once at the
+beginning after MathJax has processed the page the first time, and
+then use that result each time you adjust the mathematics to be
+displayed.
+
+To get the element jax the first time, you need to be sure that you
+ask MathJax for it **after** MathJax has processed the page the first
+time.  This is another sitaution where you want to use the MathJax
+queue.  If your startup code performs the commands
+
+.. code-block:: javascript
+
+    var studentDisplay = null;
+    MathJax.Hub.Queue(function () {
+      studentDisplay = MathJax.Hub.getAllJax("MathDiv");
+    });
+
+then you can use 
+
+.. code-block:: javascript
+
+    MathJax.Hub.Queue(["Text",studentDisplay,studentAnswer])
+
+to change the student's answer to be the typeset version of whatever
+is in the ``studentAnswer`` variable.
+
+Here is a complete example that illustrates this approach
+
+.. code-block:: html
+
+    <html>
+    <head>
+    <title>MathJax Dynamic Math Test Page</title>
+
+    <script src="/MathJax/MathJax.js">
+      MathJax.Hub.Config({
+        extensions: ["tex2jax.js"],
+        jax: ["input/TeX","output/HTML-CSS"],
+        tex2jax: {inlineMath: [["$","$"],["\\(","\\)"]]}
+      });
+    </script>
+
+    </head>
+    <body>
+
+    <script>
+      //
+      //  Use a closure to hide the local variables from the
+      //  global namespace
+      //
+      (function () {
+        var QUEUE = MathJax.Hub.queue;  // shorthand for the queue
+        var math = null;                // the element jax for the math output.
+
+        //
+        //  Get the element jax when MathJax has produced it.
+        //
+        QUEUE.Push(function () {
+          math = MathJax.Hub.getAllJax("MathOutput")[0];
+        });
+
+        //
+        //  The onchange event handler that typesets the
+        //  math entered by the user
+        //
+        window.UpdateMath = function (TeX) {
+          QUEUE.Push(["Text",math,"\\displaystyle{"+TeX+"}"]);
+        }
+      })();
+    </script>
+
+    Type some TeX code: 
+    <input id="MathInput" size="50" onchange="UpdateMath(this.value)" />
+    <p>
+
+    <div id="MathOutput">
+    You typed: ${}$
+    </div>
+
+    </body>
+    </html>

data/lib/gollum/frontend/public/javascript/MathJax/docs/html/_static/basic.css

@@ -0,0 +1,509 @@
+/*
+ * basic.css
+ * ~~~~~~~~~
+ *
+ * Sphinx stylesheet -- basic theme.
+ *
+ * :copyright: Copyright 2007-2010 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+/* -- main layout ----------------------------------------------------------- */
+
+div.clearer {
+    clear: both;
+}
+
+/* -- relbar ---------------------------------------------------------------- */
+
+div.related {
+    width: 100%;
+    font-size: 90%;
+}
+
+div.related h3 {
+    display: none;
+}
+
+div.related ul {
+    margin: 0;
+    padding: 0 0 0 10px;
+    list-style: none;
+}
+
+div.related li {
+    display: inline;
+}
+
+div.related li.right {
+    float: right;
+    margin-right: 5px;
+}
+
+/* -- sidebar --------------------------------------------------------------- */
+
+div.sphinxsidebarwrapper {
+    padding: 10px 5px 0 10px;
+}
+
+div.sphinxsidebar {
+    float: left;
+    width: 230px;
+    margin-left: -100%;
+    font-size: 90%;
+}
+
+div.sphinxsidebar ul {
+    list-style: none;
+}
+
+div.sphinxsidebar ul ul,
+div.sphinxsidebar ul.want-points {
+    margin-left: 20px;
+    list-style: square;
+}
+
+div.sphinxsidebar ul ul {
+    margin-top: 0;
+    margin-bottom: 0;
+}
+
+div.sphinxsidebar form {
+    margin-top: 10px;
+}
+
+div.sphinxsidebar input {
+    border: 1px solid #98dbcc;
+    font-family: sans-serif;
+    font-size: 1em;
+}
+
+img {
+    border: 0;
+}
+
+/* -- search page ----------------------------------------------------------- */
+
+ul.search {
+    margin: 10px 0 0 20px;
+    padding: 0;
+}
+
+ul.search li {
+    padding: 5px 0 5px 20px;
+    background-image: url(file.png);
+    background-repeat: no-repeat;
+    background-position: 0 7px;
+}
+
+ul.search li a {
+    font-weight: bold;
+}
+
+ul.search li div.context {
+    color: #888;
+    margin: 2px 0 0 30px;
+    text-align: left;
+}
+
+ul.keywordmatches li.goodmatch a {
+    font-weight: bold;
+}
+
+/* -- index page ------------------------------------------------------------ */
+
+table.contentstable {
+    width: 90%;
+}
+
+table.contentstable p.biglink {
+    line-height: 150%;
+}
+
+a.biglink {
+    font-size: 1.3em;
+}
+
+span.linkdescr {
+    font-style: italic;
+    padding-top: 5px;
+    font-size: 90%;
+}
+
+/* -- general index --------------------------------------------------------- */
+
+table.indextable {
+    width: 100%;
+}
+
+table.indextable td {
+    text-align: left;
+    vertical-align: top;
+}
+
+table.indextable dl, table.indextable dd {
+    margin-top: 0;
+    margin-bottom: 0;
+}
+
+table.indextable tr.pcap {
+    height: 10px;
+}
+
+table.indextable tr.cap {
+    margin-top: 10px;
+    background-color: #f2f2f2;
+}
+
+img.toggler {
+    margin-right: 3px;
+    margin-top: 3px;
+    cursor: pointer;
+}
+
+div.modindex-jumpbox {
+    border-top: 1px solid #ddd;
+    border-bottom: 1px solid #ddd;
+    margin: 1em 0 1em 0;
+    padding: 0.4em;
+}
+
+div.genindex-jumpbox {
+    border-top: 1px solid #ddd;
+    border-bottom: 1px solid #ddd;
+    margin: 1em 0 1em 0;
+    padding: 0.4em;
+}
+
+/* -- general body styles --------------------------------------------------- */
+
+a.headerlink {
+    visibility: hidden;
+}
+
+h1:hover > a.headerlink,
+h2:hover > a.headerlink,
+h3:hover > a.headerlink,
+h4:hover > a.headerlink,
+h5:hover > a.headerlink,
+h6:hover > a.headerlink,
+dt:hover > a.headerlink {
+    visibility: visible;
+}
+
+div.body p.caption {
+    text-align: inherit;
+}
+
+div.body td {
+    text-align: left;
+}
+
+.field-list ul {
+    padding-left: 1em;
+}
+
+.first {
+    margin-top: 0 !important;
+}
+
+p.rubric {
+    margin-top: 30px;
+    font-weight: bold;
+}
+
+.align-left {
+    text-align: left;
+}
+
+.align-center {
+    clear: both;
+    text-align: center;
+}
+
+.align-right {
+    text-align: right;
+}
+
+/* -- sidebars -------------------------------------------------------------- */
+
+div.sidebar {
+    margin: 0 0 0.5em 1em;
+    border: 1px solid #ddb;
+    padding: 7px 7px 0 7px;
+    background-color: #ffe;
+    width: 40%;
+    float: right;
+}
+
+p.sidebar-title {
+    font-weight: bold;
+}
+
+/* -- topics ---------------------------------------------------------------- */
+
+div.topic {
+    border: 1px solid #ccc;
+    padding: 7px 7px 0 7px;
+    margin: 10px 0 10px 0;
+}
+
+p.topic-title {
+    font-size: 1.1em;
+    font-weight: bold;
+    margin-top: 10px;
+}
+
+/* -- admonitions ----------------------------------------------------------- */
+
+div.admonition {
+    margin-top: 10px;
+    margin-bottom: 10px;
+    padding: 7px;
+}
+
+div.admonition dt {
+    font-weight: bold;
+}
+
+div.admonition dl {
+    margin-bottom: 0;
+}
+
+p.admonition-title {
+    margin: 0px 10px 5px 0px;
+    font-weight: bold;
+}
+
+div.body p.centered {
+    text-align: center;
+    margin-top: 25px;
+}
+
+/* -- tables ---------------------------------------------------------------- */
+
+table.docutils {
+    border: 0;
+    border-collapse: collapse;
+}
+
+table.docutils td, table.docutils th {
+    padding: 1px 8px 1px 5px;
+    border-top: 0;
+    border-left: 0;
+    border-right: 0;
+    border-bottom: 1px solid #aaa;
+}
+
+table.field-list td, table.field-list th {
+    border: 0 !important;
+}
+
+table.footnote td, table.footnote th {
+    border: 0 !important;
+}
+
+th {
+    text-align: left;
+    padding-right: 5px;
+}
+
+table.citation {
+    border-left: solid 1px gray;
+    margin-left: 1px;
+}
+
+table.citation td {
+    border-bottom: none;
+}
+
+/* -- other body styles ----------------------------------------------------- */
+
+ol.arabic {
+    list-style: decimal;
+}
+
+ol.loweralpha {
+    list-style: lower-alpha;
+}
+
+ol.upperalpha {
+    list-style: upper-alpha;
+}
+
+ol.lowerroman {
+    list-style: lower-roman;
+}
+
+ol.upperroman {
+    list-style: upper-roman;
+}
+
+dl {
+    margin-bottom: 15px;
+}
+
+dd p {
+    margin-top: 0px;
+}
+
+dd ul, dd table {
+    margin-bottom: 10px;
+}
+
+dd {
+    margin-top: 3px;
+    margin-bottom: 10px;
+    margin-left: 30px;
+}
+
+dt:target, .highlighted {
+    background-color: #fbe54e;
+}
+
+dl.glossary dt {
+    font-weight: bold;
+    font-size: 1.1em;
+}
+
+.field-list ul {
+    margin: 0;
+    padding-left: 1em;
+}
+
+.field-list p {
+    margin: 0;
+}
+
+.refcount {
+    color: #060;
+}
+
+.optional {
+    font-size: 1.3em;
+}
+
+.versionmodified {
+    font-style: italic;
+}
+
+.system-message {
+    background-color: #fda;
+    padding: 5px;
+    border: 3px solid red;
+}
+
+.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;
+}
+
+.guilabel, .menuselection {
+    font-family: sans-serif;
+}
+
+.accelerator {
+    text-decoration: underline;
+}
+
+.classifier {
+    font-style: oblique;
+}
+
+/* -- code displays --------------------------------------------------------- */
+
+pre {
+    overflow: auto;
+}
+
+td.linenos pre {
+    padding: 5px 0px;
+    border: 0;
+    background-color: transparent;
+    color: #aaa;
+}
+
+table.highlighttable {
+    margin-left: 0.5em;
+}
+
+table.highlighttable td {
+    padding: 0 0.5em 0 0.5em;
+}
+
+tt.descname {
+    background-color: transparent;
+    font-weight: bold;
+    font-size: 1.2em;
+}
+
+tt.descclassname {
+    background-color: transparent;
+}
+
+tt.xref, a tt {
+    background-color: transparent;
+    font-weight: bold;
+}
+
+h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
+    background-color: transparent;
+}
+
+.viewcode-link {
+    float: right;
+}
+
+.viewcode-back {
+    float: right;
+    font-family: sans-serif;
+}
+
+div.viewcode-block:target {
+    margin: -1px -10px;
+    padding: 0 10px;
+}
+
+/* -- math display ---------------------------------------------------------- */
+
+img.math {
+    vertical-align: middle;
+}
+
+div.body div.math p {
+    text-align: center;
+}
+
+span.eqno {
+    float: right;
+}
+
+/* -- printout stylesheet --------------------------------------------------- */
+
+@media print {
+    div.document,
+    div.documentwrapper,
+    div.bodywrapper {
+        margin: 0 !important;
+        width: 100%;
+    }
+
+    div.sphinxsidebar,
+    div.related,
+    div.footer,
+    #top-link {
+        display: none;
+    }
+}