Installation notes for OzTeX 4.0, September 1999 ================================================ Andrew Trevorrow akt@kagi.com www.kagi.com/akt CONTENTS: Introduction System and memory requirements Upgrading an existing version How to install OzTeX How to print the OzTeX User Guide How to preview the OzTeX User Guide Important changes Specifying a text editor A minimal OzTeX system Introduction ------------ OzTeX is a Macintosh implementation of Donald Knuth's TeX typesetting system. This file explains how to install OzTeX and print out the OzTeX User Guide. OzTeX is shareware, so if you like it and decide to keep it then please pay the shareware fee; see the "Shareware Fee" item in OzTeX's Help menu for payment details. System and memory requirements ------------------------------ OzTeX, OzMF and OzMP run on all Macintosh models from a Mac Plus to a Power Mac (in native mode) and under all System versions from 6.0 up (System 7 or later is preferred). OzTtH requires a PowerPC Mac. As distributed, the preferred memory sizes for all Oz* apps add up to about 9Mb (or about 11Mb on a Power Mac with virtual memory turned off). However, you should only need two of the applications running at any given time. A typical OzTeX system uses anywhere from 15 to 100Mb of disk space, depending on the block size of your disk and how many extras you want. A minimal OzTeX system could probably squeeze in under 15Mb if you only want to run TeX and print/preview the occasional document. The final section discusses how to set up such a system. Upgrading an existing version ----------------------------- If you have an existing version of OzTeX then BEFORE installing the new version you should COPY all the existing Oz* Prefs files from your system's Preferences folder into the same folder as your old Oz* apps. When the new Oz* apps start up they will update the Oz* Prefs files in the Preferences folder and make them unusable by the older apps. Apart from the above reason, there are a couple of other reasons why it is a good idea to keep your Oz* Prefs files in the same folder as the apps: 1. It makes it easier to do backups. (You do backup your prefs don't you?) 2. It is less likely that the Prefs files will become corrupted. I've had occasional reports of corruptions that I suspect are caused by buggy extensions or virus detection software. How to install OzTeX -------------------- OzTeX is normally distributed as a set of StuffIt archives: OzTeX.sit - the OzTeX application (68000 and PowerPC code). OzMF.sit - the OzMF application (ditto). OzMP.sit - the OzMP application (ditto). OzTtH.sit - the OzTtH application (only PowerPC code). TeX.sit - the TeX folder (used by OzTeX). MF.sit - the MF folder (used by OzMF). MP.sit - the MP folder (used by OzMP). TtH.sit - the TtH folder (used by OzTtH). Extras.sit - the Extras folder (AlphaLite, BibTeX, MakeIndex, etc). Register.sit - the Register folder (to pay the shareware fee). Correct.sit - the Correct file (to check the installation). Local.sit - the Local config file. If you already have an older version of OzTeX then you should install this new version in a new folder to avoid clobbering any of your own config files, fonts, input files, etc. After you have the new version up and running you can easily add in your own modifications by making suitable changes to the Local config file. Assuming you have enough disk space, carry out these steps: 1. Create a new folder anywhere on your disk and call it anything you like. "OzTeX" would be a good choice! 2. Put all the .sit files in the new folder and unpack them by dragging them onto StuffIt Expander. Delete the .sit files when you're finished. 3. To check the installation, double-click on the Correct file. It contains a picture of a correctly installed OzTeX folder, so make sure your new folder looks the same. That's it. OzTeX and the other Oz* apps are now ready to run. How to print the OzTeX User Guide --------------------------------- 1. Start up OzTeX by double-clicking on the application. It should load the Default and Local config files, then an encoding file. (If you get any warning messages about unknown folders or files then you've made a mistake during installation, so go back and check the Correct file.) 2. OzTeX is set up to print on A4 paper. If your printer uses US Letter paper then select "US Letter" from the Config menu. (You can make this a permanent change if you like; see the notes in the Local file.) 3. Select "Page Setup..." from the File menu and check that the paper size and orientation are correct. 4. OzTeX's Default configuration file is set up for a 300 dpi printer. If you are using a StyleWriter (or any 360 dpi printer) then select the "StyleWriter" item in the Config menu. If you have an ImageWriter (or any 144 dpi printer) then select the "ImageWriter" item. There are also items for a Linotronic (at 1270 dpi) and a 600 dpi printer. 5. Select "Print DVI..." from the File menu and open ozuser.dvi in the :TeX:Docs:LaTeX: folder. 6. When the print dialog box appears, select suitable options. For example, reverse the page order if your printer stacks pages face up. Note that OzTeX is supplied with enough PK fonts to print the User Guide on 144/300/360 dpi printers. If you don't have such a printer (or if you don't know), make sure the "Make missing PK fonts" option is checked. Finally, click on the Print button. Once the User Guide is printed you might like to read it! How to preview the OzTeX User Guide ----------------------------------- If you have trouble printing the User Guide or if you'd prefer to save paper then you can use OzTeX to read it. Select "View DVI" in the View menu and open :TeX:Docs:LaTeX:ozuser.dvi. The "Handy Hints" item in OzTeX's Help menu has a summary of all the keyboard and mouse shortcuts. Important changes ----------------- Here's a summary of the most important changes in OzTeX 4.0: - The folder structure has undergone a major overhaul. The result is an OzTeX folder that is simpler, more consistent and much less cluttered. The new structure should have very little impact on existing OzTeX users because there are also new configuration file features that make it easy to customize the OzTeX system without making a SINGLE change to any of the distributed folders. - The new Extras folder has all the peripheral stuff, mostly contributions from other people. It contains the latest versions of AlphaLite, BibTeX, Excalibur and MakeIndex, as well as all support files for the Y&Y fonts. - The Extras folder also contains Odd Jobs, my latest shareware offering. This utility can perform many useful file-processing tasks. - OzTeX's Default config file now uses big values for all TeX parameters. Some TeX parameters have had their upper limits increased. All formats have been rebuilt and OzTeX's preferred memory size is now 3500K. - OzTeX supports printing dvi files on color QuickDraw printers, and can also preview color PICT/EPSF images. System 7 or later is required. - Most previewing shortcuts can now be performed using the mouse. - LaTeX has been updated to the latest release (1999/06/01 patch level 1). The EC fonts are also included. - Added OzTtH, a Mac port of Ian Hutchinson's TeX to HTML translator. - OzTeX can remember recent TeX/DVI/PostScript files. New submenus let you select any of these files. - OzTeX's Tools menu has new items that provide quick access to OzTtH, BibTeX, MakeIndex, MacGS and Distiller. System 7 or later is required. - All Oz* apps create text files using a creator code specified by a new text_editor parameter (see the next section). - All the major tools and applications (dvips, Metafont, MetaPost, etc) have been updated to the latest versions. Make sure you select "Changes to OzTeX 3.1" from OzTeX's Help menu to see all the details about these and other changes. Specifying a text editor ------------------------ OzTeX does not contain an integrated text editor. Instead, Pete Keleher's AlphaLite program is supplied. Nearly all the TEXT files distributed with OzTeX have AlphaLite as their creator. If you prefer to use a different editor then Odd Jobs can easily change all the creator codes; just drop the OzTeX folder onto a suitable joblet (BBEdit Doc for example). All the Oz* apps create text files using a creator code specified by the text_editor parameter. The supplied Default files set text_editor to ALFA (for Alpha or AlphaLite) so if you use a different editor then add a line like this at the start of the Local config file: text_editor = R*ch (for BBEdit) text_editor = "MPS " (for MPW) If you use another editor and don't know its creator code then just drop the application onto Odd Jobs' Show Apps joblet. A minimal OzTeX system ---------------------- You might be running short of disk space, so let's consider the bare essentials needed for a working OzTeX system: - Use Odd Jobs to remove unwanted 68000/PowerPC code from all apps. - Delete :Extras:AlphaLite: if you use a different text editor. - Delete :Extras:Excalibur: if you don't need a spelling checker. - Delete :Extras:MakeIndex: if you don't need to create an index. - Delete :Extras:BibTeX: if you don't need to create a bibliography. - Delete :Extras:Y&Y: if you don't have any of the Y&Y fonts. - Delete OzMP and the MP folder if you don't want to use MetaPost. - Delete OzTtH and the TtH folder if you don't want to convert TeX files to HTML, or if you don't have a PowerPC Mac. - Delete OzMF and the MF folder if you have a full set of TFM and PK files, and you won't be needing any of the font-related tools in OzMF. - If you don't use LaTeX then delete these files and folders: :TeX:Formats:LaTeX.fmt :TeX:Inputs:LaTeX: - If you don't use AMS-TeX then delete these files and folders: :TeX:Formats:AMSTeX.fmt :TeX:Inputs:AMS-TeX: :TeX:TFM:AMS: :MF:Inputs:AMS: :Extras:Docs:AMSFonts: - If you don't use T1-encoded fonts then delete all the EC fonts: :TeX:TFM:EC: :MF:Inputs:EC: - If you don't use PostScript fonts then delete these folders: :TeX:VF:PS: :TeX:TFM:PS: - Delete all the subfolders in :TeX:PK: and let OzMF create new PK files. - Delete the Register folder after paying the shareware fee. :-) Happy OzTeXing!