mirror of
https://git.friendi.ca/friendica/friendica-addons.git
synced 2024-12-22 18:50:15 +00:00
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(
|
$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.')),
|
'$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