summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex')
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex135
1 files changed, 69 insertions, 66 deletions
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
index 1540e1589d8..698e51ef644 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
@@ -1,4 +1,4 @@
-%% The very short guide to typesetting with \LaTeX{}
+%% The Very Short Guide to Typesetting with \LaTeX{}
\documentclass[a5paper]{vsg}
\addbibresource{veryshortguide.bib}
\setlength{\bibnamesep}{-\itemsep}
@@ -10,76 +10,78 @@
\date{\monthdate}
\maketitle
\subsection*{What's this all about? What's \LaTeX?}
-
-\LaTeX\ is a document preparation system which uses the \TeX\ typesetting
-program. It enables you to produce publication-quality documents with
-great accuracy and consistency. \LaTeX\ works on any computer and
-produces industry-standard PDF. It is available both
-in free (open-source) and commercial implementations. \LaTeX\ can be
-used for any kind of document, but it is especially suited to those
-with complex structures, repetitive formatting, or notations like
-mathematics\footnote{For reasons of space this guide does not cover
- details of mathematics typesetting.}; or where technical stability,
-dimensional accuracy, or a persistent and non-proprietary file format
-are needed. Install the software from
+\LaTeX\ is a document preparation system which uses the \TeX\
+typesetting program. It enables you to produce
+publication-quality documents with great accuracy and
+consistency. \LaTeX\ works on any computer and produces
+industry-standard PDF. It is available both in free (open-source)
+and commercial implementations. \LaTeX\ can be used for any kind
+of document, but it is especially suited to those with complex
+structures, repetitive formatting, or notations like
+mathematics\footnote{For reasons of space this guide does not
+cover details of mathematics typesetting.}; or where technical
+stability, dimensional accuracy, or a persistent and
+non-proprietary file format are needed. Install the software from
\url{www.tug.org/texlive/} or buy a commercially-supported
-version from one of the vendors (see the list on p.\thinspace\pageref{comm}).
-
+version from one of the vendors (see the list on
+p.\thinspace\pageref{comm}).
\subsection*{Creating and typesetting your document}
-
\begin{enumerate}[noitemsep]\setlength{\fboxsep}{1pt}
- \item Create your document using any suitable plain-text editor
- with \LaTeX\ controls, eg \textit{\TeX shop} (Mac), \textit{\TeX
- Maker} (Win), \textit{Kile} (Linux), \textit{Emacs} (all),
- even \textit{vi}\thinspace!
+ \item Create your document using any suitable plain-text
+ editor with \LaTeX\ controls, eg \textit{\TeX shop}
+ (Mac), \textit{\TeX Maker} (Win), \textit{Kile}
+ (Linux), \textit{Emacs} (all), even
+ \textit{vi}\thinspace!
\item Save the file with a name ending in \verb+.tex+
(\emph{never} use spaces in filenames!);
- \item Use the {\small\keys{Build}} or {\small\keys{Compile}}
- toolbar button or menu item in your editor to typeset and display
- the document;\label{typeset}
- \item Make any changes needed in your original document and repeat
- step \ref{typeset}.
+ \item Use the {\small\keys{Build}} or
+ {\small\keys{Compile}} toolbar button or menu item in
+ your editor to typeset and display the
+ document;\label{typeset}
+ \item Make any changes needed in your original document
+ and repeat step \ref{typeset}.
\end{enumerate}
-
-\subsection*{Syntax (how to type \LaTeX\ commands --- these are the rules)}
-
+\subsection*{Syntax (how to type \LaTeX\ commands --- these
+ are the rules)}
\begin{itemize}[noitemsep]
- \item \textbf{All \LaTeX\ commands begin with a backslash}.\\
- \example \verb+\tableofcontents+\endexample
- \item \textbf{If a command needs text to work
- with, it goes in curly braces}.\\
- \example \verb+\title{Irisches Tagebuch}\author{Heinrich Böll}+\endexample
- \item \textbf{If options are used, they go in square brackets
- before the curly braces}.\\
- \example \verb+\documentclass[a4paper,11pt]{book}+\endexample
- \item \textbf{Spaces after commands \emph{without} braces get suppressed}.\\
- \example \verb+Copyright \copyright␣+\texttt{\number\year}
- \gives{Copyright ©\number\year} \nobox\\
- To prevent this, put empty curly braces after the command:\\
- \example \verb+Copyright \copyright{}␣+\texttt{\number\year}
+ \item \textbf{All \LaTeX\ commands begin with a
+ backslash}.\\ \example
+ \verb+\tableofcontents+\endexample
+ \item \textbf{If a command needs text to work with, it
+ goes in curly braces}.\\ \example
+ \verb+\title{Irisches Tagebuch}\author{Heinrich Böll}+\endexample
+ \item \textbf{If options are used, they go in square
+ brackets before the curly braces}.\\ \example
+ \verb+\documentclass[a4paper,11pt]{book}+\endexample
+ \item \textbf{Spaces after commands \emph{without} braces
+ get suppressed}.\\ \example
+ \verb+Copyright \copyright␣+\texttt{\number\year}
+ \gives{Copyright ©\number\year} \nobox\\ To prevent
+ this, put empty curly braces after the
+ command:\\ \example
+ \verb+Copyright \copyright{}␣+\texttt{\number\year}
\gives{Copyright ©~\number\year} \yesbox
- \item \textbf{Curly braces are also used to restrict the scope of
- effects inside them}.\\
- \example \verb+Some {\tiny little} word+ \gives{Some {\tiny little} word}
+ \item \textbf{Curly braces are also used to restrict the
+ scope of effects inside them}.\\ \example
+ \verb+Some {\tiny little} word+ \gives{Some {\tiny
+ little} word}
\end{itemize}
\begin{note}
-This guide shows only a tiny fraction of \LaTeX's power. For more
-information, visit the \TeX\ Users Group site (\url{www.tug.org}). For
-help, see the FAQ (\url{www.tex.ac.uk/faq}), StackExchange
+This guide shows only a tiny fraction of \LaTeX's power. For
+more information, visit the \TeX\ Users Group site
+(\url{www.tug.org}). For help, see the FAQ
+(\url{www.tex.ac.uk/faq}), StackExchange
(\url{tex.stackexchange.com}), or the Usenet newsgroup
\url{comp.text.tex}. For packages (plugins), use CTAN, the
-Comprehensive \TeX\ Archive Network (\url{www.ctan.org}). For
-further details, see \citetitle{fi}
-\parencite{fi} and other online resources.
+Comprehensive \TeX\ Archive Network
+(\url{www.ctan.org}). For further details, see
+\citetitle{fi} \parencite{fi} and other online resources.
\end{note}
-
\begin{multicols}{2}\small\parskip4pt
\subsection*{Writing a \LaTeX\ document}
\subsubsection{Basic document structure}
-
Here's the skeleton of a \LaTeX\ document. These three lines are
\textsc{compulsory}: your document will not work without them:
-
\begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>]
!added\documentclass[11pt]{article}
!comment your Preamble goes here (extra setups, if any)
@@ -88,20 +90,21 @@ Here's the skeleton of a \LaTeX\ document. These three lines are
!added\end{document}
\end{Verbatim}
\vspace*{-.5\baselineskip}
-{\fontsize67\selectfont\sffamily New material in each example is shown
-in {\ttfamily\added blue}; material from previous examples is in
-black. Comments and mnemonics are in \textcolor{DarkRed}{red}.\par}
-
+{\fontsize67\selectfont\sffamily New material in each example is
+shown in {\ttfamily\added blue}; material from previous examples
+is in black. Comments and mnemonics are in
+\textcolor{DarkRed}{red}.\par}
\begin{itemize}[noitemsep]
- \item The document class name \textsc{must} be one of the standard
- \verb+book+, \verb+article+, or \verb+report+, or one of the many
- others preinstalled or downloadable (eg \verb+thesis+,
- \verb+memoir+, etc);
- \item There are body type size options \verb+10pt+ (the default),
- \verb+11pt+, and \verb+12pt+;
- \item There are paper size options including \verb+a4paper+
- (210\thinspace mm$\times$297\thinspace mm) and \verb+letterpaper+
- (8½$''\times$11$''$) [see below].
+ \item The document class name \textsc{must} be one of the
+ standard \verb+book+, \verb+article+, or \verb+report+,
+ or one of the many others preinstalled or downloadable
+ (eg \verb+thesis+, \verb+memoir+, etc);
+ \item There are body type size options \verb+10pt+ (the
+ default), \verb+11pt+, and \verb+12pt+;
+ \item There are paper size options including
+ \verb+a4paper+ (210\thinspace mm$\times$297\thinspace
+ mm) and \verb+letterpaper+ (8½$''\times$11$''$) [see
+ below].
\end{itemize}
\subsubsection{Front matter}