summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/ptex2pdf/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/ptex2pdf/README')
-rw-r--r--Master/texmf-dist/doc/latex/ptex2pdf/README111
1 files changed, 111 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/ptex2pdf/README b/Master/texmf-dist/doc/latex/ptex2pdf/README
new file mode 100644
index 00000000000..c19322ee230
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ptex2pdf/README
@@ -0,0 +1,111 @@
+ptex2pdf.lua
+============
+
+Convert Japanese TeX documents to pdf
+
+Author: Norbert Preining <norbert@preining.info>
+
+Main purpose of the script is easy support of Japanese typesetting
+engines in TeXworks. As TeXworks typesetting setup does not allow
+for multistep processing, this script runs one of the ptex based
+programs (ptex, uptex, eptex, platex, uplatex) followed by dvipdfmx.
+
+Usage
+-----
+[texlua] ptex2pdf[.lua] { option | basename[.tex] } ...
+options: -v version
+ -h help
+ -e use eptex class of programs
+ -u use uptex class of programs
+ -l use latex based formats
+ -s stop at dvi
+ -i retain intermediate files
+ -ot '<opts>' extra options for TeX
+ -od '<opts>' extra options for dvipdfmx
+
+
+Installation
+------------
+
+Copy the file ptex2pdf.lua into a directory where scripts are found,
+that is for example
+ TLROOT/texmf-dist/scripts/ptex2pdf/
+(where TLROOT is for example the root of your TeX Live installation)
+
+Unix:
+create a link in one of the bin dirs to the above file, in the
+TeX Live case:
+ TLROOT/bin/ARCH/ptex2pdf -> ../../texmf-dist/scripts/ptex2pdf/ptex2pdf.lua
+
+Windows:
+create a copy of runscript.exe as ptex2pdf.exe, in the TeX Live case:
+ copy TLROOT/bin/win32/runscript.exe TLROOT/bin/win32/ptex2pdf.exe
+
+
+
+TeXworks setup
+--------------
+Under Preferences > Typesetting add new entries, for example:
+
+for ptex files:
+ Name: pTeX to pdf
+ Program: ptex2pdf
+ Arguments: -ot
+ $synctexoption
+ $fullname
+
+for platex files:
+ Name: pLaTeX to pdf
+ Program: ptex2pdf
+ Arguments: -l
+ -ot
+ $synctexoption
+ $fullname
+
+for uptex files:
+ Name: upTeX to pdf
+ Program: ptex2pdf
+ Arguments: -u
+ -ot
+ $synctexoption
+ $fullname
+
+for uplatex files:
+ Name: upLaTeX to pdf
+ Program: ptex2pdf
+ Arguments: -l
+ -u
+ -ot
+ $synctexoption
+ $fullname
+
+
+Original development place
+--------------------------
+https://git.gitorious.org/tlptexlive/ptex2pdf.git
+
+
+License and copyright
+---------------------
+
+Originally based on musixtex.lua from Bob Tennent.
+
+(c) Copyright 2012 Bob Tennent rdt@cs.queensu.ca
+(c) Copyright 2013 Norbert Preining norbert@preining.info
+
+This program is free software; you can redistribute it and/or modify it
+under the terms of the GNU General Public License as published by the
+Free Software Foundation; either version 2 of the License, or (at your
+option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
+Public License for more details.
+
+You should have received a copy of the GNU General Public License along
+with this program; if not, write to the Free Software Foundation, Inc.,
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+
+
+