% !TEX TS-program = xelatex 
% !TEX encoding = UTF-8 Unicode samples, and choose one of the font names 


\documentclass[12pt, oneside]{article}
\usepackage{geometry}                % See geometry.pdf to learn the layout options. There are lots.
\geometry{letterpaper}                   % ... or a4paper or a5paper or ... 
%\geometry{landscape}                % Activate for for rotated page geometry
\usepackage[parfill]{parskip}    % Activate to begin paragraphs with an empty line rather than an indent
\usepackage{graphicx}
\usepackage{amssymb}
\usepackage{epstopdf}
\DeclareGraphicsRule{.tif}{png}{.png}{`convert #1 `dirname #1`/`basename #1 .tif`.png}
\usepackage[colorlinks=true, pdfstartview=FitV, linkcolor=blue, 
            citecolor=blue, urlcolor=blue]{hyperref}
            
\usepackage{fontspec,xltxtra,xunicode} 
\defaultfontfeatures{Mapping=tex-text} 
\setromanfont{Hoefler Text} 
\setromanfont{Optima}
\setromanfont{Baskerville}
\setsansfont[Scale=MatchLowercase] {Gill Sans} 
\setmonofont[Scale=MatchLowercase] {Andale Mono} 

            
\title{Read Me First}
%\author{The Author}
%\date{}                                           % Activate to display a given date or no date

\begin{document}
\maketitle
\tableofcontents


\section{TeXShop and TeXworks}

\TeX{} is a typesetting program, originally designed for mathematical and scientific documents, but increasingly used in other fields as well. The Mac\TeX{} distribution contains the \TeX{} program and a large number of support files: fonts, style files, and so forth.

Most of these files remain hidden from the user, who interacts with \TeX{} via a front end. This front end contains an editor used to enter source text, and a preview window showing the typeset output. After installation of Mac\TeX{}, your \path{/Applications/TeX} folder will contain two front ends to \TeX{} --- TeXShop and TeXworks. TeXShop has been available for OS X since the introduction of the operating system; TeXworks is a front end modeled on TeXShop but available for many computer platforms.  



\section{First Steps with \TeX}

If you are new to \TeX, the following steps will get you started. Go to \path{/Applications/TeX} and find TeXShop. Drag its icon to your dock. Run the program. You will be presented with a blank window; at the top right of this window you'll find a pull down menu named ``Templates''. From this menu choose ``LaTeX Template''. The blank window will fill with some standard boilerplate required in each \TeX\ source file. The red lines are comments which \TeX\ ignores.

New material goes between the lines

\begin{verbatim}
     \begin{document}
\end{verbatim}

and

\begin{verbatim}
     \end{document}
\end{verbatim}

Type some sentences there now.  \TeX\ will ignore most carriage returns because it knows how to format text, so insert them randomly if you wish. Use a blank line to indicate  the start of a new paragraph. 



\begin{figure}[htbp] %  figure placement: here, top, bottom, or page
   \centering
   \includegraphics[width=4.9in]{edit.png} 
   \caption{Edit Window}
   \label{fig:example}
\end{figure}

\newpage

Uncomment the source line with the words ``usepackage[parfill]{parskip}''
if you prefer to separate paragraphs with an empty line instead of an indent.

When you have some material, hit the ``Typeset'' button at the top left of the window. A dialog will appear asking you to save the document. When \TeX\ typesets, it creates three or four additional files, so it is not a good idea to save directly to a location with many other files. Instead,  put your source in a folder within such a location. To do that, navigate to a reasonable location, say \path{~/Documents}, and then hit the ``New Folder'' button at the bottom of the dialog. Accept the default name or choose another and create the folder. Then name the document and save it. The default ``Untitled'' name will do.

As soon as you save, \TeX\ will typeset the document and open a second window showing the result.


\begin{figure}[htbp] %  figure placement: here, top, bottom, or page
   \centering
   \includegraphics[width=6in]{edit2.png} 
   \caption{Typeset Window}
   \label{fig:example}
\end{figure}






Go back to the original window and add some additional text. Hit ``Typeset'' again. This time \TeX\ immediately typesets the new material and updates the output window.

Now quit the program.

It is possible to reopen the project by double clicking on the Untitled file or by starting TeXShop and navigating to Untitled in the Open dialog, but there is a much easier way. Start TeXShop and under the File menu choose the item ``Open Recent...'' In the resulting list, choose ``Untitled'' and you will immediately return to the document.

Those are the basics. You will find further information in the TeXShop Help menu. The first short item, ``First Steps With TeXShop'', should tell you everything  you need to know to get started. Go to the Help menu now and select the submenu ``TeXShop Demos'' and then the item ``Getting Started''. You'll be shown a movie illustrating the steps you just performed.

You may be unhappy with TeXShop's placement of the two crucial windows. This is easily fixed, as explained in the second movie ``Initial Preferences''. Watch that movie and follow the suggestions in it to rationalize placement of the windows.

\section{Second Steps with \TeX}
The next crucial step is to learn \TeX. George Gr\"{a}tzer gave permission to put the first portion of his book \emph{More Math Into \LaTeX} in the TeXShop Help window, so begin by reading that document. 

It is also a good idea to read some of the material on the Mac\TeX{} web site: \url{http://www.tug.org/mactex}. The link ``References'' at the top of this page leads to a particularly useful page
which has a lot of information about learning \TeX. In particular, several useful online tutorials are available. If you are serious about \TeX, you'll probably want to buy some books. Visit  \url{http://tug.org/books/} for an excellent list of classics, available at a discount with free shipping.

The following locations may prove useful:
\begin{itemize}
	

	\item TeX Wiki by Gary Gray, Joseph Slater, and others:\newline \url{http://mactex-wiki.tug.org}
	
	\item Information on joining the \TeX\ on Mac OS X mailing list: \newline \url{http://mactex-wiki.tug.org/wiki/index.php?title=Mailing_Lists}
\end{itemize}

For specialized versions of \TeX\ and \LaTeX\ see:
\begin{itemize}
\item	Information on \XeTeX\ and \XeLaTeX: \newline \url{http://scripts.sil.org/xetex}

\item	Information on Con\TeX t:\newline  \url{http://wiki.contextgarden.net/Main_Page}
and
	\newline  \url{http://wiki.contextgarden.net/ConTeXt_Minimals}
\end{itemize}

Mac\TeX{} is brought you by the TeX user groups across the world, including the one for English speakers:
\begin{itemize}
	\item \TeX\ Users Group Site: \newline \url{http://www.tug.org}
\end{itemize}

Searching this site will reveal a vast reservoir of information, including
\begin{itemize}
\item	A Short History of \TeX: \newline  \url{http://www.tug.org/whatis.html}

\item	A free online journal focused on practical use: \newline  \url{http://www.tug.org/pracjourn/}

\item	Archived issues of the main journal about \TeX: \newline  \url{http://www.tug.org/TUGboat/}

\item	Information on joining TUG, to get the latest issues and much more:  \newline \url{http://www.tug.org/join.html}. 
 \newline See also  \newline \url{http://www.tug.org/usergroups.html}  \newline for a list of other user groups; please join the one best for you!

\item	The Comprehensive \TeX\ Archive Network (CTAN): \newline  \url{http://www.ctan.org/}
\end{itemize}

TeXShop is just one of the many available editors and previewers for \TeX\ on OS X. After you are comfortable with \TeX, you'll want to investigate other possibilities. A good starting point is the Gray-Slater site listed above.


\section{Mac\TeX{} for Experts}

Mac\TeX{} installs \TeX\ Live 2013 in \path{/usr/local/texlive/2013}. The distribution it installs is exactly the same as the distribution that would be obtained by using \TeX\ Live's standard install script. \TeX\ Live runs on almost all architectures: OS X, Windows, GNU/Linux, and other Unix systems. The distribution is the same on all of these platforms; nothing has been added or removed to customize it for OS X.

The Mac\TeX{} installer performs extra tasks which aren't done when you install with \TeX\ Live's standard script. Mac\TeX{} extends PATH and MANPATH so \TeX\ binaries and man pages for the distribution are available within Unix shells. It installs a \TeX\ Distribution preference pane for Apple's System Preferences to manage \TeX\ distributions on your machine. If you were using \TeX\ Live 2012 or the \TeX\ distribution in Fink or MacPorts, that distribution remains unchanged on your machine after installing Mac\TeX{}-2013. You can switch back and forth between \TeX\ Live 2013 and your old distribution by pushing a radio button in the preference pane. When  you push that button, PATH and MANPATH and all front ends and utilities are automatically reconfigured. A consequence of the mechanism used to make the panel work is that all of the \TeX\ front ends and utilities provided by MacTeX are automatically configured for \TeX; this applies to most current programs available over the web, not just those we supply with Mac\TeX{}.

On other Unix machines it is common to set environment variables like TEXINPUTS. While \TeX\ Live recognizes these variables, it is usually not necessary or desirable to set them.

Mac\TeX{} tries to guess your paper size at installation time. If it makes a mistake, you can set the paper size by running the program TeX Live Utility in /Applications/TeX, and selecting the ``Change Paper Size...'' item in the Action menu.

Use TeX Live Utility to keep your distribution up to date. When the program starts, it lists packages in TeX for which updates are available. 
Select the ``Update All Packages'' item in the Action menu to update these packages over the net.

For details about these features, read "What Is Installed" in \path{/Applications/TeX}.


\section{\TeX\ Live Documentation}

\TeX\ Live comes with extensive documentation. To browse through the full set, click the link
\url{file:///usr/local/texlive/2013/index.html}.  This leads to several deceptively simple README links in various languages. If you follows links within these README files, you will soon reach extensive amounts of information, including some book length introductions to \TeX. An important link is \url{file:///usr/local/texlive/2013/doc.html}
which has links pointing to all of the html and pdf package documentation, sorted by package name. There are so many links that it is difficult to pick favorites; here are a few samples to show the variety of available information:

\begin{itemize}
\item
     A 139 page book on \LaTeX, \emph {The Not So Short Introduction to \LaTeX 2e}, by Tobias Oetiker, Hubert Partl, Irene Hyna and Elisabeth Schlegl: 
     \url{file:///usr/local/texlive/2013/texmf-dist/doc/latex/lshort-english/lshort.pdf}
     
%\item     \emph{A Survey of Free Math Fonts for \TeX\ and \LaTeX } by Stephen G. Hartke:
%     \url{file:///usr/local/texlive/2013/texmf-dist/doc/fonts/free-math-font-survey/survey.pdf}
%
\item     \emph{The \TeX\ Live Guide} for 2013, edited by Karl Berry:
    \url{file:///usr/local/texlive/2013/texmf/doc/texlive/texlive-en/texlive-en.pdf}

\item     The documentation for Beamer, a \LaTeX\ class to create presentations for a projector:
     \url{file:///usr/local/texlive/2013/texmf-dist/doc/latex/beamer/doc/beameruserguide.pdf} 
\end{itemize}

\section{Spell Checking}

Apple's spell checker doesn't understand \TeX, so it marks most \TeX\ control words as misspelled. There are two solutions to this problem. The first is to spell check documents after they are written, using the stand alone \emph{Excalibur} in \path{/Applications/TeX}. The second is to download Anton Leuski's \emph{cocoAspell}, a plugin for Apple's system which does recognize \TeX\ control words. To download and install the free \emph{cocoAspell}, go to 
	\url{http://people.ict.usc.edu/~leuski/cocoaspell/}

We do not include \emph{cocoAspell} because you would need to go to this web page anyway to select a language and dictionary; at least 74 languages are supported.




\end{document}
  