Texshop in 2003
Total Page:16
File Type:pdf, Size:1020Kb
TeXShop in 2003 Richard Koch Mathematics Department University of Oregon Eugene, Oregon, USA [email protected] http://www.uoregon.edu/~koch Abstract TeXShop is a free TEX previewer for Mac OS X, released under the GPL. A great many people have contributed code to the project. TeXShop uses teTEX and TEX Live as an engine, typesetting primarily with pdftex and pdflatex. The pdf output is displayed using Apple’s internal pdf display code. I’ll discuss recent changes in the program and plans for the future. Introduction What are we talking about here? I talked about TeXShop at the 2001 TUG confer- In case you don’t work on a Mac or haven’t used ence. Mac OS X had just been released and still had the program, I’ll start with an overview. When quirks; during my talk, the Finder crashed. I typed TeXShop first starts, a single window opens for the option-shift-escape to bring up the Force Quit panel, source code. This window is shown behind another restarted the Finder, and continued. After the talk, window. The “Templates” button on the toolbar is a an audience member told me “I’m not very inter- pulldown menu naming various pieces of text which ested in your program. But it’s wonderful that you can be added to the document; one of these pieces could restart the Finder without rebooting!” inserts starting code for a LATEX document. The de- A lot has changed since then. The Finder never fault LATEX template text is shown in blue. Actually crashes, the teTEX/TEX Live distribution is stronger, the editor colors all TEX commands blue and these lots of pdf bugs have been fixed, and TeXShop has have come from the template. A beginner would new features. choose this template and add text in the middle. 32 TUGboat, Volume 24 (2003), No. 1 — Proceedings of the 2003 Annual Meeting TeXShop in 2003 Pushing the “Typeset” button on the toolbar up with a page sparsely sprinkled with letters. causes the document to be saved and typeset with Ghostscript 6 worked fine. This was a seri- pdflatex. A second window then appears showing ous bug because NSF preprint repositories often the output. This window has tools to change pages, had Ghostscript 7 pdf files. The bug was fixed change the magnification, and rapidly move to a in Jaguar and TeXShop users now use Ghost- later page. script 8. Next to the “Typeset” button is a pulldown • The Large Letter Bug. Large symbols — in- menu labeled “LaTeX”. This menu contains a list of tegral signs, summation signs, parentheses — A possible typesetting commands: Plain TEX, LTEX, were cut off. Sometimes the top and bottom BibTEX, ConTEXt. Also included are MakeIndex, would display and the middle would be miss- MetaPost, and MetaFont. If one of these is chosen, ing. Documents with such symbols would print the Typeset command will run that program. fine on PostScript printers, but not on inkjet I have described the simplest situation. Most printers. This important bug was fixed in sys- users will open an existing TEX document and then tem 10.2.4. both the source and preview windows will open side by side. After adding text to the source, users push Another significant change is Gerben Wierda’s “Typeset” to save and typeset the changed source. rapid improvement of the teTEX/TEX Live installer, Multiple documents can be open at once. making it easy for users to maintain an up-to-date Printing is straightforward. Select “Print” and TEX distribution. Wierda’s i-Installer is completely the output will be printed on any inkjet or Post- independent of TeXShop and his distribution is used Script printer. If the printer handles color, illustra- by most front ends on Mac OS X. I often receive tions and text can appear in color. email complaining that TeXShop doesn’t typeset cor- rectly. If the email contains an example, I typeset The Mac OS X landscape it from the terminal and usually determine that the typeset output is exactly as the writer describes. So There have been many changes in the Mac world I write back “this is not my problem.” If I were more since 2001. The most important from my point of responsible, I’d look at the source code and try to view is that bugs in Apple’s pdf code have been find the error. quashed. I know of no outstanding bug. A final change is that T X can now be created My bug folder lists the following items, in order E on Mac OS X using a great many different programs. of correction: Apple’s release of its own X window system makes • The Window Server Crash Bug. After one early X programs coexist nicely with Aqua programs, so release of OS X, users sent me illustrations and users can easily use emacs and xdvi. At the Apple complained that TeXShop crashed when it tried developer conference, I only saw one slide of a sys- to display them. When I saved these illustra- tem running TEX and that fellow was using xdvi. tions in a folder and selected one, the Finder Many wonderful front ends and tools have been re- tried to create a thumbnail preview and crashed. leased; these will be described by other people at the Apple fixed this bug very rapidly! conference. I’m somewhat selfishly going to describe • The Accent Bug. Certain accented letters dis- only TeXShop, but users should experiment before played with the accent displaced to the right settling down with one solution. rather than placed over the letter. Documents with accents printed fine on PostScript printers, Configuring TeXShop but incorrectly on inkjet printers. This bug was In the course of this talk, I’m going to mention sev- fixed gradually, and as a result complaints from eral people who have made enormous contributions. European nations gradually narrowed to just a Don Knuth, of course, is responsible for everything few countries, and then disappeared. we do; I’ve never met him. Two other people are • The Ghostscript 7 Bug. TeXShop has a sec- here, Thomas Esser who created the teTEX distri- ond typesetting option in which a source file bution, and H`anThˆe´ Th`anh, who created pdftex. is typeset with LATEX, the dvi file is converted Salute! to PostScript with dvips, the PostScript file TeXShop now has a reasonable help system, is converted to pdf by Ghostscript, and this created by Martin Kerz (figure 1). I’ve haven’t been pdf file is displayed. For a long time, Apple’s a great fan of Apple’s Help Viewer because it is slow, pdf routines ignored most fonts in documents but I expect great improvements soon. Let me show created by Ghostscript 7 and the user ended you the help system because I want to point out one TUGboat, Volume 24 (2003), No. 1 — Proceedings of the 2003 Annual Meeting 33 Richard Koch Figure 1: TeXShop help system. Figure 2: TeXShop window positioning. feature, the “How do I configure TeXShop?” sec- a document is typeset during a TeXShop session, tion. I hope users will get in the habit of reading a warning dialog appears allowing the user to turn this section whenever they upgrade the program. off shell escape for that particular document. This In the “Recommended Preference Changes” sec- makes it easy to use graphic conversions for your tion, I recommend different window placement de- own source but not for source received in email. In faults. When TeXShop is first installed, it is con- case you are wondering, I don’t have the flag checked figured to remember the last positions of the source on my machine. Live dangerously. and preview windows, and use these the next time TeXShop has a few hidden preferences with no TeXShop runs. This only makes sense if you work interface in the preference panel. One causes it to with one file at a time; otherwise it is likely that create a backup file every time a file is saved or type- one of the windows was pulled out of the way before set. The configure help section explains how to set quitting, and its position may become the position that preference. TeXShop uses when it runs again. It is far more con- venient to open source and preview windows side-by- File encodings and the power of side with fixed dimensions set in advance. To make programmers in Japan this happen, typeset a small file and position the source and preview windows as you like. Then open Internally, Cocoa editors use Unicode. But conven- Preferences. For “Source Window Position,” choose tional TEX cannot handle Unicode, so TeXShop con- “All windows start at fixed position” and push the verts a file to Unicode when it opens the file, and “Set with current position” button. Configure the converts the Unicode back to something else when Preview window similarly (figure 2). it saves. TeXShop now supports sixteen different While I’m dealing with preferences, I’d like to encodings; I don’t recall how many encodings TeX- mention another one. TeXShop now starts config- Shop supported in 2001 — maybe only one. ured to automatically convert eps files to pdf and Three of these encodings are interesting. The tiff files to png during typesetting. We made this first is utf-8, which preserves Unicode. I know a lit- change when pdftex dropped support for tiff files. tle about TEX programs which can input Unicode, In the new configuration, the -shell-escape flag is but hope to learn a lot more at the conference.