diff options
Diffstat (limited to 'Master/texmf-dist/doc/otherformats/jadetex')
14 files changed, 2379 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/ChangeLog b/Master/texmf-dist/doc/otherformats/jadetex/base/ChangeLog new file mode 100644 index 00000000000..5eff22033ca --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/ChangeLog @@ -0,0 +1,148 @@ +2002-01-14 09:12 icastle + + * jadetex.dtx, ucharacters.sty, uentities.sty: Add support for euro + symbol and € entity + + This provides higher quality euro symbol support using the + PostScript font provided by the marvosym package (instead of the TC + font). There is now a dependancy on the marvosym package as a + result. + + In addition the € entity is now supported. + +2002-01-07 17:34 icastle + + * doc/: Makefile, releasenotes.dsl, releasenotes.xml: Add skeleton + for release notes + +2002-01-07 17:33 icastle + + * doc/install.sgm: Remove obsolete install.sgm + +2002-01-07 17:32 icastle + + * doc/install.sgm: install.sgm is obsoleted by index.xml + +2002-01-07 14:46 icastle + + * ChangeLog, ChangeLog-old: The pre-CVS ChangeLog is now + ChangeLog-old. + + ChangeLog is generated by cvs2cl from the CVS Commit messages + +2002-01-07 14:28 icastle + + * mlnames.sty: sf.net request 452537 Add extra fonts + + Added a variety of extra fonts (also from the mandrakesoft + configuration). Of course, you will need these fonts installed if + you want to use them! + +2002-01-07 13:08 icastle + + * jadetex.dtx: Red Hat bugzilla bug 47345 + + https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=47345 + + Long Directory path goes off the page: If there is a long directory + path in a document it goes off the side of the page. Long + pathnames should be split or put on a separate line so that they + don't go off the edge of the page. Added + '\setlength\emergencystretch{2in}'. In case of overfull hboxes, an + extra stretchable length gets added to the end of the lines. + +2002-01-07 13:02 icastle + + * Makefile: Make makefile more friendly for packagers with + introduction of DESTDIR environment variable. This change is + transparent to those that don't want to use DESTDIR. + +2002-01-07 11:56 icastle + + * jadetex.dtx: Applied sf patch #492522 + + Fix unbalanced multi columns: the TeX multicol package supports + both balanced and unbalanced columns. However, jadetex 3.11 + doesn't call the functions for unbalanced columns correctly. Since + a bug in the handling of %page-balanced-columns?% was fixed in + 3.11, this is now the common case - so multicolumn documents that + used to work in 3.10 no longer work... + +2002-01-07 11:52 icastle + + * jadetex.dtx: Apply sf patch #470586 + + Fix for ext-graphics rendering: ExternalGraphic is centered within + \textwidth instead of \columnwidth, causing bad placement in + multicolumn mode. + +2002-01-07 11:45 icastle + + * jadetex.dtx: Add patch #444445 from source forge. + + Fix for space above horizontal rule: Not all of the patch detailed + in http://sources.redhat.com/ml/docbook-apps/2001-q2/msg00352.html + made it in to jadetex. The \nointerlineskip to supress blank space + above a horizontal rule is missing. + +2002-01-07 11:39 icastle + + * doc/install.sgm: Minor corrections + +2002-01-07 11:31 icastle + + * doc/: .cvsignore, Makefile, demo.tex, docbook.dsl, install.log, + install.pdf, install.sgm, install.tex: Reinstate "install.sgm". + Remove output files from cvs. Make "Makefile" more generic so it + will build in a standard environment. Add .cvsignore so that + openjade/pdftex output files are not checked in. + +2001-07-19 16:20 rahtz + + * ChangeLog, Makefile, jadetex.dtx, jadetex.ltx, unicode.sty: + allowed for missing T2aenc.def, and Kubek's multicol patch + +2001-07-13 10:53 rahtz + + * ChangeLog, jadetex.dtx, jadetex.ltx: corrected silly typo in qqq + fix for 3.9 + +2001-07-11 22:53 rahtz + + * ChangeLog, jadetex.dtx, jadetex.ltx: make 3.9 release (forgot to + update number!) + +2001-07-11 22:46 rahtz + + * ChangeLog, Makefile, jadetex.dtx, jadetex.ltx: fixed problem with + comparing -999 for unknown page + +2001-07-02 23:49 rahtz + + * Makefile, index.html, index.xml, jadetex.dtx, jadetex.ltx: update + documentation + +2001-07-02 23:09 rahtz + + * index.html, index.xml, index.xsl, doc/install.sgm: added + documentation to CVS + +2001-07-02 20:51 rahtz + + * jadetex.1, jadetex.cfg, jadetex.dtx, jadetex.ini, jadetex.ins, + dummyels.sty, jadetex.ltx, mlnames.sty, ucharacters.sty, + uentities.sty, pdfjadetex.1, pdfjadetex.ini, unicode.sty, + ChangeLog, Makefile, dsssl.def, ut1omlgc.fd, doc/install.log, + doc/Makefile, doc/install.sgm, doc/demo.sgm, doc/demo.tex, + doc/install.tex, doc/install.pdf: initial checkin of Jadetex at + release 3.7 + +2001-07-02 20:51 rahtz + + * jadetex.1, jadetex.cfg, jadetex.dtx, jadetex.ini, jadetex.ins, + dummyels.sty, jadetex.ltx, mlnames.sty, ucharacters.sty, + uentities.sty, pdfjadetex.1, pdfjadetex.ini, unicode.sty, + ChangeLog, Makefile, dsssl.def, ut1omlgc.fd, doc/install.log, + doc/Makefile, doc/install.sgm, doc/demo.sgm, doc/demo.tex, + doc/install.tex, doc/install.pdf: Initial revision + diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/ChangeLog-old b/Master/texmf-dist/doc/otherformats/jadetex/base/ChangeLog-old new file mode 100644 index 00000000000..bb7119b059b --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/ChangeLog-old @@ -0,0 +1,270 @@ +2001-07-19 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + * jadetex.dtx: version 3.11 + * jadetex.dtx: patches for multiple columns from Jean-Marie Kubek + <kubek@insa-tlse.fr> + +2001-07-13 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + * jadetex.dtx: version 3.10 + * jadetex.dtx: changed \if#1{qqq} to \ifx#1\@qqq, stupid mistake + by me + +2001-07-11 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + * jadetex.dtx: version 3.9 + * jadetex.dtx: undefined page labels now "qqq" instead of -999, + because pages can now be non-numeric (eg "ii"), and the \ifnum + test could not work (from Ian Castle + <bb+lists.docbook-apps@looksystems.co.uk>) + +2001-06-23 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + + * jadetex.dtx: version 3.8 + From: Richard Sharpe <sharpe@ns.aus.com> + small patch to ensure that there is no + ugly space before or after a Rule. + +2001-06-22 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + + * version 3.7 + * patches from Francis J. Lacoste + <francis.lacoste@Contre.COM> + + * mlnames.sty: There seems to be a problem with certain tetex + installation where + the name francais isn't defined. Change it back to french which is + always supported. + + *jadetex.dtx: + + * Add a \noindent before the leaders so that they always work. + + * Make margins specification compliant with the DSSSL semantics. + + * Somewhat fixes the white space problem in the + footnotes. Inter-line and inter-paragraph spacing wasn't + working. This improves it a little bit, but + it's still not perfect. + + * Fix a bug that prevent simple-page-sequence to be labelled (made + some table of content generation failed) + + * It was possible for -999 page number to crept in the table of + content. Fixed. + + * Implement inline graphic as per the DSSSL spec. Limited + implementation of layer property : object with layer > 1 overdraw + the text. This makes some superposition effects possible. + + * Implement all possible rule (inline and display, horizontal and + vertical). Limited implementation of the layer property. + + +2001-03-28 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + + * version 3.4, 3.5, 3.6: fixing errors in macros related to + odd/even page setup + +2001-02-01 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + version 3.3 + * jadetex.dtx: make \Link look at \LinkType property + +2001-01-18 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + Version 3.2 + * jadetex.dtx: make a DisplayGroup set a link + +2001-01-17 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + + * jadetex.dtx: make twoside the default again (can still be turned off) + +2001-01-10 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + + * jadetex.dtx: remove Babel dependency, and pick up alternate code + from mlnames.sty (shared with PassiveTeX) + +2001-01-09 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * fix Norwegian language support (from Tore Morkemo <tore@bibsyst.no>) + * loads of patches from http://indev.insu.com/openjade/ , + communicated by Thomas Andre Berger <thomasbe@osc.no> (not sure who + did the work). + + * twoside optional characteristic + JadeTeX turns on the twoside LaTeX + feature by default. Make it optional by using an extension + characteristics (needs patched openjade) + + * cell-*-row-margin support + JadeTeX support for the + cell-before-row-margin and cell-after-row-margin + wasn't working properly. + + + * Sequence in table support + + JadeTeX wasn't handling sequence in table cells + properly. If you used a sequence to typeset a word in italic, the rest + of the cell was also typeset in italic. + + * multipar removal + This patch removes the unused multipar macro from + JadeTex. + + * Better table support + Those patches makes the support for tables in the TeX + backend a lot better (needs openjade patch too) + + + Support for nested tables. + cell-after-column-margin: and cell-before-column-margin: + wasn't really working. + Row spanning was broken. This patch only supports 'start + row alignment though. + Paragraphs in cell spanning multiple column are now working. + Support for the row-alignment: characteristic. + Support for cell-background? and background-color properties + + * Trailing page bug fix + JadeTeX was always outputting an extra blank page. + This patch solves this problem. + + * Support for 'asis and 'asis-wrap + Those patches adds support for the 'asis and + 'asis-wrap values for the paragraph's lines: + characteristic. + + * Support for 'background-color box's characteristic + This patch adds support for the 'background-color + characteristic of the box sosofo object. + + * Support for more fonts with long name + This patch adds windows like alias for the fonts Monospace821, + Humanist521 and NewsGothic. + + +2000-06-20 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * release 2.20 + added special case of listitem-content-mode to allow element + labelling + + (missed out changes 2.11 to 2.19 :-}) + +2000-04-14 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + + * jadetex.dtx: added ifmmode test for 183 in dsssl.def. + \displaygroup now does setupics in a table cell + +2000-03-26 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * jadetex.dtx: fixes by Simon Pepping + a) to indentation after display math + b) to treatment of left and right in fences + c) to the way multiple columns are worked out + * monkeying around with tables, trying (not 100% successfully) + to solve the outstanding errors + * clean error in reading ucharacters.sty + * manually set up characters 32-126 + +1999-12-30 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + * jadetex.dtx: math mode should be display by default, not inline + (Matthias Clasen) + +1999-12-17 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + RELEASE 2.10 + * jadetex.dtx: used u*sty instead of u*tex + * note dependence on PassiveTeX package + +1999-12-17 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + RELEASE 2.9 + * jadetex.dtx: defined \Entity + +1999-12-09 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + RELEASE 2.8 + * jadetex.dtx: new entitiy scheme, and shared code with PassiveTeX + +1999-11-25 Sebastian Rahtz <sebastian.rahtz@computing-services.oxford.ac.uk> + + * jadetex.dtx: support for PageBalanceColumns (choose multicols* + and multicols) + +1999-06-29 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + RELEASE 2.7 + * jadetex.dtx: J.-M. Kubek (kubek@insa-tlse.fr) supplied patches + to support \HeadPar, for PDF bookmarks + + +1999-05-12 Sebastian Rahtz <sebastian.rahtz@oucs.ox.ac.uk> + + RELEASE 2.6 + * jadetex.dtx: removed \@begindocumenthook from \FOT. fouls up + pdftex. not even sure why it was there + +1998-12-15 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * jadetex.dtx: move read of jadetex.cfg to end of \FOT + +Sun Oct 18 22:51:35 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * RELEASE 2.3 (maybe test only) + * jadetex.dtx: more vertical space changes. call \the\everypar at + end of Displaynic and start of endDisplayNIC. Desparation. forget + flags. forget conditional calls to useJadevskip. scream. + +Sat Oct 17 15:09:41 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * jadetex.dtx: an infinity of changes to get vertical space right + with much help from David Carlisle. + The algorithm now is + a) at start of DisplayGroup: + 1. if flag set, use Jadeskip + 2. set Jadeskip to computed above-space; set flag + b) at end of DisplayGroup, set Jadeskip to + computed below-space; set flag + c) at \everypar, use Jadeskip + d) at use Jadeskip, unset flag + +this means that the Jadeskip space is replaced each time, and normally +activated by everypar, but it is also activated by hand when a new +display object starts; this makes \par\par\par have the right behaviour + + +Wed Oct 14 10:24:08 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * jadetex.dtx: support for Score object added (for Lexis-Nexis). + Support for "page" value of \Keep characteristic (for Simon + Pepping) to keep displaygroup on same page (\vbox) + + * corrected entity list, it was wrong. sigh. + + * Release 2.2 for jadetex 1.2.1 + + * extensive changes and additions to the entity lists. + * make T3 optional + +Sun Oct 04 22:32:35 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * jadetex.dtx: moderately manic changes to honour KeepWithNext, + probably make no difference. + +Mon Sep 28 14:41:04 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * jadetex.dtx: rewrite test of previously defined hypertext + anchor, to avoid duplicates + + * jadetex.dtx: various cleanups from Lassi A. Tuura <lat@iki.fi> + +Sun Sep 27 23:27:15 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * jadetex.dtx: removed traces of CellCount + +Sat Sep 12 14:24:09 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + + * Release 2.1 + * jadetex.dtx: add version numbering and checking system (from + ideas by Matthias Clasen) + +Thu Sep 10 22:25:25 1998 Sebastian Rahtz <s.rahtz@elsevier.co.uk> + * Release 1.06 + * jadetex.dtx: merged in David Carlisle's mods needed for MathML + + diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/Makefile b/Master/texmf-dist/doc/otherformats/jadetex/base/Makefile new file mode 100644 index 00000000000..7a3ffdb68cd --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/Makefile @@ -0,0 +1,45 @@ +MAX_TEX_RECURSION=4 +JADE=openjade +JADETEX=jadetex +PDFJADETEX=pdfjadetex +XMLDECL=/usr/share/sgml/xml.dcl + +all: releasenotes.pdf releasenotes.html releasenotes.ps + +%.tex: %.xml %.dsl + $(JADE) -v -t tex -V tex-backend -d $*.dsl#print $(XMLDECL) $*.xml + +%.pdf: %.tex + $(PDFJADETEX) $< + if ! cmp $(shell basename $< .tex).aux prior.aux 2>/dev/null && \ + expr $(MAKELEVEL) '<' $(MAX_TEX_RECURSION); then \ + cp -pf $(shell basename $< .tex).aux prior.aux ; \ + rm -f $@ ; \ + $(MAKE) $@ ; \ + fi + rm -f prior.aux + +%.dvi: %.tex + $(JADETEX) $< + if ! cmp $(shell basename $< .tex).aux prior.aux 2>/dev/null && \ + expr $(MAKELEVEL) '<' $(MAX_TEX_RECURSION); then \ + cp -pf $(shell basename $< .tex).aux prior.aux ; \ + rm -f $@ ; \ + $(MAKE) $@ ; \ + fi + rm -f prior.aux + +%.ps: %.pdf + acroread -toPostScript -pairs $< $@ + +%.html: %.xml %.dsl + $(JADE) -v -t sgml -i html -V nochunks -V rootchunk -V "%root-filename%=$*" -V "%html-ext%=.html" -d $*.dsl#html $(XMLDECL) $*.xml + +%.1: %.xml + xmlto man -x /usr/share/xmlto/xsl/db2man/docbook.xsl $*.xml + +clean: + -rm -f *.out *.aux *.log *.dvi *.tex + +realclean: clean + -rm -f *.html *.pdf *.ps diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/demo.sgm b/Master/texmf-dist/doc/otherformats/jadetex/base/demo.sgm new file mode 100644 index 00000000000..80077078822 --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/demo.sgm @@ -0,0 +1,5 @@ +<!doctype doc [ +<!element doc - o empty> +<!attlist doc a nmtokens #implied> +]> +<doc a="àƬ龥xヮy"> diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/docbook.dsl b/Master/texmf-dist/doc/otherformats/jadetex/base/docbook.dsl new file mode 100644 index 00000000000..79411c327c5 --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/docbook.dsl @@ -0,0 +1,19 @@ +<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ +<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA dsssl> +]> + +<style-sheet> + +<style-specification use="docbook"> +<style-specification-body> + +;; ==================== +;; customize the print stylesheet +;; ==================== + +</style-specification-body> +</style-specification> + +<external-specification id="docbook" document="docbook.dsl"> + +</style-sheet> diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/index.html b/Master/texmf-dist/doc/otherformats/jadetex/base/index.html new file mode 100644 index 00000000000..0da397dc6c4 --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/index.html @@ -0,0 +1,513 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!--THIS FILE IS GENERATED FROM AN XML MASTER. + DO NOT EDIT--><head> +<meta content="text/html; charset=iso-8859-1" http-equiv="Content-Type"> +<title>JadeTeX</title> +<link rel="stylesheet" type="text/css" href="http://www.oucs.ox.ac.uk/stylesheets/tei-oucs.css"> +<meta name="DC.Title" content="JadeTeX"> +<meta name="DC.Author" content="Sebastian Rahtz"> +<meta name="DC.Language" content="(SCHEME=iso639) en"> +<meta name="DC.Creator" content="Oxford University Computing Services, 13 Banbury Road, Oxford OX2 6NN, United Kingdom"> +<meta name="DC.Creator.Address" content="webmaster@oucs.ox.ac.uk"> +</head> +<body> +<a name="TOP"></a><table class="header" width="100%"> +<tr> +<td rowspan="3"><a href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=28782" width="88" height="31" border="0" alt="SourceForge Logo"></a></td> +<td align="left"><h2 class="institution">Sourceforge</h2></td> +</tr> +<tr><td align="left"><h1 class="maintitle">JadeTeX</h1></td></tr> +</table> +<hr> +<h2>Contents</h2> +<ul class="toc"> +<li class="toc"><a class="toc" href="#body.1_div.1">JadeTeX</a></li> +<li class="toc"> +<a class="toc" href="#body.1_div.2">Installation</a><ul class="toc"> +<li class="toc"><a class="toc" href="#index-div-id2625974">Introduction</a></li> +<li class="toc"><a class="toc" href="#index-div-id2626091">Increasing TeX capacities</a></li> +<li class="toc"><a class="toc" href="#index-div-id2625854">Creating the format files</a></li> +<li class="toc"><a class="toc" href="#index-div-id2627082">Testing the installation</a></li> +<li class="toc"><a class="toc" href="#index-div-id2627126">Frequently Asked Questions</a></li> +</ul> +</li> +</ul> +<div class="teidiv"> +<h2> +<a name="body.1_div.1"></a>JadeTeX</h2> + +<p> +<a name="id2627399"></a>This is a TeX macro package for processing the output from + Jade/OpenJade in TeX (-t) mode. You can download it +from Sourceforge; <a href="http://sourceforge.net/projects/jadetex/" target="_top" class="quicklink"><tt>http://sourceforge.net/projects/jadetex/</tt></a>. +</p> +</div> +<div class="teidiv"> +<h2> +<a name="body.1_div.2"></a>Installation</h2> + <div class="teidiv"> +<h3> +<a name="index-div-id2625974"></a>Introduction</h3> + + + + <p> +<a name="id2625998"></a>This documents is based on a note by FC describing his + experience installing JadeTeX with OpenJade 1.3 and teTeX 1.06 + (on Unix). It has since been expanded and checked by SR and + SP. It is aimed to people who have perhaps some experience + using TeX and LaTeX, enough to write up technical reports + using simple macros, but know little or nothing about format + files or the particulars of the TeX distribution structure, + and consequently have a rough time with JadeTeX…</p> + <p> +<a name="id2627409"></a>This document relates to JadeTeX version 2.11 or later.</p> + + <p> +<a name="id2626028"></a>To use JadeTeX, you first of all should compile and install + OpenJade. The resulting openjade executable, used + with the <code class="Value">-t tex</code> flag, will format an + SGML/XML file and yield a TeX output file. Using + jadetex or pdfjadetex, you can + transform this into DVI or PDF; + from DVI, you can use a program like + dvips to get PostScript output. This note describes + how to build and install the former two programs, + jadetex and pdfjadetex.</p> + </div> + + <div class="teidiv"> +<h3> +<a name="index-div-id2626091"></a>Increasing TeX capacities</h3> + + + <p> +<a name="id2626116"></a>The TeX output file uses a macro package, JadeTeX, built on + top of LaTeX, just as LaTeX is a macro package sitting on top of + plain TeX. It is probably possible to just stick an + <code class="Input">\input</code> at the top of your + <code class="Filespec">.tex</code> file and use the JadeTeX macros this + way, but that would be slow since TeX would need to parse and + compile the macro definitions every time you format your + <code class="Filespec">.tex</code> file. So what we do instead is to use + TeX (actually, initex) to read in the LaTeX + format, followed by the JadeTeX package, once, and dump the + compiled image to what is called a ‘format file.’ + This is the same way that LaTeX is usually employed. Once the + format file is built and installed, it is easy to arrange for + TeX to read it in quickly and automatically when you process a + <code class="Filespec">.tex</code> file.</p> + + <p> +<a name="id2626184"></a>But, as ever, there are complications, relating to TeX's + capacity restrictions. TeX is designed to use a fixed amount + of resources to process documents; for example, there is a + maximum number of strings that can be allocated, and a maximum + stack size. If a processing run exceeds the default limits, + TeX will complain and refuse to continue. Unfortunately, + OpenJade's TeX backend tends to exceed these default + limits.</p> + + <p> +<a name="id2626585"></a>Fortunately, though, there is no need to recompile your TeX + binary. If you are using teTeX (or any other Web2c-based + distribution) there will be a file called + <code class="Filespec">texmf.cnf</code> in your installation which sets + the capacity parameters and is consulted every time TeX is + run. By adding the right parameter settings here, you can + ensure that JadeTeX will be unlikely to run out of memory.</p> + + <p> +<a name="id2626607"></a>Where is <code class="Filespec">texmf.cnf</code>? You can find it in the + <code class="Filespec">web2c</code> directory under + your <code class="Filespec">texmf</code> tree... which begs the question, where + is <code class="Filespec">texmf</code>? The most + straightforward way to find it is to make sure all the TeX executables + are in your <code class="Filespec">PATH</code>; then do: + <code class="Input">kpsewhich -expand-var '$TEXMFMAIN'</code> +<code class="Output">/usr/share/texmf/web2c/texmf.cnf</code> + and it will + respond with the location of your texmf tree. As you can see, it is also + known as <code class="Filespec">$TEXMFMAIN</code>, which is how I shall + refer to it in the sequel.</p> + + <p> If for some reason kpsewhich is not in your + <code class="Filespec">PATH</code>, + and you don't know where it is, here are some likely locations: + </p> +<ul> +<li> +<a name="id2626710"></a><code class="Filespec">/usr/share/texmf</code> +</li> +<li> +<a name="id2626722"></a><code class="Filespec">/usr/local/share/texmf</code> +</li> +<li> +<a name="id2626734"></a><code class="Filespec">/usr/local/teTeX/texmf</code> +</li> +<li> +<a name="id2626746"></a><code class="Filespec">/usr/local/lib/teTeX/texmf</code> +</li> +<li> +<a name="id2626759"></a><code class="Filespec">/usr/local/lib/texmf</code> +</li> +<li> +<a name="id2626771"></a><code class="Filespec">/usr/lib/texmf</code> +</li> +<li> +<a name="id2626783"></a><code class="Filespec">/usr/lib/teTeX/texmf</code> +</li> +</ul> +<p> + + <p> +<a name="id2626796"></a>In a minute we are going to modify <code class="Filespec">texmf.cnf</code> to + increase the capacities, then build the JadeTeX format file and install + the JadeTeX executable(s). You may have a command + hugelatex, a version of latex with greater + capacity settings than the usual one, which is named simply + latex. If so, build your format file + using hugelatex rather than + latex, so that JadeTeX inherits the `huge' + settings. Otherwise, make sure your latex is big. + In addition, if you make any changes to the literate source of the + JadeTeX macro package (see below), a normal latex + may not do.</p> + + <p> +<a name="id2626856"></a>First we need to update texmf.cnf to ensure that + latex really is + <em>huge</em>. Take a look at the top of the file. +It will probably say: +<pre class="Program">%original texmf.cnf -- runtime path configuration file for kpathsea. +% (If you change or delete `original' on the previous line, the +% distribution won't install its version over yours.) +</pre> +If it says +<pre class="Program">% TeX Live texmf.cnf +</pre> +then you can skip all this and proceed to the next section, as TeX + Live is already set up for JadeTeX</p> + +<p> +<a name="id2626900"></a> + If you have an `original', follow those directions and delete the string + <code class="Input">original</code> to ensure that + future upgrades won't obliterate your changes.</p> + + <p> +<a name="id2626917"></a>In the latter half of the file, you will find the capacity settings, + which look something like this: + + <pre class="Program">pool_size = 125000 +pool_size.context = 750000</pre> + + Here, <code class="Input">pool_size</code> is the name of the parameter in + both cases, but the second one is qualified with + <code class="Input">.context</code>, which indicates that this setting will be + preferred when using the ConTeXt macro package. We need to make similar + accomodations not only for latex but also + jadetex and pdfjadetex. + Unfortunately, we don't know the minimal required values for every + parameter and some of these values are probably + ridiculously high, but no matter ... + + <pre class="Program">% latex settings +main_memory.latex = 1100000 +param_size.latex = 1500 +stack_size.latex = 1500 +hash_extra.latex = 15000 +string_vacancies.latex = 45000 +pool_free.latex = 47500 +nest_size.latex = 500 +save_size.latex = 5000 +pool_size.latex = 500000 +max_strings.latex = 55000 +font_mem_size.latex= 400000 + +% jadetex & pdfjadetex +main_memory.jadetex = 1500000 +param_size.jadetex = 1500 +stack_size.jadetex = 1500 +hash_extra.jadetex = 50000 +string_vacancies.jadetex = 45000 +pool_free.jadetex = 47500 +nest_size.jadetex = 500 +save_size.jadetex = 5000 +pool_size.jadetex = 500000 +max_strings.jadetex = 55000 + +main_memory.pdfjadetex = 2500000 +param_size.pdfjadetex = 1500 +stack_size.pdfjadetex = 1500 +hash_extra.pdfjadetex = 50000 +string_vacancies.pdfjadetex = 45000 +pool_free.pdfjadetex = 47500 +nest_size.pdfjadetex = 500 +save_size.pdfjadetex = 5000 +pool_size.pdfjadetex = 500000 +max_strings.pdfjadetex = 55000 +</pre> + + Add these to the end of the file, or wherever makes you happy.</p> + + <p> +<a name="id2626201"></a>Now let's build some format files. Under + <code class="Filespec">$TEXMFMAIN/tex/latex/config</code>, + you will find the files necessary to rebuild latex. + Copy them somewhere temporary and go there: +<pre class="Screen"> +cp -R /usr/share/texmf/tex/latex/config /tmp +cd /tmp/config</pre> + + Now do this: + + <pre class="Screen">tex -ini -progname=latex latex.ini</pre> + + This will produce a file <code class="Filespec">latex.fmt</code> + in the same directory. + Become root and put it in + <code class="Filespec">$TEXMFMAIN/web2c</code>. This + is where all the format files are kept. (You can delete the other copied + files from <code class="Filespec">config</code> afterwards.) + + <pre class="Screen">mv latex.fmt /usr/share/texmf/web2c</pre> + </p> + + <p> +<a name="id2626274"></a>Now just create a symbolic link from tex to + latex: + + <pre class="Screen">ln -s /usr/bin/tex /usr/local/bin/latex</pre> + + When tex is invoked, it looks at the name + <code class="Filespec">X</code> it was invoked with, then loads the format + file <code class="Filespec">X.fmt</code> from + <code class="Filespec">$TEXMFMAIN/web2c</code> before + it starts processing the document. So creating this symbolic link is all + that is needed to create the latex + executable.</p> + </div> + + <div class="teidiv"> +<h3> +<a name="index-div-id2625854"></a>Creating the format files</h3> + + <p> +<a name="id2625879"></a>Next, take a look at your OpenJade distribution. Under the directory + <code class="Filespec">dsssl</code> you will find the files necessary to build + jadetex and pdfjadetex, including a Makefile. Now become root and just do: + + <pre class="Screen">make install</pre> + + This creates <code class="Filespec">jadetex.fmt</code> and + <code class="Filespec">pdfjadetex.fmt</code>, puts them in + <code class="Filespec">$TEXMFMAIN/web2c</code> for you + (using kpsewhich to find + <code class="Filespec">$TEXMFMAIN</code>), and installs a few other + auxiliary files under + <code class="Filespec">$TEXMFMAIN/tex/jadetex</code>.</p> + <p> +<a name="id2627041"></a>All that's left to do is to create the links: + + <pre class="Screen">ln -s /usr/bin/tex /usr/bin/jadetex +ln -s /usr/bin/pdftex /usr/bin/pdfjadetex</pre> + (changing the location of the binary directory to wherever your TeX is) + and run mktexlsr so that your TeX distribution becomes + aware of the newly installed files in + <code class="Filespec">$TEXMFMAIN/tex/jadetex</code>. + + <pre class="Screen">mktexlsr</pre> +</p> + + </div> + + <div class="teidiv"> +<h3> +<a name="index-div-id2627082"></a>Testing the installation</h3> + + <p> +<a name="id2627107"></a>Finally, test your installation using the demonstration files in + that directory: + + <pre class="Screen">openjade -t tex -d demo.dsl demo.sgm +jadetex demo.tex +pdfjadetex demo.tex</pre> + + You're done!</p> + </div> + + <div class="teidiv"> +<h3> +<a name="index-div-id2627126"></a>Frequently Asked Questions</h3> + +<p><dl> +<dt><strong> + I installed JadeTeX, but when I run it, it complains that a + file named <code class="Filespec">unicode.sty</code> (or + <code class="Filespec">dsssl.def</code>, etc) can't be found. What did I do + wrong? + </strong></dt> +<dd> + You didn't run the mktexlsr, so + kpathsea doesn't know about the newly installed + files. + </dd> +<dt><strong> + I don't like JadeTeX's default behavior in some situations. + How do I modify it? + </strong></dt> +<dd> + If for some reason you want to modify the JadeTeX macro + package, modify the file <code class="Filespec">jadetex.dtx</code>. This is + the literate source for the format file and other files installed + under + <code class="Filespec">$TEXMFMAIN/tex/jadetex</code>. + To format it, use latex: + + <pre class="Screen">latex jadetex.dtx</pre> + + You will get tons of overfull hboxes but if you are using a nice + big latex, it will work. + + Formatting the batch file <code class="Filespec">jadetex.ins</code> + will produce stripped sources + (<code class="Filespec">dsssl.def</code> and + <code class="Filespec">jadetex.ltx</code>), + which can be compiled into format files as before: + + <pre class="Screen">latex jadetex.ins +make -f Makefile.jadetex</pre> + + </dd> +<dt><strong> + What fonts can I use? + </strong></dt> +<dd> + Following is the names of the font families supported at the + time of writing. Of course you must actually have these fonts + installed to format the document (but not to produce the TeX + output). + <ul> +<li> +<a name="id2634580"></a>Arial</li> +<li> +<a name="id2634585"></a>Helvetica</li> +<li> +<a name="id2634591"></a>Palatino</li> +<li> +<a name="id2634596"></a>Bookman</li> +<li> +<a name="id2634601"></a>Courier</li> +<li> +<a name="id2634606"></a>Symbol</li> +<li> +<a name="id2634612"></a>Wingdings</li> +<li> +<a name="id2634617"></a>WingDings</li> +<li> +<a name="id2634622"></a>LucidaSans</li> +<li> +<a name="id2634627"></a>LucidaBright</li> +<li> +<a name="id2634632"></a>Savoy</li> +<li> +<a name="id2634638"></a>ACaslon</li> +<li> +<a name="id2634643"></a>Caslon</li> +<li> +<a name="id2634648"></a>Formata</li> +<li> +<a name="id2634653"></a>FranklinGothic</li> +<li> +<a name="id2634659"></a>OCRAbyBT</li> +<li> +<a name="id2634664"></a>AGaramond</li> +<li> +<a name="id2634669"></a>Avant-Garde</li> +<li> +<a name="id2634674"></a>Courier-New</li> +<li> +<a name="id2634680"></a>New-Century-Schoolbook</li> +<li> +<a name="id2634685"></a>Times-Roman</li> +<li> +<a name="id2634690"></a>Trade-Gothic</li> +<li> +<a name="id2634695"></a>Times-New-Roman</li> +<li> +<a name="id2634700"></a>Times-NR-MT</li> +<li> +<a name="id2634706"></a>Courier-New</li> +<li> +<a name="id2634711"></a>Zapf-Dingbats</li> +<li> +<a name="id2634716"></a>Gill-Sans</li> +<li> +<a name="id2634721"></a>iso-serif</li> +<li> +<a name="id2634727"></a>iso-sanserif</li> +<li> +<a name="id2634733"></a>iso-monocase</li> +<li> +<a name="id2634740"></a>LetterGothic12PitchBT</li> +<li> +<a name="id2634747"></a>Monospace821</li> +<li> +<a name="id2634754"></a>OCRB10PitchBT</li> +<li> +<a name="id2634761"></a>OCR-A</li> +<li> +<a name="id2634768"></a>OCR-B-10PitchBT</li> +<li> +<a name="id2634775"></a>Computer-Modern-Typewriter</li> +<li> +<a name="id2634782"></a>Computer-Modern-Sans</li> +<li> +<a name="id2634789"></a>Computer-Modern</li> +<li> +<a name="id2634796"></a>Computer-Modern-Caps-And-Small-Caps</li> +</ul> + </dd> +<dt><strong> + Why doesn't hyphenation work? + </strong></dt> +<dd> + Remember that your text must be fully justified + (<code class="Input">quadding: #t</code>), hyphenation must be on, + <code class="Input">hyphenation?: #t</code>, and a current language must + be selected (e.g., <code class="Input">language: 'EN</code>) for JadeTeX + to perform hyphenation. + </dd> +<dt><strong> + I'm using Norman Walsh's DocBook stylesheets and my + footnotes are coming up at the end of the document rather than + at the foot of each page. Why? + </strong></dt> +<dd> + The DocBook stylesheets need to be made aware that you are + using the TeX backend. Add <code class="Value">-V tex-backend</code> to + your openjade command-line. + </dd> +</dl></p> + </div> +</div> +<hr> +<div class="footer"> +<a class="plain" target="_top" href="http://sourceforge.net/">Sourceforge</a> +| <a class="plain" target="_top" href="http://www.oucs.ox.ac.uk/">Jadetex Project</a> +| <a class="plain" target="_top" href="http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/?cvsroot=yourproject ">Search</a> +| <a class="plain" target="_top" href="mailto:sebastian.rahtz@oucs.ox.ac.uk">Feedback</a> +</div> +<hr> +<address>Date: + (revised July 2001) + Author: Sebastian RahtzSimon PeppingFrank Christoph. + <br>© Sebastian Rahtz<!-- +Generated using an XSLT version 1.0 stylesheet +based on http://www.oucs.ox.ac.uk/stylesheets/teihtml.xsl +processed using libxslt on 2002-03-04T14:27:25Z--> +</address> +</body> +</html> diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/index.xml b/Master/texmf-dist/doc/otherformats/jadetex/base/index.xml new file mode 100644 index 00000000000..da488dfe163 --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/index.xml @@ -0,0 +1,427 @@ +<?xml version="1.0" encoding="utf-8"?> +<?xml-stylesheet type="text/xsl" href="index.xsl" ?> +<!DOCTYPE TEI.2 SYSTEM "http://www.oucs.ox.ac.uk/dtds/tei-oucs.dtd"[]> +<TEI.2> + <teiHeader> + <fileDesc> + <titleStmt> + <title>JadeTeX</title> + <author>Sebastian Rahtz</author> + <author>Simon Pepping</author> + <author>Frank Christoph</author> + </titleStmt> + <publicationStmt> + <authority>OUCS</authority> + <address> + <email>sebastian.rahtz@oucs.ox.ac.uk</email> + </address> + </publicationStmt> + <sourceDesc> + <p>This is the master version of an original document.</p> + </sourceDesc> + </fileDesc> + <revisionDesc> + <list> + <head>Most recent revision. +For a full list, see the change management records </head> + <item> + <date>July 2001</date> + </item> + </list> + </revisionDesc> + </teiHeader> + <text> +<body> +<div> +<head>JadeTeX</head> +<p>This is a TeX macro package for processing the output from + Jade/OpenJade in TeX (-t) mode. You can download it +from Sourceforge; <xptr url="http://sourceforge.net/projects/jadetex/"/>. +</p> +</div> +<div><head>Installation</head> + <div> + + <head>Introduction</head> + + <p>This documents is based on a note by FC describing his + experience installing JadeTeX with OpenJade 1.3 and teTeX 1.06 + (on Unix). It has since been expanded and checked by SR and + SP. It is aimed to people who have perhaps some experience + using TeX and LaTeX, enough to write up technical reports + using simple macros, but know little or nothing about format + files or the particulars of the TeX distribution structure, + and consequently have a rough time with JadeTeX…</p> + <p>This document relates to JadeTeX version 2.11 or later.</p> + + <p>To use JadeTeX, you first of all should compile and install + OpenJade. The resulting <name>openjade</name> executable, used + with the <Value>-t tex</Value> flag, will format an + SGML/XML file and yield a TeX output file. Using + <name>jadetex</name> or <name>pdfjadetex</name>, you can + transform this into DVI or PDF; + from DVI, you can use a program like + <name>dvips</name> to get PostScript output. This note describes + how to build and install the former two programs, + <name>jadetex</name> and <name>pdfjadetex</name>.</p> + </div> + + <div> + <head>Increasing TeX capacities</head> + + <p>The TeX output file uses a macro package, JadeTeX, built on + top of LaTeX, just as LaTeX is a macro package sitting on top of + plain TeX. It is probably possible to just stick an + <Input>\input</Input> at the top of your + <Filespec>.tex</Filespec> file and use the JadeTeX macros this + way, but that would be slow since TeX would need to parse and + compile the macro definitions every time you format your + <Filespec>.tex</Filespec> file. So what we do instead is to use + TeX (actually, <name>initex</name>) to read in the LaTeX + format, followed by the JadeTeX package, once, and dump the + compiled image to what is called a <q>format file.</q> + This is the same way that LaTeX is usually employed. Once the + format file is built and installed, it is easy to arrange for + TeX to read it in quickly and automatically when you process a + <Filespec>.tex</Filespec> file.</p> + + <p>But, as ever, there are complications, relating to TeX's + capacity restrictions. TeX is designed to use a fixed amount + of resources to process documents; for example, there is a + maximum number of strings that can be allocated, and a maximum + stack size. If a processing run exceeds the default limits, + TeX will complain and refuse to continue. Unfortunately, + OpenJade's TeX backend tends to exceed these default + limits.</p> + + <p>Fortunately, though, there is no need to recompile your TeX + binary. If you are using teTeX (or any other Web2c-based + distribution) there will be a file called + <Filespec>texmf.cnf</Filespec> in your installation which sets + the capacity parameters and is consulted every time TeX is + run. By adding the right parameter settings here, you can + ensure that JadeTeX will be unlikely to run out of memory.</p> + + <p>Where is <Filespec>texmf.cnf</Filespec>? You can find it in the + <Filespec>web2c</Filespec> directory under + your <Filespec>texmf</Filespec> tree... which begs the question, where + is <Filespec>texmf</Filespec>? The most + straightforward way to find it is to make sure all the TeX executables + are in your <Filespec>PATH</Filespec>; then do: + <Input>kpsewhich -expand-var '$TEXMFMAIN'</Input> +<Output>/usr/share/texmf/web2c/texmf.cnf</Output> + and it will + respond with the location of your texmf tree. As you can see, it is also + known as <Filespec>$TEXMFMAIN</Filespec>, which is how I shall + refer to it in the sequel.</p> + + <p> If for some reason <name>kpsewhich</name> is not in your + <Filespec>PATH</Filespec>, + and you don't know where it is, here are some likely locations: + <list> + <item><Filespec>/usr/share/texmf</Filespec></item> + <item><Filespec>/usr/local/share/texmf</Filespec></item> + <item><Filespec>/usr/local/teTeX/texmf</Filespec></item> + <item><Filespec>/usr/local/lib/teTeX/texmf</Filespec></item> + <item><Filespec>/usr/local/lib/texmf</Filespec></item> + <item><Filespec>/usr/lib/texmf</Filespec></item> + <item><Filespec>/usr/lib/teTeX/texmf</Filespec></item> + </list></p> + + <p>In a minute we are going to modify <Filespec>texmf.cnf</Filespec> to + increase the capacities, then build the JadeTeX format file and install + the JadeTeX executable(s). You may have a command + <name>hugelatex</name>, a version of latex with greater + capacity settings than the usual one, which is named simply + <name>latex</name>. If so, build your format file + using <name>hugelatex</name> rather than + <name>latex</name>, so that JadeTeX inherits the `huge' + settings. Otherwise, make sure your latex is big. + In addition, if you make any changes to the literate source of the + JadeTeX macro package (see below), a normal <name>latex</name> + may not do.</p> + + <p>First we need to update texmf.cnf to ensure that + <name>latex</name> really is + <emph>huge</emph>. Take a look at the top of the file. +It will probably say: +<Program +>%original texmf.cnf -- runtime path configuration file for kpathsea. +% (If you change or delete `original' on the previous line, the +% distribution won't install its version over yours.) +</Program> +If it says +<Program +>% TeX Live texmf.cnf +</Program> +then you can skip all this and proceed to the next section, as TeX + Live is already set up for JadeTeX</p> + +<p> + If you have an `original', follow those directions and delete the string + <Input>original</Input> to ensure that + future upgrades won't obliterate your changes.</p> + + <p>In the latter half of the file, you will find the capacity settings, + which look something like this: + + <Program +>pool_size = 125000 +pool_size.context = 750000</Program> + + Here, <Input>pool_size</Input> is the name of the parameter in + both cases, but the second one is qualified with + <Input>.context</Input>, which indicates that this setting will be + preferred when using the ConTeXt macro package. We need to make similar + accomodations not only for <name>latex</name> but also + <name>jadetex</name> and <name>pdfjadetex</name>. + Unfortunately, we don't know the minimal required values for every + parameter and some of these values are probably + ridiculously high, but no matter ... + + <Program +>% latex settings +main_memory.latex = 1100000 +param_size.latex = 1500 +stack_size.latex = 1500 +hash_extra.latex = 15000 +string_vacancies.latex = 45000 +pool_free.latex = 47500 +nest_size.latex = 500 +save_size.latex = 5000 +pool_size.latex = 500000 +max_strings.latex = 55000 +font_mem_size.latex= 400000 + +% jadetex & pdfjadetex +main_memory.jadetex = 1500000 +param_size.jadetex = 1500 +stack_size.jadetex = 1500 +hash_extra.jadetex = 50000 +string_vacancies.jadetex = 45000 +pool_free.jadetex = 47500 +nest_size.jadetex = 500 +save_size.jadetex = 5000 +pool_size.jadetex = 500000 +max_strings.jadetex = 55000 + +main_memory.pdfjadetex = 2500000 +param_size.pdfjadetex = 1500 +stack_size.pdfjadetex = 1500 +hash_extra.pdfjadetex = 50000 +string_vacancies.pdfjadetex = 45000 +pool_free.pdfjadetex = 47500 +nest_size.pdfjadetex = 500 +save_size.pdfjadetex = 5000 +pool_size.pdfjadetex = 500000 +max_strings.pdfjadetex = 55000 +</Program> + + Add these to the end of the file, or wherever makes you happy.</p> + + <p>Now let's build some format files. Under + <Filespec>$TEXMFMAIN/tex/latex/config</Filespec>, + you will find the files necessary to rebuild <name>latex</name>. + Copy them somewhere temporary and go there: +<Screen> +cp -R /usr/share/texmf/tex/latex/config /tmp +cd /tmp/config</Screen> + + Now do this: + + <Screen>tex -ini -progname=latex latex.ini</Screen> + + This will produce a file <Filespec>latex.fmt</Filespec> + in the same directory. + Become root and put it in + <Filespec>$TEXMFMAIN/web2c</Filespec>. This + is where all the format files are kept. (You can delete the other copied + files from <Filespec>config</Filespec> afterwards.) + + <Screen>mv latex.fmt /usr/share/texmf/web2c</Screen> + </p> + + <p>Now just create a symbolic link from <name>tex</name> to + <name>latex</name>: + + <Screen>ln -s /usr/bin/tex /usr/local/bin/latex</Screen> + + When <name>tex</name> is invoked, it looks at the name + <Filespec>X</Filespec> it was invoked with, then loads the format + file <Filespec>X.fmt</Filespec> from + <Filespec>$TEXMFMAIN/web2c</Filespec> before + it starts processing the document. So creating this symbolic link is all + that is needed to create the <name>latex</name> + executable.</p> + </div> + + <div> + <head>Creating the format files</head> + <p>Next, take a look at your OpenJade distribution. Under the directory + <Filespec>dsssl</Filespec> you will find the files necessary to build + jadetex and pdfjadetex, including a Makefile. Now become root and just do: + + <Screen>make install</Screen> + + This creates <Filespec>jadetex.fmt</Filespec> and + <Filespec>pdfjadetex.fmt</Filespec>, puts them in + <Filespec>$TEXMFMAIN/web2c</Filespec> for you + (using <name>kpsewhich</name> to find + <Filespec>$TEXMFMAIN</Filespec>), and installs a few other + auxiliary files under + <Filespec>$TEXMFMAIN/tex/jadetex</Filespec>.</p> + <p>All that's left to do is to create the links: + + <Screen>ln -s /usr/bin/tex /usr/bin/jadetex +ln -s /usr/bin/pdftex /usr/bin/pdfjadetex</Screen> + (changing the location of the binary directory to wherever your TeX is) + and run <name>mktexlsr</name> so that your TeX distribution becomes + aware of the newly installed files in + <Filespec>$TEXMFMAIN/tex/jadetex</Filespec>. + + <Screen>mktexlsr</Screen></p> + + </div> + + <div> + <head>Testing the installation</head> + <p>Finally, test your installation using the demonstration files in + that directory: + + <Screen>openjade -t tex -d demo.dsl demo.sgm +jadetex demo.tex +pdfjadetex demo.tex</Screen> + + You're done!</p> + </div> + + <div> + <head>Frequently Asked Questions</head> +<list type="gloss"> + <label> + I installed JadeTeX, but when I run it, it complains that a + file named <Filespec>unicode.sty</Filespec> (or + <Filespec>dsssl.def</Filespec>, etc) can't be found. What did I do + wrong? + </label> + <item> + You didn't run the <name>mktexlsr</name>, so + <name>kpathsea</name> doesn't know about the newly installed + files. + </item> + + <label> + I don't like JadeTeX's default behavior in some situations. + How do I modify it? + </label> + <item> + If for some reason you want to modify the JadeTeX macro + package, modify the file <Filespec>jadetex.dtx</Filespec>. This is + the literate source for the format file and other files installed + under + <Filespec>$TEXMFMAIN/tex/jadetex</Filespec>. + To format it, use <name>latex</name>: + + <Screen>latex jadetex.dtx</Screen> + + You will get tons of overfull hboxes but if you are using a nice + big latex, it will work. + + Formatting the batch file <Filespec>jadetex.ins</Filespec> + will produce stripped sources + (<Filespec>dsssl.def</Filespec> and + <Filespec>jadetex.ltx</Filespec>), + which can be compiled into format files as before: + + <Screen>latex jadetex.ins +make -f Makefile.jadetex</Screen> + + </item> + + <label> + What fonts can I use? + </label> + <item> + Following is the names of the font families supported at the + time of writing. Of course you must actually have these fonts + installed to format the document (but not to produce the TeX + output). + <list> + <item>Arial</item> + <item>Helvetica</item> + <item>Palatino</item> + <item>Bookman</item> + <item>Courier</item> + <item>Symbol</item> + <item>Wingdings</item> + <item>WingDings</item> + <item>LucidaSans</item> + <item>LucidaBright</item> + <item>Savoy</item> + <item>ACaslon</item> + <item>Caslon</item> + <item>Formata</item> + <item>FranklinGothic</item> + <item>OCRAbyBT</item> + <item>AGaramond</item> + <item>Avant-Garde</item> + <item>Courier-New</item> + <item>New-Century-Schoolbook</item> + <item>Times-Roman</item> + <item>Trade-Gothic</item> + <item>Times-New-Roman</item> + <item>Times-NR-MT</item> + <item>Courier-New</item> + <item>Zapf-Dingbats</item> + <item>Gill-Sans</item> + <item>iso-serif</item> + <item>iso-sanserif</item> + <item>iso-monocase</item> + <item>LetterGothic12PitchBT</item> + <item>Monospace821</item> + <item>OCRB10PitchBT</item> + <item>OCR-A</item> + <item>OCR-B-10PitchBT</item> + <item>Computer-Modern-Typewriter</item> + <item>Computer-Modern-Sans</item> + <item>Computer-Modern</item> + <item>Computer-Modern-Caps-And-Small-Caps</item> + </list> + </item> + + <label> + Why doesn't hyphenation work? + </label> + <item> + Remember that your text must be fully justified + (<Input>quadding: #t</Input>), hyphenation must be on, + <Input>hyphenation?: #t</Input>, and a current language must + be selected (e.g., <Input>language: 'EN</Input>) for JadeTeX + to perform hyphenation. + </item> + + <label> + I'm using Norman Walsh's DocBook stylesheets and my + footnotes are coming up at the end of the document rather than + at the foot of each page. Why? + </label> + <item> + The DocBook stylesheets need to be made aware that you are + using the TeX backend. Add <Value>-V tex-backend</Value> to + your <name>openjade</name> command-line. + </item> +</list> + </div> +</div> +</body> +</text> +</TEI.2> +<!-- +.A link to the projects group page on SourceForge. + 2.Mailing list links (we'll create them in a second) + 3.A SourceForge icon and web counter - see the site documentation for this. + 4.A link to the CVS web interface at + + 5.Some info about using CVS specific to your project. + 6.Setup mailing lists for your project. +--> diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/index.xsl b/Master/texmf-dist/doc/otherformats/jadetex/base/index.xsl new file mode 100644 index 00000000000..99dc66a302a --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/index.xsl @@ -0,0 +1,72 @@ +<?xml version="1.0" encoding="utf-8"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + + <xsl:import href="http://www.oucs.ox.ac.uk/stylesheets/teihtml.xsl"/> + <xsl:import href="http://www.oucs.ox.ac.uk/stylesheets/teihtml-oucsdoc.xsl"/> + + <xsl:template name="logoPicture"><a href="http://sourceforge.net"> <img + src="http://sourceforge.net/sflogo.php?group_id=28782" + width="88" height="31" border="0" alt="SourceForge + Logo"/></a></xsl:template> + <xsl:variable name="cssFile">http://www.oucs.ox.ac.uk/stylesheets/tei-oucs.css</xsl:variable> + <xsl:variable name="feedbackURL">mailto:sebastian.rahtz@oucs.ox.ac.uk</xsl:variable> + <xsl:variable name="feedbackWords">Feedback</xsl:variable> + <xsl:variable name="homeLabel">Home</xsl:variable> + <xsl:variable name="homeURL">http://www.oucs.ox.ac.uk/</xsl:variable> + <xsl:variable name="homeWords">Jadetex Project</xsl:variable> + <xsl:variable name="institution">Sourceforge</xsl:variable> + <xsl:variable name="department"/> + <xsl:variable name="parentURL">http://sourceforge.net/</xsl:variable> + <xsl:variable name="parentWords">Sourceforge</xsl:variable> + <xsl:variable name="searchURL">http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/?cvsroot=yourproject </xsl:variable> + <xsl:variable name="searchWords">CVS web interface</xsl:variable> + <xsl:variable name="topNavigationPanel">true</xsl:variable> + <xsl:variable name="bottomNavigationPanel">true</xsl:variable> + <xsl:variable name="alignNavigationPanel">right</xsl:variable> + <xsl:variable name="linkPanel">true</xsl:variable> + <xsl:template name="copyrightStatement">© Sebastian Rahtz</xsl:template> + <xsl:variable name="leftLinks"/> + <xsl:variable name="rightLinks"/> + <xsl:variable name="linksWidth">10%</xsl:variable> + <xsl:param name="makeFrames"/> + <xsl:variable name="frameCols">200,*</xsl:variable> + <xsl:variable name="frameAlternateURL"/> + <xsl:template name="logoFramePicture"/> + <xsl:variable name="sectionUpLink"/> + <xsl:template name="topLink"><p>[<a href="#TOP">Back to top</a>]</p></xsl:template> + <xsl:variable name="appendixWords">Appendix</xsl:variable> + <xsl:variable name="tocWords">Contents</xsl:variable> + <xsl:variable name="upWord">Up</xsl:variable> + <xsl:variable name="nextWord">Next</xsl:variable> + <xsl:variable name="previousWord">Previous</xsl:variable> + <xsl:template name="contentsWord">Contents</xsl:template> + <xsl:variable name="dateWord">Date:</xsl:variable> + <xsl:variable name="authorWord">Author:</xsl:variable> + <xsl:variable name="divOffset">2</xsl:variable> + <xsl:variable name="numberHeadings">1</xsl:variable> + <xsl:variable name="prenumberedHeadings"></xsl:variable> + <xsl:variable name="numberFrontHeadings"/> + <xsl:variable name="numberBackHeadings">A.1</xsl:variable> + <xsl:variable name="headingNumberSuffix">. </xsl:variable> + <xsl:variable name="numberHeadingsDepth">9</xsl:variable> + <xsl:variable name="fontURL">tt</xsl:variable> + <xsl:variable name="tableAlign">center</xsl:variable> + <xsl:variable name="showTitleAuthor"/> + <xsl:variable name="footnoteFile"/> + <xsl:variable name="minimalCrossRef"/> + <xsl:variable name="graphicsPrefix"/> + <xsl:variable name="graphicsSuffix">.jpg</xsl:variable> + <xsl:variable name="showFigures">true</xsl:variable> + <xsl:template name="bodyHook"/> + <xsl:template name="headHook"/> + <xsl:param name="verbose"/> + <xsl:variable name="downPicture">http://www.oucs.ox.ac.uk/images/down.gif</xsl:variable> + <xsl:variable name="useHeaderFrontMatter"/> + <xsl:variable name="outputEncoding">iso-8859-1</xsl:variable> + + <xsl:variable name="rendSeparator" select="';'"/> + + + +</xsl:stylesheet> diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/jadetex.1 b/Master/texmf-dist/doc/otherformats/jadetex/base/jadetex.1 new file mode 100644 index 00000000000..d484b8cf8a4 --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/jadetex.1 @@ -0,0 +1,45 @@ +.TH JADETEX 1 "12 July 1998" "Marcus Brinkmann" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff +.el .ds OX TeX\" for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.\"===================================================================== +.SH NAME +jadetex \- processing tex files produced by the \*(TX backend of Jade. +.SH SYNOPSIS +.B jadetex +[ first line ] +.\"===================================================================== +.SH DESCRIPTION +This manual page was derived from the manual page for \*(LX and is not meant +to be exhaustive. The complete +documentation for this version of \*(TX can be found in the info file +or manual +.IR "Web2C: A TeX implementation" . +.PP +Jade\*(TX is a \*(TX macro package, not a modification to the \*(TX source +program, so all the capabilities described in +.BR tex (1) +are present. +.B pdfjadetex +is the PDF\*(TX version of the jade\*(TX format. +.\"===================================================================== +.SH "SEE ALSO" +.BR pdfjadetex (1), +.BR latex (1), +.BR tex (1), +.br +.SH AUTHORS +The author of jade\*(TX is Sebastian Rahtz. +.PP +This manual page was derived from the \*(LX manual page. It is provided for +the Debian distribution by Marcus Brinkmann. Please send improvements, +suggestion and other comments to brinkmd@debian.org. diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/jadetex.cfg b/Master/texmf-dist/doc/otherformats/jadetex/base/jadetex.cfg new file mode 100644 index 00000000000..efd96c9fac0 --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/jadetex.cfg @@ -0,0 +1,4 @@ +\AtBeginDocument{% + \def\pdfBorderAttrs{/Border [0 0 1]}% +} + diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/logo.png b/Master/texmf-dist/doc/otherformats/jadetex/base/logo.png Binary files differnew file mode 100644 index 00000000000..ef412ef90d2 --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/logo.png diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/pdfjadetex.1 b/Master/texmf-dist/doc/otherformats/jadetex/base/pdfjadetex.1 new file mode 100644 index 00000000000..7c8714aa5dc --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/pdfjadetex.1 @@ -0,0 +1,239 @@ +.TH PDFJADETEX 1 "12 July 1998" "Marcus Brinkmann" +.\"===================================================================== +.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP +.if n .ds TX TeX +.if n .ds MF Metafont +.if t .ds MF M\s-2ETAFONT\s0 +.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff +.el .ds OX TeX\" for nroff +.\" the same but obliqued +.\" BX definition must follow TX so BX can use TX +.if t .ds BX \fRB\s-2IB\s0\fP\*(TX +.if n .ds BX BibTeX +.\" LX definition must follow TX so LX can use TX +.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX +.if n .ds LX LaTeX +.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX +.if n .ds AX AmSTeX +.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX +.if n .ds AY AmSLaTeX +.\"===================================================================== +.SH NAME +pdfjadetex \- PDF output from JadeTeX +.SH SYNOPSIS +.B pdfjadetex +.RI [ options ] +.RI [ commands ] +.\"===================================================================== +.SH DESCRIPTION +This manual page was derived from the manual page for pdf\*(TX and is not meant +to be exhaustive. The complete documentation for this version of \*(TX can be +found in the info file or manual +.IR "Web2C: A TeX implementation" . +.PP +pdfjade\*(TX is a version of \*(TX that can create +.I PDF +files as well as +.I DVI +files. +.PP +The typical use of pdfjade\*(TX is with a pregenerated formats for which +PDF output has been enabled. The +.B pdfjadetex +command uses the equivalent of the plain Jade\*(TX format. +.PP +pdfjade\*(TX's handling of its command-line arguments is similar to that of +\*(LX. +.\"===================================================================== +.SH OPTIONS +This version of pdfjade\*(TX understands the following command line options. +.TP +.BI --fmt \ format +.rb +Use +.I format +as the name of the format to be used, instead of the name by which +pdfjade\*(TX was called or a +.I %& +line. +.TP +.B --help +.rb +Print help message and exit. +.TP +.B --ini +.rb +Be +.BR pdfinitex , +for dumping formats; this is implicitly true if the program is called +as +.BR pdfinitex . +.TP +.BI --interaction \ mode +.rb +Sets the interaction mode. The mode can be one of +.IR batchmode , +.IR nonstopmode , +.IR scrollmode , +and +.IR errorstopmode . +The meaning of these modes is the same as that of the corresponding +\ecommands. +.TP +.B --ipc +.rb +Send DVI or PDF output to a socket as well as the usual output file. +Whether this option is available is the choice of the installer. +.TP +.B --ipc-start +.rb +As +.BR --ipc , +and starts the server at the other end as well. Whether this option +is available is the choice of the installer. +.TP +.BI --kpathsea-debug \ bitmask +.rb +Sets path searching debugging flags according to the bitmask. See the +.I Kpathsea +manual for details. +.TP +.BI --maketex \ fmt +.rb +Enable +.RI mktex fmt , +where +.I fmt +must be one of +.I tex +or +.IR tfm . +.TP +.BI --no-maketex \ fmt +.rb +Disable +.RI mktex fmt , +where +.I fmt +must be one of +.I tex +or +.IR tfm . +.TP +.BI --output-comment \ string +.rb +Use +.I string +for the DVI file comment instead of the date. +.TP +.BI --progname \ name +.rb +Pretend to be program +.IR name . +This affects both the format used and the search paths. +.TP +.B --shell-escape +.rb +Enable the +.BI \ewrite18{ command } +construct. The +.I command +can be any Bourne shell command. This construct is normally +disallowed for security reasons. +.TP +.B --version +.rb +Print version information and exit. +.\"===================================================================== +.SH ENVIRONMENT +See the Kpathsearch library documentation (the `Path specifications' +node) for precise details of how the environment variables are used. +The +.B kpsewhich +utility can be used to query the values of the variables. +.PP +One caveat: In most pdfjade\*(TX formats, you cannot use ~ in a filename you +give directly to pdfjade\*(TX, because ~ is an active character, and hence is +expanded, not taken as part of the filename. Other programs, such as +\*(MF, do not have this problem. +.PP +.TP +TEXMFOUTPUT +Normally, pdfjade\*(TX puts its output files in the current directory. If +any output file cannot be opened there, it tries to open it in the +directory specified in the environment variable TEXMFOUTPUT. +There is no default value for that variable. For example, if you say +.I tex paper +and the current directory is not writable, if TEXMFOUTPUT has +the value +.IR /tmp , +pdfjade\*(TX attempts to create +.I /tmp/paper.log +(and +.IR /tmp/paper.pdf , +if any output is produced.) +.TP +TEXINPUTS +Search path for +.I \einput +and +.I \eopenin +files. +This should probably start with ``.'', so +that user files are found before system files. +.TP +TEXFONTS +Search path for font metric +.RI ( .tfm ) +files. +.TP +TEXFORMATS +Search path for format files. +.TP +TEXPOOL +search path for +.B pdfinitex +internal strings. +.TP +TEXEDIT +Command template for switching to editor. The default, usually +.BR vi , +is set when pdfjade\*(TX is compiled. +.\"===================================================================== +.SH FILES +The location of the files mentioned below varies from system to +system. Use the +.B kpsewhich +utility to find their locations. +.TP +.I pdfjadetex.pool +Encoded text of pdfjade\*(TX's messages. +.TP +.I texfonts.map +Filename mapping definitions. +.TP +.I *.tfm +Metric files for pdfjade\*(TX's fonts. +.TP +.I *.fmt +Predigested pdfjade\*(TX format (.\|fmt) files. +.br +.\"===================================================================== +.SH BUGS +This version of pdfjade\*(TX fails to trap arithmetic overflow when +dimensions are added or subtracted. Cases where this occurs are rare, +but when it does the generated +.I DVI +file will be invalid. +.\"===================================================================== +.SH "SEE ALSO" +.BR jadetex (1), +.BR tex (1), +.BR mf (1), +.BR undump (1). +.\"===================================================================== +.SH AUTHORS +The author of pdfjade\*(TX is Sebastian Rahtz. +.PP +This manual page was derived by Marcus Brinkmann for the Debian distribution from +the pdf\*(TX manual page from the te\*(TX distribution by Thomas Esser. diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/releasenotes.dsl b/Master/texmf-dist/doc/otherformats/jadetex/base/releasenotes.dsl new file mode 100644 index 00000000000..98086435d88 --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/releasenotes.dsl @@ -0,0 +1,227 @@ +<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ +<!ENTITY html-ss + PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA dsssl> +<!ENTITY print-ss + PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA dsssl> +]> +<style-sheet> +<style-specification id="print" use="print-stylesheet"> +<style-specification-body> + +;; This draws in version 1.74b of the module docbook DSSSL stylesheets +;; together with sourceforge patch #502637 + +;; customize the print stylesheet + +(define %hsize-bump-factor% 1.1) + +(define %chapter-autolabel% + ;; Are chapters enumerated? + #f) + +(define %two-side% #t) + +(define %graphic-extensions% +;; List of graphic filename extensions +'("pdf" "eps" "epsf" "gif" "tif" "tiff" "jpg" "jpeg" "png")) + + +(define preferred-mediaobject-notations + (list "PDF" "EPS" "PS" "JPG" "JPEG" "PNG" "linespecific")) + +(define preferred-mediaobject-extensions + (list "pdf" "eps" "ps" "jpg" "jpeg" "png")) + +(define %titlepage-in-info-order% #f) + +;; Fix bug in numbering of the preface + + (define ($component$) + (make simple-page-sequence + page-n-columns: %page-n-columns% + page-number-restart?: (or %page-number-restart% + (first-chapter?)) + page-number-format: ($page-number-format$) + use: default-text-style + left-header: ($left-header$) + center-header: ($center-header$) + right-header: ($right-header$) + left-footer: ($left-footer$) + center-footer: ($center-footer$) + right-footer: ($right-footer$) + start-indent: %body-start-indent% + input-whitespace-treatment: 'collapse + quadding: %default-quadding% + (make sequence + ($component-title$) + (process-children)) + (make-endnotes))) + +;; Customise the title page +(element book + (let* ((bookinfo (select-elements (children (current-node)) + (normalize "bookinfo"))) + (dedication (select-elements (children (current-node)) + (normalize "dedication"))) + (nl (titlepage-info-elements (current-node) bookinfo))) + (make sequence + (if %generate-book-titlepage% + (make simple-page-sequence + page-n-columns: %titlepage-n-columns% + input-whitespace-treatment: 'collapse + use: default-text-style + bottom-margin: 144pt + right-footer: ($title-right-footer$) + (book-titlepage nl 'recto) + (make display-group + break-before: 'page + (book-titlepage nl 'verso))) + (empty-sosofo)) + + (if (node-list-empty? dedication) + (empty-sosofo) + (with-mode dedication-page-mode + (process-node-list dedication))) + + (if (not (generate-toc-in-front)) + (process-children) + (empty-sosofo)) + + (if %generate-book-toc% + (make simple-page-sequence + page-n-columns: %page-n-columns% + page-number-format: ($page-number-format$ (normalize "toc")) + use: default-text-style + left-header: ($left-header$ (normalize "toc")) + center-header: ($center-header$ (normalize "toc")) + right-header: ($right-header$ (normalize "toc")) + left-footer: ($left-footer$ (normalize "toc")) + center-footer: ($center-footer$ (normalize "toc")) + right-footer: ($right-footer$ (normalize "toc")) + input-whitespace-treatment: 'collapse + (build-toc (current-node) + (toc-depth (current-node)))) + (empty-sosofo)) + + (let loop ((gilist ($generate-book-lot-list$))) + (if (null? gilist) + (empty-sosofo) + (if (not (node-list-empty? + (select-elements (descendants (current-node)) + (car gilist)))) + (make simple-page-sequence + page-n-columns: %page-n-columns% + page-number-format: ($page-number-format$ (normalize "lot")) + use: default-text-style + left-header: ($left-header$ (normalize "lot")) + center-header: ($center-header$ (normalize "lot")) + right-header: ($right-header$ (normalize "lot")) + left-footer: ($left-footer$ (normalize "lot")) + center-footer: ($center-footer$ (normalize "lot")) + right-footer: ($right-footer$ (normalize "lot")) + input-whitespace-treatment: 'collapse + (build-lot (current-node) (car gilist)) + (loop (cdr gilist))) + (loop (cdr gilist))))) + + (if (generate-toc-in-front) + (process-children) + (empty-sosofo))))) + +(define %openjade-logo% + ;; The nice look systems logo + "logo.png" ) + +(define ($title-right-footer$) + (if-first-page + (make external-graphic + scale: 1.0 + entity-system-id: %openjade-logo% + notation-system-id: "PDF" + display?: #f) + (empty-sosofo))) + +(define (book-titlepage-recto-elements) + (list (normalize "corpauthor") + (normalize "subtitle") + (normalize "title") + (normalize "graphic"))) + +(define (book-titlepage-verso-elements) + (list (normalize "legalnotice") + (normalize "copyright") + (normalize "edition") + (normalize "pubdate") + (normalize "abstract") + (normalize "revhistory"))) + +(define (book-titlepage-before node side) +(empty-sosofo) + ) + +(mode book-titlepage-recto-mode + + (element graphic + (make display-group + (make external-graphic + entity-system-id: (attribute-string "fileref") + display?: #t + ) + ) + ) + (element title + (make paragraph + font-size: 36pt + font-family-name: "Palatino" + font-weight: 'bold + space-before: 12pt + line-spacing: 36pt + (make rule + space-after: 4pt + line-thickness: 1pt) + (process-children) + ) + ) + (element subtitle + (make paragraph + font-size: 24pt + line-spacing: 24pt + font-family-name: "Palatino" + font-weight: 'bold + (process-children) + ) + ) + (element corpauthor + (make paragraph + font-size: 24pt + line-spacing: 24pt + space-after: 6pt + font-family-name: "Palatino" + font-weight: 'normal + (process-children) + ) + ) +) + + +</style-specification-body> +</style-specification> + +<style-specification id="html" use="html-stylesheet"> +<style-specification-body> + +;; customize the html stylesheet + + +;; customize the html stylesheet +(define %body-attr% + ;; What attributes should be hung off of BODY? + (list + (list "BGCOLOR" "#FFFFFF") + (list "TEXT" "#000000"))) + +</style-specification-body> +</style-specification> +<external-specification id="print-stylesheet" document="print-ss"> +<external-specification id="html-stylesheet" document="html-ss"> +</style-sheet> diff --git a/Master/texmf-dist/doc/otherformats/jadetex/base/releasenotes.xml b/Master/texmf-dist/doc/otherformats/jadetex/base/releasenotes.xml new file mode 100644 index 00000000000..8cd1e264986 --- /dev/null +++ b/Master/texmf-dist/doc/otherformats/jadetex/base/releasenotes.xml @@ -0,0 +1,365 @@ +<?xml version='1.0'?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "/usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd" [ +]> +<book> +<bookinfo> + <title>JadeTeX 3.12</title> + <subtitle>Release Notes</subtitle> + <corpauthor>JadeTeX Development Team</corpauthor> + <edition>Release 3.12</edition> + <pubdate>January 2002</pubdate> + <copyright> + <year>2002</year> + <holder>Ian Castle</holder> + </copyright> +</bookinfo> + +<chapter><title>JadeTeX 3.12 Release Notes</title> +<para>JadeTeX is a companion package to the OpenJade DSSSL processor. +OpenJade applies a DSSSL stylesheet to an SGML or XML document. The output +of this process can be in a number of forms, including a set of high level +LaTeX macros. It is the task of the JadeTeX package to transform these +macros into DVI/PostScript (use the command <command>jadetex</command>) or Portable Document Format (PDF) form (use the command <command>pdfjadetex</command>).</para> +<para>JadeTeX is architecture and platform independent. If LaTeX is available for your platform, then JadeTeX will be also.</para> +<sect1><title>Obtaining JadeTeX</title> +<para>The latest version of JadeTeX may be obtained from +<filename>http://jadetex.sourceforge.net</filename></para> +</sect1> +<sect1><title>Dependencies</title> +<para>Jadetex is dependent upon OpenJade and a reasonably up to date and full featured LaTeX installation. For best results OpenJade 1.3.1 should be used. However, JadeTeX will work fine with older versions (including Jade 1.2.1), although it may be necessary to adjust your <filename>jadetex.cfg</filename> configuration file to supply JadeTeX with any features missing from your version of OpenJade.</para> +<para>Any recent LaTeX distribution such as TeXlive, fpTeX or teTeX is required. As a guide the following table lists some of the requirements and suggested minimum versions.</para> +<table id="texdepends" frame="topbot"><title>Dependencies on LaTeX</title> +<tgroup cols="4" align="left" colsep="0" rowsep="0"> +<colspec colname="c1" colwidth="1*" /> +<colspec colname="c2" colwidth="3*" /> +<thead> +<row rowsep="1"> + <entry>Package</entry> + <entry>Minimum Required Version</entry> +</row> +</thead> +<tbody> +<row> + <entry ><filename>times</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>fontenc</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>array</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>longtable</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>color</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>colortbl</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>marvosym</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>graphicx</filename></entry> + <entry>1997/06/09</entry> +</row> +<row> + <entry ><filename>multicol</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>hyperref</filename></entry> + <entry>2000/03/01</entry> +</row> +<row> + <entry ><filename>fancyhdr</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>inputenc</filename></entry> + <entry>1997/12/20</entry> +</row> +<row> + <entry ><filename>ulem</filename></entry> + <entry></entry> +</row> +<row> + <entry ><filename>pdfTeX</filename></entry> + <entry>0.13d</entry> +</row> +</tbody> +</tgroup> +</table> +</sect1> +<sect1><title>Installation</title> +<para>See the installation guide.</para> +</sect1> +<sect1><title>Configuration</title> +<para>It is possible to customize the behavior of JadeTeX by placing definitions in the file <filename>jadetex.cfg</filename>. This is usually placed in your working directory, but theoretically make be placed anywhere in your TeX path.</para> +<para>If you are producing PDF files then you may wish to consult the <command>hyperref</command> documentation. Options for customizing the look and feel of the PDF file described in the hyperref documentation should be placed in the <filename>jadetex.cfg</filename>. For example: +<screen> +\hypersetup{pdfpagemode=None, pdfauthor=jadetex team, colorlinks=false, + linkcolor=black, pdfstartview=FitH} +\def\Gin@extensions{.pdf,.png,.jpg,.mps,.tif} +</screen> +Would cause the PDF document to open without displaying book marks. +Links would not be highlighted in anyway (if they were, the would be color black). +The document will be placed in a "fit width" viewing mode. +Finally, pdfjadetex would prefer image with a pdf extensions over a png extension if none is specified. +This is useful if you want to give priority to scalable documents for a PDF file, while preferring a bit mapped format for other output types.</para> +<para>If you have a out of date version of openjade, which does not support the characteristics +<screen> + "UNREGISTERED::OpenJade//Characteristic::page-two-side?" + + "UNREGISTERED::OpenJade//Characteristic::two-side-start-on-right?" +</screen> +and you want to use two sided output then you would have to add the definitions +<screen> +\def\PageTwoSide{1} +\def\TwoSideStartOnRight{1} +</screen> +to your <filename>jadetex.cfg</filename> to make up for the deficiency.</para> +</sect1> +<sect1><title>Version 3.12</title> +<formalpara><title>Released January 2002.</title> +<para>This release is primarily a maintenance release and is intended +to be used with openjade 1.3.1. In addition to fixing some bugs it +also provides enhanced support for the "euro" monetary symbol €.</para> +</formalpara> +<table id="id1" frame="topbot"><title>Changes for release 3.12</title> +<tgroup cols="2" align="left" colsep="0" rowsep="0"> +<colspec colname="c1" colwidth="1*" /> +<colspec colname="c2" colwidth="3*" /> +<thead> +<row rowsep="1"> + <entry>Item 1</entry> + <entry>Fix for space above horizontal rule</entry> +</row> +</thead> +<tbody> +<row> + <entry><para>References</para></entry> + <entry><para>Source Forge patch #444445</para></entry> +</row> +<row> + <entry><para>Category</para></entry> + <entry><para>Software Bug</para></entry> +</row> +<row> +<entry><para>Problem</para></entry> +<entry><para>A horizontal rule has spurious blank space above it</para></entry> +</row> +<row> +<entry><para>Resolution</para></entry> +<entry><para>Added \nointerlineskip to suppress the blank space</para></entry> +</row> +</tbody> +</tgroup> +<tgroup cols="2" align="left" colsep="0" rowsep="0"> +<colspec colname="c1" colwidth="1*" /> +<colspec colname="c2" colwidth="3*" /> +<thead> +<row rowsep="1"> + <entry>Item 2</entry> + <entry>Graphics centered within page not column</entry> +</row> +</thead> +<tbody> +<row> + <entry><para>References</para></entry> + <entry><para>Source Forge patch #470586</para></entry> +</row> +<row> + <entry><para>Category</para></entry> + <entry><para>Software Bug</para></entry> +</row> +<row> +<entry><para>Problem</para></entry> +<entry><para>External Graphics are centered with respect to the entire page. This causes a problem in multicolumn mode.</para></entry> +</row> +<row> +<entry><para>Resolution</para></entry> +<entry><para>External Graphics are now centered within the column width</para></entry> +</row> +</tbody> +</tgroup> +<tgroup cols="2" align="left" colsep="0" rowsep="0"> +<colspec colname="c1" colwidth="1*" /> +<colspec colname="c2" colwidth="3*" /> +<thead> +<row rowsep="1"> + <entry>Item 3</entry> + <entry>Fix fatal error with unbalanced columns</entry> +</row> +</thead> +<tbody> +<row> + <entry><para>References</para></entry> + <entry><para>Source Forge patch #492522</para></entry> +</row> +<row> + <entry><para>Category</para></entry> + <entry><para>Software Bug</para></entry> +</row> +<row> + <entry><para>Problem</para></entry> + <entry><para>The TeX multicol package supports + both balanced and unbalanced columns. However, JadeTeX 3.11 + didn't call the functions for unbalanced columns correctly. Since + a bug in the handling of %page-balanced-columns?% was fixed in + 3.11, this is now the common case - so multicolumn documents that + used to work in 3.10 no longer work</para></entry> +</row> +<row> + <entry><para>Resolution</para></entry> + <entry><para>Reworked the invocation of the unbalanced column macros. + It isn't pretty, but it works.</para></entry> +</row> +</tbody> +</tgroup> +<tgroup cols="2" align="left" colsep="0" rowsep="0"> +<colspec colname="c1" colwidth="1*" /> +<colspec colname="c2" colwidth="3*" /> +<thead> +<row rowsep="1"> + <entry>Item 4</entry> + <entry>Add <varname>DESTDIR</varname> environment variable to + <filename>Makefile</filename></entry> +</row> +</thead> +<tbody> +<row><entry><para>References</para></entry> + <entry><para>None</para></entry> +</row> +<row> + <entry><para>Category</para></entry> + <entry><para>Software Installation / Configuration</para></entry> +</row> +<row> + <entry><para>Problem</para></entry> + <entry><para>Makefile doesn't have <varname>DESTDIR</varname> environment variable</para></entry> +</row> +<row> + <entry><para>Resolution</para></entry> + <entry><para>Make makefile more friendly for packagers with + introduction of <varname>DESTDIR</varname> environment variable. This change is + transparent to those that don't want to use <varname>DESTDIR</varname>.</para></entry> +</row> +</tbody> +</tgroup> +<tgroup cols="2" align="left" colsep="0" rowsep="0"> +<colspec colname="c1" colwidth="1*" /> +<colspec colname="c2" colwidth="3*" /> +<thead> +<row rowsep="1"> + <entry>Item 5</entry> + <entry>Long directory/file names disappear of the page</entry> +</row> +</thead> +<tbody> +<row> + <entry><para>References</para></entry> + <entry><para>Red Hat Bugzilla bug 47345</para></entry> +</row> +<row> + <entry><para>Category</para></entry> + <entry><para>Software Bug</para></entry> +</row> +<row> + <entry><para>Problem</para></entry> + <entry><para>If there is a long directory + path in a document it goes off the side of the page. Long + pathnames should be split or put on a separate line so that they + don't go off the edge of the page.</para></entry> +</row> +<row> + <entry><para>Resolution</para></entry> + <entry><para>Added '\setlength\emergencystretch{2in}'. + In case of overfull hboxes, an extra stretchable length gets + added to the end of the lines.</para></entry> +</row> +</tbody> +</tgroup> +<tgroup cols="2" align="left" colsep="0" rowsep="0"> +<colspec colname="c1" colwidth="1*" /> +<colspec colname="c2" colwidth="3*" /> +<thead> +<row rowsep="1"> + <entry>Item 6</entry> + <entry>Add Extra Fonts</entry> +</row> +</thead> +<tbody> +<row> + <entry><para>References</para></entry> + <entry><para>sf.net request #452537, Mandrakesoft Documentation Project</para></entry> +</row> +<row> + <entry><para>Category</para></entry> + <entry><para>Software Bug</para></entry> +</row> +<row> + <entry><para>Problem</para></entry> + <entry><para>Many commonly installed fonts such as Charter and Utopia +are not available for use with JadeTeX</para></entry> +</row> +<row> + <entry><para>Resolution</para></entry> + <entry><para>Added the following fonts: Utopia, ZapfChancery, Fibonacci, +Funny, Dunhill, Concrete, Charter, Fontpxr, Fontaer, Fontaess, Fontaett, +Fontlcmss, Fontlcmtt, Fontlcmvtt, Fontcmbr, Fontcmtl, Fontpxss, Fonttxss, +Fonttxr. Note that this justs makes the fonts available to JadeTeX. You must +have them installed already to actually use them in documents</para></entry> +</row> +</tbody> +</tgroup> +<tgroup cols="2" align="left" colsep="0" rowsep="0"> +<colspec colname="c1" colwidth="1*" /> +<colspec colname="c2" colwidth="3*" /> +<thead> +<row rowsep="1"> + <entry>Item 7</entry> + <entry>Enhanced Euro symbol € support</entry> +</row> +</thead> +<tbody> +<row> + <entry><para>References</para></entry> + <entry><para>None</para></entry> +</row> +<row> + <entry><para>Category</para></entry> + <entry><para>Functional Change</para></entry> +</row> +<row> + <entry><para>Problem</para></entry> + <entry><para>Using the reference <command>&euro;</command> does +not produce any output. Using the Unicode character reference produces +a black square unless a Computer Modern font is being used.</para></entry> +</row> +<row> + <entry><para>Resolution</para></entry> + <entry><para>Switched to the <command>marvosym.sty</command> package +for the euro symbol. This is provides a good quality postscript font +containing the euro symbol. Some consideration was given to using Adobe's +freely available euro fonts and the <command>eurosans.sty</command> package. +However as the adobe fonts cannot be distributed freely this option +was not chosen. In addition, the <command>marvosym.sty</command> package +is available in most modern TeX distributions.</para> +<para>Additionally, support was added for the <command>&euro;</command> +entity reference.</para></entry> +</row> +</tbody> +</tgroup> +</table> +</sect1> +</chapter> +</book> |
