From 11157acdf0bb42a42b937b9db204da13c725bc5b Mon Sep 17 00:00:00 2001 From: moodler Date: Fri, 13 Feb 2004 01:42:46 +0000 Subject: [PATCH] To help with our GPL obligations --- filter/tex/README.mimetex | 191 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 191 insertions(+) create mode 100644 filter/tex/README.mimetex diff --git a/filter/tex/README.mimetex b/filter/tex/README.mimetex new file mode 100644 index 0000000000..63ce8b39e9 --- /dev/null +++ b/filter/tex/README.mimetex @@ -0,0 +1,191 @@ + + -------------------------------------------------------------------------- + January 11, 2004 Version 1.40 + + 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. + -------------------------------------------------------------------------- + + by: John Forkosh + john@forkosh.com www.forkosh.com + + 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, + 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 + http://www.forkosh.com/mimetex.html + then click its "full mimeTeX manual" link and see + Section II. + + +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 + 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 + ../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 + Any problems with the above? + o read the more detailed instructions in Section III below, + or see 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. + + +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 + and execute under all environments without any change whatsoever. + Build instructions below are for Unix. Modify them as necessary + for your particular situation. + + Unzip mimetex.zip in any convenient working directory. + You should now have files + 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 + 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 + texfonts.h output from several gfuntype runs, needed by mimetex.c + gifsave.c gif library by Sverre H. Huseby + mimetex.html sample html document, mimeTeX demo and tutorial + Note: all files in mimetex.zip use Unix line termination, + i.e., linefeeds (without carriage returns) signal line endings. + 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. + Ascii dump of bitmap image... Hex dump of colormap indexes... + ........**..................**.. .......1**1................1**1. + .......*..*.....*..........*..*. .......*23*.....*..........*23*. + ..........*.....*.............*. ..........*.....*.............*. + .***......*.....*....**.*.....*. .***1....2*.....*....**3*....2*. + .**.*....*......*....**.*....*.. .**.*...1*......*....**.*...1*.. + ..*.....*.*..******...*.*...*.*. ..*....2*.*..******...*.*..2*.*. + **.*...****.....*....*.*...****. **.*...****.....*....*.*2..****. + ****............*.....**........ ****............*....1**........ + ................*......*........ ................*......*........ + ................*....**......... ................*....**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\