This page contains miscellaneous useful commands which have not yet found their natural place in the help system.
After the phrase is typed, push RETURN to go to the first occurrence of the phrase in the document. This will also make the main pdfView the first responder, so the selection will be visible in blue. Type command-G to go to the next occurrence, and shift-command-G for a backward search. This is parallel to the corresponding commands for text searches. (Previously, RETURN and SHIFT-RETURN performed these commands, but these require that the search field be the first responder and thus product selections in gray instead of blue.)
Suppose you want to search on page 63. Go to that page and select any section of text with at least one letter. After that, searches will begin from that selection.
Click in the PDF file to create an empty selection. Then searches will again begin at the start of the document.
If a search reaches the end of the document, it will cycle to start at the beginning.
A user complained that his collaborators in Europe insert non-ascii characters into the source document, and asked for a search command which would locate all such characters so they could be edited out. This feature is already present in TeXShop.
Select the OgreKit Find Panel using TeXShop Preferences. This panel has powerful features and is activated by most TeXShop users. In particular, it can handle regular expressions.
Search for
Click "Next" to search for occurrences one by one, or push the "Highlight" button to highlight all non-ascii characters at once.
Similar tricks are possible using other regular expressions. Read about regular expressions on the internet and experiment.
TeXShop has a hidden preference setting to control the "ColorIndex" tool. Type the following command in Terminal to turn this item on by default for each new document:
When either magnifying glass is being used, temporarily pushing the Command, Option, or Control keys will increase the amount of magnification, and temporarily pushing Shift-Command, Shift-Option, Shift-Control will decrease the magnification.
The LaTeX hyperref package adds active links and url's to pdf documents. Many are under author control, but the package automatically links table of contents items to the starts of chapters and sections, and automatically links reference items to the corresponding bibliography entry.
TeXShop makes it easy to understand these links at a glance. If the mouse hovers over a link, a popup window appears for several seconds showing the linked portion of the document. This is particularly useful when checking references in the document.
Normally the popup window is on the screen for four seconds and then disappears. If the option key is down when these four seconds are up, the popup window will remain on the screen until the mouse moves.
Tabs are not appropriate for all TeX projects. They work best on books and large articles with from five to fifteen chapters or divisions, each introduced with an \include command. Some authors prefer to divide their project into many more pieces, perhaps one file per section, and then associating a tab with each file would product unmanageably many tabs.
TeXShop has two mechanisms to enhance Sierra tab support. The first is very simple. Within the top 20 lines of the root file, add the line
This first method allows an optional extension listing short names for the added tabs:
The second mechanism gives the user considerably more control over the tabs. Within the top 20 lines of the root file, add the line
Optional short names will only be recognized in High Sierra, because it requires additional Apple API first made available there. Feel free to use the options in Sierra; they will cause no harm there, but will be ignored.
Finally, we list some technical details. The first mechanism searches for \include lines after \begin{document} in the body of the root file. It is common to list files without extensions, and in that case TeXShop adds the extension ".tex" when creating the tab. In the second mechanism, however, TeXShop will not change the extension given by the user, or add a missing extension, because tab files can have unusual types so the extensions provide crucial information. Both methods create at most 20 tabs and ignore lines which might create more of them. The "useTabs" mechanism only works if the root file has at most 20,000 characters, to avoid very long searches for \include lines in gigantic root files.
If a window with tabs is left open when TeXShop is closed, then the next time TeXShop is opened, macOS opens the window and recreates the tabs. The new tab mechanism recognizes this behavior and lets macOS do the job without itself creating tabs. However, macOS does not understand tabs made from pdf files, graphic files, and a few others, so some of the tabs may be missing. It is easy to get these tabs back. Close the document and then reopen it. This forces TeXShop to recreate the tabs, and then all tabs come back. Or open the missing files yourself and drag their windows to missing tabs. (This macOS behavior is not a bug; other features of TeXShop depend on it. We cannot have everything.)
Finally, a word about the path information between the curly brackets in the "tabbedFile" magic lines. Three types of path strings are recognized. The first are strings that start in the location of the root file. Examples include {chapter1.tex} and {Chapter1/Introduction.tex}. Longer strings of directories are allowed. When it sees this sort of string, TeXShop prepends the full path to the folder containing the root file.
Another possibility is a path starting at your home directory, like {~/Galois/Equations.tex}. Here ~ denotes the home directory, so this file is probably not in the project directory.
Finally, TeXShop recognizes full paths like {/Users/koch/Galois/Equations.tex}.
If you use still more Unix conventions, they may or may not work. No guarantees. Tests suggest that spaces are allowed in both directory names and file names, but I'm loathe to recommend them.
There are a few tricky points. The Finder often lists TeX source files without the ".tex" extension, but this extension is just hidden, not absent. It must be written as part of the tab file path. (During testing, I was confused by this point several times).
When TeXShop is asked to create a tab, it opens the file exactly as if a user had dragged the file icon to TeXShop and dropped it there. Then the window described in the tab is "tabbed." This creates a few surprising cases that look like bugs but aren't. For example, then TeXShop opens a dvi file, it actually converts the file to pdf using dvips and Ghostscript, and then opens the pdf file. So tabbing a dvi file will give a pdf file as a tab.
Here is another surprising case. Suppose that you are working on a project named "Galois.tex" and you earlier created a project named "Abel.tex". When you open Galois.tex, you want Abel.tex as a tab so you can refer to that source file as you write Galois. But if you drop the icon for Galois.tex on TeXShop, both Galois.tex and Galois.pdf will open in separate windows. Similarly dropping the icon for Abel.tex on TeXShop will open Abel.tex and Abel.pdf. After tabbing occurs, you'll have a tabbed window containing Galois.tex and Abel.tex, and you'll have Galois.pdf in a separate window. But you'll also have Abel.pdf in another window. The existence of this extra pdf file looks like a bug, but isn't.