summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/hvextern/doc/hvextern.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-08-23 03:01:02 +0000
committerNorbert Preining <norbert@preining.info>2023-08-23 03:01:02 +0000
commit76d75859475de5b0b64017c9dfc11644a2ece537 (patch)
treee2f334df5d811d8fe54215e0591eaf227de58fe0 /macros/latex/contrib/hvextern/doc/hvextern.tex
parentcf3e954514eb50bea0335bdc97d6b76f80f5d03e (diff)
CTAN sync 202308230300
Diffstat (limited to 'macros/latex/contrib/hvextern/doc/hvextern.tex')
-rw-r--r--macros/latex/contrib/hvextern/doc/hvextern.tex79
1 files changed, 41 insertions, 38 deletions
diff --git a/macros/latex/contrib/hvextern/doc/hvextern.tex b/macros/latex/contrib/hvextern/doc/hvextern.tex
index 7f3e7fcc86..b05f01e14a 100644
--- a/macros/latex/contrib/hvextern/doc/hvextern.tex
+++ b/macros/latex/contrib/hvextern/doc/hvextern.tex
@@ -1,4 +1,4 @@
-%% $Id: hvextern.tex 737 2023-07-03 11:28:45Z herbert $
+%% $Id: hvextern.tex 748 2023-08-22 18:03:42Z herbert $
\RequirePackage{pdfmanagement-testphase}
\DeclareDocumentMetadata{}
\documentclass[ngerman,a4paper,twoside]{article}
@@ -10,11 +10,12 @@
\usepackage{fancyhdr}
\pagestyle{fancy}
\usepackage{hvlogos}
-\usepackage[checkCode]{hvextern}
+\usepackage%[checkCode]
+{hvextern}
\usepackage{hvindex}
\usepackage{hvdoctools}
\usepackage{listings}
-\lstset{basicstyle=\ttfamily\small,language=[LaTeX]TeX,breaklines}
+\lstset{basicstyle=\ttfamily\small,language=[LaTeX]TeX,breaklines}
\usepackage{xcolor,xspace}
\usepackage{hyperref}
@@ -27,13 +28,15 @@
\begin{document}
\title{Writing, running and including the output of external documents
from within a main\newline \LaTeX\ document~--v. \hvexternFileversion}
-\author{Herbert Voß \url{herbert@dante.de}\thanks{Thanks to Karl Berry; Rolf Niepraschk}}
+\author{Herbert Voß \url{herbert@dante.de}\thanks{Thanks to Karl Berry;
+Werner Lemberg; Rolf Niepraschk}}
\maketitle
\tableofcontents
%\newpage
-\setkeys{hv}{moveToExampleDir,ExampleDir=Exa,showFilename,verbose}
+\setkeys{hv}{%moveToExampleDir,ExampleDir=Exa,
+showFilename,verbose}
\clearpage
@@ -106,7 +109,7 @@ outside of the main document and then to insert the output
we can do this from within this \LuaLaTeX\ document itself. The external document is compiled
with \XeLaTeX\ and the output is insert as pdf image:
\begin{externalDocument}[%
- compiler=xelatex, inline, force=false, runs=2, grfOptions={height=8pt},%
+ compiler=xelatex, inline, force=true, runs=2, grfOptions={height=8pt},%
crop, cropmargin=0, cleanup, docType=latex]{voss}
\documentclass{ctexart}
\pagestyle{empty}
@@ -122,7 +125,7 @@ shown by the environment \Lenv{externalDocument}.
\begin{minipage}{.59\linewidth}
\begin{lstlisting}
\begin{externalDocument}[
- compiler=pdflatex,force=false,cleanup]{voss}
+ compiler=pdflatex,force=true,cleanup]{voss}
\documentclass{standalone}
%StartVisiblePreamble
\usepackage{fontenc}
@@ -146,7 +149,7 @@ shown by the environment \Lenv{externalDocument}.
\end{minipage}
\begin{minipage}{.39\linewidth}
\begin{externalDocument}[
- compiler=pdflatex,force=false,cleanup={log,aux},showFilename=false]{voss}
+ compiler=pdflatex,force=true,cleanup={log,aux},showFilename=false]{voss}
\documentclass{standalone}
%StartVisiblePreamble
\usepackage{fontenc}
@@ -202,7 +205,7 @@ catagory, which is done internally by the package. The complete definition of th
compiler=python3,
code,
ext=py,
- force=false,
+ force=true,
docType=py,
usefancyvrb,
grfOptions={width=\linewidth}]{python}
@@ -252,7 +255,7 @@ line in the above code shows how it can be done with Python.
\begin{externalDocument}[
compiler=python3,
progpath=/usr/local/bin/,
- force=false,
+ force=true,
runs=1,
code,
ext=py,
@@ -312,7 +315,7 @@ e.g. \texttt{shiftFN=5ex}.
\begin{externalDocument}[grfOptions={width=0.95\linewidth},
compiler=xelatex,code,mpwidth=0.6\linewidth,
- crop,cleanup,force=false,usefancyvrb=false,ext=tex,showFilename=false]{voss}
+ crop,cleanup,force=true,usefancyvrb=false,ext=tex,showFilename=false]{voss}
\documentclass{article}
%StartVisiblePreamble
\usepackage{tikz}
@@ -424,7 +427,7 @@ runsequence={lualatex,biber,xindex -l de -c AU,lualatex,lualatex}
runsequence={lualatex,biber,xindex -l de -c AU,lualatex,lualatex},
,
verbose,
- force=false,
+ force=true,
cleanup={log,aux,toc,bbl,blg},
code,docType=latex,
lstOptions={columns=fixed}]{voss}
@@ -463,7 +466,7 @@ the environment \Lenv{externalDocument} is:
\begin{externalDocument}[
verbose,
compiler=java,ext=java,code,
- force=false,docType=java,includegraphic,
+ force=true,docType=java,includegraphic,
usefancyvrb,grfOptions={width=0.9\linewidth}]{java}
import java.awt.Color;
import java.awt.Graphics;
@@ -594,7 +597,7 @@ to \Lcs{VerbatimInput}. The following example uses
mpwidth=0.6\linewidth,
crop,
cleanup,
- force=false,
+ force=true,
docType=latex]{voss}
\RequirePackage{pdfmanagement-testphase}
\DeclareDocumentMetadata{}
@@ -642,7 +645,7 @@ The color of the frame is set to the same values, hence not seen. The following
mpwidth=0.6\linewidth,
crop,
cleanup,
- force=false,
+ force=true,
usefancyvrb,
docType=latex]{voss}
\RequirePackage{pdfmanagement-testphase}
@@ -729,7 +732,7 @@ The following example uses:
% mpwidth=0.6\linewidth,
% crop,
cleanup,
- force=false,
+ force=true,
frame,
% usefancyvrb,
% float,
@@ -782,7 +785,7 @@ which is the default. Using a caption and a label are optional.
% mpwidth=0.6\linewidth,
crop,
cleanup,
- force=false,
+ force=true,
usefancyvrb,
float,
floatsetting=!ht,
@@ -845,7 +848,7 @@ The follwoing example was created with
% mpwidth=0.6\linewidth,
crop, cropmargin=5,
cleanup,
- force=false,
+ force=true,
frame,
% usefancyvrb,
% float,
@@ -906,7 +909,7 @@ or \Lkeyval{b}.
showFilename=false,
crop,
cleanup,
- force=false,
+ force=true,
aboveskip=0pt,belowskip=0pt,
docType=latex]{voss}
\documentclass{article}
@@ -931,7 +934,7 @@ or \Lkeyval{b}.
code,
crop,
cleanup,
- force=false,
+ force=true,
aboveskip=0pt,belowskip=0pt,
docType=latex]{voss}
\documentclass{article}
@@ -957,7 +960,7 @@ or \Lkeyval{b}.
showFilename=false,
crop,
cleanup,
- force=false,
+ force=true,
aboveskip=0pt,belowskip=0pt,
docType=latex]{voss}
\documentclass{article}
@@ -983,7 +986,7 @@ or \Lkeyval{b}.
crop,
showFilename=false,
cleanup,
- force=false,
+ force=true,
mpwidth=0.5\linewidth,
aboveskip=0pt,belowskip=0pt,
docType=latex]{voss}
@@ -1009,7 +1012,7 @@ or \Lkeyval{b}.
showFilename=false,
crop,
cleanup,
- force=false,
+ force=true,
mpwidth=0.5\linewidth,
aboveskip=0pt,belowskip=0pt,
docType=latex]{voss}
@@ -1036,7 +1039,7 @@ or \Lkeyval{b}.
showFilename=false,
crop,
cleanup,
- force=false,
+ force=true,
mpwidth=0.5\linewidth,
aboveskip=0pt,belowskip=0pt,
docType=latex]{voss}
@@ -1067,7 +1070,7 @@ next Chinese characters
\begin{externalDocument}[
compiler=xelatex, inline, runs=2, grfOptions={height=8pt},
crop, cropmargin=0,
- cleanup, force=false, docType=latex]{voss}%
+ cleanup, force=true, docType=latex]{voss}%
\documentclass{ctexart}
\pagestyle{empty}
\begin{document}
@@ -1083,7 +1086,7 @@ With \Lkeyset{inline} the optional argument \Lkeyword{code} is
automatically set to false. The next Chinese characters
\begin{externalDocument}[
compiler=xelatex, inline, runs=2, grfOptions={height=8pt},
- crop, cropmargin=0, cleanup, force=false, docType=latex]{voss}
+ crop, cropmargin=0, cleanup, force=true, docType=latex]{voss}
\documentclass{ctexart}
\pagestyle{empty}
\begin{document}
@@ -1122,7 +1125,7 @@ sorted digits of the number $A$: $495=954-459$.
\begin{externalDocument}[
- compiler=perl, force=false, docType=pl, ext=pl, includegraphic=false,
+ compiler=perl, force=true, docType=pl, ext=pl, includegraphic=false,
code, mpwidth=0.6\linewidth]{voss}
#!/usr/bin/perl
#
@@ -1177,7 +1180,7 @@ outFile = io.open(shortFN..".txt","w+") -- open external file
\begin{externalDocument}[
- compiler=lua, force=false, docType=lua, ext=lua, includegraphic=false,
+ compiler=lua, force=true, docType=lua, ext=lua, includegraphic=false,
code, usefancyvrb=false,textOptions={basicstyle=\ttfamily\footnotesize},
shiftFN=6ex]{voss}
#!/usr/bin/env lua
@@ -1252,7 +1255,7 @@ The following examples uses
pages=2,
crop,
cleanup,
- force=false,
+ force=true,
xindex,
xindexOptions={-l DE --config AU},
mpwidth=0.6\linewidth,
@@ -1308,7 +1311,7 @@ runsequence={lualatex,biber,{xindex -l de -c AU},lualatex,lualatex}
frame,
runsequence={lualatex,biber,xindex -l de -c AU,lualatex,lualatex},
verbose,
- force=false,
+ force=true,
cleanup={log,aux,toc,bbl,blg},
code,docType=latex,
lstOptions={columns=fixed}]{voss}
@@ -1348,7 +1351,7 @@ The default is using \Lcs{lstinputlisting} for the printed code sequences.
pages={1,3},
frame,compiler=pdflatex,
% crop,
- force=false,runs=2,code,docType=latex,
+ force=true,runs=2,code,docType=latex,
frame,
lstOptions={columns=fixed}]{voss}
%StartVisiblePreamble
@@ -1408,7 +1411,7 @@ it makes no difference using the optional argument \Lkeyword{usefancyvrb} or not
frame,compiler=pdflatex,
showFilename,
% crop,
- force=false,runs=2,code,docType=latex,
+ force=true,runs=2,code,docType=latex,
frame,framesep=0pt,usefancyvrb]{voss}
%StartVisiblePreamble
\documentclass[chapterprefix=on,parskip=half-,DIV=12,fontsize=12pt]{scrbook}
@@ -1502,7 +1505,7 @@ other examples, you can set \Lkeyword{showoutput} to false.
showoutput=false,
frame,compiler=pdflatex,
crop,
- force=false,runs=2,code,docType=latex,
+ force=true,runs=2,code,docType=latex,
frame,usefancyvrb]{voss}
%StartVisiblePreamble
\documentclass[chapterprefix=on,parskip=half-,DIV=12,fontsize=12pt]{scrbook}
@@ -1578,7 +1581,7 @@ Whith this definition and the setting \Lkeyset{docType=ltx} the last example loo
frame,
compiler=pdflatex,
showFilename,
- force=false,
+ force=true,
runs=2,code,docType=ltx,
usefancyvrb]{voss}
\documentclass[chapterprefix=on,parskip=half-,DIV=12,fontsize=12pt]{scrreprt}
@@ -1642,7 +1645,7 @@ It is already internally defined.
compiler=mpost,
showFilename,
% crop,
- force=false,
+ force=true,
cleanup,
code,
docType=mp,
@@ -1678,7 +1681,7 @@ It is already internally defined.
compiler=tex,
showFilename,
% crop,
- force=false,
+ force=true,
code,
docType=tex,
ext=tex,]{voss}
@@ -1744,7 +1747,7 @@ not needed. The \texttt{pdf} is directly created.
compiler=lualatex,
showFilename,
crop,
- force=false,
+ force=true,
code,
docType=latex,
ext=tex,]{voss}
@@ -1786,7 +1789,7 @@ not needed. The \texttt{pdf} is directly created.
compiler=context,
showFilename,
runs=2,
- force=false,
+ force=true,
code,
docType=context,
ext=tex,]{voss}