summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/lshort-persian/appendix.tex
blob: 358f08e7de4933620840c0b732742c207b4757be (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
\appendix
\chapter{Installing \LaTeX}
\begin{intro}
Knuth has published the source to \TeX{} back in a time when nobody knew
about OpenSource and or Free Software. The License that comes with \TeX{}
lets you do whatever you want with the source. But you can only call the
result of your work \TeX{} if the program passes a set of tests Knuth has
also provided. This has lead to a situation where we have free \TeX{}
implementations for almost every Operating System under the Sun. In this chapter
you will give some hints on what to install on Linux, Mac OS X and Windows to
get \TeX{} working.
\end{intro}

\section{What to Install}

For using LaTeX on any computer system, you need 3 essential pieces of
software:

\begin{enumerate}

\item a text editor for editing your LaTeX source files.

\item the \TeX{}/\LaTeX{} program for processing your \LaTeX{} source files
into typeset PDF or DVI documents.

\item a PDF/DVI viewer program for previewing and printing your
documents.

\item a program to handle PostScript files and images for inclusion into
your documents.

\end{enumerate}

For all platforms there are many programs that fit the requirements above.
Here we just tell about the ones we know, like and have some experience
with.

\section{\TeX{} on Mac OS X}

\subsection{Picking an Editor}

Base your LaTeX environment on the \wi{TextMate} editor! TextMate is not
only a highly customizable, general purpose text editor, it also provides
excellent LaTeX support and integrates tightly with the PDFView previewer.
This combination of tools, lets you use LaTeX in a convenient and Mac-like
manner. You can download a free trial version from the Textmate website on
\url{http://macromates.com/} and purchase a full version for 39 EUR. If you
know an equivalent OpenSource tool for the Mac, please let us know.

\subsection{Get a \TeX{} Distribution}

If you are already using Macports or Fink for installing Unix software under
OS X, install LaTeX using these package managers. Macport users install
LaTeX with \framebox{\texttt{port install tetex}},
Fink users use the command \framebox{\texttt{fink install tetex}}.

If you are neither using Macports nor Fink, download \wi{MacTeX}, which is a
precompiled LaTeX distribution for OS X. \wi{MacTeX} provides a full LaTeX
installation plus a number of additional tools. Get MaxTeX from
\url{http://www.tug.org/mactex/}.

\subsection{Treat yourself to \wi{PDFView}}

Use PDFView for viewing PDF files generated by LaTeX, it integrates tightly
with your LaTeX text editor. PDFView is an open-source application can be
downloaded from the PDFView website on\\
\url{http://pdfview.sourceforge.net/}. Download and install PDFView. Open
PDFViews preferences dialog and make sure that the \emph{automatically reload
documents} option is enabled and that PDFSync support is set to the TextMate
preset.

\section{\TeX{} on Windows}

\subsection{Getting \TeX{}}

First, get a copy of the excellent \wi{MiKTeX} distribution from\\
\url{http://www.miktex.org/}. It contains all the basic programs and files
required to compile \LaTeX{} documents.  The coolest feature in my eyes is,
that MiKTeX will download missing \LaTeX{} packages on the fly and install them
magically while compiling a document.

\subsection{A \LaTeX{} editor}

\LaTeX{} is a programming language for text documents. \wi{TeXnicCenter}
uses many concepts from the programming-world to provide a nice and
efficient \LaTeX{} writing environment in Windows. Get your copy from\\
\url{http://www.toolscenter.org}. TeXnicCenter integrates nicely with
MiKTeX.

An another excellent choice is the editor provided by the LEd project available on
\url{http://www.latexeditor.org}

\subsection{Working with graphics}

Working with high quality graphics in \LaTeX{} means, that you have to use
Postscript (eps) or PDF as your picture format. The program that helps you
deal with this is called \wi{GhostScript}. You can get it, together with its
own front-end \wi{GhostView} from \url{http://www.cs.wisc.edu/~ghost/}.

If you deal with bitmap graphics (photos and scanned material). You may want
to have a look at the open source photoshop alternative \wi{Gimp} available
from \url{http://gimp-win.sourceforge.net/}.

\section{\TeX{} on Linux}

If you work with Linux, chances are high that \LaTeX{} is already installed
on your system, or at least available on the installation source you used to
setup. Use your package manager to install the following packages:

\begin{itemize}
\item tetex or texlive -- the base \TeX{}/\LaTeX{} setup.
\item emacs (with auctex) -- a Linux editor that integrates tightly with \LaTeX{} through the add-on AucTeX package.
\item ghostscript -- a PostScript preview program.
\item xpdf and acrobat -- a PDF preview program.
\item imagemagick -- a free program for converting bitmap images.
\item gimp -- a free photoshop look-a-like.
\item inkscape -- a free illustrator/corel draw look-a-like.
\end{itemize}