suzanne.soy/scribble-mathjax
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add section on switch from SourceForge to GitHub to migration document

Browse Source
This commit is contained in:
Davide P. Cervone 2011-03-08 08:01:08 -05:00
parent 28e6cad423
commit d5967f6abe
4 changed files with 72 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docs/html/_sources/upgrade.txt
View File

@ -232,3 +232,28 @@ configuration file. For example
will load the pre-defined ``TeX-AMS_HTML`` configuration, but will modify
the settings to allow ``$...$`` delimiters, and to process ``\$`` to
produce dollar signs within the text of the page.
New Distribution Location
=========================
Version 1.0 of MathJax was distributed through `SourceForge`, but the
development of MathJax has switched to `GitHub
<https://github.com/mathjax/MathJax/>`_, which is now the primary location
for MathJax source code and distributions. The SourceForge repository will
no longer be avtively maintained (and hasn't been since November 2010), and
so you will not be able to obtain updates through ``svn`` if you checked
out MathJax from there.
You may be able to switch to using the MathJax CDN (see above) rather than
hosting your own copy of MathJax, and avoid the problem of updates all
together. If you must install your own copy, however, you should follow
the instructions at :ref:`Installing and Testing MathJax <installation>`,
using either ``git`` or ``svn`` as described to obtain your copy from
GitHub. This will allow you to keep your copy of MathJax up to date as
development continues.
We apologize for the inconvenience of having to switch distributions, but
the git-to-svn bridge we tried to implement to keep both copies in synch
turned out to be unreliable, and so the SourceForge disrtibution was
retired in favor of the GitHub site.

2
docs/html/searchindex.js
View File

File diff suppressed because one or more lines are too long

21
docs/html/upgrade.html
View File

@ -240,6 +240,26 @@ configuration file. For example</p>
the settings to allow <tt class="docutils literal"><span class="pre">$...$</span></tt> delimiters, and to process <tt class="docutils literal"><span class="pre">\$</span></tt> to
produce dollar signs within the text of the page.</p>
</div>
<div class="section" id="new-distribution-location">
<h2>New Distribution Location<a class="headerlink" href="#new-distribution-location" title="Permalink to this headline"></a></h2>
<p>Version 1.0 of MathJax was distributed through <cite>SourceForge</cite>, but the
development of MathJax has switched to <a class="reference external" href="https://github.com/mathjax/MathJax/">GitHub</a>, which is now the primary location
for MathJax source code and distributions. The SourceForge repository will
no longer be avtively maintained (and hasn&#8217;t been since November 2010), and
so you will not be able to obtain updates through <tt class="docutils literal"><span class="pre">svn</span></tt> if you checked
out MathJax from there.</p>
<p>You may be able to switch to using the MathJax CDN (see above) rather than
hosting your own copy of MathJax, and avoid the problem of updates all
together. If you must install your own copy, however, you should follow
the instructions at <a class="reference internal" href="installation.html#installation"><em>Installing and Testing MathJax</em></a>,
using either <tt class="docutils literal"><span class="pre">git</span></tt> or <tt class="docutils literal"><span class="pre">svn</span></tt> as described to obtain your copy from
GitHub. This will allow you to keep your copy of MathJax up to date as
development continues.</p>
<p>We apologize for the inconvenience of having to switch distributions, but
the git-to-svn bridge we tried to implement to keep both copies in synch
turned out to be unreliable, and so the SourceForge disrtibution was
retired in favor of the GitHub site.</p>
</div>
</div>
@ -255,6 +275,7 @@ produce dollar signs within the text of the page.</p>
<li><a class="reference internal" href="#combined-configurations">Combined Configurations</a></li>
<li><a class="reference internal" href="#loading-mathjax-from-the-cdn">Loading MathJax from the CDN</a></li>
<li><a class="reference internal" href="#change-in-default-tex-delimiters">Change in default TeX delimiters</a></li>
<li><a class="reference internal" href="#new-distribution-location">New Distribution Location</a></li>
</ul>
</li>
</ul>

25
docs/source/upgrade.rst
View File

@ -232,3 +232,28 @@ configuration file. For example
will load the pre-defined ``TeX-AMS_HTML`` configuration, but will modify
the settings to allow ``$...$`` delimiters, and to process ``\$`` to
produce dollar signs within the text of the page.
New Distribution Location
=========================
Version 1.0 of MathJax was distributed through `SourceForge`, but the
development of MathJax has switched to `GitHub
<https://github.com/mathjax/MathJax/>`_, which is now the primary location
for MathJax source code and distributions. The SourceForge repository will
no longer be avtively maintained (and hasn't been since November 2010), and
so you will not be able to obtain updates through ``svn`` if you checked
out MathJax from there.
You may be able to switch to using the MathJax CDN (see above) rather than
hosting your own copy of MathJax, and avoid the problem of updates all
together. If you must install your own copy, however, you should follow
the instructions at :ref:`Installing and Testing MathJax <installation>`,
using either ``git`` or ``svn`` as described to obtain your copy from
GitHub. This will allow you to keep your copy of MathJax up to date as
development continues.
We apologize for the inconvenience of having to switch distributions, but
the git-to-svn bridge we tried to implement to keep both copies in synch
turned out to be unreliable, and so the SourceForge disrtibution was
retired in favor of the GitHub site.