Date: Tue, 17 Mar 1998 23:23:17 +0000 From: Nik Clayton <nik@nothing-going-on.demon.co.uk> To: doc@FreeBSD.ORG Subject: Getting jadetex to work on FreeBSD Message-ID: <19980317232317.34032@nothing-going-on.org>
next in thread | raw e-mail | index | archive | help
For those who are following the efforts to get the Handbook converted
from LinuxDoc to DocBook, I've had some success getting JadeTeX to work
on FreeBSD.
Here are my notes on the process so far. If you're an enterprising TeX
hacker with some time to spare I'd really appreciate you looking over
the following, trying it out, and letting me know where my lack of TeX
know-how is letting me down.
Cheers,
N
Notes on getting JadeTeX to work on FreeBSD
This is some very rough and ready notes that get JadeTeX at least
partially working on FreeBSD. Hopefully, this is enough to let the
interested and knowledgable TeX hacker let me know what I've missed.
I don't doubt there are things I've done wrong here, or workarounds that
are unnecessary. I don't know TeX, but I'm working on it.
Obviously, you need to have 'jade', which is in ports/textproc/jade.
------------------------------------------------------------------------
1. Download and install teTeX 0.4.
teTeX is in ports collection, so you can
# cd /usr/ports/print/teTeX
# make
# make install
or you can get it from the package.
2. Configure TeX using /usr/local/bin/texconfig.
From the menus, make the following changes. I'm not sure how many of
them were specific to getting JadeTeX working:
- Rebuild the ls-R database.
- Change the hyphenation table. Uncomment the British and French
entries.
- Set the xdvi default papertype to something useful, I used A4.
- Do the same for dvips.
- In the Font menu, add global write permissions to the standard
fonts tree. Probably a security hole if you're running on a system
with lots of users, but I'm not.
3. Download the jadetex package from CTAN,
<URL:ftp://ftp.tex.ac.uk/pub/archive/macros/jadetex/>;
You want the contents of that directory and its subdirectories.
4. Extract jadetex to a temporary directory ('jadetex')
Check the version you downloaded. My tests were with version 0.59
(according to jadetex.dtx).
5. Copy the contents of the 'cooked' subdirectory into the 'jadetex'
(parent) directory.
This is so that the hyperref (and other) stylesheets can be found.
# cd jadetex
# cp cooked/* .
6. Edit 'makefile' (or apply this patch). I had to make the following
changes:
- Comment out the references to pdftex and jadetexpdf, since a
PDF capable TeX is not (or appears not to be) built from
teTex.
- Change "tex -ini" to "initex", since the '-ini' flag is
unrecognised.
- Drop the use of 'kpsewhich' which doesn't understand the switches
passed to it (on my system) and for which documentation is
lamentably lacking. Hardcode the target directory.
Diffs for these changes:
------------------------------------------------------------------------
--- makefile.org Tue Mar 17 22:31:20 1998
+++ makefile Tue Mar 17 22:01:52 1998
@@ -1,20 +1,21 @@
-default: jadetex.fmt jadetexpdf.fmt
+#default: jadetex.fmt jadetexpdf.fmt
+default: jadetex.fmt
basic: jadetex.ltx
tex jadetex.ins
jadetex.fmt: basic
- tex -ini "&latex" jadetex.ini
+ initex "&latex" jadetex.ini
jadetexpdf.fmt: basic
pdftex -ini "&pdflatex" jadetexpdf.ini
-install: jadetex.fmt jadetexpdf.fmt
- (TT=`kpsewhich -expand-var '$$TEXMFMAIN'`;cp jadetexpdf.fmt $$TT/web2c)
- (TT=`kpsewhich -expand-var '$$TEXMFMAIN'`;cp jadetex.fmt $$TT/web2c)
- (TT=`kpsewhich -expand-var '$$TEXMFMAIN'`;\
- -mkdir $$TT/tex/jadetex ; \
- cp dsssl.def isoents.tex jadetex.ltx $$TT/tex/jadetex)
+#install: jadetex.fmt jadetexpdf.fmt
+# (TT=`kpsewhich -expand-var '$$TEXMFMAIN'`;cp jadetexpdf.fmt $$TT/web2c)
+install: jadetex.fmt
+ cp jadetex.fmt /usr/local/share/texmf/web2c
+ -mkdir /usr/local/share/texmf/tex/jadetex
+ cp dsssl.def isoents.tex jadetex.ltx /usr/local/share/texmf/tex/jadetex
clean:
-rm jade*.fmt *.log *.aux *.idx dsssl.def isoents.tex jadetex.ltx
@@ -22,7 +23,7 @@
test:
jade -t tex -d art.dsl test.sgm
- jadetexpdf test
+# jadetexpdf test
distrib:
(cd ..; zip -r jadetex jadetex/cooked jadetex/*.dtx jadetex/*.ins \
------------------------------------------------------------------------
7. You can then 'make' and 'make install' (as root). This should just
work.
8. Now you need Norm Walsh's modular DocBook stylesheets. Download the
current stylesheets from
<URL:http://nwalsh.com/docbook/>;
(sorry, that's not quite the full URL which I don't have to hand, but
the appropriate link should be obvious)
Unpack the stylesheets, which should give you a /docbook/ directory.
9. This should be enough for you to convert a sample file.
The sample file I've used is available from
<URL:http://www.nothing-going-on.demon.co.uk/FreeBSD/policy-incoming.sgml>;
Then, to convert this file do:
% jade -t tex -d /path/to/docbook/print/docbook.dsl policy-incoming.sgml
% tex "&jadetex" policy-incoming.tex
which produces policy-incoming.dvi, which you can preview using xdvi.
10. Problems
- If you try and run the 'tex' command outside the jadetex/ directory it
will fail, with
This is TeX, Version 3.14159 (C version 6.1)
Sorry, I can't find that format; will try the default.
(policy-incoming.tex
Babel <French> and hyphenation patterns for loaded.
! Undefined control sequence.
l.1 \FOT
{}\Seq%
I assume this is because the .sty and .ref files that are in the
jadetex directory (which were originally in the cooked/ directory)
haven't been properly installed for TeX.
Does this mean we'll need ports for these as well as for JadeTeX?
- xdvi throws out lots of warning messages like
xdvi.bin: special "html:<A name="31">" not implemented
which is (I assume) something to with hyperlinking that hasn't been
properly implemented.
--
Work: nik@iii.co.uk | FreeBSD + Perl + Apache
Rest: nik@nothing-going-on.demon.co.uk | Remind me again why we need
Play: nik@freebsd.org | Microsoft?
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19980317232317.34032>