punLaTeX v1.0

##
##
##        Mod title:  punLaTeX
##
##      Mod version:  1.0
##   Works on PunBB:  1.1, 1.1.1, 1.1.2, 1.1.3, 1.1.4, 1.1.5
##     Release date:  2004-10-12
##           Author:  Chris Moore (chris@ilovephysics.com)
##
##      Description:  Adds support for the LaTeX math mark-up language,
##              allowing equations to be posted in forums.
##
##   Affected files:  include/parser.php
##
##       Affects DB:  No
##
##            Notes:  This mod uses a LaTeX engine called mimeTeX. MimeTeX
##              parses a LaTeX math expression and emits the
##              corresponding gif image on-the-fly. It is a separate
##              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. This means that it can be used on servers that
##              do not have LaTeX installed, such as most free and paid
##              hosting.
##
##       DISCLAIMER:  Please note that "mods" are not officially supported by
##                    PunBB. Installation of this modification is done at your
##                    own risk. Backup your forum database and any and all
##                    applicable files before proceeding.
##
##


#
#---------[ 1. UPLOAD ]-------------------------------------------------------
#


The supplied mimetex.cgi file has been compiled for Linux servers and may not
work for other platforms. The original source can be found at the following
URL with other platform compiled versions: http://www.forkosh.com/mimetex.html

mimetex.cgi to yourdomain/cgi-bin/


#
#---------[ 4. OPEN ]---------------------------------------------------------
#


include/parser.php


#
#---------[ 5. FIND (lines: 200-216) ]---------------------------------------------
#


200    $pattern = array('#\[b\](.*?)\[/b\]#s',
201         '#\[i\](.*?)\[/i\]#s',
202         '#\[u\](.*?)\[/u\]#s',
203         '#\[url\](.*?)\[/url\]#e',
204         '#\[url=(.*?)\](.*?)\[/url\]#e',
205         '#\[email\](.*?)\[/email\]#',
206         '#\[email=(.*?)\](.*?)\[/email\]#',
207         '#\[color=([a-zA-Z]*|\#?[0-9a-fA-F]{6})](.*?)\[/color\]#s');
208
209    $replace = array('<strong>$1</strong>',
210         '<em>$1</em>',
211         '<u>$1</u>',
212         'truncate_url(\'$1\')',
213         'truncate_url(\'$1\', \'$2\')',
214         '<a href="mailto:$1">$1</a>',
215         '<a href="mailto:$1">$2</a>',
216         '<span style="color: $1">$2</span>');

This section of code defines the various tags used in the forum. We are going
to add a new tag.


#
#---------[ 6. REPLACE WITH ]-------------------------------------------------
#


200    $pattern = array('#\[b\](.*?)\[/b\]#s',
201     '#\[i\](.*?)\[/i\]#s',
202     '#\[u\](.*?)\[/u\]#s',
203     '#\[url\](.*?)\[/url\]#e',
204     '#\[url=(.*?)\](.*?)\[/url\]#e',
205     '#\[email\](.*?)\[/email\]#',
206     '#\[email=(.*?)\](.*?)\[/email\]#',
207     '#\[color=([a-zA-Z]*|\#?[0-9a-fA-F]{6})](.*?)\[/color\]#s',
208     '#\[tex\](.*?)\[/tex\]#');
209
210    $replace = array('<strong>$1</strong>',
211     '<em>$1</em>',
212     '<u>$1</u>',
213     'truncate_url(\'$1\')',
214     'truncate_url(\'$1\', \'$2\')',
215     '<a href="mailto:$1">$1</a>',
216     '<a href="mailto:$1">$2</a>',
217     '<span style="color: $1">$2</span>',
218     '<img src="http://yourdmain/cgi-bin/mimetex.cgi?$1" border="0" 
        alt="LaTeX Image">');

We have now added a new tag: [tex] ... [/tex]. Everything between the [tex]
tags will be sent to mimetex.cgi and a gif image file of the corresponding
equation will be displayed. The new tag is added in line 208 and 218.

IMPORTANT: Make sure you replace "yourdomain" in line 218 with your actual
domain name.


#
#---------[ 12. SAVE/UPLOAD ]-------------------------------------------------
#

To learn more about mimeTeX and what you can do with it, visit:

http://www.forkosh.com/mimetex.html

For more information on the LaTeX math mark-up lnguage visit:

http://www.latex-project.org/

For questions about this MOD and integrating it into your site, visit:

http://www.ilovephysics.com/forum

    $replace = array('<strong>$1</strong>',
                     '<em>$1</em>',
                     '<u>$1</u>',
                     'truncate_url(\'$1\')',
                     'truncate_url(\'$1\', \'$2\')',
                     '<a href="mailto:$1">$1</a>',
                     '<a href="mailto:$1">$2</a>',
                     '<span style="color: $1">$2</span>',
                     '<img src="http://adress/cgi-bin/mimetex.exe?$1" border="0" alt="LaTeX Image">');