diff options
author | Karl Berry <karl@freefriends.org> | 2022-03-04 21:49:27 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-03-04 21:49:27 +0000 |
commit | d3b099a6b6a3fd79df1bfdea379069327fd1d9bf (patch) | |
tree | fb0b555d1aae2bddbe0d5002061dbe9c409a4649 /Master/texmf-dist/doc | |
parent | 808579db8e96ab527d841002ac61a8dcb0f4075d (diff) |
hvpygmentex (4mar22)
git-svn-id: svn://tug.org/texlive/trunk@62405 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/hvpygmentex/Changes | 1 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/hvpygmentex/README.md | 18 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.pdf | bin | 0 -> 21465 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.tex | 67 |
4 files changed, 86 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/hvpygmentex/Changes b/Master/texmf-dist/doc/latex/hvpygmentex/Changes new file mode 100644 index 00000000000..63758cdc8d0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hvpygmentex/Changes @@ -0,0 +1 @@ +0.01 2022-03-03 - first CTAN version diff --git a/Master/texmf-dist/doc/latex/hvpygmentex/README.md b/Master/texmf-dist/doc/latex/hvpygmentex/README.md new file mode 100644 index 00000000000..3755469e294 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hvpygmentex/README.md @@ -0,0 +1,18 @@ +# hvpygmentex.sty + +Formatting source code of programming languages. + +The package is based on pygmentex but provides an automatic +run from within the document itself, with the option "--shell-escape". +It do not needs the additional action by the user to run the external +program pygmentize to create the code snippets. + +%% It 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 2005/12/01 or later. + +hvoss@tug.org
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.pdf b/Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.pdf Binary files differnew file mode 100644 index 00000000000..b28a7c357db --- /dev/null +++ b/Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.pdf diff --git a/Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.tex b/Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.tex new file mode 100644 index 00000000000..6850c477a74 --- /dev/null +++ b/Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.tex @@ -0,0 +1,67 @@ +\errorcontextlines=100 +\documentclass[DIV=12]{scrartcl} + +\usepackage{libertinus-otf} +\usepackage[force]{hvpygmentex} +\usepackage{url} +\title{Typeset highlited sourcecode} +\author{Herbert Voß} +\begin{document} +\maketitle + +\section{Introduction} +This package is fully compatible to package \texttt{pygmentex}. Read +the package documentation (\url{http://ctan.org/pkg/pygmentex}) for the +supported languages a.s.o. + +\begin{verbatim} +usepackage[options]{hvpygmentex} +\end{verbatim} + + + +With \texttt{hvpygmentex} one do not needs the external Python run to +create the formatted tex snippets which are inserted into the document. +With the optional argument \texttt{--shell-escape} for the \LaTeX\ run +\TeX\ is allowed to run the external program \texttt{pygmentize} from within the document and +no additional action by the user is required. + +This package itself has an additional option \texttt{force} which is +preset to \texttt{true}. Without using it the external +formatted \TeX\ snippets for the listings will not be recreated by following \LaTeX\ runs. This +may speed up the \LaTeX\ runs and, of course, makes only sense, if you are sure that there +are no changes in the source code listings. + + +\section{Example} + +\begin{pygmented}[lang=tex,font=\ttfamily\small] +\bgroup +\initcatcodetable1 +\aftergroup{\global\catcode`¡=12}% +\catcode`\_=12 \catcode`\^=12 \catcode`\$=12 \catcode`\%=12 \catcode`\#=12 +\catcode`\&=12 \catcode`\{=12 \catcode`\}=12 \catcode`\~=12 \catcode`¡=0 +\catcode`\\=12 +¡savecatcodetable1 +¡egroup +\end{pygmented} + + +This document was run with + +\begin{verbatim} +lualatex --shell-escape hvpygmentex.tex +\end{verbatim} + +In the terminal output you'll find something like + +\begin{verbatim} +[...] +>>>> running pygmentex (option force=true) ... +>>>> ... done. +[...] +\end{verbatim} + + + +\end{document} |