summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/ptex2pdf/README
blob: c19322ee23052ffec0a0dc355383b92dd6ff03cb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
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.