diff options
author | Karl Berry <karl@freefriends.org> | 2013-07-28 21:51:45 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-07-28 21:51:45 +0000 |
commit | 468d5a3048538797838d81e77f805c42c70cef2d (patch) | |
tree | 592f32e147658a09c5055b0ba822af1768e70ded /Master/texmf-dist/doc/latex/lshort-persian/appendix.tex | |
parent | 29ec2175f05db5b6240733cd3063b42f04318027 (diff) |
lshort-persian (28jul13)
git-svn-id: svn://tug.org/texlive/trunk@31296 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/lshort-persian/appendix.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/lshort-persian/appendix.tex | 109 |
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. |