summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-03-04 21:49:27 +0000
committerKarl Berry <karl@freefriends.org>2022-03-04 21:49:27 +0000
commitd3b099a6b6a3fd79df1bfdea379069327fd1d9bf (patch)
treefb0b555d1aae2bddbe0d5002061dbe9c409a4649 /Master/texmf-dist/doc
parent808579db8e96ab527d841002ac61a8dcb0f4075d (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/Changes1
-rw-r--r--Master/texmf-dist/doc/latex/hvpygmentex/README.md18
-rw-r--r--Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.pdfbin0 -> 21465 bytes
-rw-r--r--Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.tex67
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
new file mode 100644
index 00000000000..b28a7c357db
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/hvpygmentex/hvpygmentex.pdf
Binary files differ
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}