--- loncom/cgi/mimeTeX/mimetex.html 2007/10/09 21:41:41 1.3
+++ loncom/cgi/mimeTeX/mimetex.html 2012/06/09 00:58:11 1.5
@@ -1,10 +1,11 @@
-
+
-
+
+
+
+
+ true, // return web page
+ CURLOPT_HEADER => true); // return headers
+ $ch = curl_init( $url );
+ //curl_setopt_array( $ch, $options );
+ curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
+ curl_setopt( $ch, CURLOPT_HEADER, true );
+ $gif = curl_exec( $ch );
+ $errno = curl_errno( $ch );
+ $error = curl_error( $ch );
+ //$info = curl_getinfo( $ch );
+ curl_close( $ch );
+ //echo '
url= ',$url,'
',"\n";
+ //echo '
gif=
',$gif,'
',"\n";
+ if ( $errno == 0 ) {
+ $fields = explode("Vertical-Align:",$gif);
+ $vfield = trim($fields[1]);
+ $fldlen = strspn($vfield,"+-0123456789");
+ $valign = substr($vfield,0,$fldlen); }
+ else {
+ echo 'verticalalign> errno ',$errno,' = ',$error,'
',"\n"; }
+ return $valign;
+ }
+ function mimetextag( $label, $expression ) {
+ global $mimetexurl;
+ $valign = verticalalign($expression);
+ $url = $mimetexurl . $expression;
+ //echo ' valign=',$valign,' ',"\n";
+ echo '';
+ echo '',$expression,'';
+ echo '', "\n";
+ }
+ ?>
+
+
+
+ This page contains more information
+ than you'll probably need to read. If you follow the
+ Installation and Usage Summary
+ below, try installing mimeTeX immediately. Or continue reading until you feel comfortable
+ trying to install mimeTeX.
+ Prerequisites are: some knowledge of your OS's shell,
+ of installing cgi's, of LaTeX.
+
+
+ "Computers are like Old Testament gods:
+ lots of rules and no mercy."
+
+ Joseph Campbell, The Power of Myth
+ (Doubleday 1988, page 18)
@@ -252,129 +385,47 @@ SECTION I. INTRODUCTION
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 <img> tag in your document
- wherever you want to see the corresponding LaTeX expression.
- For example,
-<img src="../cgi-bin/mimetex.cgi?f(x)=\int_{-\infty}^xe^{-t^2}dt" - alt="" border=0 align=middle> immediately
- generates the corresponding gif image on-the-fly, displaying
- wherever you put that <img> tag.
+ is very easy to install. -mimeTeX plugins...-There's no inherent need to repeatedly write the cumbersome - <img> tag illustrated above. You can write your own custom tags, - or write a wrapper script around mimeTeX to simplify the - notation. - -For example, if you're using - phpBB2, then - Jameson - contributed the following typical one-line mod that lets you just write - [tex] f(x)=\int_{-\infty}^xe^{-t^2}dt [/tex] - to obtain the same image illustrated above: -#--------[open]----------------------------------------------------- - /includes/bbcode.php - #--------[find]----------------------------------------------------- - // Remove our padding from the string.. - #--------[before, add]---------------------------------------------- - $text = preg_replace('/\[tex\](.*?)\[\/tex\]/ie', - "'<img src=\"/cgi-bin/mimetex.cgi?'.rawurlencode('$1').'\" align=\"middle\" />'", - $text);- If you're using - phpBB3, - then no mod is even needed. - Just click Postings from the Administrator Control Panel, - and add the custom BBCode [tex]{TEXT}[/tex] - with the HTML replacement - <img src="/cgi-bin/mimetex.cgi?{TEXT}" align=middle> - -Similarly, PmWiki also has a - - mimeTeX plugin that lets you just write - {$ f(x)=\int_{-\infty}^xe^{-t^2}dt $} - to obtain that same image. Several other packages - also have similar mimeTeX plugins: -
Please note: If you're writing your own plugin for mimeTeX, - please don't write php code using system( ), or any other - shell escape mechanism, just to cache images. Use mimeTeX's - -DCACHEPATH=\"path/\" - compile option instead. - system( ) raises security - issues, either real ones if used carelessly, or just in the minds of - system administrators. Either way, I've received many emails from - people unable to use mimeTeX because of unnecessary system( ) - calls prohibited by security-conscious sysadmins. MimeTeX itself poses - minimal risk when used as illustrated above, but you're responsible - for any plugin/wrapper script you write around it. + compile option.) + And there's no inherent need to repeatedly write the + cumbersome <img> tag illustrated above. + You can write your own + wrapper scripts, + discussed below, around mimeTeX to simplify the notation.Alternative solutions...@@ -388,38 +439,34 @@ Alternative solutions...latexrender which uses LaTeX to create higher quality images than mimeTeX produces. For comparison, - , with arbitrary mean - - and standard deviation - , and at mimeTeX's next larger font size, looks like + , + with arbitrary mean + and standard deviation + , + and at mimeTeX's next larger font size, looks like
Similar LaTeX-based solutions that you may want to look at are + mathtran, textogif and ...www.tug.org/interest.html and in the tex-faq. + + For example, mathtran
+ is a public LaTeX web service that's
+ particularly easy to use by following these simple
+ instructions. In the <head> of your
+ html page, place the tag
Now enter your own LaTeX expression, use the sample provided, @@ -570,51 +709,111 @@ QUICKSTART if you submit the sample expression - already in the box. - -And the <img> tag to embed this same integral anywhere - in your own document is -<img src="../cgi-bin/mimetex.cgi?\large f(x)=\int_{-\infty}^xe^{-t^2}dt" - alt="" border=0 align=middle>- - - The typical mimeTeX <img> tag has the form + alt="" border=0 style="Vertical-Align:-11px"> + if you submit the sample expression already in the box. + Or see error messages whenever an + unexpected image is displayed instead. And (as discussed + above) the <img> tag to embed this same integral anywhere + in your own document is+ + + - (Ib) Examples-Here are various additional random examples further demonstrating + Here are various additional random examples further illustrating mimeTeX's features and usage. To see how they're done, Click any one of them to place its corresponding expression in the Query Box above. Then press Submit @@ -761,9 +960,9 @@ EXAMPLES | @@ -782,7 +981,7 @@ EXAMPLES | @@ -880,13 +1079,13 @@ using \longxxxarrow[] and \begin{array} | mimeTeX \picture(size){pic_elems} @@ -921,10 +1120,11 @@ using \longxxxarrow[] and \begin{array} The image at left is picture-in-picture-in-picture. |
Some useful scripts that automatically construct + mimeTeX <img> tags for you are illustrated below. + And you can also write your own scripts to simplify + the HTML notation required to incorporate mimeTeX + math images in your pages.
+ ++ The following javascript snippet (based on + mathtran's + mathtran_img.js) lets you just write + <img alt="mimetex:c=\sqrt{a^2+b^2}"> + wherever you want to see
+<script type="text/javascript"> + <!-- + // Create a namespace to hold variables and functions + mimetex = new Object(); + // Change this to use your server + mimetex.imgSrc = "http://www.yourdomain.com/cgi-bin/mimetex.cgi?"; + // Transform the whole document: add src to each img with + // alt text starting with "mimetex:", unless img already has a src. + mimetex.init = function () { + if (! document.getElementsByTagName) return; + var objs = document.getElementsByTagName("img"); + var len = objs.length; + for (i=0; i<len; i++) { + var img = objs[i]; + if (img.alt.substring(0,8) == 'mimetex:') + if (!img.src) { + var tex_src = img.alt.substring(8); + img.src = mimetex.imgSrc + encodeURIComponent(tex_src); + // Append TEX to the class of the IMG. + img.className +=' tex'; } + } + mimetex.hideElementById("mimetex.error"); } + // Utility function + mimetex.hideElementById = function (id) { + var obj = document.getElementById(id); + if (obj) obj.style.display = 'none'; } + // resolve a cross-browser issue (see CBS events) + mimetex.addEvent = function (obj, evType, fn, useCapture) { + if (obj.addEventListener) { //For Mozilla. + obj.addEventListener(evType, fn, useCapture); + return true; } + else if (obj.attachEvent) { //For Internet Explorer. + var r = obj.attachEvent("on"+evType, fn); + return r; } + } + // Initialize after entire document is loaded + mimetex.addEvent(window, 'load', mimetex.init, false); + --> + </script>+ +
+ Bulletin boards, wikis, etc, can also incorporate mimeTeX images + with short scripts. For example, if you're using + phpBB2, then + Jameson + contributed the following typical one-line mod that lets you write + [tex] c=\sqrt{a^2+b^2} [/tex] to obtain the + same image illustrated above
+#--------[open]----------------------------------------------------- + /includes/bbcode.php + #--------[find]----------------------------------------------------- + // Remove our padding from the string.. + #--------[before, add]---------------------------------------------- + $text = preg_replace('/\[tex\](.*?)\[\/tex\]/ie', + "'<img src=\"/cgi-bin/mimetex.cgi?'.rawurlencode('$1').'\" align=\"middle\" />'", + $text);+
If you're using + phpBB3, + then no mod is even needed. + Just click Postings from the Administrator Control Panel, + and add the custom BBCode [tex]{TEXT}[/tex] + with the HTML replacement + <img src="/cgi-bin/mimetex.cgi?{TEXT}" align=middle>
+ +Similarly, PmWiki + also has a + + mimeTeX plugin that lets you just write + {$ f(x)=\int_{-\infty}^xe^{-t^2}dt $} + to obtain that same image. Several other packages + also have similar mimeTeX plugins:
+Package | ++ | Plugin | +
+ + PmWiki | + | + mimeTeX plugin |
+ + + MediaWiki | ++ | + + "mimeTeX alternative" |
+ PunBB | ++ mimeTeX plugin | |
+ + Movable Type | + | mimeTeX plugin |
+ WordPress | ++ + mimeTeX plugin | |
+ Joomla | + | mimeTeX plugin |
+ Mambo | + | "mimeTeX bot" |
Please note: If you're writing your own plugin for mimeTeX, + please don't write php code using system( ), or any other + shell escape mechanism, just to cache images. Use mimeTeX's + -DCACHEPATH=\"path/\" + compile option instead. + system( ) raises security + issues, either real ones if used carelessly, or just in the minds of + system administrators. Either way, I've received many emails from + people unable to use mimeTeX because of unnecessary system( ) + calls prohibited by security-conscious sysadmins. MimeTeX itself poses + minimal risk when used as illustrated above, but you're responsible + for any plugin/wrapper script you write around it.
+ +An image like + + doesn't look as good as the same image + + that's vertically aligned with your surrounding text. + Along with several standard + + HTTP header fields, mimeTeX also emits a special + Vertical-Align: nn + header, where nn is the number of pixels + (usually negative as illustrated) needed for a + style="Vertical-Align: nn px" + attribute in the <img> tag used to + render your expression. This Vertical-Align: header + is obtained by placing the directive \depth + anywhere in your expression.
+ +But mimeTeX's special Vertical-Align: header + is unrecognized and ignored by your browser. You have to get the + header, interpret it, and write the corresponding <img> tag. + The only feasible way to do all this is using a scripting language, + as illustrated by the following, rather naive, php code
+<?php + $mimetexurl = "http://www.yourdomain.com/cgi-bin/mimetex.cgi?"; + function verticalalign( $expression ) { + global $mimetexurl; + // note: curl_init() stops at the first whitespace char in $url argument + $expression = ereg_replace(" ","~",$expression); // so remove whitespace + $url = $mimetexurl . "\depth~" . $expression; + $valign = "0"; + $ch = curl_init( $url ); + curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true ); + curl_setopt( $ch, CURLOPT_HEADER, true ); + $gif = curl_exec( $ch ); + $errno = curl_errno( $ch ); + curl_close( $ch ); + if ( $errno == 0 ) { + $fields = explode("Vertical-Align:",$gif); + $vfield = trim($fields[1]); + $fldlen = strspn($vfield,"+-0123456789"); + $valign = substr($vfield,0,$fldlen); } + return $valign; + } + function mimetextag( $expression ) { + global $mimetexurl; + $valign = verticalalign($expression); + $url = $mimetexurl . "\depth~" . $expression; + echo ' <img src="',$url,'" '; + echo ' style="Vertical-Align:',$valign,'px" '; + echo ' alt="" border=0>', "\n"; + } + ?>+ +
Now you can write + <?php mimetextag('\frac12\left(a^2+b^2\right)'); ?> + wherever you want to see + + correctly aligned. Note that the php code automatically + prepends \depth to your expression for you. + + (Also note that this code calls mimeTeX twice to render each + expression, once to get the Vertical-Align: header and build + an <img> tag, and then again to render that tag. + If you're a good php programmer and write better code, + please email me a copy.)
+ +If you're using mimeTeX's + -DCACHEPATH=\"path/\" + compile option, you can request + that all images be cached with Vertical-Align: headers, + whether or not they contain the \depth directive. Prefix your + path/ with a leading % and write + -DCACHEPATH=\"%path/\" instead. + That leading % won't become part of your cache + directory's path/, but it will signal mimeTeX + to cache headers along with each image. (In this case, + the directive \nodepth suppresses + mimeTeX's header caching for that image.) +
-To protect your own intellectual property, I recommend - To protect your own intellectual property, I recommend (both are pdf) + Copyright Basics from The Library of Congress, - in particular Circular 61, Copyright Registration for Computer Programs.
@@ -1237,14 +1734,15 @@ Ascii dump of bitmap image... http://www.yourdomain.com/cgi-bin/mimetex.cgi?x^2+y^2 If you don't see the image, then your installation failed.
@@ -1330,13 +1828,22 @@ Ascii dump of bitmap image...
is relative to mimetex.cgi, and must be writable by it.
Files created under path/ are named
filename.gif, where filename
- is the 32-character MD5 hash of the LaTeX expression.
- When caching a new image, mimeTeX also
+ is the 32-character MD5 hash of your LaTeX expression.
+ If you're also using mimeTeX's
+ Vertical-Align: feature, prefix your
+ path/ with a leading % and write
+ -DCACHEPATH=\"%path/\"
+ instead. That leading % won't become part of
+ your cache directory's path/, but it will signal
+ mimeTeX to cache headers along with each image.
+ Otherwise, the Vertical-Align: information is lost,
+ and attempts to align cached images will fail.
+ When caching a new image, mimeTeX also
updates the file path/mimetex.log containing
a timestamp, filename and LaTeX expression for each new file
created. A sample entry looks like
--------------------------------------------------------------------- -2004-08-07:09:00:53am f8ccc8dd93c8eeb1d9c40b353ef781e0.gif +2008-09-07:11:29:53am f8ccc8dd93c8eeb1d9c40b353ef781e0.gif \LARGE x=\frac{-b\pm\sqrt{b^2-4ac}}{2a} ---------------------------------------------------------------------
For complete information about the characters and math symbols +
The Comprehensive LaTeX Symbol List
+ illustrates some 6,000 symbols supported by LaTeX. For complete
+ information about the subset of these characters and math symbols
available in mimeTeX, you'll need to browse through the bottom
- 500-or-so lines of mimetex.h. And several additional
+ 1500-or-so lines of mimetex.h. And several additional
symbols like \ldots and \AA and \hbar are
defined by the mimeTeX preprocessor, function mimeprep( )
- in mimetex.c Generally speaking, I've tried to
+ in mimetex.c
+
+ I haven't exhaustively checked all the name-number matchings for
+ the thousand-or-so symbols in mimetex.h. You can eaily correct
+ any minor mistake you find in what I hope is an obvious manner.
+ The fonts Appendix IVa below provides
+ additional information.
Generally speaking, I've tried to encode the cmr10, cmmi10, cmmib10, cmsy10, cmex10, bbold10, rsfs10, stmary10 and wncyr10 families with "names", e.g., \alpha \beta \forall \sqcup, etc, identical to your LaTeX expectations. @@ -1853,11 +2545,12 @@ and some other characters.. {\cyr Khrushchev} or \cyr{Khrushchev} to see . + alt="" border=0 align="middle">
. Most LaTeX distributions supply stmaryrd.dvi and stmaryrd.sty that both document the names of the stmary10 symbols. Similarly, amsfndoc.dvi documents the names of the wncyr10 cyrillic symbols and ligatures. + -I haven't exhaustively checked all the name-number matchings for - the hundreds of symbols in mimetex.h. You can eaily correct - any minor mistake you find in what I hope is an obvious manner. - The fonts Appendix IVa below provides - additional information.
+In addition to extra LaTeX symbols like \ldots, \AA and \hbar, mentioned above, the mimeTeX preprocessor @@ -1888,6 +2577,287 @@ and some other characters.. even more cumbersome form \"E inside a query string.
+Illustrated below are some of the character sets and math symbols + supported by mimeTeX, starting with several roman character fonts. + The blackboard bold font contains many characters besides + a-z,A-Z. Calligraphic and script fonts contain + uppercase A-Z only.
+ +Characters from the Greek alphabet supported by mimeTeX, + along with \mathbb{ } versions, are + illustrated next. For example, \mathbb{\lambda} + renders + .
+ +Finally, some of the math symbols supported by mimeTeX are illustrated + below. Operators shown in two sizes are automatically + "promoted" to the larger size in   \displaystyle + mode. For example, + f(x)=\int_{-\infty}^x e^{-t^2}dt renders + + whereas + \displaystyle f(x)=\int_{-\infty}^x e^{-t^2}dt + renders + +
+ +MimeTeX currently has eight font sizes, numbered 0-7, with default 3. @@ -2004,6 +2974,105 @@ and some other characters.. by the usual rules, one size smaller than the "x", in font size 1.
+Finally, illustrated below are some examples of fonts and symbols + at several mimeTeX sizes. All symbols and sizes from cmr, cmmi, + cmmib (use \mathbf{ }), cmsy, cmex, bbold (use + \mathbb{ }), rsfs (use \mathscr{ }), + stmary and cyrillic wncyr (use {\cyr } or + \cyr{ }) should be available, but they're not all shown. + The illustrated font sizes are numbered 4=\Large, + 3=\large and 2=\normalsize (not shown are 7=\Huge, 6=\huge, + 5=\LARGE, 1=\small and 0=\tiny).
+ +
+cmmi latin uppercase, and lowercase
+ + |
+calligraphic, and rsfs (\cal{A}, \scr{B}, etc)
+ + |
+cmmi greek uppercase, and \var lowercase
+ + |
+cmmi greek lowercase
+ + |
+cmsy symbols at mimeTeX font size 3 +(operators shown large are automatically "promoted" +to the larger size in \displaystyle mode) + + |
+a few other cmmi, cmr, stmary and wncyr symbols
+at mimeTeX font size 4
+ + |
MimeTeX is always in a math-like mode, so you needn't surround @@ -2521,7 +3590,7 @@ Raise and rotate, Compose, Abb
Optionally, the overlay is horizontally + offset by the specified number of pixels + (positive offsets to the right, negative to the left). + For example,
Vertical offset can be obtained using a \raisebox + in either the base or overlay + expression, or in both. (Although, note that + \compose{\raisebox{10}{base}}{overlay} + renders identically to + \raisebox{10}{\compose{base}{overlay}}, + so applying \raisebox to the base + expression is typically unnecessary.) + Vertical overlay offset is relative to the + centered image, as discussed immediately above, + i.e., \compose{base}{\raisebox{0}{overlay}} + has no effect at all, and the overlay image + remains centered on the base. + For example,
Separately or in some judicious combination, \compose and - \raisebox and \rotatebox and \reflectbox - should help you construct special symbols not "natively" available - with mimeTeX's limited set of built-in font families. - This can be especially useful in conjunction with the - -DNEWCOMMANDS compile-time + \raisebox and \rotatebox and \reflectbox, + discussed above, perhaps along with \rule and \eval + discussed immediately below, may help you construct special symbols + not "natively" available with mimeTeX's limited set of built-in font + families. This can be especially useful in conjunction with the + DNEWCOMMANDS compile-time option discussed above.
mimeTeX can evaluate arithmetic expressions, + which is a feature intended primarily for use in + \newcommand's discussed above. + Expressions can be built up from the following elements
+ All optional [ ] and mandatory
+ { } numeric arguments for
+ \rule[lift]{width}{height},
+ \compose[offset]{ }{ },
+ \raisebox{height}{ },
+ \rotatebox{angle}{ }, and
+ \longarrow[width]
+ can be expressions as described above, rather than just
+ numeric constants. By using the fs variable, you can
+ construct \newcommand
+ expressions that properly scale with font size.
+ For example, the \mapsto symbol is not explicitly provided
+ in any mimeTeX font, but is instead constructed by the
+ embedded \newcommand
+
+ where \rule's [lift]=fs/2 and {height}=5+fs are scaled by
+ font size to render symbols
+
+
+ whose rendering automatically varies appropriately with font size.
+ This kind of \newcommand construction
+ is the primary use intended for mimeTeX's expression evaluation feature.
+
But mimeTeX also provides the \eval{expression} + command to make the expression evaluation feature render + "visible" results. It's not particularly useful, + but an expression like 1+2+3+4+5=\eval{1+2+3+4+5} + renders + .
+ +Finally, one little "gotcha" is mimeTeX's + order of evaluation when interpreting expressions. + Parentheses are respected as you'd expect. But within + (...) parentheses, or in an + unparenthesized expression, mimeTeX finds the first (reading + from the left) operator, then iteratively evaluates the + separate subexpressions to that operator's left and to its right, + and then finally combines those two separate results. + So an expression like 2*3+4 renders 14, + and you need to write (2*3)+4 to get 10. +
+ + +
+ \magstep{magnification}, placed anywhere
+ within an expression, magnifies the entire expression
+ by an integer factor 1<=magnification<=10
+ in both width and height.
+ Each single pixel thus becomes a square box, e.g.,
+ for magnification=2 each single pixel becomes
+ a four-pixel square box with dimensions 2-by-2.
+ This compromises mimeTeX's anti-aliasing algorithm,
+ and the resulting image is both hazy/blurry and jagged/staircased
+ compared to an unmagnified image of the same expression.
+ For example, at \LARGE size,
+
+
+ at mimeTeX's largest "native" font size,
+
+ Nevertheless, if you still want to render images larger than
+ mimeTeX's \Huge size, then \magstep{magnification}
+ may render almost-acceptable results.
To magnify just part of an expression,
+ you can use \magbox{magnification}{expression},
+ which only magnifies each pixel within the enclosed
+ {expression}, again
+ by an integer factor 1<=magnification<=10
+ in both width and height, and also adjusts the baseline accordingly.
+ But \magbox is applied directly to mimeTeX's black-and-white
+ bitmap before anti-aliasing .
+ At the present time, this virtually completely defeats
+ mimeTeX's anti-aliasing algorithm, and the resulting image
+ exhibits even more pronounced jagged-line/staircase effects.
+ For example,
+
+
@@ -2718,6 +3990,9 @@ Raise and rotate, Compose, Abb
And for further security, \input{ } is disabled by default + unless mimeTeX is compiled with either the -DINPUTOK or + -DINPUTPATH or -DINPUTREFERER + compile option discussed above. + When it's disabled, the command \input{filename} + renders the error message + [\input{filename} not permitted] .
+MimeTeX also supports the optional form \input{filename:tag}. In this case, filename is read as before, but only those characters @@ -3149,6 +4432,14 @@ Raise and rotate, Compose, Abb the \counter command, Unix "touch" and "chmod" those files so they're mimeTeX readable and writable.
+ Also as with \input, for security \counter is
+ disabled by default unless mimeTeX is compiled with either
+ the -DINPUTOK or the -DCOUNTEROK
+ compile option
+ (notice that -DINPUTOK also enables \counter).
+ If you've compiled mimeTeX with \counter enabled,
+ then it behaves as
If counterfile isn't readable and writable, then the \counter command always displays 1st. Otherwise, it maintains a @@ -3176,7 +4467,7 @@ Raise and rotate, Compose, Abb
Somewhat more detailed log information can be accumulated in the optional logfile. If you provide that filename, mimeTeX writes a line to it of the form - 2004-09-20:12:59:33pm <tag>=99 192.168.1.1 http_referer + 2008-09-07:12:59:33pm <tag>=99 192.168.1.1 http_referer containing a timestamp, the counter tag and its current value, and the user's IP address and http_referer page if they're available.
@@ -3190,6 +4481,25 @@ Raise and rotate, Compose, Abb unless/until you "touch" and "chmod" counters.txt (and, optionally, counters.log) in your mimetex.cgi directory. +Submitting the expression \environment + to mimeTeX renders
displaying the http environment variables + known to mimeTeX. This is primarily a programming aid, + showing information available to mimeTeX that might facilitate + future enhancements.
+ +As with \input and \counter above, + for security \environment is + disabled by default unless mimeTeX is compiled with either + the -DINPUTOK or the -DENVIRONOK + compile option + (notice that -DINPUTOK also enables \environment).
+Any (La)TeX error is typically also a mimeTeX error. + However, mimeTeX has no command line interface or + .log file for reporting errors. Its only + communication with you is through the mimeTeX image + rendered by your browser. So error messages are embedded + in that image whenever feasible. For example, + suppose you want to see + , but you mistakenly type + \alpha\bethe\gamma\delta instead. + Then the image rendered is + , indicating the unrecognized + [\bethe?] where you wanted to type \beta + and hoped to see + . + If your expression contains some unprintable character + (meaning any character mimeTeX has no bitmap for), + then just + is displayed in the + corresponding position.
+ +The preceding example illustrates a pretty trivial error. + Any non-trivial errors in your expression are likely to + go unrecognized and unreported by mimeTeX, and to render + unexpected images. While checking your input expression + for syntax errors, keep in mind the following points + about mimeTeX's behavior:
+The latest release of mimeTeX is version + + which was last revised + . + The special mimeTeX directive \version + displays that same information,
+ To check that your own release of mimeTeX is current,
+ type a url into your browser's locator window something like
+
+ http://www.yourdomain.com/cgi-bin/mimetex.cgi?\version
+ which will display the version and revision date of
+ mimeTeX installed on your server.
One small problem with the above procedure is that the default
gftype program supplied with most TeX distributions
- can't emit the long lines needed to display mimeTeX's larger font
- sizes. You'll need to compile your own version from source.
+ can't emit the long lines needed to display mimeTeX's larger font sizes.
+ gftype.zip contains a statically linked linux
+ executable modified to emit the necessary long lines.
+ It may or may not run on your intel linux machine.
+ If not, you'll need to compile your own version from source.
The following instructions are for Unix/Linux:
First, download both
-
+ web-7.5.3.tar.gz and
- web2c-7.5.3.tar.gz,
- or more recent versions. Then untar them both,
+
+ web2c-7.5.3.tar.gz
+ (note: these files are no longer
+ explicitly archived by ctan, having been superceded
+ by texlive sources, so the preceding two links
+ point to copies kept on my site, www.forkosh.com).
+ Then untar both gzipped tar files,
cd web2c-7.5.3/ and run ./configure
and make in the usual way (make may fail before
completion if you don't have all needed fonts installed,
but it will create and compile gftype.c before failing). Now edit
- texk/web2c/gftype.c and notice two lines very near the top
- that #define maxrow (79)   and similarly for maxcol.
- Change both 79's to 1024, and then re-run make. The new
- texk/web2c/gftype executable image can emit the long
- lines needed for mimeTeX's larger font sizes.
Finally, the Unix/Linux bash shell script
- email: john@forkosh.com |