From: skodak Date: Thu, 16 Jul 2009 09:48:17 +0000 (+0000) Subject: MDL-19832 new mimeTeX binaries v1.70 X-Git-Url: http://git.mjollnir.org/gw?a=commitdiff_plain;h=16b07d61d94c602f589fa708a6a305ebd3b83ddd;p=moodle.git MDL-19832 new mimeTeX binaries v1.70 --- diff --git a/filter/tex/README.mimetex b/filter/tex/README.mimetex index 63ce8b39e9..dd94231284 100644 --- a/filter/tex/README.mimetex +++ b/filter/tex/README.mimetex @@ -1,10 +1,10 @@ -------------------------------------------------------------------------- - January 11, 2004 Version 1.40 + September 6, 2008 Version 1.70 m i m e T e X R e a d m e F i l e - Copyright(c) 2002-2004, John Forkosh Associates, Inc. All rights reserved. + Copyright(c) 2002-2008, John Forkosh Associates, Inc. All rights reserved. -------------------------------------------------------------------------- by: John Forkosh @@ -12,17 +12,21 @@ This file is part of mimeTeX, which is free software. You may redistribute and/or modify it under the terms - of the GNU General Public License, version 2 or later, + of the GNU General Public License, version 3 or later, as published by the Free Software Foundation. See http://www.gnu.org/licenses/gpl.html - Follow the Quick Start instructions immediately below - or the detailed instructions in Section III to install - mimeTeX on your machine, and then point your browser to - http://www.yourdomain.com/mimetex.html - for a complete discussion, including demo/tutorial and - reference. Installation problems? Point your browser - to my page at + MimeTeX is discussed and illustrated online at + its homepage + http://www.forkosh.com/mimetex.html + Or you can follow the Quick Start instructions below + (or the more detailed instructions in Section III) + to immediately install mimeTeX on your own machine. + Then point your browser to + http://www.yourdomain.com/mimetex.html + for a demo/tutorial and reference. + Installation problems? Point your browser to + mimeTeX's homepage http://www.forkosh.com/mimetex.html then click its "full mimeTeX manual" link and see Section II. @@ -31,57 +35,63 @@ I. QUICK START ------------------------------------------------------------------------ To compile and install mimeTeX - o unzip mimetex.zip in any convenient working directory - o to produce an executable that emits anti-aliased gif images + * unzip mimetex.zip in any convenient working directory + * to produce an executable that emits anti-aliased + gif images (recommended) cc -DAA mimetex.c gifsave.c -lm -o mimetex.cgi -or- for gif images without anti-aliasing cc -DGIF mimetex.c gifsave.c -lm -o mimetex.cgi -or- to produce an executable that emits mime xbitmaps cc -DXBITMAP mimetex.c -lm -o mimetex.cgi - o mv mimetex.cgi to your server's cgi-bin/ directory - o mv mimetex.html to your server's htdocs/ directory - o if the relative path from htdocs to cgi-bin isn't + (For Windows, see "Compile Notes" in Section III below.) + * mv mimetex.cgi to your server's cgi-bin/ directory + * mv mimetex.html to your server's htdocs/ directory + * if the relative path from htdocs to cgi-bin isn't ../cgi-bin then edit mimetex.html and change the - few dozen occurrences as necessary - To quickly learn about mimeTeX - o point your browser to www.yourdomain.com/mimetex.html + few dozen occurrences as necessary. + Then, to quickly learn more about mimeTeX + * point your browser to www.yourdomain.com/mimetex.html Any problems with the above? - o read the more detailed instructions in Section III below, - or see www.forkosh.com/mimetex.html + * read the more detailed instructions below, + or see http://www.forkosh.com/mimetex.html II. INTRODUCTION ------------------------------------------------------------------------ - MimeTeX is licensed under the gpl. It parses LaTeX math expressions, - emitting either gif images or mime xbitmaps of them, rather than the - usual TeX dvi's. And mimeTeX is an entirely separate little program - that doesn't use TeX in any way. Therefore, mimeTeX images are easily - inserted directly into html documents using a standard html tag, - - without intermediate dvi-to-gif conversion, and without storing lots - of little gif image files, one file for each converted expression. - This makes your web site and html documents more easily maintained. - - Thus, mimeTeX is primarily intended to help you write native html - documents containing math. In this sense it's a kind of "lightweight" - alternative to MathML, with the advantage that mimeTeX preserves LaTeX - syntax, and works with any browser and server. + MimeTeX, licensed under the gpl, lets you easily embed LaTeX math in + your html pages. It parses a LaTeX math expression and immediately + emits the corresponding gif image, rather than the usual TeX dvi. + And mimeTeX is an entirely separate little program that doesn't + use TeX or its fonts in any way. It's just one cgi that you put in + your site's cgi-bin/ directory, with no other dependencies. + So mimeTeX is very easy to install. And it's equally easy to use. + Just place an html tag in your document wherever you want to + see the corresponding LaTeX expression. For example, + + generates and displays the corresponding gif image on-the-fly, + wherever you put that tag. MimeTeX doesn't need intermediate + dvi-to-gif conversion, and it doesn't clutter your filesystem with + separate little gif files for each converted expression. (Optional + image caching does store gif files, and subsequently reads them as + needed, rather than re-rendering the same images every time a page + is reloaded.) III. COMPILATION AND INSTALLATION ------------------------------------------------------------------------ - I've comnpiled and run mimeTeX under Linux and NetBSD using gcc. - The source code is entirely ansi-standard C, and should compile + I've built and run mimeTeX under Linux and NetBSD using gcc. + The source code is ansi-standard C, and should compile and execute under all environments without any change whatsoever. - Build instructions below are for Unix. Modify them as necessary - for your particular situation. + Build instructions below are for Unix. Modify them as necessary + for your particular situation. Note the -DWINDOWS switch if + applicable. Unzip mimetex.zip in any convenient working directory. - You should now have files + Your working directory should now contain mimetex.zip your gnu zipped mimeTeX distribution containing... README this file (see mimetex.html for demo/tutorial) - LICENSE GPL license, under which you may use mimeTeX + COPYING GPL license, under which you may use mimeTeX mimetex.c mimeTeX source program and all required functions mimetex.h header file for mimetex.c (and for gfuntype.c) gfuntype.c parses output from gftype -i and writes bitmap data @@ -93,32 +103,35 @@ III. COMPILATION AND INSTALLATION Conversion for Windows, Macs, VMS, etc, can usually be accomplished with unzip's -a option, i.e., unzip -a mimetex.zip - Now, to produce an executable that emits anti-aliased gif images - (which is how the "official" www.forkosh.com/mimetex.html page - is displayed), compile mimetex with the command - cc -DAA mimetex.c gifsave.c -lm -o mimetex.cgi - - Or, to produce an executable that emits gif images - without anti-aliasing, compile mimetex with the command - cc -DGIF mimetex.c gifsave.c -lm -o mimetex.cgi - - Alternatively, for an executable that emits mime xbitmaps, - just compile mimetex with the command - cc -DXBITMAP mimetex.c -lm -o mimetex.cgi - - Several additional command-line options that you may find - useful are discussed in Section IIc (href="#options") - of mimetex.html . - - That's all there is to building mimeTeX. You can now test mimetex.cgi - from the Unix command line by typing, e.g., - ./mimetex.cgi x^2+y^2 - which should emit an ascii raster something like the left-hand - illustration. And if you've compiled mimeTeX with the anti-aliasing - -DAA option, then you'll also see the right-hand illustration. - It shows asterisks in the same positions as the left-hand illustration, - and anti-aliased grayscale colormap indexes assigned to neighboring - pixels. And you'll also be shown the actual rgb value for each index. + Now, to compile a mimeTeX executable that emits anti-aliased gif + images (recommended for most uses), type the command + cc -DAA mimetex.c gifsave.c -lm -o mimetex.cgi + + Or, for an executable that emits gif images without + anti-aliasing, + cc -DGIF mimetex.c gifsave.c -lm -o mimetex.cgi + + Alternatively, to compile a mimeTeX executable that emits + mime xbitmaps, just type the command + cc -DXBITMAP mimetex.c -lm -o mimetex.cgi + + Compile Notes: + * If (and only if) you're compiling a Windows executable + with the -DAA or -DGIF option (but not -DXBITMAP), then + add -DWINDOWS also. For example, + cc -DAA -DWINDOWS mimetex.c gifsave.c -lm -o mimetex.cgi + The above Unix-like syntax works with MinGW (http://www.mingw.org) + and djgpp (http://www.delorie.com/djgpp/) Windows compilers, but + probably not with most others, where it's only intended as a + "template". + * Several additional command-line options that you may find + useful are discussed in Section IId (href="#options") + of your mimetex.html page. + + That's all there is to building mimeTeX. You can now test your + mimetex.cgi executable from the Unix command line by typing, e.g., + ./mimetex.cgi "x^2+y^2" + which should emit two ascii rasters something like the following Ascii dump of bitmap image... Hex dump of colormap indexes... ........**..................**.. .......1**1................1**1. .......*..*.....*..........*..*. .......*23*.....*..........*23*. @@ -132,34 +145,50 @@ III. COMPILATION AND INSTALLATION ................*....**......... ................*....**1........ The 5 colormap indexes denote rgb... .-->255 1-->196 2-->186 3-->177 *-->0 - If you get much fancier than x^2+y^2, remember that many characters have - to be escaped from the Unix command line, e.g., x\