Excalibur CTEX-21CE User Manual

About TeXShopRichard KochSeptember 3, 2006Contents1 Basic Help 41.1 Preliminaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.2 G

There is a way to permanently set the typesetting method of a document regardlessof preference choices. If one of the first twenty lines of the source

or with other color schemes. TeXShop has new macros to set the source windowcolors, and to reset to default colors.• There are hidden preferences to m

distributors provided their own "altpdflatex" scripts, which was confusing forbeginning users. This new version of TeXShop bundles "altp

in a temporary directory and display it.• If the abort button was pushed in the console and the user later typed andpushed RETURN, the program crashed

Bugs fixed:• The TeX, Latex, Bibtex, Makeindex, Metapost, Context, and Metafont buttonson the toolbar reset the default typesetting engine. This no lon

the Latex typesetting button except that it creates an html rather than a pdf,and displays the html in Safari rather than TeXShop. An advantage of thi

– makeindex– typesetinteractive– latexinteractive– texinteractive– bibtexinteractive– contextinteractive– metapostinteractive– makeindexinteractive– t

∗ bibtexinteractive∗ contextinteractive∗ metapostinteractive∗ makeindexinteractive∗ typesetinteractive∗ refreshpdf∗ taskdone∗ open for externaleditorT

One such case is eps topdf.sty, used to automatically convert eps files to pdfformat during typesetting.• Zenitani provided additional drag and drop su

• At the request of Joachim Kock, when TeXShop opens a file for Preview, oris in external editor mode and opens a file, the program now compares thedate

Version 1.32 adds two extra features to TeXShop and fixes some bugs.New features:• There is a new menu item, "New Tag", which inserts an empt

An alternate LaTeX spell checker named Excalibur is often used. This spell checkerwas written by Rick Zaccone; it can open TeXShop files. To obtain it,

the page down key, and the right arrow key stopped before displaying the lastpage. All of these problems are fixed.Version 1.31 adds some extra feature

– In Panther, the small yellow tags which display the current page whenscrolling in multipage and double multipage display formats were blank.Also, th

TeXShop TagSections NO" but this preference was disabled somewhere alongthe line and certainly in 1.30. It is enabled again.• The Preference wind

matrix. This wonderful panel is the work of Jonas Zimmermann, who can be reachedat [email protected] TeXShop 1.35 or above, the Matrix Panel can al

1.11 Including GraphicsThe programs pdftex and pdflatex can use graphic files produced in pdf, jpg, png,or mps format. If you are using the default late

program preference is “pdflatex –shell-escape”, and the LaTeX header contains thefollowing lines\usepackage{graphicx}\usepackage{epstopdf}\DeclareGraph

Users in Japan and Korea will use other conversion preferences, also provided.It is possible to reset the background color of the source window. The p

defaults write TeXShop ConsoleWindowAlpha 0.75defaults write TeXShop SourceWindowAlpha 0.75defaults write TeXShop PreviewWindowAlpha 0.75Here an alpha

the folder from scratch, and then repopulate the folder with additional templatesfrom the old Templates folder.The commands \usepackage{amssymb} and \

TeXShop can be instructed to create a backup file every time a file is saved or typeset.This is set using a hidden preferenc e. To create backup files, o

%e extensionIf an extension is not mentioned in the Macro Editor, then it is handled in the defaultmanner mentioned earlier. Thus for most people, no

2.2 Additional Typesetting Engines . . . . . . . . . . . . . . . . . . . . . 232.3 Removing AUX Files . . . . . . . . . . . . . . . . . . . . . . . .

1.18 Sending Bug ReportsTo file bug reports for TeXShop and suggest improvements, contactRichard KochMathematics DepartmentUniversity of OregonEugene,

MetaPost Web Site:http://cm.bell-labs.com/who/hobby/MetaPost.htmlComprehensive TeX Archive:http://www.ctan.orghttp://www.ctan.org/tex-archiveTeX Users

2 Advanced Help2.1 Adding Personal Sty and Macro Files to teTeXUsers sometimes create additional sty, cls, bib, and tex files for c ommon use in severa

2.2 Additional Typesetting EnginesRecently, Jonathan Kew introduced XeTeX and XeLaTeX. These programs can useMacintosh fonts directly within a TeX doc

24

TeXShop now supports XeTeX and XeLaTeX. XeTeX and XeLaTeX are availablein the pull-down typesetting menu on the source window A user can make XeTeXor

There must be one space after %!TEX and one space before the equals sign; the spacesin the name of the encoding must match the spaces in the name list

trash all files in the current source directory with the same name as the source fileand extension aux, blg, brf, ccs, ent, fff, glo, idx, idv, ilg, ind,

window, and typeset. In this mode, TeXShop never opens or modifies the source file.It simply passes this file to the Unix TeX or LaTeX process.The previe

The “taskdone” call can be used to test completion; it returns NO while typesettingis being done, and YES when it is finished. Each of these calls refr

4.1 Preliminaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704.2 Did You Install Correctly? . . . . . . . . . . . . . . . . . . .

\begin{document}\include{Chapter1/one}\include{Chapter2/two}\include{Chapter3/three}\end{document}This root file contains formatting commands for the e

name as the input file and the extension “.texshop”. For instance, if the input forchapter two is in two.tex, TeXShop writes the name of the root in tw

click on a spot in the source file. TeXShop obtains the string 20 characters widecentered about the click, and searches for the corresponding string in

Earlier versions of TeXShop used an alternate synchronization method, invented in2003 by J´erˆome Laurens and Piero D’Ancona. They wrote a style file f

not from the included source back to the preview. It is easy to remedy this by addinga “%!TEX root” comment to the top of each source file.As explained

use of ligatures, so characters have different shapes at the ends of words than in themiddle) and Chinese. A new menu item will appear with a flag indic

author ={Donald E. Knuth},address ={Stanford, CA 94305},number ={STAN-CS-83-980},institution ={Department of ComputerScience, Stanford University} }@p

TeXShop to create the file “mybibliography.bib” in the first place, use the pulldowntag labeled “file format” to save the file as a bib file rather than as

When machines were slower, users often created their own format files to speed uptypesetting. This is done less often today, but dealing with format fil

Then uo.fmt will be used for that document regardless of the typesetting optionchosen.The above instructions assume you have a format for pdflatex. You

1 Basic Help1.1 PreliminariesTeXShop is a Mac OS X program which can typeset TeX and LaTeX files andpreview the output on the screen. The program usual

required “uo.fmt”.You might like to try this with the following “uo.tex” file:\documentclass[11pt]{article}\usepackage{geometry}\geometry{letterpaper}\

The eps files produced by Mathematica use the Macintosh line feed conventions.Earlier versions of TeXShop and teTeX required that these files be convert

green, a color w ith components (r, g, b) = (0.0, 1.0, 0.0). To do so, open the Terminalwindow and type the following commandsdefaults write TeXShop m

2.17 Colored Text in TeXIt has always been possible to color TeX output. To do so, add the line\usepackage{color}to the preamble, and insert a line li

2.18 More About teTeXteTeX is installed in the directory /usr/local/teTeX, which is not visible from theFinder. But the installer creates a symbolic l

Library –> texmf –> tex –> latex –> miscand store “new.sty” inside this misc directory.2.19 Coexisting with FinkMac OS X can also run X-wi

more details seehttp://cm.bell-labs.com/who/hobby/MetaPost.htmlInteresting metapost examples can be found at many web sites; f or instance seehttp://w

metademo.3, metademo.4. These names are determined by the number parameterof “beginfig()”. If this number is nonnegative, like beginfig(0) or beginfig(10

will run directly when the MetaPost engine is selected. A document containingMetaPost source code is first typeset with pdflatex or latex, creating a mp

\end{mfpic}\begin{center}\begin{mfpic}[15]{-2.2}{5}{-2.2}{2.2}\store{a}{\circle{(0,0),2}}\store{b}{\circle{(2 *sqrt 2,0),2}}\store{c}{\arcPage{(0,0),-4

To obtain these files and programs, go to Wierda’s sitehttp://www.rna.nl/tex.htmland obtain i-Installer, the TeX installer. You’ll find it in the downlo

\newcommand{\tit}[1]{\textit{\ignorespaces #1\ignorespaces}}\newcommand{\Cc}{{\protect\mathbb C}}\newcommand\ra{\rightarrow}\newcommand{\abs}[1]{\lver

Let $E,\pri E$ be metric spaces and $f:E\rightarrow \pri E$ a map.$f$ is called \tit{continuous} at $x_0\in E$ if\begin{equation}\notag\Au_{\pri U\in

\noindent\parbox[c]{7.51cm}{The picture on the right shows the intersection of twosets $A$ and $B$. Notice that this intersection consists ofall point

$\Si=\set{z\in\Cc^*}{\arg z\neq \pi}$ with$\pri\exp z=\exp z\neq 0$, and therefore, in view of the previous theorem,we may conclude\begin{theorem}The

KeyEquivalents.plist, Macros Latex.plist, and Macros Context.plist. These files re-side inside your personal library in a folder called ˜/Library/TeXSh

3 Macros Help3.1 PreliminariesTeXShop macros and the Macro Editor are by Mitsuhiro Shishikura. Default Latexmacros were created by Mitsuhiro Shishikur

as you desire.3.2 Understanding Default MacrosThe best way to understand default macros is to examine their definition with theMacro Editor. For exampl

3.4 Defining New MacrosNew items, new submenus, and new separators can be created by the buttoms at thebottom left. A little practice illustrates the b

TeX file has an error, the console will appear and wait for user input, but such inputwould not be recognized.Commands beginning with “–AppleScript” ar

automatically open files using any of these conventions. Most programs includingTextEdit, TeXShop, etc., follow these guidelines. In TeXShop, new files

1.3 Getting and Installing TeXShopIf you installed TeX with the MacTeX install package, you already have TeXShop.In that case, you only need read the

program to recreate any .gifs which already exist.pdfselectc: This script runs the shell script pdfselect to create pdf files containingonly certain se

is replaced with the complete path name of the source tex file minus its extension,and any string#DOCUMENTNAME#is replaced with the display name of the

taskdonerefreshpdfrefreshtextgoto lineThe first seven commands call TeXShop typesetting routines. These commandstypeset continuously without stopping a

display dialog "Test dialog: type something below"default answer "Hello World!"buttons {"A", "B", "B"

returnend ifset frontName to #DOCUMENTNAME#tell application "TeXShop"save document frontNameend telltell document frontName of application &

exit repeatend ifend repeatlatexend tellThe first line of this command indicates that this is an AppleScript macro. Thenext lines check #FILEPATH#, a p

#!/bin/tcsh# pdflatexc# Claus Gerhardt## Usage# pdflatexc filename.texset path= ($path /usr/local/teTeX/bin/powerpc-apple-darwin-current /usr/local/bi

tell document frontNamerefreshpdfend tellIgnoring the introductory comments, the first seven lines of this script are a magicrecipe by Claus Gerhardt t

the single quotes because of the space in the name of one directory.Shell commands in AppleScript are issued in the formdo shell script "command

The final three lines update the Preview window.To be sure, several of these lines are complicated, but these lines can be copiedwithout change into ne

TeXShop 1.35 came with new templates by Will Robertson. These templates willnot automatically be installed. You can obtain them by going to the folder

4 How do I configure TeXShop?4.1 PreliminariesPlease read only the first two sections below if you are a new user installing TeXShopfor the first time. I

TeXShop 1.35 comes with additional applescripts by Claus Gerhardt and Will Robert-son. If you upgrade from a previous version, you will not automatica

“After Window Resize” preference in the right column is set to “Fixed Magnifica-tion”. If it is set to “Actual Size” or “Fit to Window”, then it doesn’

4.5 Default Preference ItemsTeXShop 1.35 and above comes with a new Find panel, which requires system 1.3or later. Other users will still see the old

\usepackage{graphicx}\usepackage{epstopdf}\DeclareGraphicsRule{.tif}{png}{.png}{‘convert #1 ‘basename #1.tif‘.png}4.7 Hidden Preference ItemsTeXShop a

The text color of the source window can be changed. This change requires thatsyntax coloring be on. For example, to set this foreground color for text

TeXShop can be configured to save a backup file whenever it saves or typesets asource file. To turn this on, run Terminal and type the following command.

editor to be refreshed automatically, but pdf files opened for a brief glance to beleft alone, run Terminal and type the following command. The default

defaults write TeXShop LeftRightArrowsAlwaysPage YESThe console text reporting typesetting behavior and errors s hows black text. Thetext can be made

4.8 .plist FilesMac OS X makes extensive use of xml files; xml is a structured language closelyrelated to html.TeXShop uses five xml files for configurati

pulldown menu. Choosing a tag entry in this menu will scroll to the appropriateline in the source file. Lines which begin with the words \section, \sub

4.10 Modifying Auto CompletionThe preference panel contains a checkbox to turn auto completion on or off; bydefault it is off. When auto completion is o

5 CreditsTeXShop is produced under the GPL public license. Coordination by:• Richard Koch• Dirk Olmes• Gerben WierdaCode by:• Richard Koch• Dirk Olmes

• Nicol´as Ojeda B¨ar• Martin Heusse• Sarah Childers• Makoto Inoue• Sven A. Schmidt• Georg Klein• David Reitter• Maarten Sneep• Kevin Ballard• Elliott

• Nicola Vitacolonna• Seiji Zenitani• Yoshihisa Okazaki• Paulo Abreu• Andrei Teleman• Roxana Tenea Teleman• Juan Luis Varona MalumbresContact Informat

APPENDIXA Appendix: What’s New?Versions 1.42 and 2.05 add extra features to TeXShop and fix somebugs.New features in 2.05:• TeXShop 2.05 is now a Unive

occurred when a new pdf file was loaded into the PdfKitView in the Previewwindow. According to Apple documentation, this should have released theprevio

After this step, resizing the window leaves the wraps fixed. This is useful if yousend source to a colleague whose editor has fixed width and no wrappin

• Changed the English under the Preview tab of Preferences from "After WindowReview" to "Magnification Style" and changed "Pre

• Slightly modified the appearnce of the Console window, particularly in En-glish. More work is needed here. Note that the console window can be resize

• Conversion of eps, ps, and dvi files to pdf (caused by opening such a file) nowworks even if the path to the file has folders whose names contain space

text. By double or triple clicking before holding down the mouse, a larger portion ofthe text will be magnified. The magnified region can be changed dur

• When typesetting engines are c alled, they are now passed the program filenamewith extension, rather than just the filename.• In 1.35, it was only pos

PDFKit makes the following new features possible:– TeXShop supports hyperlinks. To activate this feature, add the line\usepackage[colorlinks=true, pdf

– PDFKit brings additional polish to the display of pdf documents. It sup-ports documents with isolated rotated pages, and correctly prints rotatedpag

• Commands have been added to the default Macros menu which insert thesymbols "%!TEX TS-program = " and "%!TEX encoding = " and &q

• Improvements were made in the pdfsync code.• In previous versions, it was possible to add a Macro button to the PreviewWindow Toolbar in English, bu

– c) If one of the first ten lines of the source has the form%!TEX encoding = UTF-8 Unicodethen that file will be loaded and saved with UTF-8 Unico de e

The encoding used to op en or save a file can b e set by w riting a line of theform%!TEX encoding = UTF-8 Unicodeas one of the first 20 lines of a sourc

with TeXShop 1.34. TeXShop did not keep up with the changes by d’Anconaand Laurens for several months; sorry!In the new version, \include and \input a

cursor. This is now changed; the first click in the edit text is recognized andpositions the cursor.When applescript runs under the Macro menu, it star

– a) SourceDoc and Root File information will be used to find the rootdocument– b) All files with appropriate extensions listed above will be moved to t