Comprehensive TeX Archive Network

Direc­tory macros/latex/contrib/perltex

                |              PERLTEX               |
                | By Scott Pakin, scott+pt@pakin.org |


PerlTeX is a combination Perl script (perltex.pl) and LaTeX2e style
file (perltex.sty) that, together, give the user the ability to define
LaTeX macros in terms of Perl code.  Once defined, a Perl macro becomes
indistinguishable from any other LaTeX macro.  PerlTeX thereby combines
LaTeX's typesetting power with Perl's programmability.


In case it's not obvious, you'll need a Perl installation.  Perl is
freely available and runs on dozens of platforms.  See the list of Perl
binary distributions on CPAN (http://www.cpan.org/ports/index.html).

Execute "latex perltex.ins" to generate perltex.sty and perltex.pl.
Install perltex.sty in an appropriate directory (e.g.,
/usr/local/share/texmf/tex/latex/misc or C:\localtexmf\tex\latex\misc).
perltex.pl is a Perl script.  On Unix, you may want to rename it to
just "perltex" and set execute permissions ("chmod +x perltex").  On
Windows, you may want to create a batch-file wrapper for it ("pl2bat
perltex.pl").  In either case, perltex should be installed somewhere in
your executable path (e.g., /usr/local/bin).

It's not necessary to produce the documentation as PerlTeX comes with
prebuilt documentation in PDF format (perltex.pdf).  However, if you
want to build the documentation yourself (e.g., to use A4 paper instead
of U.S. Letter), run "latex perltex.dtx" twice, then "makeindex -s
gind.ist perltex.idx" and "makeindex -s gglo.ist perltex.glo -o
perltex.gls", then "latex perltex.dtx" again, then "dvips perltex.dvi
-o perltex.ps" if you want to produce PostScript.


Copyright (C) 2010 Scott Pakin

These files may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3c of this license or
(at your option) any later version.  The latest version of this license
is in:


and version 1.3c or later is part of all distributions of LaTeX version
2006/05/20 or later.

Down­load the con­tents of this pack­age in one zip archive (304.6k).

perl­tex – De­fine macros in terms of Perl code

Perl is a com­bi­na­tion Perl script (perl­tex.pl) and pack­age (perl­tex.sty) that, to­gether, give the user the abil­ity to de­fine macros in terms of Perl code. Once de­fined, a Perl macro be­comes in­dis­tin­guish­able from any other macro. Perl thereby com­bines 's type­set­ting power with Perl's pro­gramma­bil­ity. Perl will make use of per­sis­tent named pipes, and thereby run more ef­fi­ciently, on op­er­at­ing sys­tems that of­fer them (mostly Unix-like sys­tems).

Also pro­vided is a switch to gen­er­ate a Perl-free, doc­u­ment-spe­cific, nop­erl­tex.sty that is use­ful when dis­tribut­ing a doc­u­ment to places where Perl is not avail­able.

Li­cense The Project Public Li­cense
Main­tainer Scott Pakin
Con­tained inTeX Live as perl­tex
MiKTeX as perl­tex
Topics call ex­ter­nal code and pro­cess the re­sult
Guest Book Sitemap Contact Contact Author