1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
|
---|
3 | "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
---|
4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
5 | %general-entities;
|
---|
6 |
|
---|
7 | <!ENTITY jadetex-download-http "http://prdownloads.sourceforge.net/jadetex/jadetex-&jadetex-version;.tar.gz?download">
|
---|
8 | <!ENTITY jadetex-download-ftp " ">
|
---|
9 | <!ENTITY jadetex-size "103 KB">
|
---|
10 | <!ENTITY jadetex-buildsize "9.6 MB">
|
---|
11 | <!ENTITY jadetex-time "0.11 SBU">
|
---|
12 | ]>
|
---|
13 |
|
---|
14 | <sect1 id="jadetex" xreflabel="JadeTeX-&jadetex-version;">
|
---|
15 | <sect1info>
|
---|
16 | <othername>$LastChangedBy$</othername>
|
---|
17 | <date>$Date$</date>
|
---|
18 | </sect1info>
|
---|
19 | <?dbhtml filename="jadetex.html"?>
|
---|
20 | <title>JadeTeX-&jadetex-version;</title>
|
---|
21 | <indexterm zone="jadetex">
|
---|
22 | <primary sortas="a-JadeTeX">JadeTeX</primary></indexterm>
|
---|
23 |
|
---|
24 | <sect2>
|
---|
25 | <title>Introduction to <application>JadeTeX</application></title>
|
---|
26 |
|
---|
27 | <para>The <application>JadeTeX</application> package is a companion package to
|
---|
28 | the <application>OpenJade</application> <acronym>DSSSL</acronym> processor.
|
---|
29 | <application>JadeTeX</application> transforms high level LaTeX macros into
|
---|
30 | <acronym>DVI</acronym>/PostScript and Portable Document Format
|
---|
31 | (<acronym>PDF</acronym>) forms.</para>
|
---|
32 |
|
---|
33 | <sect3><title>Package information</title>
|
---|
34 | <itemizedlist spacing='compact'>
|
---|
35 | <listitem><para>Download (HTTP):
|
---|
36 | <ulink url="&jadetex-download-http;"/></para></listitem>
|
---|
37 | <listitem><para>Download (FTP):
|
---|
38 | <ulink url="&jadetex-download-ftp;"/></para></listitem>
|
---|
39 | <listitem><para>Download size: &jadetex-size;</para></listitem>
|
---|
40 | <listitem><para>Estimated disk space required:
|
---|
41 | &jadetex-buildsize;</para></listitem>
|
---|
42 | <listitem><para>Estimated build time:
|
---|
43 | &jadetex-time;</para></listitem></itemizedlist>
|
---|
44 | </sect3>
|
---|
45 |
|
---|
46 | <sect3><title><application>JadeTeX</application> dependencies</title>
|
---|
47 | <sect4><title>Required</title>
|
---|
48 | <para><xref linkend="tex"/> and
|
---|
49 | <xref linkend="openjade"/></para>
|
---|
50 | </sect4>
|
---|
51 | </sect3>
|
---|
52 |
|
---|
53 | </sect2>
|
---|
54 |
|
---|
55 | <sect2>
|
---|
56 | <title>Installation of <application>JadeTeX</application></title>
|
---|
57 |
|
---|
58 | <para>First, as the root user, make some required modifications to files
|
---|
59 | already installed on the system:</para>
|
---|
60 |
|
---|
61 | <screen><userinput role='root'><command>sed -i.orig -e "s/original texmf.cnf/modified texmf.cnf/" \
|
---|
62 | /usr/share/texmf/web2c/texmf.cnf</command></userinput></screen>
|
---|
63 |
|
---|
64 | <para>You'll need to make two modifications to
|
---|
65 | <filename>/usr/share/texmf/web2c/texmf.cnf</filename>. First, add the
|
---|
66 | following line under the section titled <quote>ConTeXt is a memory
|
---|
67 | hog...</quote>:</para>
|
---|
68 |
|
---|
69 | <screen><userinput role='root'>pool_size.context = 750000</userinput></screen>
|
---|
70 |
|
---|
71 | <para>Next, add <command>latex</command>, <command>jadetex</command> and
|
---|
72 | <command>pdfjadetex</command> settings using the following command:</para>
|
---|
73 |
|
---|
74 | <screen><userinput role='root'><command>cat >> /usr/share/texmf/web2c/texmf.cnf << "EOF"</command>
|
---|
75 |
|
---|
76 | % The following 3 sections added for JadeTeX
|
---|
77 |
|
---|
78 | % latex settings
|
---|
79 | main_memory.latex = 1100000
|
---|
80 | param_size.latex = 1500
|
---|
81 | stack_size.latex = 1500
|
---|
82 | hash_extra.latex = 15000
|
---|
83 | string_vacancies.latex = 45000
|
---|
84 | pool_free.latex = 47500
|
---|
85 | nest_size.latex = 500
|
---|
86 | save_size.latex = 5000
|
---|
87 | pool_size.latex = 500000
|
---|
88 | max_strings.latex = 55000
|
---|
89 | font_mem_size.latex= 400000
|
---|
90 |
|
---|
91 | % jadetex settings
|
---|
92 | main_memory.jadetex = 1500000
|
---|
93 | param_size.jadetex = 1500
|
---|
94 | stack_size.jadetex = 1500
|
---|
95 | hash_extra.jadetex = 50000
|
---|
96 | string_vacancies.jadetex = 45000
|
---|
97 | pool_free.jadetex = 47500
|
---|
98 | nest_size.jadetex = 500
|
---|
99 | save_size.jadetex = 5000
|
---|
100 | pool_size.jadetex = 500000
|
---|
101 | max_strings.jadetex = 55000
|
---|
102 |
|
---|
103 | % pdfjadetex settings
|
---|
104 | main_memory.pdfjadetex = 2500000
|
---|
105 | param_size.pdfjadetex = 1500
|
---|
106 | stack_size.pdfjadetex = 1500
|
---|
107 | hash_extra.pdfjadetex = 50000
|
---|
108 | string_vacancies.pdfjadetex = 45000
|
---|
109 | pool_free.pdfjadetex = 47500
|
---|
110 | nest_size.pdfjadetex = 500
|
---|
111 | save_size.pdfjadetex = 5000
|
---|
112 | pool_size.pdfjadetex = 500000
|
---|
113 | max_strings.pdfjadetex = 55000
|
---|
114 | <command>EOF</command></userinput></screen>
|
---|
115 |
|
---|
116 | <para>Build a new <filename>latex.fmt</filename> file using the following
|
---|
117 | commands:</para>
|
---|
118 |
|
---|
119 | <screen><userinput><command>cp -v -R /usr/share/texmf/tex/latex/config . &&
|
---|
120 | cd config &&
|
---|
121 | tex -ini -progname=latex latex.ini &&
|
---|
122 | cd ..</command></userinput></screen>
|
---|
123 |
|
---|
124 | <para>Now, as the root user, install the <filename>latex.fmt</filename> file,
|
---|
125 | then build and install <application>JadeTex</application> using the following
|
---|
126 | commands:</para>
|
---|
127 |
|
---|
128 | <screen><userinput role='root'><command>mv /usr/share/texmf/web2c/latex.fmt \
|
---|
129 | /usr/share/texmf/web2c/latex.fmt.orig &&
|
---|
130 | install -v -m644 config/latex.fmt /usr/share/texmf/web2c &&
|
---|
131 | make install &&
|
---|
132 | ln -v -sf tex /usr/bin/jadetex &&
|
---|
133 | ln -v -sf pdftex /usr/bin/pdfjadetex &&
|
---|
134 | mktexlsr</command></userinput></screen>
|
---|
135 |
|
---|
136 | </sect2>
|
---|
137 |
|
---|
138 | <sect2>
|
---|
139 | <title>Command explanations</title>
|
---|
140 |
|
---|
141 | <para><command>sed -i -e "s/original texmf.cnf/modified texmf.cnf/"</command>:
|
---|
142 | This changes <filename>/usr/share/texmf/web2c/texmf.cnf</filename> so that if
|
---|
143 | <application>TeX</application> is upgraded, this file won't get
|
---|
144 | overwritten.</para>
|
---|
145 |
|
---|
146 | <para><command>ln -v -sf tex ...; ln -v -sf pdftex ...; mktexlsr</command>: The
|
---|
147 | <application>JadeTeX</application> programs are actually just symlinks to the
|
---|
148 | <application>TeX</application> programs. <command>mktexlsr</command> updates
|
---|
149 | <application>TeX</application>'s <filename>ls-R</filename> database used by
|
---|
150 | the <filename class='libraryfile'>libkpathsea</filename> library so that
|
---|
151 | <application>TeX</application> knows to use the
|
---|
152 | <application>JadeTeX</application> <filename>.fmt</filename> files when
|
---|
153 | <command>jadetex</command> or <command>pdfjadetex</command> is called.</para>
|
---|
154 |
|
---|
155 | </sect2>
|
---|
156 |
|
---|
157 | <sect2>
|
---|
158 | <title>Configuring <application>JadeTeX</application></title>
|
---|
159 |
|
---|
160 | <sect3><title>Config files</title>
|
---|
161 | <para><filename>jadetex.dtx</filename> in the
|
---|
162 | <application>JadeTeX</application> source tree.</para>
|
---|
163 | </sect3>
|
---|
164 |
|
---|
165 | <sect3><title>Configuration Information</title>
|
---|
166 |
|
---|
167 | <para>If you need to modify the default <application>JadeTeX</application>
|
---|
168 | macro settings, see the
|
---|
169 | <ulink url="http://jadetex.sourceforge.net/#index-div-d18e397">
|
---|
170 | <application>JadeTeX</application> <acronym>FAQ</acronym></ulink>.</para>
|
---|
171 | </sect3>
|
---|
172 |
|
---|
173 | </sect2>
|
---|
174 |
|
---|
175 | <sect2>
|
---|
176 | <title>Contents</title>
|
---|
177 |
|
---|
178 | <segmentedlist>
|
---|
179 | <segtitle>Installed Programs</segtitle>
|
---|
180 | <segtitle>Installed Libraries</segtitle>
|
---|
181 | <segtitle>Installed Directories</segtitle>
|
---|
182 | <seglistitem>
|
---|
183 | <seg>jadetex and pdfjadetex</seg>
|
---|
184 | <seg>None</seg>
|
---|
185 | <seg>/usr/share/texmf/tex/jadetex</seg>
|
---|
186 | </seglistitem>
|
---|
187 | </segmentedlist>
|
---|
188 |
|
---|
189 | <variablelist>
|
---|
190 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
191 | <?dbfo list-presentation="list"?>
|
---|
192 |
|
---|
193 | <varlistentry id="jadetex-prog">
|
---|
194 | <term><command>jadetex</command></term>
|
---|
195 | <listitem><para>transforms LaTeX macros created by
|
---|
196 | <application>OpenJade</application> into <acronym>DVI</acronym>/PostScript
|
---|
197 | forms.</para>
|
---|
198 | <indexterm zone="jadetex jadetex-prog">
|
---|
199 | <primary sortas="b-jadetex">jadetex</primary></indexterm>
|
---|
200 | </listitem>
|
---|
201 | </varlistentry>
|
---|
202 |
|
---|
203 | <varlistentry id="pdfjadetex">
|
---|
204 | <term><command>pdfjadetex</command></term>
|
---|
205 | <listitem><para>transforms LaTeX macros created by
|
---|
206 | <application>OpenJade</application> into Portable Document Format
|
---|
207 | (<acronym>PDF</acronym>) forms.</para>
|
---|
208 | <indexterm zone="jadetex pdfjadetex">
|
---|
209 | <primary sortas="b-pdfjadetex">pdfjadetex</primary></indexterm>
|
---|
210 | </listitem>
|
---|
211 | </varlistentry>
|
---|
212 | </variablelist>
|
---|
213 |
|
---|
214 | </sect2>
|
---|
215 |
|
---|
216 | </sect1>
|
---|
217 |
|
---|