Menu
CTAN
Comprehensive TeX Archive Network
Cover Upload Browse Search

Direc­tory tex-archive/macros/latex/contrib/perltex

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


Description
-----------

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.


Installation
------------

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.


License
-------

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:

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

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

Files

Name Size Date Notes
README 2216 2010-07-11 01:24
perltex.1 9916 2010-07-11 01:17
perltex.dtx 120286 2010-07-11 01:12
perltex.ins 3062 2010-07-11 00:58
perltex.pdf 333786 2010-07-11 01:12

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

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

PerlTeX is a com­bi­na­tion Perl script (perl­tex.pl) and LaTeX2ε pack­age (perl­tex.sty) that, to­gether, give the user the abil­ity to de­fine LaTeX macros in terms of Perl code. Once de­fined, a Perl macro be­comes in­dis­tin­guish­able from any other LaTeX macro. PerlTeX thereby com­bines LaTeX's type­set­ting power with Perl's pro­gramma­bil­ity. PerlTeX 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 PerlTeX-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 PerlTeX is not avail­able.

Pack­age De­tailsperl­tex
Ver­sion2.1
Li­censeThe LaTeX Project Public Li­cense
Copy­right2009 Scott Pakin
Main­tainerScott Pakin
Con­tained inTeXlive as perl­tex
MikTeX as perl­tex
Topics call ex­ter­nal code and pro­cess the re­sult
Guest Book Sitemap Contact