summaryrefslogtreecommitdiff
path: root/graphics/pstricks/scripts/pst2pdf/README
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /graphics/pstricks/scripts/pst2pdf/README
Initial commit
Diffstat (limited to 'graphics/pstricks/scripts/pst2pdf/README')
-rw-r--r--graphics/pstricks/scripts/pst2pdf/README59
1 files changed, 59 insertions, 0 deletions
diff --git a/graphics/pstricks/scripts/pst2pdf/README b/graphics/pstricks/scripts/pst2pdf/README
new file mode 100644
index 0000000000..b59e3919cf
--- /dev/null
+++ b/graphics/pstricks/scripts/pst2pdf/README
@@ -0,0 +1,59 @@
+pst2pdf is a Perl script which isolates all PostScript or
+PSTricks related parts of the TeX document into single
+LaTeX files, for which an eps and pdf image is created.
+The pdf ones are then imported in a last pdflatex run
+for the pdf output of the main document. The eps and
+pdf files are saved in a subdirectory images.
+
+Syntax: pst2pdf.pl file[.tex] [options]
+
+alternative: perl pst2pdf.pl file[.tex] [options]
+
+
+Some restrictions:
+\begin{postscript}
+...
+\begin{pspicture}
+....
+\end{pspicture}
+...
+\end{postscript}
+
+The pspicture environment can be nested, the postscript one NOT!
+pspicture can be inside of a postscript environment, but
+not vice versa.
+
+The postscript environment should be used for all other
+PostScript related commands, which are not part of
+a pspicture environment, e.g. nodes inside normal text.
+
+pst2pdf creates a document file-pdf.tex for use with
+pdflatex, which then creates file-pdf.pdf. The created
+images are named file-fig-<No>.pdf
+
+Options:
+ -h,--help - display this help and exit
+ -l,--license - display license information and exit
+ -v,--version - display version (current $nv) and exit
+ -d,--dpi=<int> - the dots per inch for images (default 300)
+ -j,--jpg - create .jpg files (need Ghostscript)
+ -p,--png - create .png files (need Ghostscript)
+ -e,--eps - create .eps files (need pdftops)
+ -s,--svg - create .svg files (need pdf2svg)
+ -P,--ppm - create .ppm files (need pdftoppm)
+ -a,--all - create .(pdf,eps,jpg,png,ppm,svg) images
+ -c,--clear - delete all temp and aux files
+ -x,--xetex - using (Xe)LaTeX for create images
+ -m,--margins=<int> - margins for pdfcrop (in bp) (default 1)
+ -ni,--noimages - generate file-pdf.tex, but not images
+ -np,--single - create images files whitout preview and Ghostscript
+ -ns,--nosource - delete all source(.tex) for images files
+ --imgdir=<string> - the folder for the created images (default images)
+ --ignore=<string> - skip other verbatim environment (default other)
+ --bibtex - run bibtex on the aux file, if exists
+ --biber - run biber on the bcf file, if exists
+ --Verbose - creates a long log file (.plog)
+
+for more documentation => pst2pdf --help or read the documentation
+--
+Herbert Voss 2010-01-04