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