source: archive/jadetex.xml@ fa91d2e

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since fa91d2e was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 10.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY jadetex-download-http "&sourceforge-repo;/jadetex/jadetex-&jadetex-version;.tar.gz">
8 <!ENTITY jadetex-download-ftp "&gentoo-ftp-repo;/jadetex-&jadetex-version;.tar.gz">
9 <!ENTITY jadetex-md5sum "634dfc172fbf66a6976e2c2c60e2d198">
10 <!ENTITY jadetex-size "103 KB">
11 <!ENTITY jadetex-buildsize "9.3 MB">
12 <!ENTITY jadetex-time "less than 0.1 SBU">
13]>
14
15<sect1 id="jadetex" xreflabel="JadeTeX-&jadetex-version;">
16 <?dbhtml filename="jadetex.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>JadeTeX-&jadetex-version;</title>
23
24 <indexterm zone="jadetex">
25 <primary sortas="a-JadeTeX">JadeTeX</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to JadeTeX</title>
30
31 <para>The <application>JadeTeX</application> package is a companion package
32 to the <application>OpenJade</application> DSSSL processor.
33 <application>JadeTeX</application> transforms high level LaTeX macros into
34 DVI/PostScript and Portable Document Format (PDF) forms.</para>
35
36 &lfs70_checked;
37
38 <important>
39 <para>Do not install this package if you have already installed
40 <xref linkend="texlive"/>. The <application>TeX Live</application>
41 installation includes the <application>JadeTeX</application>
42 components.</para>
43 </important>
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>Download (HTTP): <ulink url="&jadetex-download-http;"/></para>
49 </listitem>
50 <listitem>
51 <para>Download (FTP): <ulink url="&jadetex-download-ftp;"/></para>
52 </listitem>
53 <listitem>
54 <para>Download MD5 sum: &jadetex-md5sum;</para>
55 </listitem>
56 <listitem>
57 <para>Download size: &jadetex-size;</para>
58 </listitem>
59 <listitem>
60 <para>Estimated disk space required: &jadetex-buildsize;</para>
61 </listitem>
62 <listitem>
63 <para>Estimated build time: &jadetex-time;</para>
64 </listitem>
65 </itemizedlist>
66
67 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
68 <itemizedlist spacing='compact'>
69 <listitem>
70 <para>Recommended demo files: <ulink
71 url="&sources-anduin-http;/j/jadetex-3.13-demo.tar.bz2"/>
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">JadeTeX Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required"><xref linkend="texlive"/> and
80 <xref linkend="openjade"/></para>
81
82 <para condition="html" role="usernotes">User Notes:
83 <ulink url="&blfs-wiki;/jadetex"/></para>
84
85 </sect2>
86
87 <sect2 role="installation">
88 <title>Installation of JadeTeX</title>
89
90 <para>If you downloaded the demo files tarball, unpack it along with the
91 source tarball. It will unpack as a
92 <filename class='directory'>demo</filename> directory in the root of the
93 source tree.</para>
94
95 <para>First, as the <systemitem class="username">root</systemitem> user,
96 make some required modifications to the <filename>texmf.cnf</filename>
97 file already installed on the system by the <application>texlive</application>
98 package, then build a new <filename>latex.fmt</filename> file using the
99 following commands:</para>
100
101<screen role="root"><?dbfo keep-together="auto"?><userinput>sed -i.orig -e "s/original texmf.cnf/modified texmf.cnf/" \
102 -e "s/memory hog.../&amp;\npool_size.context = 750000/" \
103 $(kpsewhich texmf.cnf) &amp;&amp;
104cat &gt;&gt; $(kpsewhich texmf.cnf) &lt;&lt; "EOF"
105<literal>
106% The following 3 sections added for JadeTeX
107
108% latex settings
109main_memory.latex = 1100000
110param_size.latex = 1500
111stack_size.latex = 1500
112hash_extra.latex = 15000
113string_vacancies.latex = 45000
114pool_free.latex = 47500
115nest_size.latex = 500
116save_size.latex = 5000
117pool_size.latex = 500000
118max_strings.latex = 55000
119font_mem_size.latex= 400000
120
121% jadetex settings
122main_memory.jadetex = 1500000
123param_size.jadetex = 1500
124stack_size.jadetex = 1500
125hash_extra.jadetex = 50000
126string_vacancies.jadetex = 45000
127pool_free.jadetex = 47500
128nest_size.jadetex = 500
129save_size.jadetex = 5000
130pool_size.jadetex = 500000
131max_strings.jadetex = 55000
132
133% pdfjadetex settings
134main_memory.pdfjadetex = 2500000
135param_size.pdfjadetex = 1500
136stack_size.pdfjadetex = 1500
137hash_extra.pdfjadetex = 50000
138string_vacancies.pdfjadetex = 45000
139pool_free.pdfjadetex = 47500
140nest_size.pdfjadetex = 500
141save_size.pdfjadetex = 5000
142pool_size.pdfjadetex = 500000
143max_strings.pdfjadetex = 55000
144</literal>
145EOF
146LATEX_FMT_DIR="$(kpsewhich -expand-var '$TEXMFSYSVAR')/web2c" &amp;&amp;
147mv -v $(kpsewhich latex.fmt) $(kpsewhich latex.fmt).orig &amp;&amp;
148mv -v $LATEX_FMT_DIR/latex.log $LATEX_FMT_DIR/latex.log.orig &amp;&amp;
149fmtutil-sys --byfmt latex</userinput></screen>
150
151 <para>Install <application>JadeTex</application> using the following
152 commands:</para>
153
154<screen><userinput>make</userinput></screen>
155
156 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
157
158<screen role="root"><userinput>install -v -m755 -d \
159 $(kpsewhich -expand-var '$TEXMFLOCAL')/tex/jadetex/config &amp;&amp;
160install -v -m644 dsssl.def jadetex.ltx *.sty \
161 $(kpsewhich -expand-var '$TEXMFLOCAL')/tex/jadetex &amp;&amp;
162install -v -m644 {,pdf}jadetex.ini \
163 $(kpsewhich -expand-var '$TEXMFLOCAL')/tex/jadetex/config &amp;&amp;
164FMTUTIL_CNF="$(kpsewhich fmtutil.cnf)" &amp;&amp;
165mv $FMTUTIL_CNF $FMTUTIL_CNF.orig &amp;&amp;
166cat $FMTUTIL_CNF.orig - &gt;&gt; $FMTUTIL_CNF &lt;&lt; "EOF"
167<literal>
168# JadeTeX formats:
169jadetex etex - "&amp;latex" jadetex.ini
170pdfjadetex pdfetex - "&amp;pdflatex" pdfjadetex.ini
171</literal>
172EOF
173mv -v $(kpsewhich -expand-var '$TEXMFMAIN')/ls-R \
174 $(kpsewhich -expand-var '$TEXMFMAIN')/ls-R.orig &amp;&amp;
175mv -v $(kpsewhich -expand-var '$TEXMFSYSVAR')/ls-R \
176 $(kpsewhich -expand-var '$TEXMFSYSVAR')/ls-R.orig &amp;&amp;
177mktexlsr &amp;&amp;
178fmtutil-sys --byfmt jadetex &amp;&amp;
179fmtutil-sys --byfmt pdfjadetex &amp;&amp;
180mktexlsr &amp;&amp;
181ln -v -sf $(which etex) /usr/bin/jadetex &amp;&amp;
182ln -v -sf $(which pdfetex) /usr/bin/pdfjadetex &amp;&amp;
183install -v -m644 -D index.html \
184 /usr/share/doc/jadetex-&jadetex-version;/index.html &amp;&amp;
185install -v -m644 *.1 /usr/share/man/man1</userinput></screen>
186
187 <para>If you downloaded the demo files tarball, issue the following
188 commands as an unprivileged user to test the functionality of the new
189 <application>JadeTex</application> installation:</para>
190
191<screen><userinput>cd demo &amp;&amp;
192openjade -t tex -d demo.dsl demo.sgm &amp;&amp;
193jadetex demo.tex &amp;&amp;
194pdfjadetex demo.tex &amp;&amp;
195ls -lrt &amp;&amp;
196cd ..</userinput></screen>
197
198 <para>The commands should complete without errors or warnings and create
199 <filename>demo.dvi</filename> and <filename>demo.pdf</filename> files.</para>
200
201 </sect2>
202
203 <sect2 role="commands">
204 <title>Command Explanations</title>
205
206 <para><command>sed -i -e ... -e ... $(kpsewhich texmf.cnf)</command>:
207 This command uses <command>kpsewhich</command> to locate the installed
208 <filename>texmf.cnf</filename>. The first change is used to modify the
209 header of the file so that if <application>texlive</application> is upgraded,
210 the file won't get overwritten. The next change adds a parameter to
211 increase ConTeXt's memory size to accommodate
212 <application>JadeTeX</application>.</para>
213
214 <para><command>fmtutil-sys ...</command>: These commands are used to build
215 the <filename>latex.fmt</filename>, <filename>jadetex.fmt</filename> and
216 <filename>pdfjadetex.fmt</filename> files. Additionally, the command
217 automagically places the files in the correct directory.</para>
218
219 <para><command>mktexlsr; ln -v -sf tex ...; ln -v -sf pdftex ...</command>:
220 The <application>JadeTeX</application> programs are actually just symlinks
221 to the <application>texlive</application> programs. <command>mktexlsr</command>
222 updates <application>texlive</application>'s <filename>ls-R</filename> databases
223 used by the <filename class='libraryfile'>libkpathsea</filename> library so
224 that <application>texlive</application> knows to use the
225 <application>JadeTeX</application> <filename>.fmt</filename> files when
226 <command>jadetex</command> or <command>pdfjadetex</command> is called.</para>
227
228 </sect2>
229
230 <sect2 role="configuration">
231 <title>Configuring JadeTeX</title>
232
233 <sect3>
234 <title>Config Files</title>
235
236 <para><filename>jadetex.dtx</filename> in the
237 <application>JadeTeX</application> source tree.</para>
238
239 </sect3>
240
241 <sect3>
242 <title>Configuration Information</title>
243
244 <para>If you need to modify the default <application>JadeTeX</application>
245 macro settings, see the
246 <ulink url="http://jadetex.sourceforge.net/#index-div-d18e397">
247 <application>JadeTeX</application> FAQ</ulink>.</para>
248
249 </sect3>
250
251 </sect2>
252
253 <sect2 role="content">
254 <title>Contents</title>
255
256 <segmentedlist>
257 <segtitle>Installed Programs</segtitle>
258 <segtitle>Installed Libraries</segtitle>
259 <segtitle>Installed Directories</segtitle>
260
261 <seglistitem>
262 <seg>jadetex and pdfjadetex</seg>
263 <seg>None</seg>
264 <seg>/usr/share/texmf-local and
265 /usr/share/doc/jadetex-&jadetex-version;</seg>
266 </seglistitem>
267 </segmentedlist>
268
269 <variablelist>
270 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
271 <?dbfo list-presentation="list"?>
272 <?dbhtml list-presentation="table"?>
273
274 <varlistentry id="jadetex-prog">
275 <term><command>jadetex</command></term>
276 <listitem>
277 <para>transforms LaTeX macros created by
278 <application>OpenJade</application> into DVI/PostScript forms.</para>
279 <indexterm zone="jadetex jadetex-prog">
280 <primary sortas="b-jadetex">jadetex</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="pdfjadetex">
286 <term><command>pdfjadetex</command></term>
287 <listitem>
288 <para>transforms LaTeX macros created by
289 <application>OpenJade</application> into Portable Document Format
290 (PDF) forms.</para>
291 <indexterm zone="jadetex pdfjadetex">
292 <primary sortas="b-pdfjadetex">pdfjadetex</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296
297 </variablelist>
298
299 </sect2>
300
301</sect1>
Note: See TracBrowser for help on using the repository browser.