%!TEX TS-program = xelatex
%!TEX encoding = UTF-8 Unicode
%
\documentclass[12pt]{article}
\usepackage{graphicx}
\usepackage[hscale=.7, vscale=.8, centering]{geometry}
\usepackage{rotating}
\usepackage[numbers]{natbib}
\bibpunct{}{}{,}{s}{,}{,}

\usepackage{fontspec,xltxtra,xunicode}%xetex support stuff
\setromanfont[]{GentiumBookBasic}%body font
\setsansfont[Scale=MatchLowercase]{AndikaCompact}%sans serif font
\setmonofont[Scale=MatchLowercase]{AndaleMono}%mono space font

\usepackage{xcolor}%define colors
\usepackage{multicol}%two or more columns
\usepackage{textpos}
\setlength\parskip{\medskipamount}
\setlength\parindent{0pt}
\definecolor{links}{rgb}{.35,.35,.65}%{.3,.3,.9}
\definecolor{rule1}{rgb}{.7,.2,.1}
\definecolor{rule2}{rgb}{.1,.2,.7}
\definecolor{localgrey}{rgb}{.35,.35,.35}
\definecolor{AppleCantaloupe}{rgb}{1.00,0.80,0.40}
\clubpenalty=10000 %No orphans
\widowpenalty=10000 %No widows
\setcounter{secnumdepth}{0}
\setcounter{tocdepth}{2}

\usepackage{fancyhdr}
\pagestyle{fancy}
\lhead{}{}
\chead{}{}%{\color{rule1}{\hrule height 4pt}}
\rhead{Welcome to Mac\TeX}{}
\lfoot{}{}
\cfoot{\thepage}{}%{\color{rule1}{\hrule height 4pt}}
\rfoot{}{}
\renewcommand{\headrulewidth}{0pt} 
\renewcommand{\footrulewidth}{0pt}

\renewcommand{\labelitemi}{\(\Rightarrow\)}
\renewcommand{\labelitemii}{\(\triangleright\)}

%makes links hot internally and externally
%sets pdf metadata
\usepackage[unicode=true, bookmarks=false, pdfpagemode=UseThumbs, colorlinks=true, linkcolor=links, anchorcolor=links, citecolor=links, filecolor=links, menucolor=links, urlcolor=links, pdfauthor={Bob Kerstetter}, pdftitle={Welcome to MacTeX}, pdfsubject={Introduction to TeX and friends on Mac OS X. Send comments to tex@villaghiker.com}]{hyperref}

%font macros
%slanted, colored Chalkboard
\font\waa="ChalkboardSE-Light:color=FEDEE0;slant=-.4" at 24pt%
\font\wab="ChalkboardSE-Light:color=FDA0A3;slant=-.2" at 30pt%
\font\wac="ChalkboardSE-Light:color=FB0017;slant=0" at 36pt%.

%slanted Zapfino
\font\wba="Zapfino:color=E5FFD6;slant=-.4" at 24pt%
\font\wbb="Zapfino:color=B6FF8D;slant=-.2" at 30pt%
\font\wbc="Zapfino:color=51FF06;slant=0" at 36pt%

%languages in vertical type. XeTeX only.
\font\wca="Menlo-Regular:color=FF0000;vertical;" at 24pt%Roman
\font\wcb="Osaka:color=FF7F00;vertical;letterspace=12" at 24pt%Japanese
\font\wcc="Menlo-Regular:color=FFFF00;vertical;" at 24pt%Roman
\font\wcd="Menlo-Regular:color=00FF00;vertical;" at 24pt%Roman
\font\wce="Menlo-Regular:color=0000FF;vertical;" at 24pt%Roman
\font\wcf="STHeitiSC-Light:color=4B0082;vertical;" at 24pt%Chinese
\font\wcg="Menlo-Regular:color=8B00FF;vertical;" at 24pt%Roman

%slanted and shadowed MarkFelt 
\font\wda="MarkerFelt-Thin:color=0747CC;slant=0" at 42pt%.
\font\wdb="MarkerFelt-Thin:color=C4D1DF;slant=1.75" at 42pt%

%general fonts settings for the document 
\font\zaplove="Zapfino:color=DA6977;slant=0" at 10pt%
\font\chapterhead="Copperplate-Bold:color=000000;smallcaps=yes" at 12pt%
\font\countries="Arial Narrow" at 8pt% AndikaCompact
\font\osakatext="Osaka" at 12pt%

\renewcommand{\contentsname}{{\large Table of Contents}}


\begin{document}
\pagenumbering{roman}
 \thispagestyle{empty}
%cover page showing some capabilities of MacTeX
%shadowed and slanted Welcome to MacTeX in MarkerFelt-Thin
\centerline{\wda Welcome to Mac\TeX}\par%
\centerline{\raisebox{.5\depth}{\scalebox{1}[-1]{\wdb Welcome to Mac\TeX}}}

\bigskip

%scaled and colored welcome to MacTex in ChalkboardSE-Light
\centerline{\waa Welcome to Mac\TeX}\par%
\centerline{\wab Welcome to Mac\TeX}\par%
\centerline{\wac Welcome to Mac\TeX}\par%

%welcome in seven languages 
\centerline{\rotatebox{270}{\wca fogadtatás}%hungarian
\hfil\rotatebox{270}{\wcb ようこそ}%japanese
\hfil\rotatebox{270}{\wcc bienvenida}%spanish
\hfil\rotatebox{270}{\wcd  kaabọ}%yoruba
\hfil\rotatebox{270}{\wce chào mừng}%vietnamese
\hfil\rotatebox{270}{\wcf 歡迎}%chinese 
\hfil\rotatebox{270}{\wcg добродошао}}\par\vspace{36pt}%macedonian

%scaled and colored welcome to MacTeX in Zapfino
\centerline{\wbc Welcome to Mac\TeX}\par%
\centerline{\wbb Welcome to Mac\TeX}\par%
\centerline{\wba Welcome to Mac\TeX}\par%
\newpage

\tableofcontents
\newpage

\section{What You Can Do with Mac\TeX}
\pagenumbering{arabic}

Mac\TeX\ is an OS~X install package providing a completely configured and ready-to-use version of \TeX\ Live. Produced by \TeX\ User Groups worldwide, \TeX\ Live consists of the \TeX\ typesetting system and friends such as \LaTeX, \XeTeX\ and Lua\TeX.  \TeX\ Live enables you to create any variety of documents\footnote{Finding a common term to describe the documents produced by a full \TeX\ system is difficult. This is  because documents created by \TeX, \LaTeX\ and \XeTeX\ differ from each other in subtle ways. This document refers to them all as \TeX\ Live documents because they all come from the \TeX\ Live system.}, from wedding invitations to books. You work with an editor such as \TeX{}Shop or a graphical user interface program such as LyX. 

\begin{figure}[h]
\includegraphics[width=\textwidth]{MacTeXTeXShopText.jpg}
\caption{You create and change \TeX\ Live files with an editor. You supply content and commands. \TeX\ Live does the formatting.}
\end{figure}

\TeX\ Live operates cross platform on OS~X, Linux, Windows and Unix, plus virtually all other current computer systems. Documents produced with \TeX\ Live on the Macintosh typeset identically on Windows or Unix—with the same linefeeds, page breaks, fonts and illustrations. This makes collaboration trivial, regardless of the computing platforms involved.

\hypertarget{what-you-can-do}What you can do with \TeX\ Live depends on your familiarity with its capabilities. You can use \TeX\ Live for almost all types of printing and publishing activities—from very simple to extremely detailed:

\begin{itemize}
\item Write a letter or publish a memoir.

\item Design a poster or create a product catalog.

\item Generate a brochure or produce a textbook.

\item Construct a newsletter or fashion an annual report.

\end{itemize}


You can print your output or package it as a PDF or publish it as HTML. In fact, you can do almost anything with \TeX\ Live—from a publishing point of view.


\subsection{An Overly Modest View of \TeX}\label{overly-modest}

\TeX{}—the original ancestor of \TeX\ Live—is a free, multilingual typesetting system designed “for the creation of beautiful books—and especially for books that contain a lot of mathematics.”\footnote{Donald Ervin Knuth. \textsl{The \TeX{}book}, Volume A of Computers \& Typesetting. Addison-Wesley, Reading, Mass., 1986. ISBN 0201134470.} While this understated official description comes from \TeX\ developer Donald E. Knuth, it may make the system sound very specialized. The opposite is true. In addition to beautiful equations, \TeX\ produces the most beautiful text available for general publishing. But, does this really matter in the era of email, tweets and texts? Give it a try. Your love letters, business communications and mathematical treatises may benefit.

\subsection{Word Processors, \TeX\ and Formatting}

Near the beginning of the personal computer era, developers created word processing. Since then, word processors have gained some text manipulation and page layout abilities. But essentially all 21st Century word processors publish text the same now as then—exactly as you type it. Word processor marketers used to call this \textsl{What You See Is What You Get}. They abbreviated it as \textsf{WYSIWYG} and pronounced it as \textsl{whiz-e-wig}, or something similar.  WYSIWYG works in more or less one way. When you type:

\begin{verbatim}
Hello.          I 
love        you.
Won't          you tell        me your
           name.
\end{verbatim}

your obedient software prints everything just as you entered it:

\begin{verbatim}
Hello.          I 
love        you.
Won't          you tell        me your
           name?
\end{verbatim}

While this may be nice on occasion, suppose you were nervously hurrying and typing poorly. Your output in this circumstance may look like a harassment note instead of a first indication of possible affection. But \TeX\ can take care of that.

Type the exact same thing in \TeX\ Live—with the exact same spacing and line breaks—and you could very easily get:

{\zaplove Hello.          I 
love        you.
Won't          you tell        me your
           name?}

\TeX\ Live corrects your spacing—not your spelling—and line breaks. And it uses a beautiful font and color you requested.  This is for most purposes much better than WYSIWYG. Aware of the differences of their system over conventional word processors, \TeX\ users sometimes refer to WYSIWYG as WYSIAYG—or \textsl{What You See Is All You Get}.

What makes the difference between \TeX\ Live and word processing? Formatting!

\subsection{The Difference Rests in the Formatting}

With a word processor, you do the formatting—with its potential inconsistencies. As you word process, you must remember to format everything—every time. From a \TeX\ perspective, amazingly efficient software does the formatting and leaves the content to you. You tell \TeX\ what you want and it does everything as you like it.

But suppose you want to do all of the formatting? Can you do that with \TeX?

Of\\
\strut\hspace{20pt}\textbf{course}\\
\strut\hspace{60pt}\textsl{you}\\
\strut\hspace{80pt}\texttt{can}…

if you really want to. But \TeX\ eases the tasks of formatting, plus it produces beautiful typography.

\subsection{Hints of What \TeX\ Live Can Do for You}

\TeX\ Live creates beautiful documents according to the commands you use. It comes with hundreds of built-in primitive commands and hundreds of additional ones created by combining primitives into so-called \textsl{macros}. A sample macro might combine two primitives—$\backslash${\tt sl} for {\sl slanted text} and $\backslash${\tt bf} for {\bf bold text}—to make a $\backslash${\tt section} command with \textsl{\textbf{slanted bold}} text. When you tell \TeX\ Live to format some text using this \texttt{section} heading, the heading takes on the appearance of the command you specify. This same concept applies to every division head, paragraph, sentence, word and character in your document. You provide the instructions. \TeX\ does the formatting.

As a more specific example, a section heading may appear as bold characters, 12 points in size, using Copperplate font with small caps:

{\chapterhead A Hypothetical Section Heading}

In addition to fonts, the command for a section heading would also define space above and below the text, text alignment and other typographical controls. If you want to alter the appearance of the section heading, you modify its settings. The changes show up everywhere you use the section heading in your document. 

But, this just touches the surface because \TeX\ Live provides extreme flexibility.

\section{A Sampler of What \TeX\ Live Does}

\TeX\ Live helps make publishing convenient and consistent by controlling almost every aspect of document formatting. This benefits people in everyday life by saving time once you learn \TeX\ Live. As a real-world example, an economics consulting company saved 200 hours of production time each month by switching preparation of its detailed reports from a page publishing program to \TeX\ Live.  When thoughtfully implemented, \TeX\ Live can help recover lost time by managing the formatting of your documents. This section provides a sampling of the things \TeX\ Live can do to lighten the formatting load so you can concentrate on content. But first you need to understand some limitations.
\begin{figure}[h]
\font\expanda="Impact:color=007FFF;letterspace=26;extend=3.5" at 36pt%
\font\contracta="Impact:color=007FFF;letterspace=26;" at 42pt%
\font\stretcha="Hoefler Text:color=BFDDFE;letterspace=2;" at 36pt%
\font\shortena="Optima ExtraBlack:color=007FFF;letterspace=2;" at 36pt%
\font\rotatea="AndikaCompact:color=007FFF;" at 30pt%
\font\rotateb="Osaka:color=007FFF;" at 30pt%
\centerline{{\expanda Expand}}
\centerline{{\resizebox{72pt}{36pt}{\contracta Contract}}}
\centerline{{\scalebox{.8}[4]{\stretcha Stretch}}}
\centerline{{\resizebox{128pt}{6pt}{\shortena SCRUNCH}}}
\centerline{{\rotatebox{17}{\rotatea Rotate}}\hfil{\rotatebox{34}{\rotatea Rotate}}\hfil{\rotatebox{51}{\rotatea Rotate}}}
\caption{Reshaping words with \TeX\ Live.}
\end{figure}

\subsection{About \TeX\ Live Limitations and Fixes}

\TeX\ Live is not all-things-publishing to all people. But its flexibility makes it come close. Consider some limitations of the popular \LaTeX\ format. A format consists of a structured group of related \TeX\ macros. These macros define everything from page margins to character styles.

\LaTeX\ is the primary and most well-known format of \TeX. Originally the work of developer Leslie Lamport, \LaTeX\ provides macros to easily access most \TeX\ functions, such as setting up document structures, creating tables of contents, generating indexes and constructing various types of lists. But it also defines document formatting from the viewpoint of one person, the developer. The formatting macros in \LaTeX\ never work for everyone—unmodified, that is. For example, out-of-box \LaTeX\ implements multiple columns as one column or two. A new page begins each time you switch between one and two columns. This can produce some genuine pain when designing a document with varying numbers of columns. \LaTeX\ also defines typographic standards according to the tastes of the developer. While thoughtfully designed, these standards do not meet the needs of everyone.

To address these issues, \LaTeX\ offers access hooks into its macros for making minor changes. \LaTeX\ also contains designed-in flexibility for other developers to alter and extend its capabilities and behaviors.

The majority of users bend \LaTeX\ to their needs by using classes and packages to alter and extend its capabilities.

\textsl{Classes} define structures for document types such as letters, articles, reports and books. Developers can and do create new classes designed to meet their own needs. One such class implements multiple columns with the ability to change the number of columns within a single page.

\textsl{Packages} alter and extend classes. Some provide commands to customize text formats. Others add new functions, such as creating hypertext links, making magazine style layouts and customizing headers and footers.

You can find dozens of classes and hundreds of packages on CTAN—the \href{http://www.ctan.org}{Comprehensive \TeX\ Archive Net­work}—all for free. When you need a specialized capability, there is probably a package waiting to serve your needs.

In summary, while formats such as \LaTeX\ may not provide all design elements you need, classes and packages probably can. Sometimes you may need to search a little to find a class or package to fit your need. Sometimes you may need to create your own format, class, package or macro. You can also modifying existing ones.

\subsection{Document Structures}

\TeX\ Live defines document structures using classes.   You can choose from various document styles, including classes for letters, articles, reports and books—the four built-in classes of \LaTeX. Classes provide commands for setting up document elements such as title pages, tables of contents, abstracts, acknowledgements, bibliographies and indexes, plus division levels for parts, chapters, sections and paragraphs.

Identical commands usually produce different results across various classes. For instance, section headings look differently in articles and books. Additionally, articles insert no page breaks between their titles, tables of contents and text. Report and book title pages and tables of contents appear on separate pages.  Finally, some common commands are not available in all classes. This applies to document division commands in the letter class, because letters generally need no section headings. However, you can find workarounds to add formatted section headings to letters, if you really need to.

Classes enable flexibility for creating anything from newsletters to technical manuals to annual reports. You can also design your own classes, but doing this requires some expertise.

\begin{figure}[h]
\font\reflecta="ChalkboardSE-Light:color=FC7108;letterspace=2;" at 42pt%
\font\reflectb="ChalkboardSE-Light:color=FAC6A0;letterspace=2;" at 42pt%
\font\mirrora="Gill Sans SemiBold:color=FC7108;" at 36pt%
\font\mirrorb="Gill Sans SemiBold:color=FAC6A0;" at 36pt%
\font\shadowa="MarkerFelt-Thin:color=FC7108;slant=0" at 36pt%.
\font\shadowb="MarkerFelt-Thin:color=FAC6A0;slant=1.75" at 36pt%
\centerline{\reflectbox{\reflecta Reflect}{\reflectb Reflect}}
\bigskip
\centerline{\mirrora Mirror Mirror}
\centerline{\raisebox{\depth}{\scalebox{1}[-1]{\mirrorb Mirror Mirror}}}
\bigskip
\centerline{\shadowa Shadow}\par%
\centerline{\raisebox{.5\depth}{\scalebox{1}[-1]{\shadowb Shadow}}}
\caption{Having Fun with Reflections.}
\end{figure}

\subsection{Page Margins, Odd and Even Numbered Pages, Columns}

Good page design varies with the purpose of your publication and its means of distribution. For example, the specifications of odd and even numbered pages depend on the final destination of your project. When printing on one side or not printing at all, you may want all pages to look the same. For two-sided printing, you may oppositely offset odd- and even-numbered pages to create binding margins. You may increase white space for margin notes or narrow the margins to reduce the number of printed pages. The amount of text and graphic columns you choose varies with page width and size of graphics.

These considerations and others make page design complex and potentially difficult to manage. \TeX\ Live classes and packages provide commands to make page design easier.  Classes specify default margins, page layout and number of columns. You can change these with class options and commands from page-design packages. To make life easier, some packages allow you to specify just the measurements you want to control—left and rights margins, for example—and then automatically adjust all other settings to match the best practices of publishing.

\subsection{Division Levels, Tables of Contents, Indexes}

Division levels provide a framework for your publication, making it easier to understand at a glance. A table of contents and an index makes information easier to find, especially in large documents. 

Articles prepared in \TeX\ Live contain three levels of sections plus paragraphs. You can number the division headings or make them unnumbered. You can also number paragraphs. Reports add chapters above the sections. Each chapter automatically starts on a new page, but you can override this. You can also require all chapters to start on either odd-numbered or even-numbered pages. Books provide optional parts in addition to the chapters. Parts automatically start on new pages. You can number pages consecutively throughout your publication, or restart numbering at specified document divisions.

\TeX\ Live creates tables of contents from your division headings plus optional additional manual entries. The contents section can also create lists of figures, tables and equations. For large projects you can produce a summary contents at the beginning of the document and detailed contents after the title page of each major division.

With \TeX\ Live you can also make single-level or multiple-level indexes. You can also create multiple indexes with different purposes, for example a topic index and an index of locations.

\subsection{Cross References and Hyperlinks} \label{cross-links}

Cross references and hyperlinks make documents easier to navigate. Cross references tell readers where to find information in the current document—see page  \pageref{overly-modest} to read a quote from the original developer of \TeX. Hyperlinks create connections to external locations, such as the  \href{http://www-cs-faculty.stanford.edu/~uno/}{website of the original developer of \TeX}.

Cross references can guide your reader to specified tables, figures, equations, sections and pages—all by number. In addition to going to web addresses, hyperlinks can direct readers to other locations inside your document—such as \hyperlink{what-you-can-do}{a list of things you can do}—when you publish your document as a PDF. When you activate hyperlinks with the hyperref package, the entries in your table of contents, index, footnotes and bibliography automatically become internal hyperlinks.


\subsection{Footnotes, Glossaries, Bibliographies}

Footnotes, glossaries and bibliographies provide explanations, clarifications and scholarly background information for your documents. 

\TeX\ Live can generate footnotes or endnotes with document-wide sequential numbers or numbers restarted at division levels. You can format your footnotes to match the requirements of your publication. Once they are formatted, they stay formatted.

Bibliography creation in \TeX\ Live provides an extraordinary number of options through formats, classes, packages and styles\footnote{Bibliography styles tells \TeX\ Live how to format bibliography entries.}. Together, these allow you to create and publish a list of resources in any standard style.  You can also create one to meet your own needs. You can find existing bibliography styles to match the requirements of almost all academic institutions, professional publications and scholarly journals. Many of these organizations can provide you with their style definition for \TeX\ bibliographies. You can manually enter your bibliographic sources into \TeX\ source files or create an external database. For an external database, you can manually create your list of sources  or use one of the computer-assisted research tools, such as BibDesk—a very helpful application.

\TeX\ Live provides commands for creating one or more glossaries. These allow you to create lists of terms and definitions while leaving the formatting to \TeX\ Live.

\begin{figure}[h]
{\color[wave]{390}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{393.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{397}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{400.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{404}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{407.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{411}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{414.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{418}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{421.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{425}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{428.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{432}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{435.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{439}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{442.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{446}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{449.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{453}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{456.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{460}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{463.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{467}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{470.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{474}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{477.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{481}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{484.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{488}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{491.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{495}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{498.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{502}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{505.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{509}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{512.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{516}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{519.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{523}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{526.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{530}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{533.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{537}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{540.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{544}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{547.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{551}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{554.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{558}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{561.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{565}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{568.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{572}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{575.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{579}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{582.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{586}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{589.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{593}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{596.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{600}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{603.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{607}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{610.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{614}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{617.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{621}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{624.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{628}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{631.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{635}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{638.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{642}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{645.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{649}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{652.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{656}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{659.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{663}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{666.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{670}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{673.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{677}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{680.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{684}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{687.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{691}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{694.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{698}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{701.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{705}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{708.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{712}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{715.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{719}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{722.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{726}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{729.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{733}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{736.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{740}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{743.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{747}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{750.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{754}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{757.5}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{761}\rule[0pt]{2pt}{180pt}}\thinspace
{\color[wave]{764.5}\rule[0pt]{2pt}{180pt}}
\caption{Color Rules by Lightwave Length. See xcolor package for details.}
\end{figure}


\subsection{Floats—Graphics, Tables and Equations}

Floats provide flexibility in publishing graphics, tables and equations.  Each of these objects goes inside a specialized wrapper called an environment. Environments can move outside the normal flow of text. For example, a table may float to the top of a page, away from its neighboring text but still nearby. Floats can also move to the bottom of a page or simply stay where you originally placed them if you disable their ability to float. In some cases you tell all floats to move to the end of a section. You can then guide readers to your graphics, tables and equations through cross-referencing as described on page \pageref{cross-links}. 

Table floats can contain any type of information including rows and columns of tabular data. Graphics from external sources—such as jpeg images—float in the figure environment. You can scale, crop, position and rotate graphics. With a special type of picture environment you can draw pictures by specifying the sizes and locations of basic objects—lines, circles, arrows and text.  Equation floats contain beautifully typeset equations, the primary motivation for the original development of \TeX.  All floats provide for captions and can appear in the lists below the table of contents.


\subsection{Languages, Fonts, Characters and Unicode}

In the beginning, \TeX\ could work for any language built around roman characters—\textsf{A,~B,~C…}—and basic diacriticals—\textsf{Á,~Â,~Å…}. And it could typeset ligatures—\textsf{Æ,~Œ…}.  Today, \TeX\ Live typesets in almost any language with a TrueType or OpenType font. And it still does diacriticals and ligatures, plus old style numbers, small caps and many other typographical features. It can type Japanese hiragana, katakana and kanji, plus Chinese kanji and other ideographic characters.

\TeX\ typesets right-to-left, left-to-right and top-to-bottom.

It also supports languages\footnote{This is a  partial list compiled from the languages supported by fonts in the Mac OS X fonts library.} such as:

\begin{multicols}{6}{\baselineskip=10pt \countries Afrikaans\\Aghem\\Akan\\Albanian\\Asu\\Azerbaijani\\Bafia\\Bambara\\Basaa\\Basque\\Belarusian\\Bemba\\Bena\\Bosnian\\Breton\\Bulgarian\\Catalan\\C. Atlas Tamazight\\Chiga\\Chinese\\Congo Swahili\\Cornish\\Croatian\\Czech\\Danish\\Duala\\Dutch\\Embu\\English\\Esperanto\\Estonian\\Ewe\\Ewondo\\Faroese\\Filipino\\Finnish\\French\\Fulah\\Galician\\Ganda\\German\\Greek\\Gusii\\Hausa\\Hawaiian\\Hungarian\\Icelandic\\Igbo\\Indonesian\\Irish\\Italian\\Japanese\\Jola-Fonyi\\Kabuverdianu\\Kabyle\\Kalaallisut\\Kalenjin\\Kamba\\Kazakh\\Kikuyu\\Kinyarwanda\\Kirghiz\\Koyra Chiini\\Koyraboro Senni\\Kwasio\\Langi\\Latvian\\Lingala\\Lithuanian\\Luba-Katanga\\Luo\\Luyia\\Macedonian\\Machame\\Makhuwa-Meetto\\Makonde\\Malagasy\\Malay\\Maltese\\Manx\\Masai\\Meru\\Meta'\\Mongolian\\Morisyen\\Mundang\\Nama\\Ngomba\\North Ndebele\\Norwegian Bokmål\\Norwegian Nynorsk\\Nuer\\Nyankole\\Oromo\\Polish\\Portuguese\\Romanian\\Romansh\\Rombo\\Rundi\\Russian\\Rwa\\Samburu\\Sango\\Sangu\\Sena\\Serbian\\Shambala\\Shona\\Slovak\\Slovenian\\Soga\\Somali\\Spanish\\Swahili\\Swedish\\Swiss German\\Taita\\Tajik\\Tasawaq\\Teso\\Tongan\\Turkish\\Turkmen\\Ukrainian\\Uzbek\\Vietnamese\\Vunjo\\Welsh\\Yangben\\Yoruba\\Zarma\\ Zulu.}\end{multicols}

\subsection{Lists—Enumerate, Itemize, Description}

\TeX\ Live does lists nicely. The types of lists include:

\begin{description}
\item [Itemized] These lists separate items with bullets. 
\begin{itemize}
\item {\osakatext いち。【一】}
\item {\osakatext に。【二】}
\item {\osakatext さん。【三】}
\end{itemize}
\item [Enumerated] Once you set them, numbered lists stay numbered. They never renumber themselves or combine themselves with previous or next numbered lists,  areas where word processors struggle.
\begin{enumerate}
\item Ready.
\item Set.
\item Go.
\end{enumerate}
\item[Description] Description lists are for items needing long explanations.\footnote{The definitions of One, Two and Three are from 1913 Webster.}
\begin{description} 
\item[One] A single unit; as, one is the base of all numbers.
\item[Two] The sum of one and one; the number next greater than one and next less than three; two units or objects.
\item[Three] The number greater by a unit than two; three units or objects.
\end{description}
\end{description}

\subsection{\TeX\ Live—An Aptitude for Details}

The foregoing attributes provide a small sampling of what \TeX\ Live formats for you. And there is more. From here its aptitudes become more subtle as it forms characters into words, words into lines, lines into paragraphs and paragraphs into pages. It correctly typesets left-to-right, right-to-left and vertically. It works to create smooth  margins with evenly spaced words and without character spacing.  It manages widow and orphan lines and attempts to prevent difficult page breaks. Sometimes it requires manual intervention. But overall, it saves time and gives you the most beautiful results available, at lease equivalent to the best commercial typesetting software—sometimes better.
 
\section{Children of \TeX—Using Your System Fonts}

Dr. Knuth developed \TeX\ in the 1970s and froze the code in the early 1980s. At the time, he also developed his own fonts to use with \TeX. He named them Computer Modern. When he made \TeX\ available to others at no cost, he included the fonts. They naturally served as the standard for many years. But most things age. 

Despite the age of \TeX\ in terms of computer systems—its output quality still exceeds that of 21st Century word processors and most commercial page publishing software. %InDesign from Adobe Systems produces equivalent quality, partly because it uses some of the \TeX\ code for building characters into words, words into lines and lines into paragraphs. \TeX\ is free to use and redevelop. You can actually see \TeX\ at work in InDesign when it visually reformats paragraphs on the fly.%
However, fonts have changed dramatically since the 1980s, including the introduction of Unicode fonts for international typesetting.  Based on this evolution, several developers began modifying \TeX\ to use Unicode fonts and the system fonts of your computer. 

The first such application to gain widespread use was \XeTeX, originally developed by Jonathan Kew and now taken over by others. It came with extensions to \TeX, plus an expansion of \LaTeX\ called \XeLaTeX.  \XeTeX\ provides easy access to most TrueType and OpenType fonts. It supports Apple Advanced Typography and Graphite, a smart-font technology developed by SIL International.  \XeTeX\ supports general publishing and technical publishing, including mathematics. It is compatible with most existing \TeX\ and \LaTeX\ classes, packages and macros. This document was created using \XeLaTeX, Graphite fonts and other TrueType and OpenType fonts. The cover page was created entirely with \XeLaTeX, as were figures 2, 3 and 4. 

Another project using Unicode fonts is Lua\TeX. Lua\TeX\ is still in its early stages of development. Its most interesting feature is its ability to directly access typesetting functions in the \TeX\ systems. It is compatible with \LaTeX\ and \XeTeX.

The point here is the ongoing development of \TeX\ and its offspring. \TeX\ Live is a living and mature free publishing system with thousands of users worldwide and a huge support network.

\section{About The Learning Curve}

If you use the built-in styles of a word processor, you can learn to use \TeX\ Live. Even if you do not use word processing styles, you can still learn. As with any new software, there is a learning curve for \TeX\ Live, even on the Macintosh. But you are never alone when learning \TeX\ Live. This is because Mac\TeX\ itself receives support from one of the most active groups of users for any publishing software. The Internet contains thousands of \TeX\ tutorials, FAQs and examples. They exist on mailing lists, wikis, blogs, websites and bulletin boards worldwide.

You can also benefit from the knowledge of people using \TeX\ on Unix, IBM mainframes, Windows and other systems. Because \TeX\ operates the same on all machines, knowledge gained on the Mac instantly translates to \TeX\ wherever it works. And visa-versa.


\section{Resources}

\subsection{Books}

These are commonly used. If you really want to understand \TeX, then read  \textsl{The \TeX{}book}, written by Donald E. Knuth, the original developer.  It makes \LaTeX, \XeTeX\ and other children of \TeX\ easier to understand. \textsl{The METAFONTbook} is about the software used to make the originals \TeX\ fonts.

Michael Doob. \textsl{A Gentle Introduction to \TeX: A Manual for Self-Study}. CTAN, 1993. This is a free PDF available from CTAN: \href{http://ctan.org/pkg/gentle}{http://ctan.org/pkg/gentle}.

Victor Eijkhout. \textsl{\TeX\ by topic: a \TeX{}nician’s Reference}. Addison-Wesley Pub. Co., Wokingham, England, 1992. ISBN 0201568829. While this book is out print, you can download a free PDF of the book from CTAN: \href{http://ctan.org/pkg/texbytopic}{http://ctan.org/pkg/texbytopic}.

Michel Goossens. \textsl{The \LaTeX\ Graphics Companion}. Addison-Wesley, Upper Saddle River, NJ, 2nd ed edition, 2008. ISBN 9780321508928 (pbk. : alk. paper). \\URL http: //www.loc.gov/catdir/toc/ecip0713/2007010278.html.

Donald Ervin Knuth. \textsl{The \TeX{}book}, Volume A of Computers \& Typesetting. Addison- Wesley, Reading, Mass., 1986. ISBN 0201134470.

Donald Ervin Knuth. \textsl{The METAFONTbook}, Volume C of Computers \& Typesetting. Addison-Wesley, Reading, Mass., 1986. ISBN 0201134454 (hard).

Donald Ervin Knuth. \textsl{Digital Typography}, CSLI Lecture Notes; No.78. CSLI Publications, Stanford, Calif., 1999. ISBN 1575860112 (cloth : alk. paper). \\URL http://www.loc.gov/ catdir/description/cam029/98027331.html.

Leslie Lamport. \textsl{\LaTeX{}: A Document Preparation System: User's Guide And Reference Manual}. Addison-Wesley Pub. Co., Reading, Mass., 2nd ed edition, 1994. ISBN 0201529831.

Frank Mittelbach, Michel Goossens, Johannes Braams, and Chris Rowley. \textsl{The \LaTeX\ Companion}. Addison-Wesley, Boston, 2nd ed. edition, 2004. ISBN 0201362996 (pbk. : alk. paper).

\subsection{Web Resources}

Mac\TeX\ Website:\\
\href{http://www.tug.org/mactex/}{http://www.tug.org/mactex/}

\TeX\ Live Website. \TeX\ Live is the parent distribution of Mac\TeX:\\
\href{http://www.tug.org/texlive/}{http://www.tug.org/texlive/}

\TeX\ on Mac OS X Wiki:\\
\href{http://mactex-wiki.tug.org/}{http://mactex-wiki.tug.org/}

Mac\TeX\  Mailing Lists:\\
\href{http://mactex-wiki.tug.org/wiki/index.php/Mailing_lists}{http://mactex-wiki.tug.org/wiki/index.php/Mailing\_lists}

\subsection{Current Version of Welcome Doc}

This is Version 2.0 of Welcome to Mac\TeX. Distributed on May 20, 2015
 
You can find the current version of this document at:
\href{http://www.tug.org/mactex/}{http://www.tug.org/mactex/}

\small This document was prepared by Bob Kerstetter. Thanks to Karl Berry, Dick Koch and Herb Schulz for proofreading and making suggestions. The author is responsible for its content, including any omissions and errors. Send your comments to \href{mailto:tex@villagehiker.com}{tex@villagehiker.com}. 

\subsubsection{Change History}

May 20, 2015\quad Original release of Version 2.0 


%\nocite{*}
%\bibliography{WelcomeToMacTeX}
%\bibliographystyle{plainnat}

\end{document}
