summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-01-23 23:57:45 +0000
committerKarl Berry <karl@freefriends.org>2013-01-23 23:57:45 +0000
commitf868ed130b48508ce8e10c2fb3b96d97c67656e6 (patch)
tree2944f319a46a9a00e2897e2a096838ad56f62d91
parent7254a6de063ba4250e708c000160ebbd76d34cc9 (diff)
latex-veryshortguide (23jan13)
git-svn-id: svn://tug.org/texlive/trunk@28917 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/README44
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdfbin808366 -> 0 bytes
-rwxr-xr-xMaster/texmf-dist/doc/latex/latex-veryshortguide/build14
-rwxr-xr-xMaster/texmf-dist/doc/latex/latex-veryshortguide/index.html103
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdfbin157040 -> 176429 bytes
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdfbin661108 -> 878660 bytes
-rw-r--r--Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex342
-rwxr-xr-xMaster/texmf-dist/doc/latex/latex-veryshortguide/vsg-1.jpgbin0 -> 88114 bytes
-rwxr-xr-xMaster/texmf-dist/doc/latex/latex-veryshortguide/vsg-2.jpgbin0 -> 85052 bytes
-rwxr-xr-xMaster/texmf-dist/doc/latex/latex-veryshortguide/vsg-3.jpgbin0 -> 85025 bytes
-rwxr-xr-xMaster/texmf-dist/doc/latex/latex-veryshortguide/vsg-4.jpgbin0 -> 84230 bytes
11 files changed, 320 insertions, 183 deletions
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/README b/Master/texmf-dist/doc/latex/latex-veryshortguide/README
index a905be1f761..272ffbbc981 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/README
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/README
@@ -1,15 +1,17 @@
The Very Short Guide to LaTeX
- This is the 12 January 2012 revision of the Guide. It is designed for
+ This is the 22 January 2013 revision of the Guide. It is designed for
printing on A4 paper, double-sided, and folding once to A5.
This revision corrects some minor typographical inconsistencies and
- rephrases some descriptions for greater clarity.
+ rephrases some descriptions for greater clarity. The preformatted
+ version uses commercial typefaces: if you use CM or something else you
+ may have to rearrange the text a little, as space is very tight.
From the source comments:
This is the Very Short Guide to LaTeX, a 4pp folder designed as an
- aide-memoire for people who have just done a course in LaTeX and
+ aide-mémoire for people who have just done a course in LaTeX and
need something by them on their desk the next day to refresh their
memories. It is not intended as a substitute for full documentation.
@@ -20,14 +22,18 @@ Production notes
so this version is set as four normal A5 pages, leaving the imposition
up to your printer driver.
- Adobe Acrobat, for example, can print the PDF two-sided, two-up,
+ Adobe Acrobat 9, for example, can print the PDF two-sided, two-up,
landscape on A4 using the "Booklet Printing" option, and a
- ready-imposed PDF generated this way is included below. A better result
- can be achieved by preprocessing the PS output with the command
-pstops -pa4 -b "4:-3L(21cm,0)+0L(21cm,14.85cm),1L(21cm,0)+-2L(21cm,14.85cm)" \
+ ready-imposed PDF generated this way is included below. A similar
+ effect can be achieved by preprocessing the PS output with the command
+pstops -pa4 -b "4:-3L(30cm,0)+0L(30cm,14.85cm),1L(30cm,0)+-2L(30cm,14.85cm)" \
veryshortguide.ps | ps2pdf - veryshortguide-imposed.pdf
+ The weird value of 30cm appears to be due to a bug in pstops (and in
+ psbook: it ought to have been possible to use psbook and psnup for
+ this, but that method does not allow for offsetting).
+
The page margins are set to 12mm, because many desktop inkjet printers
cannot print the bottom 12mm of a sheet; it was felt best to equalise
this all round, at the small expense of making the printable area
@@ -46,15 +52,13 @@ License
Files
Source code
- [2]veryshortguide.tex 22K LaTeX source
+ [2]veryshortguide.tex 23K LaTeX source
Output
- [3]veryshortguide.pdf 646K PDF output
- [4]veryshortguide-imposed.pdf 154K PDF output
- [5]veryshortguide.dvi 30K DVI output
- [6]veryshortguide.ps 1.2M PS output
+ [3]veryshortguide.pdf 852K PDF output
+ [4]veryshortguide-imposed.pdf 178K PDF output
Images
- [7]menno-a.eps 444K Map (EPS)
- [8]menno-a.jpg 30K Map (JPG)
+ [5]menno-a.eps 444K Map (EPS)
+ [6]menno-a.jpg 30K Map (JPG)
Peter Flynn
@@ -62,10 +66,8 @@ Files
References
1. http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
- 2. veryshortguide.tex
- 3. veryshortguide.pdf
- 4. veryshortguide-imposed.pdf
- 5. veryshortguide.dvi
- 6. veryshortguide.ps
- 7. menno-a.eps
- 8. menno-a.jpg
+ 2. file://localhost/home/peter/texmf/dev/veryshortguide/veryshortguide.tex
+ 3. file://localhost/home/peter/texmf/dev/veryshortguide/veryshortguide.pdf
+ 4. file://localhost/home/peter/texmf/dev/veryshortguide/veryshortguide-imposed.pdf
+ 5. file://localhost/home/peter/texmf/dev/veryshortguide/menno-a.eps
+ 6. file://localhost/home/peter/texmf/dev/veryshortguide/menno-a.jpg
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf
deleted file mode 100644
index 989b705cf7f..00000000000
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/build b/Master/texmf-dist/doc/latex/latex-veryshortguide/build
new file mode 100755
index 00000000000..c39842a8a4a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/build
@@ -0,0 +1,14 @@
+#! /bin/bash
+YYYYMMDD=`date +%Y%m%d`
+latex veryshortguide
+latex veryshortguide
+pdflatex veryshortguide
+dvips -o veryshortguide.ps veryshortguide.dvi
+pstops -pa4 -b \
+ "4:-3L(21cm,.5cm)+0L(21cm,14.7cm),1L(21cm,.5cm)+-2L(21cm,14.7cm)" \
+ veryshortguide.ps | ps2pdf - veryshortguide-imposed.pdf
+#convert veryshortguide.pdf vsg.jpg
+pdftoppm veryshortguide.pdf vsg;
+ for f in *.ppm;do pnmscale -width=512 $f|pnmtojpeg >${f/ppm/jpg};done
+lynx -dump index.html >README
+cat MANIFEST | zip latex-veryshortguide-$YYYYMMDD.zip -@
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/index.html b/Master/texmf-dist/doc/latex/latex-veryshortguide/index.html
new file mode 100755
index 00000000000..34bef4526ea
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/index.html
@@ -0,0 +1,103 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Strict//EN">
+<html>
+ <head>
+ <title>The Very Short Guide to LaTeX</title>
+ <style type="text/css">
+span.lang { font-style:italic; }
+ </style>
+ </head>
+ <body>
+ <h1>The Very Short Guide to LaTeX</h1>
+ <p>This is the 22 January 2013 revision of the Guide. It is designed
+ for printing on A4 paper, double-sided, and folding once to A5.</p>
+ <p>This revision corrects some minor typographical inconsistencies
+ and rephrases some descriptions for greater clarity. The
+ preformatted version uses commercial typefaces: if you use CM or
+ something else you may have to rearrange the text a little, as
+ space is very tight.</p>
+ <blockquote>
+ <h4>From the source comments:</h4>
+ <p>This is the Very Short Guide to LaTeX, a 4pp folder designed
+ as an <span class="lang">aide-m&eacute;moire</span> for people who
+ have just done a course in LaTeX and need something by them on
+ their desk the next day to refresh their memories. It is
+ <em>not</em> intended as a substitute for full documentation.</p>
+ </blockquote>
+ <h2>Production notes</h2>
+ <p>An earlier (Jan 2008) version was typeset on two A4 landscape
+ pages ready to print, but this restricted the ways people wanted
+ to print it, so this version is set as four normal A5 pages,
+ leaving the imposition up to your printer driver.</p>
+ <p>Adobe Acrobat&nbsp;9, for example, can print the PDF two-sided,
+ two-up, landscape on A4 using the <q>Booklet Printing</q> option,
+ and a ready-imposed PDF generated this way is included below. A
+ similar effect can be achieved by preprocessing the PS output
+ with the command</p>
+ <pre>
+pstops -pa4 -b "4:-3L(30cm,0)+0L(30cm,14.85cm),1L(30cm,0)+-2L(30cm,14.85cm)" \
+ veryshortguide.ps | ps2pdf - veryshortguide-imposed.pdf
+ </pre>
+ <p>The weird value of 30cm appears to be due to a bug in
+ <code>pstops</code> (and in <code>psbook</code>: it ought to
+ have been possible to use <code>psbook</code> and
+ <code>psnup</code> for this, but that method does not allow for
+ offsetting).</p>
+ <p>The page margins are set to 12mm, because many desktop inkjet
+ printers cannot print the bottom 12mm of a sheet; it was felt
+ best to equalise this all round, at the small expense of making
+ the printable area slightly smaller.</p>
+ <div align="center">
+ <table border="1">
+ <tbody>
+ <tr>
+ <td width="25%" align="center"><img src="vsg-1.jpg"
+ width="100%" alt="Page 1"></td>
+ <td width="25%" align="center"><img src="vsg-2.jpg"
+ width="100%" alt="Page 2"></td>
+ <td width="25%" align="center"><img src="vsg-3.jpg"
+ width="100%" alt="Page 3"></td>
+ <td width="25%" align="center"><img src="vsg-4.jpg"
+ width="100%" alt="Page 4"></td>
+ </tr>
+ </tbody>
+ </table>
+ <!-- images produced with
+ pdftoppm veryshortguide.pdf vsg;
+ for f in *.ppm;do pnmscale -width=512 $f|pnmtojpeg >${f/ppm/jpg};done
+ -->
+ </div>
+ <p>If you have been maintaining a mirror or other copy of this
+ document, please update it with this version and delete the
+ previous files.</p>
+ <h2>License</h2>
+ <p>This is free documentation, issued under the <a
+ href="http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html">LaTeX
+ Project Public License</a>.</p>
+ <h2>Files</h2>
+ <table>
+ <tr>
+ <td colspan="3">Source code</td>
+ </tr>
+ <tr><td><tt><a
+ href="veryshortguide.tex">veryshortguide.tex</a></tt></td><td
+ align="right">23K</td><td>LaTeX source</td></tr>
+ <tr>
+ <td colspan="3">Output</td>
+ </tr>
+ <tr><td><tt><a
+ href="veryshortguide.pdf">veryshortguide.pdf</a></tt></td><td
+ align="right">852K</td><td>PDF output</td></tr>
+ <tr><td><tt><a
+ href="veryshortguide-imposed.pdf">veryshortguide-imposed.pdf</a></tt></td><td
+ align="right">178K</td><td>PDF output</td></tr>
+ <tr>
+ <td colspan="3">Images</td>
+ </tr>
+ <tr><td><tt><a href="menno-a.eps">menno-a.eps</a></tt></td><td
+ align="right">444K</td><td>Map (EPS)</td></tr>
+ <tr><td><tt><a href="menno-a.jpg">menno-a.jpg</a></tt></td><td
+ align="right">30K</td><td>Map (JPG)</td></tr>
+ </table>
+ <address>Peter Flynn</address>
+ </body>
+</html>
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf
index 9e74c5d1e4f..5d0b81fe7e8 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf
index f6d684575ac..a86a6a92bd7 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
index 591246ec5b5..51f06816e31 100644
--- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex
@@ -1,16 +1,16 @@
% This is the Very Short Guide to LaTeX, a 4pp folder designed as an
-% aide-memoire for people who have just done a course in LaTeX and
+% aide-mémoire for people who have just done a course in LaTeX and
% need something by them on their desk the next day to refresh their
% memories. It is NOT intended as a substitute for full documentation.
%
-% Copyright 2006-2009 by Silmaril Consultants <peter@silmaril.ie>
+% Copyright 2006-2013 by Silmaril Consultants <peter@silmaril.ie>
%
-% This is free documentation, issued under the LaTeX Rroject Public
+% This is free documentation, issued under the LaTeX Project Public
% License. For details see
% http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html
%
+% 2013-01-22
% 2009-10-01
-% 2012-01-11
%
% Please do NOT complain that there is no math here. It won't fit.
% Someone else can do a math leaflet. IANAM.
@@ -58,12 +58,13 @@
%
\usepackage[utf8x]{inputenc}
\usepackage[T1]{fontenc}
-\usepackage{lmodern,utopia,graphicx,url,fancybox,mdwlist,fix-cm,multicol}
+\usepackage{graphicx,url,fancybox,enumitem,fix-cm,multicol,nicefrac}
\usepackage{fancyvrb,bbding,parskip,ragged2e,calc,ifthen,textcomp,array}
\usepackage[svgnames]{xcolor}
-\usepackage[scaled=.95]{helvet}
-% compensate for the fact that the Bitstream fonts redefine bx to b
-\DeclareFontShape{T1}{cmr}{b}{it}{<->ssub*cmr/bx/it}{}
+\usepackage[default]{aller}
+\usepackage[default]{warnock}
+%\usepackage[scaled=.95]{helvet}
+%\usepackage[scaled=.87]{luximono}
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
@@ -78,22 +79,21 @@
\renewcommand{\labelitemi}{\raisebox{-.5ex}{\textcolor{Purple}{\PencilRight}}}
%
% Provide commands for distinguishing examples and their output
-\newcommand{\example}{%
- \color{DarkGreen}\textsf{\fontseries{bc}\selectfont Example:}
- \color{DarkRed}}
+\newcommand{\example}{\color{DarkGreen}\textsf{\bfseries Example:} \color{Grey}}
\def\endexample{\color{black}}
-\newcommand{\gives}[1]{\thinspace\color{DarkGreen}\raisebox{-.333ex}
+\newcommand{\gives}[1]{\thinspace\color{DarkGreen}\raisebox{-.7ex}
{\ArrowBoldRightStrobe}~\color{DarkBlue}{\fontfamily{cmr}\selectfont
#1}\color{black}}
-\newcommand{\nobox}{~\raisebox{-.25ex}{\footnotesize\Square\llap{\color{Red}\XSolidBrush}}}
-\newcommand{\yesbox}{~\raisebox{-.25ex}{\footnotesize\Square\llap{\color{Green}\CheckmarkBold}}}
-\def\ff#1{\fontfamily{#1}\selectfont}
+\newcommand{\nobox}{~\raisebox{-.25ex}{\footnotesize\Square\llap\XSolidBrush}}
+\newcommand{\yesbox}{~\raisebox{-.25ex}{\footnotesize\Square\llap\CheckmarkBold}}
%
% In fancyverb's Verbatim, allow rubric embedded as marked text in red
\newcommand{\comment}[1]{\ifthenelse{\equal{#1}{ }}{}{#1}\normalfont
\itshape\footnotesize\color{red}}
+% Allow notification of newly-added material
+\newcommand{\added}{\color{MediumBlue}}
% This reverts rubric back to normal, to avoid embedded spaces
-\newcommand{\revert}{\ttfamily\upshape\normalsize\color{black}}
+\newcommand{\revert}{\ttfamily\upshape\color{black}}
%
% Provide keyboard or screen keys or buttons and their icons
\newcommand{\button}[2][\relax]{\if#1\relax
@@ -128,7 +128,7 @@
\par\bigskip\hrule\medskip
}
% notes
-\renewenvironment{note}{\small\textbf{Note.}\quad}{\par}
+\newenvironment{note}{\small\textbf{Note.}\quad}{\par}
% pack headings together more tightly
\renewcommand\section{\@startsection{subsection}{1}{\z@}%
{-0pt\@plus -.2ex \@minus -.2ex}%
@@ -175,57 +175,63 @@
\LaTeX\ is a document preparation system for the \TeX\ typesetting
program. It enables you to produce publication-quality output with
great accuracy and consistency. \LaTeX\ works on any computer and
-produces industry-standard PS or PDF documents. It is available both
+produces industry-standard PDF or PS documents. 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 a complex structure, 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.
+are needed. Install the free software from
+\url{www.tug.org/texlive/} or buy a commercially-supported
+version from one of the vendors (see
+back page).
\subsection{Creating and typesetting your document}
-\begin{enumerate*}\setlength{\fboxsep}{1pt}
+\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} (all), \textit{Kile} (Linux), \textit{Emacs} (all);
+ nicCenter} (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 toolbar buttons or menu items in your editor to typeset
- and display the document;\label{typeset}
+ and display the document (you need \textit{Acrobat Reader} or
+ similar to display the PDF output);\label{typeset}
\item Make any changes needed in your original document and repeat
step \ref{typeset}.
-\end{enumerate*}
+\end{enumerate}
\subsection{Syntax (how to type \LaTeX\ commands --- these are the rules)}
-\begin{itemize*}
+\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}.\\
+ with (an `argument'), 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 first}.\\
+ \item \textbf{If options are used, they go in square brackets first,
+ before the curly braces}.\\
\example \verb+\documentclass[a4paper,11pt]{book}+\endexample
- \item \textbf{Space after commands \emph{without} braces gets suppressed}.\\
- \example \verb+Copyright \copyright +\texttt{\number\year}
- \gives{Copyright \copyright \number\year}~\nobox\\
+ \item \textbf{Spaces after commands \emph{without} braces get suppressed}.\\
+ \example \verb+Copyright \copyright␣+\texttt{\number\year}
+ \gives{Copyright \raisebox{1pt}\copyright \number\year}~\nobox\\
To prevent this, put empty curly braces after the command.\\
- \example \verb+Copyright \copyright{} +\texttt{\number\year}
- \gives{Copyright \copyright{} \number\year}~\yesbox
+ \example \verb+Copyright \copyright{}␣+\texttt{\number\year}
+ \gives{Copyright \raisebox{1pt}\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}
-\end{itemize*}
+\end{itemize}
\vfill
\begin{note}
-This guide shows only a tiny fraction of \LaTeX's power. For
+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}), the Usenet newsgroup
-\url{comp.text.tex}, and the site \url{tex.stackexchange.com}. For packages, use the Comprehensive \TeX\ Archive
+help, see the FAQ (\url{www.tex.ac.uk/faq}) and the Usenet newsgroup
+\url{comp.text.tex}. For packages, use the Comprehensive \TeX\ Archive
Network (\url{www.ctan.org}). For documentation, use the sources in
the \textit{References} [2].
\end{note}
@@ -245,16 +251,19 @@ Here's the skeleton of a \LaTeX\ document. These three lines are
\end{document}
\end{Verbatim}
-\begin{itemize*}
- \item The document class name must be one of \verb+book+,
- \verb+article+, or \verb+report+, or an extra one you have
- downloaded and installed (eg \verb+uccthesis+, \verb+memoir+, etc).
+\begin{itemize}[noitemsep]
+ \item The document class name must be one of the standard \verb+book+,
+ \verb+article+, or \verb+report+, or one of the many extras
+ preinstalled or downloadable (eg
+ \verb+thesis+, \verb+memoir+, etc).
\item There are paper size options \verb+a4paper+
(210\thinspace mm$\times$297\thinspace mm) and \verb+letterpaper+
- (8½$''\times$11$''$) and others (eg \verb+a5paper+).
- \item There are base type size options \verb+10pt+ (the default),
- \verb+11pt+, and \verb+12pt+.\label{typesize}
-\end{itemize*}
+ (8\nicefrac12$''\times$11$''$) and others (eg \verb+a5paper+).
+ \item There are body type size options \verb+10pt+ (the default),
+ \verb+11pt+, and \verb+12pt+.
+\end{itemize}
+New material introduced in each example is shown below
+in {\ttfamily\added blue}; previous material in black.
\subsubsection{Front matter}
@@ -264,50 +273,52 @@ requirements, and where you put any changes to standard features.
\begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>]
\documentclass[a4paper,11pt]{book}
-\usepackage{charter,graphicx}
-\setlength{\parindent}{1em}
+!added\usepackage{charter,graphicx}!revert
+!added\setlength{\parindent}{1em}!revert
\begin{document}
-\title!comment{your document title!revert}
-\author!comment{your name!revert}
-\date!comment{date of publication!revert}
-\maketitle
-\begin{abstract}
-!comment the paragraphs of the abstract go here
-\end{abstract}
-\tableofcontents
-!comment rest of the document goes here
+!added\title!comment{your document title!revert}
+!added\author!comment{your name!revert}
+!added\date!comment{date of publication!revert}
+!added\maketitle
+!added\begin{abstract}
+!comment the paragraphs of your abstract go here
+!added\end{abstract}
+!added\tableofcontents
+!comment the text of your document goes here
\end{document}
\end{Verbatim}
-In a typical report or article, the title, author, date, abstract
+In a typical document, the title, author, date, abstract
(summary), and table of contents (optional) all go at the start,
followed by your text.
-Leave a blank line between paragraphs as you type. This means `start a
-new paragraph', \emph{not} `leave a blank line'. You control
-spacing and indentation separately by setting \verb+\parskip+ and
-\verb+\parindent+ (see examples), or with the \textsf{parskip}
+Leave a blank line between paragraphs as you type. To \LaTeX, this
+means `start a new paragraph', \emph{not} `leave a blank line'. You
+can control spacing and indentation by setting \verb+\parskip+ and
+\verb+\parindent+ with the \verb+\setlength+ command as in the
+previous example, or with the \textsf{parskip}
package.
\subsubsection{Sections and cross-references}
Sections get numbered automatically in bold type, and get included in
the Table of Contents (if any). Numbering can be turned off
-selectively. Section heading layout can be modified with
+selectively. Section heading layout can be modified with the
\textsf{sectsty}, \mbox{\textsf{titlesec}}, and other packages. Use
-the \textsf{babel} package for typesetting other languages.
+the \textsf{babel} package for other languages.
\begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>]
-!comment (Preamble, titling, and abstract as before)
+!comment (Preamble, titling, and abstract as above)
+!added\setcounter{secnumdepth}{3}
\tableofcontents
-\section!comment{heading of a section!revert}
-!comment text for the section goes here
-...as shown in section \ref{blah}.
-\subsubsection!comment{heading of a subsection!revert}
-!comment text for the subsection goes here
-\section!comment{heading of a new section!revert}
-\label{blah} !comment make up name for the label
+!added\chapter!comment{heading of a chapter!revert}
+!comment text for the chapter goes here
+!added...as shown in section \ref{blah}.
+!added\section!comment{heading of a section!revert}
+!added\label{blah} !comment make up name for the label
!comment text for the section goes here
+!added\chapter!comment{heading of a new chapter!revert}
+!comment text for the new chapter goes here
\end{document}
\end{Verbatim}
@@ -320,48 +331,46 @@ out the right numbers to print.\\
\subsubsection{Typefaces}
-{\ff{cmr}\LaTeX's default typeface is Computer Modern, like this
- paragraph. There are a dozen or so built-in typeface packages
- including:}
+\LaTeX's default typeface is Computer Modern. There is a selection of
+other typeface packages (use them in your Preamble):
-{\footnotesize\tabcolsep3pt
-\begin{tabular}{@{}l>{\ttfamily}l|l>{\ttfamily}l@{}}
-\bfseries Face&\normalfont\bfseries Package&\bfseries
-Face&\normalfont\bfseries Package\\\hline\vrule height1.1em width0pt
+{\footnotesize\tabcolsep4pt
+\def\ff#1{\fontfamily{#1}\selectfont}
+\begin{tabular}{@{}l@{\hspace{6pt}}>{\ttfamily}l|l@{\hspace{6pt}}>{\ttfamily}l@{}}
\ff{ptm}Times&mathptmx&\ff{pcr}Courier&courier\\
\ff{ppl}Palatino&mathpazo&\ff{pag}\scriptsize Avant Garde&avant\\
\ff{pbk}Bookman&bookman&\ff{phv}Helvetica&helvet\\
\ff{bch}Charter&charter&\ff{pzc}Zapf Chancery&chancery\\
\ff{put}Utopia&utopia&\fontencoding{OT1}\ff{pnr}Pandora&pandora\\
+\ff{pnc}Century&newcent&\fontencoding{U}\ff{yfrak}Fraktur&oldgerm\\
\end{tabular}
}
+See each package's documentation for details.
+
\columnbreak\parskip5pt
-Many more can be downloaded, including mathematical, display, and
-decorative faces: see the \LaTeX\ Font Catalog
-(\url{www.tug.dk/FontCatalogue/}). To switch type family, use
-\verb+\sffamily+ for sans-serif, or \verb+\ttfamily+ for monospace. To
-change font for a word or phrase, use these commands:
+Dozens of others are available, including mathematical and decorative
+fonts. To switch to a sans-serif type family (eg Helvetica, Avant
+Garde), use \verb+\sffamily+ in your text. To change font for a word
+or phrase, use these commands (they can be nested---see below):
{\small
-\begin{tabular}{@{}l@{\enspace}>{\ttfamily\char'134 text}l<{\char'173
+\begin{tabular}{l@{\enspace}>{\ttfamily\char'134 text}l<{\char'173
Hello\char'175}@{}>{\ \gives\bgroup}l<{\ Hello\egroup}}
Italics&it&\itshape\\
-Slanted&sl&\slshape\\
-Bold Face&bf&\bfseries\\
-Small Caps&sc&\scshape\\
+Boldface&bf&\bfseries\\
+Smallcaps&sc&\scshape\\
Sans-serif&sf&\sffamily~~\\
Monospace&tt&\ttfamily\\
\end{tabular}}
-\example \verb+\textit{\textbf{\textsf+\verb+{bold+
-\verb+italic sans}}}+
+\example \verb+\textit{\textbf{\textsf+\linebreak
+\verb+{bold italic sans}}}+
\gives{\textit{\textbf{\textsf{bold italic sans}}}}
Font sizing is automatic for titles, headings, and footnotes. There
-are some named step-size commands (in points, relative to the base
-type size, see p.\pageref{typesize}):
+are some named step-size commands (in points, relative to the base size):
{\small
\begin{tabular}{>{\ttfamily\char'134}lrrr}
@@ -380,15 +389,18 @@ Huge&20\rlap*&24\rlap*&28\rlap*\\
\rotatebox[origin=c]{90}{\scriptsize* sizes rounded here to save space}
}
-You can also specify an exact size with the \textsf{fix-cm} package and
-the command
-\verb+\fontsize{+\texttt{\textit{pp}}\verb+}{+\texttt{\textit{bb}}\verb+}\selectfont+
-for any point-size (\textit{pp}) on any baseline (\textit{bb}). Group
-(enclose) the command \emph{with} its applicable text in curly braces
-to prevent it affecting the rest of the document. For wider line-spacing
+You can specify an exact size with the \textsf{fix-cm} package and
+the command:\\
+\verb+ \fontsize{+\texttt{\textit{pp}}\verb+}{+\texttt{\textit{bb}}\verb+}\selectfont+\\
+for any point-size (\textit{pp}) on any baseline (\textit{bb}). Enclose the command \emph{and} its applicable text in curly braces
+to prevent it affecting the rest of the document.
+
+For double or 1\nicefrac12 line-spacing
(eg in theses) use the \textsf{setspace} package. You can also use
-\linebreak colour with the
-\\\textsf{xcolor} package and\hfil \smash{\raisebox{0ex}{\Huge
+RGB, CMYK, HTML, and many other
+\linebreak colourspaces with the
+\\\textsf{xcolor} package and the\hfil
+\smash{\raisebox{0ex}{\fontfamily{ppl}\selectfont\Huge\quad
\textcolor[HTML]{2F50AD}{G}%
\textcolor[HTML]{B32F17}{o}%
\textcolor[HTML]{F3C20B}{o}%
@@ -397,97 +409,106 @@ to prevent it affecting the rest of the document. For wider line-spacing
\textcolor[HTML]{B32F17}{e}}}%
% web colour for l was 567122
% web colour for o2 was CAB340
-\\the \verb+\color{+\texttt{\textit{name}}\verb+}+ command.
+\\\verb+\color{+\texttt{\textit{name}}\verb+}+ command.
+
+For verbatim text, use the \textsf{listings} or
+\textsf{fancyvrb} packages, or the \verb+\verb+ command.
\subsubsection{Lists}
-There are three basic types: \textbf{itemized} (bulleted);
-\textbf{enumerated} (numbered or lettered); and
-\textbf{descriptive} (topic-and-explanation). Others can
-be defined, or packages downloaded from CTAN [5].
+There are three basic kinds: \textbf{itemized} lists (bulleted);
+\textbf{enumerated} lists (numbered or lettered); and
+\textbf{descriptive} lists (topic-and-explanation format). Others are
+avaiable on CTAN[5].
\begingroup\tiny
\renewcommand{\labelitemi}{\textbullet}
\leftmargini=2em
-\setlength{\tabcolsep}{4pt}
+\setlength{\tabcolsep}{3pt}
\begin{tabular}{%@{}%
- p{.22\columnwidth}|%
- p{.28\columnwidth}|%
+ p{.24\columnwidth}|%
+ p{.30\columnwidth}|%
p{.33\columnwidth}}
-\begin{Verbatim}
+\begin{verbatim}
\begin{itemize}
\item 1lb Sugar
\item ½pt Cream
\item Chocolate
+\item 2oz Butter
\end{itemize}
-\end{Verbatim}
+\end{verbatim}
&
-\begin{Verbatim}[commandchars=!()]
+\begin{verbatim}
\begin{enumerate}
\item Mix together
-\item Boil to 112!textdegree()C
+\item Boil to 112°C
\item Stir and cool
+\item Pour into dish
\end{enumerate}
-\end{Verbatim}
+\end{verbatim}
&
-\begin{Verbatim}
+\begin{verbatim}
\begin{description}
\item[Fudge] is fun...
\item[Broccoli] sucks...
\item[Exercise] is good
\end{description}
-\end{Verbatim}
+\end{verbatim}
\\\hline
-\begin{itemize}
+\begin{itemize}[noitemsep]
\item 1lb Sugar
\item ½pt Cream
\item Chocolate
+\item 2oz Butter
\end{itemize}
&
-\begin{enumerate}
+\begin{enumerate}[noitemsep]
\item Mix together
\item Boil to 112\textdegree C
\item Stir and cool
+\item Pour into dish
\end{enumerate}
&\tiny
-\begin{description}
-\item[Fudge] is fun but not if made too often.
+\begin{description}[noitemsep]
+\item[Fudge] is fun but fattening if made too often.
\item[Broccoli] sucks, period.
\item[Exercise] is good for you if taken daily and not to extremes.
\end{description}
\end{tabular}
\endgroup
-You can nest lists inside each other. See packages like
-\textsf{paralist} and \textsf{mdwlist} to control list formatting.
+You can nest lists inside each other. Use the \textsf{enumitem}
+package to control list formatting.
\subsubsection{Tables and figures}
-Formal tables and figures \emph{float} (change position to fill
-available space) so they may not be printed where you typed them.
+Formal tables and figures will \emph{float} (change position to fit
+available space). Use \verb+\caption+ and \verb+\label+ to caption
+and label tables and figures.
\begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
-\begin{table}[hbtp] !comment positional specifiers
-\caption{Mean growth rate and intakes
-of supplement, milk, and water for 4
-diets.}\label{dietgrowth}\centering
-\begin{tabular}{|l|r|r|r|r|}\hline
-&Growth&Supplement&Milk&Water\\
-Supplement&rate&intake&intake&intake\\
-&(g/day)&(g/day)&(ml/kg$^{0.75}$)&
-(ml/kg$^{0.75}$)\\\hline
-Lucerne &145&450&10.5&144\\\hline
-Sesbania&132&476& 9.2&128\\\hline
-Leucaena&128&364& 8.9&121\\\hline
-None & 89& 0& 9.8&108\\\hline
-\end{tabular}
-\end{table}
+!added\begin{table}
+!added\caption{Mean growth rate and intakes
+!added of supplement, milk, and water for 4
+!added diets.}
+\label{dietgrowth}\centering
+!added\begin{tabular}{|l|r|r|r|r|}\hline
+!added&Growth&Supplement&Milk&Water\\
+!added Supplement&rate&intake&intake&intake\\
+!added&(g/day)&(g/day)&(ml/kg$^{0.75}$)&
+!added (ml/kg$^{0.75}$)\\\hline
+!added Lucerne &145&450&10.5&144\\\hline
+!added Sesbania&132&476& 9.2&128\\\hline
+!added Leucaena&128&364& 8.9&121\\\hline
+!added None & 89& 0& 9.8&108\\\hline
+!added\end{tabular}
+!added\end{table}
\end{Verbatim}
% fake it
\begin{center}\fontfamily{cmss}\fontsize56\selectfont
\setlength{\tabcolsep}{2pt}
\setlength{\arrayrulewidth}{.2pt}
-\begin{tabular}{@{}|l|r|r|r|r|@{}}
+\begin{tabular}{@{}|>{\vrule height1em width0pt}l|r|r|r|r|@{}}
\multicolumn5l{\textbf{Table 2}: \textit{Mean growth rate and intakes
of supplement,}}\\
\multicolumn5l{\textit{milk, and water for four diets} (after
@@ -518,12 +539,12 @@ comprehensive list at
\textbf{Tables and Figures}, \textit{continued}
\begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
-\begin{figure}[ht] !comment ht specifies `here' or `top' if there is space
+!added\begin{figure}
\caption{Swiss and Dutch Mennonite migrations of the 1700s and 1800s}\label{lmig}
-\centering !comment (graphics must be EPS files for standard !LaTeX; but JPG, PNG, or PDF for pdf!LaTeX)
-\includegraphics[width=.8\columnwidth]{menno-a}
-\\\scriptsize Courtesy of Paul C. Adams, Department of Geography and the
-Environment, University of Texas at Austin. \cite{adams}\end{figure}
+!added\centering !comment (graphics must be EPS files for standard !LaTeX; but JPG, PNG, or PDF for pdf!LaTeX)
+!added\includegraphics[width=.8\columnwidth]{menno-a}\\ !comment (double backslash for forced linebreak)
+!added\scriptsize Courtesy of Paul C. Adams, Department of Geography and the
+!added Environment, University of Texas at Austin. \cite{adams}\end{figure}
\end{Verbatim}
\begin{center}\fontfamily{cmss}\selectfont
@@ -536,29 +557,29 @@ and the Environment, University of Texas at Austin.~[1]
\subsubsection{Footnotes, citations, references, and indexes (back matter)}
\setcounter{footnote}{1}
-Footnotes are easy:\footnote{Like this.} see below. Citations using
-BIB\TeX{} (Patashnik, 1988) are also easy (see [2], \S7.4.2) and there
-are formatting packages for journals and publishers. You can add
-indexes with the package \textsf{makeidx}, the \verb+\index+ command
-and the \textsf{makeindex} program.
+You do footnotes with a simple command,\footnote{Like this.} see
+below. Citations using BIB\TeX{} (Patashnik, 1988) are easy (see
+[2], \char'247 7.4.2), and there are packages for more complex formats for
+journals and publishers. You can add indexes with the \verb+\index+
+and \verb+\printindex+ commands and the \textsf{makeindex} program.
\begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>]
-Footnotes are easy:\footnote{Like this.} see below. Citations using BIB\TeX{}
-(Patashnik, 1988) are also easy (see [2], \S7.4.2) and there are formatting
-packages for journals and publishers. You can add indexes with the package
-\textsf{makeidx}, the \verb+\index+ command and the \textsf{makeindex} program.
-!comment add the following at the end of your document and create!ttfamily myrefs.bib!rmfamily (see BIB!TeX manual [3])
-\bibliography{myrefs}\bibliographystyle{apacite}
+You do footnotes with a simple command,!added\footnote{Like this.}!revert see below. Citations
+using BIB!added\TeX{} \citeauthoryear{oren}!revert are easy (see !added\cite[§7.4.2]{flynn}!revert), and
+there are packages for more complex formats for journals and publishers. You can
+add indexes with the !added\verb`\index`!revert and !added\verb`\printindex`!revert commands and the
+!added\textsf{makeindex}!revert program.
+!added\bibliography{myrefs} \bibliographystyle{apalike} !comment (see BIB!TeX manual [3] for details)
\end{Verbatim}
\vspace*{-3pt}
\subsubsection{References}
-\begin{enumerate*}\footnotesize\RaggedRight
+\begin{enumerate}[noitemsep]\footnotesize\RaggedRight
\item Adams, Paul C. \textit{Linguistic Chaos in Montreal},
\url{www.utexas.edu/depts/grg/adams/chaos.ppt}, 2/59, Oct 2006.
\item {\bfseries Flynn, P. \textit{Formatting Information},
- 2011, at \url{latex.silmaril.ie/formattinginformation/}}
+ 2005, at \url{latex.silmaril.ie/formattinginformation/}}
\item Patashnik, O. \textit{BIB\TeX ing}, \TeX\ Users Group, 1988
(distributed with all copies of \LaTeX).
\item Sherington, J. example table in `Informative Presentation of
@@ -568,16 +589,13 @@ packages for journals and publishers. You can add indexes with the package
\item \bfseries\TeX\ Users Group, for \TeX\ Live
(\url{www.tug.org/texlive/}) and CTAN
(Comprehensive \TeX\ Archive Network) for downloads (\url{www.ctan.org}).
-\end{enumerate*}
+\end{enumerate}
\begin{note}
-Commercial implementations of \TeX\ with business-level
-support are available from
-\textbf{Personal \TeX, Inc} (\textit{PC\TeX});
-\textbf{Blue Sky Research} (\textit{Textures});
-\textbf{MacKichan Software, Inc} (\textit{Scientific Word});
-\textbf{Micropress, Inc} (\textit{V\TeX}); and
-\textbf{True\TeX\ Software} (\textit{True\TeX}).
+Commercial implementations of \TeX\ with business
+support are available from Personal \TeX, Inc (PC\TeX); Blue Sky
+Research (Textures~[Mac]); MacKichan Software, Inc (Scientific Word);
+Micropress, Inc (V\TeX), True\TeX\ Software (True\TeX), and others.
\end{note}
\end{document}
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-1.jpg b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-1.jpg
new file mode 100755
index 00000000000..f80eeff8ae4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-1.jpg
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-2.jpg b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-2.jpg
new file mode 100755
index 00000000000..fb7b746b3e1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-2.jpg
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-3.jpg b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-3.jpg
new file mode 100755
index 00000000000..706e8a43fde
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-3.jpg
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-4.jpg b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-4.jpg
new file mode 100755
index 00000000000..49e349cfa9e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/vsg-4.jpg
Binary files differ