forked from friendica/friendica-addons
Merge pull request #126 from tobiasd/mathjax
Mathjax markdownification of the README
This commit is contained in:
commit
b64d4b35ee
4 changed files with 68 additions and 31 deletions
24
mathjax/LICENSE
Normal file
24
mathjax/LICENSE
Normal file
|
|
@ -0,0 +1,24 @@
|
|||
Copyright (c) 2011-2013 Tobias Diekershoff
|
||||
All rights reserved.
|
||||
|
||||
Redistribution and use in source and binary forms, with or without
|
||||
modification, are permitted provided that the following conditions are met:
|
||||
* Redistributions of source code must retain the above copyright notice,
|
||||
this list of conditions and the following disclaimer.
|
||||
* Redistributions in binary form must reproduce the above
|
||||
* copyright notice, this list of conditions and the following disclaimer in
|
||||
the documentation and/or other materials provided with the distribution.
|
||||
* Neither the name of the <organization> nor the names of its contributors
|
||||
may be used to endorse or promote products derived from this software
|
||||
without specific prior written permission.
|
||||
|
||||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
||||
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
||||
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY DIRECT,
|
||||
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
||||
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
||||
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
||||
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
|
||||
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
||||
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
|
|
@ -1,31 +0,0 @@
|
|||
Addon for Friendika to include MathJax (LaTeX math syntax)
|
||||
|
||||
This addon lets your users use LaTeX to type mathematical formulas
|
||||
within their posts. MathJax takes care about the best method for the
|
||||
browser to display the formula and provides compatibility to 99%
|
||||
of the modern browsers.
|
||||
|
||||
You can either use the MathJax CDN online, thus loading the required javascript
|
||||
libraries from the MathJax cloud, or use a local installation of MathJax.
|
||||
Please see the plugin settings in the admin panel for configuration possibles.
|
||||
If you don't set up a local MathJax instance, leave the configuration untouched
|
||||
it will fall back to the MathJax cloud as default value.
|
||||
|
||||
If you don't use the admin panel add mathjax to the list of active addons
|
||||
|
||||
$a->config['system']['addon'] = [..., mathjax, ...]
|
||||
|
||||
To select the source of the included javascript libraries add a line
|
||||
|
||||
$a->config['mathjax']['baseurl'] = 'the URL to your MathJax installation';
|
||||
|
||||
to your .htconfig.php file. If this line is not there, the addon assumes that
|
||||
you want to use the MathJax cloud (CDN).
|
||||
|
||||
Please note that your usage of the CDN is governed by the "MathJax CDN Terms of
|
||||
Service" see http://www.mathjax.org/download/mathjax-cdn-terms-of-service/
|
||||
|
||||
Author: Tobias Diekershoff
|
||||
http://diekershoff.homeunix.net/friendika/profile/tobias
|
||||
email: tobias.diekershoff@gmx.net
|
||||
|
||||
43
mathjax/README.md
Normal file
43
mathjax/README.md
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
MathJax Addon
|
||||
=============
|
||||
|
||||
* Author: Tobias Diekershoff
|
||||
* License: [3-clause BSD](http://opensource.org/licenses/BSD-3-Clause) license
|
||||
(see the LICENSE file in the addon directory)
|
||||
|
||||
About
|
||||
-----
|
||||
|
||||
This addon for friendica includes the [MathJax][1] CDN to enable rendering of
|
||||
[LaTeX][2] formulae in your friendica postings.
|
||||
|
||||
Configuration
|
||||
-------------
|
||||
All you need to do is provide friendica with the base URL of MathJax. This can
|
||||
be either the URL of the CDN of MathJax or your own installation.
|
||||
|
||||
In case you want to use the CDN you can try the following URL as a quick start
|
||||
|
||||
http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML
|
||||
|
||||
In case you don't want or can use the admin panel of firneidca you can activate
|
||||
the addon by adding _mathjax_ to the
|
||||
|
||||
$a->config['system']['addon']
|
||||
|
||||
list in your .htconfig.php file and then providing the base URL after that
|
||||
|
||||
$a->config['mathjax']['baseurl'] = 'the URL to your MathJax installation';
|
||||
|
||||
Usage
|
||||
=====
|
||||
|
||||
Once the addon is configured you can use LaTeX syntax in your postings to share
|
||||
formulae with your contacts. But remember that the formulae are rendered in the
|
||||
browser of the user thus your contacts need to activate this addon as well. If
|
||||
they don't they will only see the LaTeX syntax in your texts.
|
||||
|
||||
Just enclose your equations in $$...$$ pairs like e.g. $$f_c(x)=ax+b$$.
|
||||
|
||||
[1]: http://www.mathjax.org/
|
||||
[2]: https://en.wikipedia.org/wiki/LaTeX
|
||||
|
|
@ -72,6 +72,7 @@ function mathjax_plugin_admin (&$a, &$o) {
|
|||
}
|
||||
|
||||
$o = replace_macros( $t, array(
|
||||
'$submit' => t('Submit'),
|
||||
'$baseurl' => array('baseurl', t('MathJax Base URL'), get_config('mathjax','baseurl' ), t('The URL for the javascript file that should be included to use MathJax. Can be either the MathJax CDN or another installation of MathJax.')),
|
||||
));
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in a new issue