From 4fee29360f7566a474b6143951b0744fa151edc9 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Wed, 30 Aug 2023 03:01:17 +0000 Subject: CTAN sync 202308300301 --- macros/latex/contrib/hvextern/doc/hvextern.tex | 50 +++++++++++++++----------- 1 file changed, 29 insertions(+), 21 deletions(-) (limited to 'macros/latex/contrib/hvextern/doc/hvextern.tex') diff --git a/macros/latex/contrib/hvextern/doc/hvextern.tex b/macros/latex/contrib/hvextern/doc/hvextern.tex index 84b2df5183..ae1528783d 100644 --- a/macros/latex/contrib/hvextern/doc/hvextern.tex +++ b/macros/latex/contrib/hvextern/doc/hvextern.tex @@ -1,16 +1,21 @@ -%% $Id: hvextern.tex 749 2023-08-24 19:10:17Z herbert $ -\RequirePackage{pdfmanagement-testphase} -\DeclareDocumentMetadata{} +%% $Id: hvextern.tex 753 2023-08-29 07:22:20Z herbert $ +%\RequirePackage{pdfmanagement-testphase} +\DocumentMetadata{} \documentclass[english,a4paper,twoside]{article} \usepackage{babel} \usepackage{libertinus} \setmonofont[Scale=MatchLowercase,FakeStretch=0.88]{AnonymousPro} +\newfontfamily\NotoSansMono[Ligatures=TeX,Scale=MatchLowercase, + FakeStretch=0.90,Ligatures=ResetAll%,RawFeature=-tlig + ]{Noto Sans Mono} +\newfontfamily\CodeTwo{CODE2000}[Scale=MatchLowercase] \usepackage{iftex} \usepackage{fancyhdr} \pagestyle{fancy} \usepackage{hvlogos} -\usepackage[checkCode]{hvextern} +\usepackage%[checkCode] +{hvextern} \usepackage{hvindex} \usepackage{hvdoctools} \usepackage{listings} @@ -24,6 +29,8 @@ \def\Java{\textsf{Java}\xspace} + + \begin{document} \title{Writing, running and including the output of external documents from within a main\newline \LaTeX\ document~--v. \hvexternFileversion} @@ -48,7 +55,7 @@ showFilename,verbose} There exists only one option \Loption{checkCode} which is valid for all \TeX-compiler. In this case an already existing external file will only be compiled, if the -external code changed. This dosn't depends on the setting of the option \Lkeyword{force}. +external code changed. This doesn't depends on the setting of the option \Lkeyword{force}. \Loption{checkCode} can speed up the compilation time. \section{Syntax} @@ -81,16 +88,12 @@ The very first compilation run of the main document must be done with the \Loption{-shell-escape} command-line option, otherwise it won't work. Follow-up runs, for example, to resolve references, should usually be done without \Loption{-shell-escape}. - The currently used filename for the example is saved in the macro \Lcs{hvExternFilename}. \begin{verbatim} lualatex --shell-escape \end{verbatim} - - - The purpose for this package is to show the output of documents which have to be compiled with a different preamble or a different engine or a complete different system, but integrating the output automatically in the main document.. @@ -111,7 +114,7 @@ This document was run with \LuaLaTeX. Suppose you want to insert the output of a which needs for several reasons a \XeLaTeX\ run. Instead of created and running a document 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:\label{inline-exa} +with \XeLaTeX\ and the output is insert as pdf image: \begin{externalDocument}[% compiler=xelatex, inline, force=true, runs=2, grfOptions={height=8pt},% crop, cropmargin=0, cleanup, docType=latex,vshift=-1pt]{voss} @@ -121,8 +124,9 @@ with \XeLaTeX\ and the output is insert as pdf image:\label{inline-exa} 美好的一天. \end{document} \end{externalDocument} +The current filename of the above example is \hvExternFilename\ and for the source +see page \pageref{inline-exa}. -The current filename of the above example is \hvExternFilename. Let's show another example which needs a \pdfLaTeX\ run. The \Index{source} code itself is also not shown by the environment \Lenv{externalDocument}. @@ -317,7 +321,7 @@ A vertical shift of the filename is possible by setting a length to the keyword e.g. \texttt{shiftFN=5ex}. -\clearpage%%%%%%%%%%%% +%\clearpage%%%%%%%%%%%% \begin{externalDocument}[grfOptions={width=0.95\linewidth}, compiler=xelatex,code,mpwidth=0.6\linewidth, @@ -1072,10 +1076,10 @@ not part of your current font. With the setting \LKeyset{inline=true} the optional keyword \Lkeyword{code} and \Lkeyword{showFilename} is automatically set to false. The -next Chinese characters +next Chinese characters \label{inline-exa} \begin{externalDocument}[ compiler=xelatex, inline, runs=2, grfOptions={height=8pt}, - crop, cropmargin=0, + crop, cropmargin=0, vshift=-1pt,usefancyvrb, cleanup, force=true, docType=latex]{voss}% \documentclass{ctexart} \pagestyle{empty} @@ -1086,11 +1090,12 @@ next Chinese characters are inserted as \Index{inline image} without showing the code. The complete code looks like: +\let\myFont\CodeTwo -\begin{Verbatim} +\begin{Verbatim}[fontfamily=myFont] With \Lkeyset{inline} the optional argument \Lkeyword{code} is automatically set to false. The next Chinese characters -\begin{externalDocument}[ +\begin{externalDocument}[vshift=-1pt, compiler=xelatex, inline, runs=2, grfOptions={height=8pt}, crop, cropmargin=0, cleanup, force=true, docType=latex]{voss} \documentclass{ctexart} @@ -1103,6 +1108,7 @@ are inserted as inline image without showing the code. The complete code looks like: \end{Verbatim} +With the keyword \Lkeyword{vshift} the inserted image can be moed in vertically direction. \subsection{Input text instead of an image} By default the created pdf which can be, of course, only text, will be inserted by \Lcs{includegraphics}. @@ -1267,7 +1273,7 @@ The following examples uses mpwidth=0.6\linewidth, usefancyvrb=false, docType=latex]{voss} -\documentclass[paper=a6,DIV=18,parskip=half-]{screxa} +\documentclass[paper=a6,DIV=18,parskip=half-]{scrartcl} \pagestyle{empty} \usepackage{libertinus} \setmonofont{DejaVu Sans Mono}[Scale=MatchLowercase,FakeStretch=0.9] @@ -1858,13 +1864,13 @@ to get the directory listed: \begin{verbatim} -\runExtCmd[redirect,verbose,lstOptions={basicstyle=\ttfamily\small}]{df}{voss} +\runExtCmd[redirect,verbose,lstOptions={basicstyle=\ttfamily\small}]{du}{voss}% *nix \end{verbatim} \medskip -\runExtCmd[redirect,verbose,lstOptions={basicstyle=\ttfamily\footnotesize}]{df}{voss} +\runExtCmd[redirect,verbose,lstOptions={basicstyle=\ttfamily\small}]{du}{voss} @@ -1883,8 +1889,10 @@ already exists, there is no need to create it with the next run again and again. if the package option \Loption{checkCode} exists. \item[\Lkeyword{cleanup}] the auxiliary files of a \LaTeX-run are deleted, preset to \texttt{aux}, \texttt{log}. It must be a comma seperated list of the extensions of the main file, s.g. \texttt{cleanup=\{aux,log\}}. -\item[\Lkeyword{moveToExampleDir}] name of a directory for the examples, must first be created by the user himself -\item[\Lkeyword{ExampleDir}] move all examples into a directory +\item[\Lkeyword{moveToExampleDir}] move all examples into a directory, must be set \emph{before} the +option \Lkeyword{ExampleDir}. +\item[\Lkeyword{ExampleDir}] name of a directory for the examples, must + first be created by the user himself. \item[\Lkeyset{tclbox=false}] Can be used if there are some negative interactions between package \Lpack{listings} and package \Lpack{tcolorbox}. \item[\Lkeyword{framesep}] Value for \Lcs{fbox} if keyword \texttt{frame} is used. -- cgit v1.2.3