From ce7643832e815cb88d6b094fd4a6230d6b8df779 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 13 Sep 2017 22:05:42 +0000 Subject: pst-exa (14sep17) git-svn-id: svn://tug.org/texlive/trunk@45289 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/pst-exa/Changes | 1 + Master/texmf-dist/doc/latex/pst-exa/README | 2 +- .../texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib | 99 +----- .../texmf-dist/doc/latex/pst-exa/pst-exa-doc.inc | 165 ++++++++++ .../texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdf | Bin 56513 -> 71512 bytes .../texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex | 357 +++++++++++++++++++-- 6 files changed, 497 insertions(+), 127 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.inc (limited to 'Master/texmf-dist/doc/latex/pst-exa') diff --git a/Master/texmf-dist/doc/latex/pst-exa/Changes b/Master/texmf-dist/doc/latex/pst-exa/Changes index 9a245d60f59..122b5144a55 100644 --- a/Master/texmf-dist/doc/latex/pst-exa/Changes +++ b/Master/texmf-dist/doc/latex/pst-exa/Changes @@ -1,2 +1,3 @@ +0.06 2017-09-12 code modifications (pablo) 0.05 2014-09-24 added style options (pablo) 0.01 2010-01-01 first CTAN version \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/pst-exa/README b/Master/texmf-dist/doc/latex/pst-exa/README index 49344318b9a..111a713cbf3 100644 --- a/Master/texmf-dist/doc/latex/pst-exa/README +++ b/Master/texmf-dist/doc/latex/pst-exa/README @@ -1,6 +1,6 @@ The package \LPack{pst-exa} was created to realize examples with printed code and output side by side or on top of each other. The package looks in the image directory for the source -code of the examples and inserts only the code between the environment \Lenv{document}, +code of the examples and inserts only the code between the document environment , which is the sequence \LBEG{document} \ldots\ \LEND{document}. The package provides the environment \Lenv{PSTexample} with the optional diff --git a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib index 473fe07ab53..462241d6df6 100644 --- a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib +++ b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib @@ -13,49 +13,6 @@ @STRING{theaterkasse = {Von der Theaterkasse} } @STRING{theatertage = {{\TeX}-Theatertage} } -@Article{ dtk02.2:jackson.voss:plot-funktionen, - author = {Laura E. Jackson and Herbert Vo{\ss}}, - title = {Die {P}lot-{F}unktionen von {\texttt{pst-plot}}}, - journal = dtk, - year = 2002, - volume = {2/02}, - altvolume = 2, - altnumber = 14, - month = jun, - pages = {27--34}, - annote = bretter, - keywords = {}, - abstract = { Im letzten Heft wurden die mathematischen Funktionen von - \PS~im Zusammenhang mit dem {\LaTeX}-Paket - \texttt{pst-plot} zum Zeichnen von Funktionen beschrieben - und durch Beispiele erl{\"a}utert. In diesem Teil werden - die bislang nur erw{\"a}hnten Plot-Funktionen f{\"u}r - externe Daten behandelt. } -} - -@Article{ dtk02.1:voss:mathematischen, - author = {Herbert Vo{\ss}}, - title = {Die mathematischen {F}unktionen von {P}ost{S}cript}, - journal = dtk, - year = 2002, - volume = {1/02}, - altvolume = 1, - altnumber = 14, - month = mar, - pages = {}, - annote = bretter, - keywords = {}, - abstract = { \PS, faktisch genauso alt wie {\TeX}, ist im - Verh{\"a}ltnis dazu allgemein noch weniger bekannt, wenn es - darum geht zu beurteilen, was es denn nun im eigentlichen - Sinne ist. Au{\ss}erdem wird h{\"a}ufig vergessen, dass - sich mit den \PS-Funktionen viele Dinge erledigen lassen, - bei denen sonst auf externe Programme zur{\"u}ckgegriffen - wird. Dies wird im Folgenden f{\"u}r die mathematischen - Funktionen im Zusammenhang mit dem Paket \texttt{pst-plot} - gezeigt. } -} - @Book{tlgc2, author = {Michel Goosens and Frank Mittelbach and Sebastian Rahtz and Denis Roegel and Herbert Vo{\ss}}, title = {The {\LaTeX} {G}raphics {C}ompanion}, @@ -66,15 +23,6 @@ } -@Book{voss:chaos, - author = {Herbert Vo{\ss}}, - title = {Chaos und {F}raktale selbst programmieren: von {M}andelbrotmengen - {\"u}ber {F}arbmanipulationen zur perfekten Darstellung}, - publisher = {{Franzis Verlag}}, - year = {1994}, - address = {Poing} -} - @Article{girou:01:, author = {Denis Girou}, title = {Pr\'esentation de {PST}ricks}, @@ -95,59 +43,22 @@ pages = {239-246} } -@Book{PostScript, - Author = {Kollock, Nikolai G.}, - Title = {Post{S}cript richtig eingesetzt: vom {K}onzept zum - praktischen {E}insatz}, - Publisher = {IWT}, - Address = {Vaterstetten}, - year = 1989, -} - @Manual{pstricks, Title = {PSTricks - {\PS} macros for generic {\TeX}}, Author = {{Timothy van} Zandt}, - Organization = {}, Address = {\url{http://www.tug.org/application/PSTricks}}, - Note = {}, year = 1993 } -@Manual{pst-plot, - Title = {\texttt{pst-plot}: Plotting two dimensional functions and data}, - Author = {{Timothy van} Zandt}, - Organization = {}, - Address = {\url{CTAN:graphics/pstricks/generic/pst-plot.tex}}, - Note = {}, - year = 1999 -} - -@Manual{multido, - Title = {\texttt{multido.tex} - a loop macro, that supports fixed-point addition}, - Author = {{Timothy van} Zandt}, - Organization = {}, - Address = {\url{CTAN:/graphics/pstricks/generic/multido.tex}}, - Note = {}, - year = 1997 -} - @Book{PSTricks2, author = {Herbert Vo\ss}, title = {\texttt{PSTricks} -- {G}rafik f\"ur \TeX{} und \LaTeX}, - edition = {6.}, + edition = {7}, publisher = {DANTE -- Lehmanns}, year = {2010}, address = {Heidelberg/Berlin} } -@Book{voss:math, - author = {Herbert Vo\ss}, - title = {Typesetting mathematics with \LaTeX}, - publisher = {UIT}, - year = {2010}, - address = {Cambridge} -} - @Book{PSTricks2-UIT, author = {Herbert Vo\ss}, title = {PSTricks -- Graphics for \TeX\ and \LaTeX}, @@ -164,14 +75,6 @@ address = {Cambridge} } -@Manual{wolfram, - author = {Eric Weisstein}, - title = {Wolfram MathWorld}, - publisher = {{Wolfram}}, - year = {2007}, - address = {\url{http://mathworld.wolfram.com}} -} - @Manual{pst-tools, author = {Herbert Voß}, title = {\texttt{pst-tools} -- Helper functions}, diff --git a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.inc b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.inc new file mode 100644 index 00000000000..2e09c78722d --- /dev/null +++ b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.inc @@ -0,0 +1,165 @@ +\DeclareRobustCommand\PST{\texttt{PSTricks\xspace}} +\DeclareRobustCommand\PS{\texttt{PostScript\xspace}} +\def\dt{\ensuremath{\,\mathrm{d}t}} +\def\Index#1{\index{#1}#1} +% +\def\LPack#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Package!#1@\texttt{#1}}} +\def\nxLPack#1{\texttt{#1}} +\def\Lprog#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Program!#1@\texttt{#1}}} +\let\nxLprog\nxLPack +\def\LFile#1{\texttt{#1}\index{#1@\texttt{#1}}\index{File!#1@\texttt{#1}}} +\def\nxLFile#1{\texttt{#1}} +\def\Lext#1{\texttt{.#1}\index{#1@\texttt{.#1}}\index{Extension!#1@\texttt{.#1}}} +\def\nxLext#1{\texttt{.#1}} +\def\xLcs#1{\index{#1@\nxLcs{#1}}\index{Macro!#1@\nxLcs{#1}}} +\def\Lcs#1{\nxLcs{#1}\xLcs{#1}} +\def\LcsStar#1{\index{#1*@\nxLcs{#1*}}\index{Macro!#1@\nxLcs{#1*}}\nxLcs{#1}\OptArg*{*}} +\def\nxLcs#1{\texttt{\textbackslash#1}} +\def\xLenv#1{\index{#1@\texttt{#1}}\index{Environment!#1@\texttt{#1}}} +\def\Lenv#1{\texttt{#1}\xLenv{#1}} +\def\Ldim#1{\texttt{\textbackslash#1}\index{#1@\texttt{\textbackslash#1}}\index{Dimension!#1@\texttt{\textbackslash#1}}} +\def\Lskip#1{\texttt{\textbackslash#1}\index{#1@\texttt{\textbackslash#1}}\index{Skip!#1@\texttt{\textbackslash#1}}} +\def\Lkeyword#1{\texttt{#1}\xLkeyword{#1}} +\def\xLkeyword#1{\index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}}} +\def\nxLkeyword#1{\texttt{#1}} + +\def\LKeyword#1{\LKeyword@i#1!!} +\def\LKeyword@i#1=#2!!{\Lkeyword{#1}\nxLkeyword{=#2}} +\let\nxLKeyword\nxLenv % same formatting + +\let\nxLkeyval\nxLkeyword +\let\nxLenv\nxLkeyword +\let\nxLps\nxLkeyword +\def\LColor#1{\texttt{#1}\xLColor{#1}} +\def\xLColor#1{\index{#1@\texttt{#1}}\index{Color!#1@\texttt{#1}}} +\def\Lkeyval#1{\texttt{#1}\xLkeyval{#1}} +\def\xLkeyval#1{\index{#1@\texttt{#1}}\index{Keyvalue!#1@\texttt{#1}}} +\def\xLoption#1{\index{#1@\texttt{#1}}\index{Package option!#1@\texttt{#1}}} +\def\Loption#1{\texttt{#1}\xLoption{#1}} +\def\LPS#1{\texttt{#1}\index{#1@\texttt{#1}}\index{PostScript!#1@\texttt{#1}}} +\def\xLps#1{\index{#1@\texttt{#1}}\index{PostScript!#1@\texttt{#1}}} +\def\nxLps#1{\texttt{#1}} +\def\Lps#1{\nxLps{#1}\xLps{#1}} +\def\LClass#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Class!#1@\texttt{#1}}} +\let\nxLClass\nxLPack +\let\nxLdim\nxLcs +\let\nxLskip\nxLcs +\def\Lctr#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Counter!#1@\texttt{#1}}} +\def\LCtr#1{\texttt{#1}\index{#1@\texttt{#1}}\index{TeX Counter@\TeX\ Counter!#1@\texttt{#1}}} +\def\nxLctr#1{\texttt{#1}} +% +\newcommand\Lnotation [1]{\nxLnotation{#1}\xLnotation{#1}} +\newcommand\Lmnotation[1]{\nxLnotation{#1}\xLmnotation{#1}} +\newcommand\xLnotation[1]{\index{Syntax!#1@\nxLnotation{#1}}\index{#1@\nxLnotation{#1}}} +\def\nxLnotation#1{\texttt{#1}} +\def\xLkeyset#1{\expandafter\xLkeyset@i#1\@nil} +\def\xLkeyset@i#1=#2\@nil{\index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}} + \index{#2@\texttt{#2}}\index{Value!#2@\texttt{#2}}} +\def\Lkeyset#1{\expandafter\Lkeyset@i#1\@nil} +\def\Lkeyset@i#1=#2\@nil{\texttt{#1=#2}% + \index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}} + \index{#2@\texttt{#2}}\index{Value!#2@\texttt{#2}}} +% +\def\xLKeyset#1{\expandafter\xLKeyset@i#1\@nil}% without using the right value of = +\def\xLKeyset@i#1=#2\@nil{\index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}}} +\def\LKeyset#1{\expandafter\LKeyset@i#1\@nil} +\def\LKeyset@i#1=#2\@nil{\texttt{#1=#2}% + \index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}}} +\let\LKeyword\LKeyset +% +\newcommand\Larg [1]{{\normalfont\itshape#1\/}} +\newcommand\Larga[1]{$\langle$\Larg{#1}$\rangle$}% angles +\newcommand\Largb[1]{\lcb\Larg{#1}\rcb} % curly brace +\newcommand\Largs[1]{\lsb\Larg{#1}\rsb} % square brackets +\newcommand\Largr[1]{\lrb\Larg{#1}\rrb} % round brackets +\newcommand\LBEG[1]{{\normalfont\ttfamily\bs{}begin\lcb#1\rcb}\xLenv{#1}} +\newcommand\LmBEG[1]{{\normalfont\ttfamily\bs{}begin\lcb#1\rcb}\xLmenv{#1}} +\newcommand\LEND[1]{{\normalfont\ttfamily\bs{}end\lcb#1\rcb}\xLenv{#1}} +\newcommand\LmEND[1]{{\normalfont\ttfamily\bs{}end\lcb#1\rcb}\xLmenv{#1}} +% +\DeclareRobustCommand\bs{{\normalfont\ttfamily\textbackslash}} % \let\bslash=\bs +\DeclareRobustCommand\lcb{{\normalfont\ttfamily\textbraceleft}} +\DeclareRobustCommand\rcb{{\normalfont\ttfamily\textbraceright}} +\DeclareRobustCommand\lsb{{\normalfont\ttfamily[}} +\DeclareRobustCommand\rsb{{\normalfont\ttfamily]}} +\DeclareRobustCommand\lrb{{\normalfont\ttfamily(}} +\DeclareRobustCommand\rrb{{\normalfont\ttfamily)}} +\DeclareRobustCommand\false{{\ttfamily false}} +\DeclareRobustCommand\true{{\ttfamily true}} + +% +% without brackets +\def\Coordx#1{$x_{#1}$} +\def\Coordy#1{$y_{#1}$} +\def\Coordz#1{$z_{#1}$} +\def\Coord#1{\Coordx{#1},\kern 1pt\Coordy{#1}} +\def\Coordn{\Coordx{n},\kern 1pt\Coordy{n}} +\def\CoordIII#1{\Coordx{#1},\kern 1pt\Coordy{#1},\kern 1pt\Coordz{#1}}% HjG +\def\CAny{\Coordx{},\kern 1pt\Coordy{}} +\def\CIIIAny{\Coordx{},\kern 1pt\Coordy{},\kern 1pt\Coordz{}}% hv +% with brackets +\def\coord#1{(\Coordx{#1},\kern 1pt\Coordy{#1})} +\def\coordn{(\Coordx{n},\kern 1pt\Coordy{n})} +\def\coordiii#1{(\Coordx{#1},\kern 1pt\Coordy{#1},\kern 1pt\Coordz{#1})}% hv +\def\coordx#1{($x_{#1}$)} +\def\coordy#1{($y_{#1}$)} +\def\coordz#1{($z_{#1}$)} +\def\cAny{(\Coordx{},\kern 1pt\Coordy{})} +\def\ciiiAny{(\Coordx{},\kern 1pt\Coordy{},\kern 1pt\Coordz{})}% hv +% +\newskip\BDefaboveskip +\newskip\BDefbelowskip +\newskip\BDefinlineskip +\setlength\BDefaboveskip{0pt plus 2pt}% first-level list topsep +\setlength\BDefbelowskip{10pt} +\setlength\BDefinlineskip{6pt} +% +\makeatletter +\newsavebox{\boxdef} +\newenvironment{BDef} + {\begin{lrbox}\boxdef + \def\arraystretch{1.0} + \begin{tabular}{@{}l@{}l@{}l@{}}} + {\end{tabular}\end{lrbox} +% +% braces around next block are needed to stop the list env checking for blank lines +% and the \aftergroups then for making sure no indentation happens ... as i said +% urg +% + {\BCmd\fbox{\usebox\boxdef}\endBCmd} + \aftergroup\@afterindentfalse\aftergroup\@afterheading + } +\newenvironment{BDef*} + {\begin{lrbox}\boxdef + \def\arraystretch{1.0} + \begin{tabular}{@{}l@{}l@{}l@{}} + } + {\end{tabular}\end{lrbox} + {\begin{BCmd*}\fbox{\usebox\boxdef}\end{BCmd*}} + \aftergroup\@afterindentfalse\aftergroup\@afterheading + } +\newenvironment{BCmd}{ + \@beginparpenalty-\@lowpenalty + \topsep\BDefaboveskip + \fboxsep3pt + \flushleft} + {\@endparpenalty\@M + \@topsepadd\BDefbelowskip + \endflushleft} + +\newenvironment{BCmd*}{ + \@beginparpenalty\@M + \topsep\BDefinlineskip + \fboxsep3pt + \flushleft} + {\@endparpenalty5000 + \endflushleft} + + +\def\OptArgs{\colorbox{black!20}{\texttt{[Options]}}\kern1pt} +\def\OptArg{\@ifnextchar*\OptArg@i{\OptArg@ii*}}% star version without braces +\def\OptArg@i*#1{\colorbox{black!20}{\texttt{#1}}\kern1pt} +\def\OptArg@ii*#1{\colorbox{black!20}{\texttt{[#1]}}\kern1pt} +\def\DBS{{\ttfamily\textbackslash\textbackslash}} + +\makeatother \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdf b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdf index 1faf862603c..3344972804c 100644 Binary files a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdf and b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdf differ diff --git a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex index 235b3485073..f7f3bc89ceb 100644 --- a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex +++ b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex @@ -1,42 +1,343 @@ -\documentclass[pagesize=auto, fontsize=14pt, DIV=9, parskip=half]{scrartcl} -\usepackage{fixltx2e} -\usepackage{etex} -\usepackage{lmodern} -\usepackage[T1]{fontenc} -\usepackage{textcomp} +% arara: latex: {draft: yes} +% arara: latex +% arara: biber +% arara: makeindex +% arara: latex: {draft: yes} +% arara: latex +% arara: dvips +% arara: ps2pdf +% arara: clean: { files:[pst-exa-doc.out, pst-exa-doc.ps, pst-exa-doc.toc,pst-exa-doc.log,pst-exa-doc.ind,pst-exa-doc.aux, pst-exa-doc.bbl, pst-exa-doc.bcf, pst-exa-doc.blg,pst-exa-doc.dvi,pst-exa-doc.idx,pst-exa-doc.ilg,pst-exa-doc.run.xml] } +\documentclass[11pt,english,BCOR=10mm,DIV=12,bibliography=totoc,parskip=false,headings=small, + headinclude=false,footinclude=false,twoside]{scrartcl} \usepackage[utf8]{inputenc} -\usepackage{microtype} -\usepackage{hyperref} +\usepackage[T1]{fontenc} +\usepackage{libertine} +\usepackage[scaled=0.88]{beramono} +\usepackage{babel} +\usepackage{makeidx}\makeindex +\input{\jobname.inc} +\listfiles +\let\Lfile\LFile +\usepackage{pst-node} +\usepackage{biblatex} -\newcommand*{\mail}[1]{\href{mailto:#1}{\texttt{#1}}} -\newcommand*{\pkg}[1]{\textsf{#1}} -\newcommand*{\env}[1]{\texttt{#1}} -\def\PS{PostScript} -\addtokomafont{title}{\rmfamily} +\addbibresource{\jobname.bib} -\title{The \pkg{pst-exa} package\thanks{This manual corresponds to \pkg{pst-exa.sty}~v0.05, dated~2014/09/24.}} -\author{Herbert Voß\thanks{\mail{hvoss@tug.org}}} -\date{\today} +\usepackage{xspace,showexpl} +\usepackage{pst-text,pst-grad} +\usepackage[tcb]{pst-exa} +\let\pstFV\fileversion +%\DeclareFixedFont{\RM}{T1}{ptm}{b}{n}{4cm} +%\renewcommand\bgImage{\pscharpath[fillstyle=gradient, +% gradbegin=red,gradend=blue,gradangle=-90]{\RM pst-exa}} +\lstset{language=PSTricks,basicstyle=\footnotesize\ttfamily} +\def\DVI{\textsc{DVI}} +\def\PDF{\textsc{PDF}} +\def\gs{\textsc{Ghostscript}} +% \begin{document} - +\title{\texttt{pst-exa}\\ +Generate examples for PSTricks environments (with pdflatex);\\ \small v. 0.06} +\author{Herbert Vo\ss \\ Pablo Gonz\'{a}lez Luengo} +%\docauthor{} +\date{\today} \maketitle -The package \pkg{pst-exa} was created to realize examples with printed code and output -side by side or on top of each other. The package looks in the image directory for the source -code of the examples and inserts only the code between the environment \env{document}, -which is the sequence \verb+\begin{document} ... \end{document}+. +\tableofcontents -The package provides the environment \env{PSTexample} with the optional -arguments. For more information read the documentation of \texttt{pst2pdf}. +\clearpage -Using \pkg{pst-exa} makes only sense together with the Perl script \texttt{pst2pdf}, which -allows the use of Postscript code and running the document in \textsc{pdf} mode. +\section{Introduction} -\nocite{*} -\bibliographystyle{plain} -\bibliography{\jobname} +The package \LPack{pst-exa} was created to realize examples with printed +code and output side by side or on top of each other. The package +looks in the image directory for the source code of the examples +and inserts only the image for code environment + +However, creating a \PDF\ file in a direct way with \Lprog{pst2pdf} or \Lprog{ltximg} is +possible and the compiles whits \Lprog{pdflatex}. + +\PST\ as \PS\ related package uses the programming language \PS\ for internal +calculations. This is an important advantage, because floating point arithmetic is no +problem. Nearly all mathematical calculation can be done when running the \DVI-file +with \gs. + +\section{Loading the package} + +The package \LPack{pst-exa} must be loaded with one of the following options in the preamble of the document: + +\begin{verbatim} +\usepackage[swpl]{pst-exa} +\end{verbatim} + +automatically load \LPack{showexpl} package. + +\begin{verbatim} +\usepackage[tcb]{pst-exa} +\end{verbatim} + +automatically load \LPack{tcolorbox} package. + +\section{Environments} +The package \LPack{pst-exa} provides two environments: + +\Lenv{PSTcode} to write only code that does not generate +an image, this is necessary to not interrupt the order in which the images are copied by the script in the process +of conversion to pdf. + +\Lenv{PSTexample} environment, +to write only code that generates an image, keep in mind that the script that performs the extraction process +does not distinguish the format given to the lines in this environment (only reads plain text) the idea is to +concentrate on the image you want to extrare and then in the format of the text. + +\section{Programs needed} +You need \nxLprog{pst2pdf} (or \Lprog{ltximg}) whit a latest version of \Lprog{Ghostscript} (9.14), +\Lprog{perl} (>=5.18), \Lprog{pdf2svg}, \Lprog{pdftoppm} and \Lprog{pdftops} +(from \Lprog{poppler-utils} or \Lprog{xpdf-utils}) for the process file. + +The general syntax for the \emph{script} is simple: + +\begin{BDef} +\nxLprog{perl} \nxLprog{pst2pdf} \Larg{file.tex} \Largs{--options} +\end{BDef} + +For \TeX Live users: +\begin{BDef} +\nxLprog{pst2pdf} \Larg{file.tex} \Largs{--options} +\end{BDef} + +this create file-pdf-exa.pdf and file-fig-exa-1.pdf, file-fig-exa-2.pdf, file-fig-exa-\dots.pdf + +\section{Examples with option \texttt{tcb}} + +\verb|\begin{pspicture}| o \tcboxverb{\begin{pspicture}[showgrid](4,4)} + +\begin{pspicture}[showgrid](4,4) + \psRing(2,2){0.3}{0.8} + \psRing*[opacity=0.5](2,2){1}{2} +\psdot(2,2) +\end{pspicture} + +%\mint[hola]{algo}$\begin{pspicture} o \begin{pspicture*}$ no problem whit inline verb :) +\section{Test PSTexample} +% numbers=none +\begin{PSTexample}[pos=t,numbers=fancy,title=First example] +\pstVerb{ 1234321 srand } +\begin{pspicture}[showgrid](-2,-2)(2,2) +\psframe*[linecolor=blue,opacity=!Rand](2,2) +\psframe*[linecolor=red,opacity=!Rand](-1,-1)(1,1) +\psframe*[linecolor=green,opacity=!Rand](-2,-2)(0,0) +\end{pspicture} +\end{PSTexample} +\vspace{20pt} +\begin{PSTexample}[hwidth=5cm] +\begin{pspicture}[showgrid](4,4) + \psRing(2,2){0.3}{0.8} + \psRing*[opacity=0.5](2,2){1}{2} +\psdot(2,2) +\end{pspicture} +\end{PSTexample} +% ned +\section{Test PSTcode} +\begin{PSTcode} +\pstVerb{ 1234321 srand } +\begin{pspicture}[showgrid](-2,-2)(2,2) +\psframe*[linecolor=blue,opacity=!Rand](2,2) +\psframe*[linecolor=red,opacity=!Rand](-1,-1)(1,1) +\psframe*[linecolor=green,opacity=!Rand](-2,-2)(0,0) +\end{pspicture} +\end{PSTcode} + +\begin{PSTcode} +\begin{pspicture}[showgrid](4,4) + \psRing(2,2){0.3}{0.8} + \psRing*[opacity=0.5](2,2){1}{2} +\psdot(2,2) +\end{pspicture} +\end{PSTcode} + + +\section{Examples with option \texttt{swpl}} + +\makeatletter +\pstexa@swpltrue +% Star code for swpl option +% Environment for code +\let\PSTcode\relax +\let\endPSTcode\relax +\lstnewenvironment{PSTcode} + {% +\lstset{ + language=PSTexa,% + frame=single,% + numbers=left,% + numbersep=1em,% + numberstyle=\tiny\color{black!75}\noaccsupp,% + rulecolor=\color{black!67},% + framesep=\fboxsep,% + framerule=\fboxrule,% + xleftmargin=\dimexpr\fboxsep+\fboxrule\relax,% + xrightmargin=\dimexpr\fboxsep+\fboxrule\relax,% + backgroundcolor=\color[rgb]{1,1,0.8},% +% literateee +literate=*{\{}{{\textcolor{blue}{\{}}}{1} + {\}}{{\textcolor{blue}{\}}}}{1} + {[}{{\textcolor{blue}{[}}}{1} + {]}{{\textcolor{blue}{]}}}{1} + {(}{{\textcolor{blue}{(}}}{1} + {)}{{\textcolor{blue}{)}}}{1} + {\$}{{\textcolor{red}{\$}}}{1} + {\#}{{\textcolor{red}{\#}}}{1}%, + }% close lstset + }% +{}% close PSTcode + +% Change position for images +\renewcommand*\SX@resultInput{% + \ifx\SX@graphicname\@empty + \begingroup + \MakePercentComment\makeatother\catcode`\^^M=5\relax + \SX@@preset\SX@preset + \if@SX@rangeaccept + \let\SX@tempa=\SX@input + \else + \let\SX@tempa=\input + \fi + \SX@tempa{\SX@codefile}\par% + \endgroup + \else + \begin{center} + \expandafter\includegraphics\expandafter[\SX@graphicparam]{\SX@graphicname} + \end{center} + \fi +}% end change postition +% PSTexample definition in swpl +\let\PSTexample\relax +\let\endPSTexample\relax + \lstnewenvironment{PSTexample}[1][] + {% + \lstset{% + language=PSTexa,% + frame=single,% + numbers=left,% + numbersep=1em,% + numberstyle=\tiny\color{black!75}\noaccsupp,% + rulecolor=\color{black!67},% + framesep=\fboxsep,% + framerule=\fboxrule,% + xleftmargin=\dimexpr\fboxsep+\fboxrule\relax,% + xrightmargin=\dimexpr\fboxsep+\fboxrule\relax,% + backgroundcolor=\color[rgb]{1,1,0.8},% +% literate for swpl, need inside the explpreset + explpreset={ +% literate +literate=*{\{}{{\textcolor{blue}{\{}}}{1} + {\}}{{\textcolor{blue}{\}}}}{1} + {[}{{\textcolor{blue}{[}}}{1} + {]}{{\textcolor{blue}{]}}}{1} + {(}{{\textcolor{blue}{(}}}{1} + {)}{{\textcolor{blue}{)}}}{1} + {\$}{{\textcolor{red}{\$}}}{1} + {\#}{{\textcolor{red}{\#}}}{1},% + codefile=\jobname.swpl,% + hsep=\columnsep,% + vsep=15pt,% + pos=l,% + wide=false,% + rframe={},% + preset=\centering,% + } % close explpreset + } % close lstset + \@temptokena{#1}% + \begingroup + \advance\c@ltxexample\@ne \advance\c@lstlisting\@ne + \expandafter\lstset\expandafter{\SX@explpreset,#1}% + \edef\x{\endgroup + \def\noexpand\SX@codefile{\SX@codefile}% + \def\noexpand\SX@graphicname{\SX@graphicname}% + \def\noexpand\SX@graphicparam{\SX@graphicparam}}% + \x + \xdef\SX@@explpreset{\the\@temptokena,codefile=\SX@codefile, + graphic={[\SX@graphicparam]{\SX@graphicname}}}% + \setbox\@tempboxa=\hbox\bgroup% Warum noetig? + \lst@BeginWriteFile{\SX@codefile}% +% Change position for images + } + {% + \lst@EndWriteFile\egroup + \SX@put@code@result + }% close environment +% end swpl code +\makeatother + +% numbers=none +\begin{PSTexample}[pos=t,numbers=none] +\pstVerb{ 1234321 srand } +\begin{pspicture}[showgrid](-2,-2)(2,2) +\psframe*[linecolor=blue,opacity=!Rand](2,2) +\psframe*[linecolor=red,opacity=!Rand](-1,-1)(1,1) +\psframe*[linecolor=green,opacity=!Rand](-2,-2)(0,0) +\end{pspicture} +\end{PSTexample} +% numbers true default +\begin{PSTexample}[width=5cm] +\begin{pspicture}[showgrid](4,4) + \psRing(2,2){0.3}{0.8} + \psRing*[opacity=0.5](2,2){1}{2} +\psdot(2,2) +\end{pspicture} +\end{PSTexample} +% ned + +\begin{PSTcode} +\pstVerb{ 1234321 srand } +\begin{pspicture}[showgrid](-2,-2)(2,2) +\psframe*[linecolor=blue,opacity=!Rand](2,2) +\psframe*[linecolor=red,opacity=!Rand](-1,-1)(1,1) +\psframe*[linecolor=green,opacity=!Rand](-2,-2)(0,0) +\end{pspicture} +\end{PSTcode} + +\begin{PSTcode} +\begin{pspicture}[showgrid](4,4) + \psRing(2,2){0.3}{0.8} + \psRing*[opacity=0.5](2,2){1}{2} +\psdot(2,2) +\end{pspicture} +\end{PSTcode} + +\begin{pspicture}[showgrid](4,4) + \psRing(2,2){0.3}{0.8} + \psRing*[opacity=0.5](2,2){1}{2} +\psdot(2,2) +\end{pspicture} + + + + +\definecolor{mygreen}{rgb}{0,0.6,0} +\definecolor{mygray}{rgb}{0.5,0.5,0.5} + +\lstset{ % + basicstyle=\ttfamily\small, + commentstyle=\color{mygreen}, + extendedchars=true, + frame={}, + keepspaces=true, + keywordstyle=\color{blue}, + numbers=left, + numbersep=5pt, + numberstyle=\tiny\color{mygray} +} +%\lstinputlisting[language=TeX]{pst-exa.sty} +%\newpage +% +\clearpage +\nocite{*} +\printbibliography +\printindex \end{document} -- cgit v1.2.3