summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/lshort-persian/appendix.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/lshort-persian/appendix.tex')
-rw-r--r--Master/texmf-dist/doc/latex/lshort-persian/appendix.tex109
1 files changed, 69 insertions, 40 deletions
diff --git a/Master/texmf-dist/doc/latex/lshort-persian/appendix.tex b/Master/texmf-dist/doc/latex/lshort-persian/appendix.tex
index 358f08e7de4..b91879ae102 100644
--- a/Master/texmf-dist/doc/latex/lshort-persian/appendix.tex
+++ b/Master/texmf-dist/doc/latex/lshort-persian/appendix.tex
@@ -1,9 +1,9 @@
\appendix
-\chapter{Installing \LaTeX}
+\chapter{نصب لاتک}
\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
+Knuth 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
@@ -13,20 +13,20 @@ get \TeX{} working.
\section{What to Install}
-For using LaTeX on any computer system, you need 3 essential pieces of
-software:
+For using LaTeX on any computer system, you need several programs.
\begin{enumerate}
-\item a text editor for editing your LaTeX source files.
-
-\item the \TeX{}/\LaTeX{} program for processing 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
+\item A text editor for editing your LaTeX source files. Some products even let
+you start the latex program from within the editor.
+
+\item A PDF/DVI viewer program for previewing and printing your
documents.
-\item a program to handle PostScript files and images for inclusion into
+\item A program to handle \PSi{} files and images for inclusion into
your documents.
\end{enumerate}
@@ -37,27 +37,34 @@ 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}
+Just download \wi{MacTeX}. It is a
+pre-compiled 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/}.
+
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}}.
+LaTeX with \framebox{\texttt{port install texlive}},
+Fink users use the command \framebox{\texttt{fink install texlive}}.
-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{Picking an Editor}
+
+The most popular open source editor for \LaTeX{} on the mac seems to be
+\TeX{}shop. Get a copy from \url{http://www.uoregon.edu/~koch/texshop}. It
+is also contained in the \wi{MacTeX} distribution.
+
+Another fine editor is Texmaker. Apart from being a useful editor it has the
+advantage of running on Windows, Mac and Unix/Linux equally well. Go to
+\url{http://www.xm1math.net/texmaker} for further Information. Note there is
+also a forked version of Texmaker called TexmakerX on
+\url{http://texmakerx.sourceforge.net/} it promises additional functionality.
+
+Recent \TeX Live distributions contain the \TeX{}works editor
+\url{http://texworks.org/} which is a multi-platform editor based on the \TeX{}Shop
+design. Since \TeX{}works uses the Qt toolkit, it is available on any platform
+supported by this toolkit (MacOS X, Windows, Linux.)
\subsection{Treat yourself to \wi{PDFView}}
@@ -73,31 +80,47 @@ preset.
\subsection{Getting \TeX{}}
-First, get a copy of the excellent \wi{MiKTeX} distribution from\\
+First, get a copy of the excellent MiK\TeX\index{MiKTeX@MiK\TeX} 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,
+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.
+magically while compiling a document. Alternatively you can also use
+the TeXlive distribution which exists for Windows, Unix and Mac OS to
+get your base setup going \url{http://www.tug.org/texlive/}.
\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.
+\url{http://http://www.texniccenter.org/}. TeXnicCenter integrates nicely with
+MiKTeX. Version 2.0 of TeXnicCenter will support Unicode, the recent alpha version
+seems to be quite stable.
+
+Other excellent choice is the editor provided by the LEd project available
+on \url{http://www.latexeditor.org}.
-An another excellent choice is the editor provided by the LEd project available on
-\url{http://www.latexeditor.org}
+See the note on Texmaker in the Mac section above for a third choice.
+
+Recent \TeX Live distributions contain the \TeX{}works Editor
+\url{http://texworks.org/}. It supports Unicode and requires at least Windows XP.
+
+\subsection{Document Preview}
+
+You will most likely be using Yap for DVI preview as it gets installed with
+MikTeX. For PDF you may want to look at Sumatra
+PDF \url{http://blog.kowalczyk.info/software/sumatrapdf/}. I mention Sumatra PDF
+because it lets you jump from any position in the pdf document back into
+corresponding position in your source document.
\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
+Working with high quality graphics in \LaTeX{} means that you have to use
+\EPSi{} (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/}.
+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
+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/}.
@@ -108,12 +131,18 @@ 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 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 ghostscript -- a \PSi{} 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}
+If you are looking for a more windows like graphical editing environment,
+check out Texmaker or \TeX{}works. See the note in the Mac section above.
+
+Most Linux distros insist on splitting up their \TeX{} environments into a
+large number of optional packages, so if something is missing after your
+first install, go check again.