Browse files

Updated math part of README.

  • Loading branch information...
1 parent 2f0a3a5 commit ff6f3b95d3b64090c0fed02057f6449a3b76ad63 @jgm committed Aug 23, 2009
Showing with 18 additions and 17 deletions.
  1. +18 −13 README.markdown
  2. +0 −4 TODO
@@ -9,15 +9,15 @@ wiki's web interface. By default, pandoc's extended version of markdown
is used as a markup language, but reStructuredText, LaTeX, or HTML
can also be used. Pages can be exported in a number of different
formats, including LaTeX, RTF, OpenOffice ODT, and MediaWiki markup.
-Gitit can be configured to display TeX math (using [jsMath][]) and
+Gitit can be configured to display TeX math (using [texmath][]) and
highlighted source code (using [highlighting-kate][]).
Getting started
@@ -271,17 +271,6 @@ surrounded by `$`s, so `literal $` must be backslash-escaped.
Adding support for math
-Gitit is designed to work with [jsMath][] to display LaTeX math in
-HTML. Download `jsMath` and `jsMath Image Fonts` from the [jsMath
-download page][]. You'll have two `.zip` archives. Unzip them both
-in the `static/js` directory (a new subdirectory, `jsMath`, will be
-created). You can test to see if math is working properly by clicking
-"help" on the top navigation bar and looking for the math example (the
-quadratic formula). Note that if you copied the `jsMath` directory into
-`static` *after* starting gitit, you will have to restart gitit for the
-change to be noticed. Gitit checks for the existence of the jsMath files
-when it starts, and will not include links to them unless they exist.
To write math on a markdown-formatted wiki page, just enclose it
in dollar signs, as in LaTeX:
@@ -291,6 +280,22 @@ You can write display math by enclosing it in double dollar signs:
+Gitit can display TeX math in three different ways, depending on the
+setting of `math` in the configuration file:
+1. `mathml` (default): Math will be converted to MathML using
+ [texmath][]. This method works with IE+mathplayer, Firefox, and
+ Opera, but not Safari.
+2. `jsMath`: Math will be rendered using the [jsMath][] javascript.
+ If you want to use this method, download `jsMath` and `jsMath
+ Image Fonts` from the [jsMath download page][]. You'll have two
+ `.zip` archives. Unzip them both in the `static/js` directory (a new
+ subdirectory, `jsMath`, will be created). This works with all
+ browsers, but is slower and not as nice looking as MathML.
+3. `raw`: Math will be rendered as raw LaTeX codes.
[jsMath download page]:
@@ -1,11 +1,7 @@
-_ get rid of googlecode page/ move issues to github??
_ get wiki up to speed as main home page (demogitit).
Add good Installing page. Up-to-date User's Guide.
Front page should list features and link to good demos.
-_ document math options
_ consider making the library independent of datafiles, moving

0 comments on commit ff6f3b9

Please sign in to comment.