summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-10-12 23:54:41 +0000
committerKarl Berry <karl@freefriends.org>2008-10-12 23:54:41 +0000
commit64761ba46fcb87ac17db5cee70e214420e72a6d0 (patch)
tree7d5a1d2d97ad5e08f0b39512c754ba5ecaf18a7b
parentf2f56362ef0e91c42dca6bd1584f5b7a85a29ea9 (diff)
new latex package texments (12oct08)
git-svn-id: svn://tug.org/texlive/trunk@10949 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/texments/README4
-rw-r--r--Master/texmf-dist/source/latex/texments/texments.dtx146
-rw-r--r--Master/texmf-dist/source/latex/texments/texments.ins59
-rw-r--r--Master/texmf-dist/tex/latex/texments/texments.sty44
-rwxr-xr-xMaster/tlpkg/bin/tlpkg-ctan-check2
-rw-r--r--Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc1
-rw-r--r--Master/tlpkg/tlpsrc/texments.tlpsrc2
7 files changed, 257 insertions, 1 deletions
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 <marek@xivilization.net>
+% -------------------------------------------------------
+%
+% 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}
+%</driver>
+%<package>\NeedsTeXFormat{LaTeX2e}
+%<package>\ProvidesPackage{texments}
+%<*package>
+ [2008/10/10 0.1.0 The Pygments highligher accessible in LaTeX]
+%<package>\RequirePackage{fancyvrb}
+%<package>\RequirePackage{color}
+%</package>
+%
+%<*driver>
+\documentclass{ltxdoc}
+\usepackage{texments}[2008/10/10]
+\usepackage{hyperref}
+\EnableCrossrefs
+\CodelineIndex
+\RecordChanges
+\begin{document}
+ \DocInput{texments.dtx}
+ \PrintChanges
+ \PrintIndex
+\end{document}
+%</driver>
+% \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 <marek@xivilization.net>
+%%
+%% 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 <marek@xivilization.net>
+
+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 <marek@xivilization.net>
+%%
+%% 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'.
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index 9af9b4c9056..3c41706d08e 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -179,7 +179,7 @@ my @WorkingTLP = qw(
pst-solides3d pst-soroban pst-spectra
pst-slpe pst-stru pst-text pst-uml pst-vue3d
pst2pdf pstool pstricks pstricks-add
- psu-thesis ptptex pxfonts
+ psu-thesis ptptex pxfonts pygments
qcm qstest quotmark qtree
r_und_s randbild rccol rcs rcsinfo recipe recipecard
refman refstyle regcount register resume robustcommand
diff --git a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
index 5c17a6f3801..db8f1465ae3 100644
--- a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
@@ -401,6 +401,7 @@ depend protocol
depend psfragx
depend pst-pdf
depend pstool
+depend texments
depend qcm
depend qstest
depend qsymbols
diff --git a/Master/tlpkg/tlpsrc/texments.tlpsrc b/Master/tlpkg/tlpsrc/texments.tlpsrc
new file mode 100644
index 00000000000..b686cd78fe1
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/texments.tlpsrc
@@ -0,0 +1,2 @@
+name texments
+category Package