From 03169d44bb9d8b8a7195dd7e7772142264319316 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 31 Dec 2008 01:00:07 +0000 Subject: pygments update (29dec08) git-svn-id: svn://tug.org/texlive/trunk@11756 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/texments/README | 73 ++++++++++++++++++++-- Master/texmf-dist/doc/latex/texments/texments.pdf | Bin 0 -> 101140 bytes 2 files changed, 69 insertions(+), 4 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/texments/texments.pdf (limited to 'Master/texmf-dist/doc/latex/texments') diff --git a/Master/texmf-dist/doc/latex/texments/README b/Master/texmf-dist/doc/latex/texments/README index cb4be946633..6be70230120 100644 --- a/Master/texmf-dist/doc/latex/texments/README +++ b/Master/texmf-dist/doc/latex/texments/README @@ -1,4 +1,69 @@ -The first public released version of texments is here, a package -which allows to use the Pygments highlighter inside LaTeX documents. -Pygments supports syntax coloring over 50 types of files and ships -with multiple color schemes. + +-------------------------------------------+ + | TEXMENTS | + | | + | Access the Pygments syntax highlighter | + | from inside LaTeX. | + | | + | By Marek Kubica, | + +-------------------------------------------+ + + +Description +----------- + +Ever wanted to include a source file into your LaTeX code? Code gets +easier to read when it is colored so many people use the ``listings'' +package that can syntax-color (highlight) your source files. Not +every language is supported, though. This is where ``texments'' +comes in handy. ``texments'' is an alternative to ``listings'' and +uses the Pygments syntax highlighter which provides highlighting +for more languages than ``listings'' itself. Especially when a +language is rather recent, Pygments often supports it already like +for example Scala and Clojure. +``texments'' also supports multiple color schemes, so almost everyone +can find a setting that pleases him. + + +Installation +------------ + +As ``texments'' is only glue between several packages, it has some +dependencies. The dependencies on the LaTeX-side are ``fancyvrb'', +``color'' and ``ifthen'' which should be all included in basically +any notable TeX distribution, so no problems are to be expected. +The documentation also uses the ``hyperref'' package which is also +part of any self-respecting TeX distribution. +The other dependency is the ``pygmentize'' command, which is part +of the Pygments () library. Pygments is +provided by many Linux distributions in the package +``python-pygments'' (Debian, Ubuntu, Fedora, openSUSE), +``pygments'' (Gentoo, Arch Linux AUR) or similar. Users of other +systems can install it using ``easy_install Pygments'' (provided +that setuptools are installed) or simply by downloading the Pygments +tarball and running ``python setup.py install'' inside of it. + +To create the ``texments.sty'' file, call ``latex texments.ins''. +Then you need to move the file into a place where TeX can find it, +probably into your TEXMF tree. To generate the documentation, +call ``pdflatex -shell-escape texments.dtx'' which will generate +the ``texments.pdf'' file which includes some examples and hints +how to use it. Note that the ``-shell-escape'' parameter is +(unfortunately) mandatory, as the macro package needs to call +``pygmentize'' to highlight the content. + + +Copyright and license +--------------------- + +Copyright (C) 2008 Marek Kubica, + +This package 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 +2008/05/04 or later. + diff --git a/Master/texmf-dist/doc/latex/texments/texments.pdf b/Master/texmf-dist/doc/latex/texments/texments.pdf new file mode 100644 index 00000000000..7afdf37a688 Binary files /dev/null and b/Master/texmf-dist/doc/latex/texments/texments.pdf differ -- cgit v1.2.3