diff options
author | Karl Berry <karl@freefriends.org> | 2012-01-12 23:13:43 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-01-12 23:13:43 +0000 |
commit | a8dc21bc7f0d5d3240be20c07c97a6746b210b1e (patch) | |
tree | d791271ea7d3475b15643f2c353784d1b8e11edb | |
parent | 7ea9fb4231d861c8122b9aa7a023287bac98618f (diff) |
latex-veryshortguide jan12 (12jan12)
git-svn-id: svn://tug.org/texlive/trunk@25084 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r-- | Master/texmf-dist/doc/latex/latex-veryshortguide/README | 101 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf | bin | 1274098 -> 808366 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf | bin | 319370 -> 157040 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf | bin | 491433 -> 661108 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex | 158 |
5 files changed, 135 insertions, 124 deletions
diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/README b/Master/texmf-dist/doc/latex/latex-veryshortguide/README index 7290085d089..a905be1f761 100644 --- a/Master/texmf-dist/doc/latex/latex-veryshortguide/README +++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/README @@ -1,70 +1,71 @@ + The Very Short Guide to LaTeX - The Very Short Guide to LaTeX + This is the 12 January 2012 revision of the Guide. It is designed for + printing on A4 paper, double-sided, and folding once to A5. -This is the 1 October 2009 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. -This revision corrects some minor typographical inconsistencies and -rephrases some descriptions for greater clarity. + 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 + need something by them on their desk the next day to refresh their + memories. It is not intended as a substitute for full documentation. - From the source comments: +Production notes - This is the Very Short Guide to LaTeX, a 4pp folder designed as an - 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. + 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. - - Production notes - -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. - -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 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)" \ + Adobe Acrobat, 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)" \ 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 -slightly smaller. + 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. -Page 1 Page 2 Page 3 Page 4 + Page 1 Page 2 Page 3 Page 4 -If you have been maintaining a mirror or other copy of this document, -please update it with this version and delete the previous files. + If you have been maintaining a mirror or other copy of this document, + please update it with this version and delete the previous files. +License - License + This is free documentation, issued under the [1]LaTeX Project Public + License. -This is free documentation, issued under the LaTeX Project Public -License <http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html>. +Files + Source code + [2]veryshortguide.tex 22K 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 + Images + [7]menno-a.eps 444K Map (EPS) + [8]menno-a.jpg 30K Map (JPG) - Files -Source code -veryshortguide.tex 22K LaTeX source -Output -veryshortguide.pdf 480K PDF output -veryshortguide-imposed.pdf 312K PDF output -veryshortguide.dvi 30K DVI output -veryshortguide.ps 1.2M PS output -Images -menno-a.eps 444K Map (EPS) -menno-a.jpg 30K Map (JPG) + Peter Flynn -Peter Flynn +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 diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf Binary files differindex 36e59e1c7ef..989b705cf7f 100644 --- a/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf +++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/README.pdf diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf Binary files differindex 3de55350ec3..9e74c5d1e4f 100644 --- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf +++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide-imposed.pdf diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf Binary files differindex 5325a28a81a..f6d684575ac 100644 --- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf +++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.pdf diff --git a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex index 6a29c0f6f6e..591246ec5b5 100644 --- a/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex +++ b/Master/texmf-dist/doc/latex/latex-veryshortguide/veryshortguide.tex @@ -1,5 +1,5 @@ % This is the Very Short Guide to LaTeX, a 4pp folder designed as an -% aide-mémoire for people who have just done a course in LaTeX and +% aide-memoire 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. % @@ -10,6 +10,7 @@ % http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html % % 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. @@ -55,14 +56,14 @@ % % Packages % -\usepackage{ucs} \usepackage[utf8x]{inputenc} \usepackage[T1]{fontenc} -\usepackage{utopia,graphicx,url,fancybox,mdwlist,fix-cm,multicol} +\usepackage{lmodern,utopia,graphicx,url,fancybox,mdwlist,fix-cm,multicol} \usepackage{fancyvrb,bbding,parskip,ragged2e,calc,ifthen,textcomp,array} \usepackage[svgnames]{xcolor} \usepackage[scaled=.95]{helvet} -%\usepackage[scaled=.87]{luximono} +% compensate for the fact that the Bitstream fonts redefine bx to b +\DeclareFontShape{T1}{cmr}{b}{it}{<->ssub*cmr/bx/it}{} % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % @@ -77,13 +78,16 @@ \renewcommand{\labelitemi}{\raisebox{-.5ex}{\textcolor{Purple}{\PencilRight}}} % % Provide commands for distinguishing examples and their output -\newcommand{\example}{\color{DarkGreen}\textsf{\bfseries Example:} \color{Grey}} +\newcommand{\example}{% + \color{DarkGreen}\textsf{\fontseries{bc}\selectfont Example:} + \color{DarkRed}} \def\endexample{\color{black}} -\newcommand{\gives}[1]{\thinspace\color{DarkGreen}\raisebox{-.7ex} +\newcommand{\gives}[1]{\thinspace\color{DarkGreen}\raisebox{-.333ex} {\ArrowBoldRightStrobe}~\color{DarkBlue}{\fontfamily{cmr}\selectfont #1}\color{black}} -\newcommand{\nobox}{~\raisebox{-.25ex}{\footnotesize\Square\llap\XSolidBrush}} -\newcommand{\yesbox}{~\raisebox{-.25ex}{\footnotesize\Square\llap\CheckmarkBold}} +\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} % % In fancyverb's Verbatim, allow rubric embedded as marked text in red \newcommand{\comment}[1]{\ifthenelse{\equal{#1}{ }}{}{#1}\normalfont @@ -180,6 +184,20 @@ mathematics\footnote{For reasons of space this guide does not cover dimensional accuracy, or a persistent and non-proprietary file format are needed. +\subsection{Creating and typesetting your document} + +\begin{enumerate*}\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); + \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} + \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)} @@ -202,26 +220,12 @@ are needed. \example \verb+Some {\tiny little} word+ \gives{Some {\tiny little} word} \end{itemize*} -\subsection{Creating and typesetting your document} - -\begin{enumerate*}\setlength{\fboxsep}{1pt} - \item Create your document using any suitable plain-text editor - with \LaTeX\ controls, eg \textit{\TeX shop} (Mac), \textit{\TeX - nicCenter} (Win), \textit{Kile} (Linux), \textit{Emacs} (all); - \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} - \item Make any changes needed in your original document and repeat - step \ref{typeset}. -\end{enumerate*} - \vfill \begin{note} This guide shows only a tiny fraction of \LaTeX's power. For information, visit the \TeX\ Users Group site (\url{www.tug.org}). For -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 +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 Network (\url{www.ctan.org}). For documentation, use the sources in the \textit{References} [2]. \end{note} @@ -235,7 +239,7 @@ Here's the skeleton of a \LaTeX\ document. These three lines are \begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>] \documentclass{article} -!comment your preamble goes here (extra setups, if any) +!comment your Preamble goes here (extra setups, if any) \begin{document} !comment your document text goes here \end{document} @@ -244,17 +248,17 @@ Here's the skeleton of a \LaTeX\ document. These three lines are \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+thesis+, \verb+memoir+, etc). + downloaded and installed (eg \verb+uccthesis+, \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+. + \verb+11pt+, and \verb+12pt+.\label{typesize} \end{itemize*} \subsubsection{Front matter} -The \textbf{preamble} is where you specify any extra \textbf{packages} +The \textbf{Preamble} is where you specify any extra \textbf{packages} (\LaTeX\ plugins) such as typefaces or special formatting requirements, and where you put any changes to standard features. @@ -280,8 +284,8 @@ In a typical report or article, the title, author, date, abstract 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 can control -spacing and indentation by setting \verb+\parskip+ and +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} package. @@ -289,12 +293,12 @@ package. 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 the +selectively. Section heading layout can be modified with \textsf{sectsty}, \mbox{\textsf{titlesec}}, and other packages. Use -the \textsf{babel} package for other languages. +the \textsf{babel} package for typesetting other languages. \begin{Verbatim}[frame=single,fontsize=\small,commandchars=!<>] -!comment (Preamble, titling, and abstract as above) +!comment (Preamble, titling, and abstract as before) \tableofcontents \section!comment{heading of a section!revert} !comment text for the section goes here @@ -316,44 +320,48 @@ out the right numbers to print.\\ \subsubsection{Typefaces} -\LaTeX's default typeface is Computer Modern. There is a selection of -other typeface packages (use them in your Preamble): +{\ff{cmr}\LaTeX's default typeface is Computer Modern, like this + paragraph. There are a dozen or so built-in typeface packages + including:} -{\footnotesize\tabcolsep4pt -\def\ff#1{\fontfamily{#1}\selectfont} -\begin{tabular}{l>{\ttfamily}l|l>{\ttfamily}l@{}} +{\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 \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\\ -\multicolumn3l{\ff{pnc}New Century Schoolbook}&newcent\\ \end{tabular} } \columnbreak\parskip5pt -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): +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: {\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\\ -Boldface&bf&\bfseries\\ -Smallcaps&sc&\scshape\\ +Slanted&sl&\slshape\\ +Bold Face&bf&\bfseries\\ +Small Caps&sc&\scshape\\ Sans-serif&sf&\sffamily~~\\ Monospace&tt&\ttfamily\\ \end{tabular}} -\example \verb+\textit{\textbf{\textsf+\linebreak -\verb+{bold ital sans}}}+ -\gives{\textit{\textbf{\textsf{bold ital sans}}}} +\example \verb+\textit{\textbf{\textsf+\verb+{bold+ +\verb+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 size): +are some named step-size commands (in points, relative to the base +type size, see p.\pageref{typesize}): {\small \begin{tabular}{>{\ttfamily\char'134}lrrr} @@ -372,7 +380,7 @@ Huge&20\rlap*&24\rlap*&28\rlap*\\ \rotatebox[origin=c]{90}{\scriptsize* sizes rounded here to save space} } -but you can specify an exact size with the \textsf{fix-cm} package and +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 @@ -393,10 +401,10 @@ to prevent it affecting the rest of the document. For wider line-spacing \subsubsection{Lists} -There are three basic kinds: \textbf{itemized} lists (bulleted); -\textbf{enumerated} lists (numbered or lettered); and -\textbf{descriptive} lists (topic-and-explanation format). Others can -be defined, or downloaded from CTAN [5]. +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]. \begingroup\tiny \renewcommand{\labelitemi}{\textbullet} @@ -458,11 +466,10 @@ Formal tables and figures \emph{float} (change position to fill available space) so they may not be printed where you typed them. \begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>] -\begin{table} +\begin{table}[hbtp] !comment positional specifiers \caption{Mean growth rate and intakes of supplement, milk, and water for 4 -diets.} -\label{dietgrowth}\centering +diets.}\label{dietgrowth}\centering \begin{tabular}{|l|r|r|r|r|}\hline &Growth&Supplement&Milk&Water\\ Supplement&rate&intake&intake&intake\\ @@ -511,7 +518,7 @@ comprehensive list at \textbf{Tables and Figures}, \textit{continued} \begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>] -\begin{figure} +\begin{figure}[ht] !comment ht specifies `here' or `top' if there is space \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} @@ -529,19 +536,19 @@ and the Environment, University of Texas at Austin.~[1] \subsubsection{Footnotes, citations, references, and indexes (back matter)} \setcounter{footnote}{1} -You do footnotes with a simple command,\footnote{Like this.} see -below. Citations using BIB\TeX{} (Patashnik, 1988) are also easy (see -[2], \S7.4.2) and there are packages for more complex formats for -journals and publishers. You can add indexes with the \verb+\index+ -command and the \textsf{makeindex} program. +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. \begin{Verbatim}[frame=single,fontsize=\footnotesize,commandchars=!<>] -You do footnotes with a simple command,\footnote{Like this.} see below. Citations -using BIB\TeX{} \citeauthoryear{oren} are also easy (see \cite[§7.4.2]{flynn} and -there are packages for more complex formats for journals and publishers. You can -add indexes with the \verb`\index` command and the \textsf{makeindex} program. +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{apalike} +\bibliography{myrefs}\bibliographystyle{apacite} \end{Verbatim} \vspace*{-3pt} @@ -551,7 +558,7 @@ add indexes with the \verb`\index` command and the \textsf{makeindex} program. \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}, - 2005, at \url{latex.silmaril.ie/formattinginformation/}} + 2011, 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 @@ -564,10 +571,13 @@ add indexes with the \verb`\index` command and the \textsf{makeindex} program. \end{enumerate*} \begin{note} -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. +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}). \end{note} \end{document} |