From 64761ba46fcb87ac17db5cee70e214420e72a6d0 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 12 Oct 2008 23:54:41 +0000 Subject: new latex package texments (12oct08) git-svn-id: svn://tug.org/texlive/trunk@10949 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/texments/README | 4 + .../texmf-dist/source/latex/texments/texments.dtx | 146 +++++++++++++++++++++ .../texmf-dist/source/latex/texments/texments.ins | 59 +++++++++ Master/texmf-dist/tex/latex/texments/texments.sty | 44 +++++++ 4 files changed, 253 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/texments/README create mode 100644 Master/texmf-dist/source/latex/texments/texments.dtx create mode 100644 Master/texmf-dist/source/latex/texments/texments.ins create mode 100644 Master/texmf-dist/tex/latex/texments/texments.sty (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/latex/texments/README b/Master/texmf-dist/doc/latex/texments/README new file mode 100644 index 00000000000..cb4be946633 --- /dev/null +++ b/Master/texmf-dist/doc/latex/texments/README @@ -0,0 +1,4 @@ +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. diff --git a/Master/texmf-dist/source/latex/texments/texments.dtx b/Master/texmf-dist/source/latex/texments/texments.dtx new file mode 100644 index 00000000000..fea4d784b86 --- /dev/null +++ b/Master/texmf-dist/source/latex/texments/texments.dtx @@ -0,0 +1,146 @@ +% \iffalse meta-comment +% +% Copyright (C) 2008 by Marek Kubica +% ------------------------------------------------------- +% +% This file may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.2 +% 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.2 or later is part of all distributions of LaTeX +% version 1999/12/01 or later. +% +% \fi +% +% \iffalse +%<*driver> +\ProvidesFile{texments.dtx} +% +%\NeedsTeXFormat{LaTeX2e} +%\ProvidesPackage{texments} +%<*package> + [2008/10/10 0.1.0 The Pygments highligher accessible in LaTeX] +%\RequirePackage{fancyvrb} +%\RequirePackage{color} +% +% +%<*driver> +\documentclass{ltxdoc} +\usepackage{texments}[2008/10/10] +\usepackage{hyperref} +\EnableCrossrefs +\CodelineIndex +\RecordChanges +\begin{document} + \DocInput{texments.dtx} + \PrintChanges + \PrintIndex +\end{document} +% +% \fi +% +% \CheckSum{27} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% +% \changes{v0.0.1}{2008/10/10}{Initial version} +% \changes{v0.1.0}{2008/10/10}{Properly repackaged} +% +% \GetFileInfo{texments.dtx} +% +% \DoNotIndex{\newcommand,\newenvironment} +% +% +% \title{The \textsf{texments} package\thanks{This document +% corresponds to \textsf{texments}~\fileversion, dated \filedate.}} +% \author{Marek Kubica \\ \texttt{marek@xivilization.net}} +% +% \maketitle +% +% \section{Introduction} +% +% texments is a package that is used to connect the not-yet award winning +% source code colorizer library Pygments (\url{http://pygments.org/}) +% with \LaTeX documents. That means that it is neccessary to have +% Pygments installed and that the \texttt{pygmentize} command is +% available. +% +% \section{Usage} +% +% This package does not provide many fancy features, it is just meant +% as an easy bridge between the highlighter and LaTeX. It calls +% internally the \texttt{pygmentize} command, so you need to start it +% with \texttt{-shell-escape} activated. Note that this might change +% in the future. +% +% \DescribeMacro{\usestyle\marg{stylename}} +% This macro needs to be called at least once to set the style that +% pygments should use to highlight all code. +% +% One quite useful style is the ``bw'' style which is, as the name +% somehow implies black and white. +% +% \usestyle{default} +% +% \DescribeMacro{\pygment\marg{language}\marg{code}} +% To highlight a chunk of code, you can use the \texttt{pygment} +% macro. +% +% An example for this is the following Python code: +% +% \pygment{python}{print "Hello World"} +% +% \StopEventually{} +% +% \section{Implementation} +% +% \begin{macro}{\usestyle} +% This macro calls \texttt{pygmentize} with the appropriate style +% name and gets the color definitions that will be used in all +% following code listings. +% \begin{macrocode} +\newcommand{\usestyle}[1]{ + \immediate\write18{pygmentize -S #1 -f latex > \jobname.pyg} + \input{\jobname.pyg} +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\pygment} +% This macro takes the code in the second argument and feeds it +% to \texttt{pygmentize}, so that it outputs code highlighted +% to the rules of the first argument. +% \begin{macrocode} + +\newwrite\code +\newcommand{\pygment}[2]{ + \immediate\openout\code\jobname.pyg + \immediate\write\code{#2} + \immediate\closeout\code + + \immediate\write18{pygmentize -l #1 -f latex -o \jobname.out.pyg \jobname.pyg} + \input{\jobname.out.pyg} +} +% \end{macrocode} +% \end{macro} +% +% \Finale +\endinput diff --git a/Master/texmf-dist/source/latex/texments/texments.ins b/Master/texmf-dist/source/latex/texments/texments.ins new file mode 100644 index 00000000000..4010c43066d --- /dev/null +++ b/Master/texmf-dist/source/latex/texments/texments.ins @@ -0,0 +1,59 @@ +%% +%% Copyright (C) 2008 by Marek Kubica +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.2 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.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +%% + +\input docstrip.tex +\keepsilent + +\usedir{tex/latex/texments} + +\preamble + +This is a generated file. + +Copyright (C) 2008 by Marek Kubica + +This file may be distributed and/or modified under the conditions of +the LaTeX Project Public License, either version 1.2 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.2 or later is part of all distributions of LaTeX version +1999/12/01 or later. + +\endpreamble + +\generate{\file{texments.sty}{\from{texments.dtx}{package}}} + +\obeyspaces +\Msg{*************************************************************} +\Msg{* *} +\Msg{* To finish the installation you have to move the following *} +\Msg{* file into a directory searched by TeX: *} +\Msg{* *} +\Msg{* texments.sty *} +\Msg{* *} +\Msg{* This package depends on pygmentize, be sure to install *} +\Msg{* this tool via your packet management system, look for *} +\Msg{* python-pygments or use easy_install Pygments *} +\Msg{* *} +\Msg{* To produce the documentation run the file texments.dtx *} +\Msg{* through LaTeX with -shell-escape active. *} +\Msg{* *} +\Msg{* Happy TeXing! *} +\Msg{* *} +\Msg{*************************************************************} + +\endbatchfile diff --git a/Master/texmf-dist/tex/latex/texments/texments.sty b/Master/texmf-dist/tex/latex/texments/texments.sty new file mode 100644 index 00000000000..2b920d11e13 --- /dev/null +++ b/Master/texmf-dist/tex/latex/texments/texments.sty @@ -0,0 +1,44 @@ +%% +%% This is file `texments.sty', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% texments.dtx (with options: `package') +%% +%% This is a generated file. +%% +%% Copyright (C) 2008 by Marek Kubica +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.2 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.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +%% +\NeedsTeXFormat{LaTeX2e} +\ProvidesPackage{texments} + [2008/10/10 0.1.0 The Pygments highligher accessible in LaTeX] +\RequirePackage{fancyvrb} +\RequirePackage{color} +\newcommand{\usestyle}[1]{ + \immediate\write18{pygmentize -S #1 -f latex > \jobname.pyg} + \input{\jobname.pyg} +} + +\newwrite\code +\newcommand{\pygment}[2]{ + \immediate\openout\code\jobname.pyg + \immediate\write\code{#2} + \immediate\closeout\code + + \immediate\write18{pygmentize -l #1 -f latex -o \jobname.out.pyg \jobname.pyg} + \input{\jobname.out.pyg} +} +\endinput +%% +%% End of file `texments.sty'. -- cgit v1.2.3