diff options
author | Karl Berry <karl@freefriends.org> | 2009-12-13 01:07:15 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-12-13 01:07:15 +0000 |
commit | 55680297935c477d4a7ac7725002fd0c15f49f7e (patch) | |
tree | 1e0a277547787a1910bb074aca245eacf4a82574 /Master/texmf-dist/source/latex/tufte-latex/sample-book.tex | |
parent | c05b490ff9e913dfee1ea598959b51c98a5dfcae (diff) |
tufte-latex 3.5.0 (11dec09)
git-svn-id: svn://tug.org/texlive/trunk@16378 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/tufte-latex/sample-book.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/tufte-latex/sample-book.tex | 747 |
1 files changed, 0 insertions, 747 deletions
diff --git a/Master/texmf-dist/source/latex/tufte-latex/sample-book.tex b/Master/texmf-dist/source/latex/tufte-latex/sample-book.tex deleted file mode 100644 index eb95dec6311..00000000000 --- a/Master/texmf-dist/source/latex/tufte-latex/sample-book.tex +++ /dev/null @@ -1,747 +0,0 @@ -\documentclass{tufte-book} - -%% -% Book metadata -\title{A Tufte-Style Book\thanks{Thanks to Edward R.~Tufte for his inspiration.}} -\author[The Tufte-LaTeX Developers]{The Tufte-LaTeX\ Developers} -\publisher{Publisher of This Book} - -%% -% If they're installed, use Bergamo and Chantilly from www.fontsite.com. -% They're clones of Bembo and Gill Sans, respectively. -%\IfFileExists{bergamo.sty}{\usepackage[osf]{bergamo}}{}% Bembo -%\IfFileExists{chantill.sty}{\usepackage{chantill}}{}% Gill Sans - -%\usepackage{microtype} - -%% -% Just some sample text -\usepackage{lipsum} - -%% -% For nicely typeset tabular material -\usepackage{booktabs} - -%% -% For graphics / images -\usepackage{graphicx} -\setkeys{Gin}{width=\linewidth,totalheight=\textheight,keepaspectratio} -\graphicspath{{graphics/}} - -% The fancyvrb package lets us customize the formatting of verbatim -% environments. We use a slightly smaller font. -\usepackage{fancyvrb} -\fvset{fontsize=\normalsize} - -%% -% Prints argument within hanging parentheses (i.e., parentheses that take -% up no horizontal space). Useful in tabular environments. -\newcommand{\hangp}[1]{\makebox[0pt][r]{(}#1\makebox[0pt][l]{)}} - -%% -% Prints an asterisk that takes up no horizontal space. -% Useful in tabular environments. -\newcommand{\hangstar}{\makebox[0pt][l]{*}} - -%% -% Prints a trailing space in a smart way. -\usepackage{xspace} - -%% -% Some shortcuts for Tufte's book titles. The lowercase commands will -% produce the initials of the book title in italics. The all-caps commands -% will print out the full title of the book in italics. -\newcommand{\vdqi}{\textit{VDQI}\xspace} -\newcommand{\ei}{\textit{EI}\xspace} -\newcommand{\ve}{\textit{VE}\xspace} -\newcommand{\be}{\textit{BE}\xspace} -\newcommand{\VDQI}{\textit{The Visual Display of Quantitative Information}\xspace} -\newcommand{\EI}{\textit{Envisioning Information}\xspace} -\newcommand{\VE}{\textit{Visual Explanations}\xspace} -\newcommand{\BE}{\textit{Beautiful Evidence}\xspace} - -\newcommand{\TL}{Tufte-\LaTeX\xspace} - -% Prints the month name (e.g., January) and the year (e.g., 2008) -\newcommand{\monthyear}{% - \ifcase\month\or January\or February\or March\or April\or May\or June\or - July\or August\or September\or October\or November\or - December\fi\space\number\year -} - - -% Prints an epigraph and speaker in sans serif, all-caps type. -\newcommand{\openepigraph}[2]{% - %\sffamily\fontsize{14}{16}\selectfont - \begin{fullwidth} - \sffamily\large - \begin{doublespace} - \noindent\allcaps{#1}\\% epigraph - \noindent\allcaps{#2}% author - \end{doublespace} - \end{fullwidth} -} - -% Inserts a blank page -\newcommand{\blankpage}{\newpage\hbox{}\thispagestyle{empty}\newpage} - -\usepackage{units} - -% Typesets the font size, leading, and measure in the form of 10/12x26 pc. -\newcommand{\measure}[3]{#1/#2$\times$\unit[#3]{pc}} - -% Macros for typesetting the documentation -\newcommand{\hl}[1]{\textcolor{Maroon}{#1}}% prints in red -\newcommand{\hangleft}[1]{\makebox[0pt][r]{#1}} -\newcommand{\hairsp}{\hspace{1pt}}% hair space -\newcommand{\hquad}{\hskip0.5em\relax}% half quad space -\newcommand{\TODO}{\textcolor{red}{\bf TODO!}\xspace} -\newcommand{\ie}{\textit{i.\hairsp{}e.}\xspace} -\newcommand{\eg}{\textit{e.\hairsp{}g.}\xspace} -\providecommand{\XeLaTeX}{X\lower.5ex\hbox{\kern-0.15em\reflectbox{E}}\kern-0.1em\LaTeX} -\newcommand{\tXeLaTeX}{\XeLaTeX\index{XeLaTeX@\protect\XeLaTeX}} -% \index{\texttt{\textbackslash xyz}@\hangleft{\texttt{\textbackslash}}\texttt{xyz}} -\newcommand{\tuftebs}{\symbol{'134}}% a backslash in tt type in OT1/T1 -\newcommand{\doccmd}[1]{% - \texttt{\tuftebs#1}% - \index{#1@\protect\hangleft{\texttt{\tuftebs}}\texttt{#1}}% -}% command name -- adds backslash automatically -\newcommand{\docopt}[1]{\ensuremath{\langle}\textrm{\textit{#1}}\ensuremath{\rangle}}% optional command argument -\newcommand{\docarg}[1]{\textrm{\textit{#1}}}% (required) command argument -\newenvironment{docspec}{\begin{quotation}\ttfamily\parskip0pt\parindent0pt\ignorespaces}{\end{quotation}}% command specification environment -\newcommand{\docenv}[1]{\texttt{#1}\index{#1@\texttt{#1} environment}\index{environments!#1@\texttt{#1}}}% environment name -\newcommand{\docpkg}[1]{\texttt{#1}\index{#1@\texttt{#1} package}\index{packages!#1@\texttt{#1}}}% package name -\newcommand{\doccls}[1]{\texttt{#1}}% document class name -\newcommand{\docclsopt}[1]{\texttt{#1}\index{#1@\texttt{#1} class option}\index{class options!#1@\texttt{#1}}}% document class option name - -% Generates the index -\usepackage{makeidx} -\makeindex - -\begin{document} - -% Front matter -\frontmatter - -% r.1 blank page -\blankpage - -% v.2 epigraphs -\newpage\thispagestyle{empty} -\openepigraph{% -The public is more familiar with bad design than good design. -It is, in effect, conditioned to prefer bad design, -because that is what it lives with. -The new becomes threatening, the old reassuring. -}{Paul Rand%, {\itshape Design, Form, and Chaos} -} -\vfill -\openepigraph{% -A designer knows that he has achieved perfection -not when there is nothing left to add, -but when there is nothing left to take away. -}{Antoine de St-Expurey} -\vfill -\openepigraph{% -\ldots the designer of a new system must not only be the implementor and the first -large-scale user; the designer should also write the first user manual\ldots -If I had not participated fully in all these activities, -literally hundreds of improvements would never have been made, -because I would never have thought of them or perceived -why they were important. -}{Donald E. Knuth} - - -% r.3 full title page -\maketitle - - -% v.4 copyright page -\newpage -\begin{fullwidth} -~\vfill -\thispagestyle{empty} -\setlength{\parindent}{0pt} -\setlength{\parskip}{\baselineskip} -Copyright \copyright\ \the\year\ \thanklessauthor - -\par\smallcaps{Published by \thanklesspublisher} - -\par\smallcaps{tufte-latex.googlecode.com} - -\par Licensed under the Apache License, Version 2.0 (the ``License''); you may not -use this file except in compliance with the License. You may obtain a copy -of the License at \url{http://www.apache.org/licenses/LICENSE-2.0}. Unless -required by applicable law or agreed to in writing, software distributed -under the License is distributed on an \smallcaps{``AS IS'' BASIS, WITHOUT -WARRANTIES OR CONDITIONS OF ANY KIND}, either express or implied. See the -License for the specific language governing permissions and limitations -under the License.\index{license} - -\par\textit{First printing, \monthyear} -\end{fullwidth} - -% r.5 contents -\tableofcontents - -% r.7 dedication -\cleardoublepage -~\vfill -\begin{doublespace} -\noindent\fontsize{18}{22}\selectfont\itshape -\nohyphenation -Dedicated to those who appreciate \LaTeX{} -and the work of \mbox{Edward R.~Tufte} -and \mbox{Donald E.~Knuth}. -\end{doublespace} -\vfill -\vfill - - -% r.9 introduction -\cleardoublepage -\chapter*{Introduction} - -This sample book discusses the design of Edward Tufte's -books\cite{Tufte2001,Tufte1990,Tufte1997,Tufte2006} -and the use of the \texttt{tufte-book} and \texttt{sample-handout} document classes. - - -%% -% Start the main matter (normal chapters) -\mainmatter - - -\chapter{The Design of Tufte's Books} -\label{ch:tufte-design} - - -\newthought{The pages} of a book are usually divided into three major -sections: the front matter (also called preliminary matter or prelim), the -main matter (the core text of the book), and the back matter (or end -matter). - -\newthought{The front matter} of a book refers to all of the material that -comes before the main text. The following table from shows a list of -material that appears in the front matter of \VDQI, \EI, \VE, and \BE -along with its page number. Page numbers that appear in parentheses refer -to folios that do not have a printed page number (but they are still -counted in the page number sequence). - -\bigskip -\begin{minipage}{\textwidth} -\begin{center} -\begin{tabular}{lcccc} -\toprule - & \multicolumn{4}{c}{Books} \\ -\cmidrule(l){2-5} -Page content & \vdqi & \ei & \ve & \be \\ -\midrule -Blank half title page & \hangp{1} & \hangp{1} & \hangp{1} & \hangp{1} \\ -Frontispiece\footnotemark{} - & \hangp{2} & \hangp{2} & \hangp{2} & \hangp{2} \\ -Full title page & \hangp{3} & \hangp{3} & \hangp{3} & \hangp{3} \\ -Copyright page & \hangp{4} & \hangp{4} & \hangp{4} & \hangp{4} \\ -Contents & \hangp{5} & \hangp{5} & \hangp{5} & \hangp{5} \\ -%Blank & -- & \hangp{6} & \hangp{6} & \hangp{6} \\ -Dedication & \hangp{6} & \hangp{7} & \hangp{7} & 7 \\ -%Blank & -- & \hangp{8} & -- & \hangp{8} \\ -Epigraph & -- & -- & \hangp{8} & -- \\ -Introduction & \hangp{7} & \hangp{9} & \hangp{9} & 9 \\ -\bottomrule -\end{tabular} -\end{center} -\end{minipage} -\vspace{-7\baselineskip}\footnotetext{The contents of this page vary from book to book. In - \vdqi this page is blank; in \ei and \ve this page holds a frontispiece; - and in \be this page contains three epigraphs.} -\vspace{7\baselineskip} - -\bigskip -The design of the front matter in Tufte's books varies slightly from the -traditional design of front matter. First, the pages in front matter are -traditionally numbered with lowercase roman numerals (\eg, i, ii, iii, -iv,~\ldots). Second, the front matter page numbering sequence is usually -separate from the main matter page numbering. That is, the page numbers -restart at 1 when the main matter begins. In contrast, Tufte has -enumerated his pages with arabic numerals that share the same page counting -sequence as the main matter. - -There are also some variations in design across Tufte's four books. The -page opposite the full title page (labeled ``frontispiece'' in the above -table) has different content in each of the books. In \VDQI, this page is -blank; in \EI and \VE, this page holds a frontispiece; and in \BE, this -page contains three epigraphs. - -The dedication appears on page~6 in \vdqi (opposite the introduction), and -is placed on its own spread in the other books. In \ve, an epigraph shares -the spread with the opening page of the introduction. - -None of the page numbers (folios) of the front matter are expressed except in -\be, where the folios start to appear on the dedication page. - -\newthought{The full title page} of each of the books varies slightly in -design. In all the books, the author's name appears at the top of the -page, the title it set just above the center line, and the publisher is -printed along the bottom margin. Some of the differences are outlined in -the following table. - -\bigskip -\begin{center} -\footnotesize -\begin{tabular}{lllll} -\toprule -Feature & \vdqi & \ei & \ve & \be \\ -\midrule -Author & & & & \\ -\quad Typeface & serif & serif & serif & sans serif \\ -\quad Style & italics & italics & italics & upright, caps \\ -\quad Size & 24 pt & 20 pt & 20 pt & 20 pt \\ -\addlinespace -Title & & & & \\ -\quad Typeface & serif & serif & serif & sans serif \\ -\quad Style & upright & italics & upright & upright, caps \\ -\quad Size & 36 pt & 48 pt & 48 pt & 36 pt \\ -\addlinespace -Subtitle & & & & \\ -\quad Typeface & -- & -- & serif & -- \\ -\quad Style & -- & -- & upright & -- \\ -\quad Size & -- & -- & 20 pt & -- \\ -\addlinespace -Edition & & & & \\ -\quad Typeface & sans serif & -- & -- & -- \\ -\quad Style & upright, caps & -- & -- & -- \\ -\quad Size & 14 pt & -- & -- & -- \\ -\addlinespace -Publisher & & & & \\ -\quad Typeface & serif & serif & serif & sans serif \\ -\quad Style & italics & italics & italics & upright, caps \\ -\quad Size & 14 pt & 14 pt & 14 pt & 14 pt \\ -\bottomrule -\end{tabular} -\end{center} - -\begin{figure*}[p] -\fbox{\includegraphics[width=0.45\linewidth]{graphics/vdqi-title.pdf}} -\hfill -\fbox{\includegraphics[width=0.45\linewidth]{graphics/ei-title.pdf}} -\\\vspace{\baselineskip} -\fbox{\includegraphics[width=0.45\linewidth]{graphics/ve-title.pdf}} -\hfill -\fbox{\includegraphics[width=0.45\linewidth]{graphics/be-title.pdf}} -\end{figure*} - -\newthought{The tables of contents} in Tufte's books give us our first -glimpse of the structure of the main matter. \VDQI is split into two -parts, each containing some number of chapters. His other three books only -contain chapters---they're not broken into parts. - -\begin{figure*}[p]\index{table of contents} -\fbox{\includegraphics[width=0.45\linewidth]{graphics/vdqi-contents.pdf}} -\hfill -\fbox{\includegraphics[width=0.45\linewidth]{graphics/ei-contents.pdf}} -\\\vspace{\baselineskip} -\fbox{\includegraphics[width=0.45\linewidth]{graphics/ve-contents.pdf}} -\hfill -\fbox{\includegraphics[width=0.45\linewidth]{graphics/be-contents.pdf}} -\end{figure*} - - -\section{Typefaces}\label{sec:typefaces1}\index{typefaces} -\index{fonts|see{typefaces}} - -Tufte's books primarily use two typefaces: Bembo and Gill Sans. Bembo is used -for the headings and body text, while Gill Sans is used for the title page and -opening epigraphs in \BE. - -Since neither Bembo nor Gill Sans are available in default \LaTeX{} -installations, the \TL document classes default to using Palatino and -Helvetica, respectively. In addition, the Bera Mono typeface is used for -\texttt{monospaced} type. - -The following font sizes are defined by the \TL classes: - -\begin{table}[h]\index{typefaces!sizes} - \footnotesize% - \begin{center} - \begin{tabular}{lccl} - \toprule - \LaTeX{} size & Font size & Leading & Used for \\ - \midrule - \verb+\tiny+ & 5 & 6 & sidenote numbers \\ - \verb+\scriptsize+ & 7 & 8 & --- \\ - \verb+\footnotesize+ & 8 & 10 & sidenotes, captions \\ - \verb+\small+ & 9 & 12 & quote, quotation, and verse environments \\ - \verb+\normalsize+ & 10 & 14 & body text \\ - \verb+\large+ & 11 & 15 & \textsc{b}-heads \\ - \verb+\Large+ & 12 & 16 & \textsc{a}-heads, \textsc{toc} entries, author, date \\ - \verb+\LARGE+ & 14 & 18 & handout title \\ - \verb+\huge+ & 20 & 30 & chapter heads \\ - \verb+\Huge+ & 24 & 36 & part titles \\ - \bottomrule - \end{tabular} - \end{center} - \caption{A list of \LaTeX{} font sizes as defined by the \TL document classes.} - \label{tab:font-sizes} -\end{table} - -\section{Headings}\label{sec:headings1}\index{headings} - -Tufte's books include the following heading levels: parts, -chapters,\sidenote{Parts and chapters are defined for the \texttt{tufte\-book} -class only.} sections, subsections, and paragraphs. Not defined by default -are: sub-subsections and subparagraphs. - -\begin{table}[h] - \begin{center} - \footnotesize% - \begin{tabular}{lcr} - \toprule - Heading & Style & Size \\ - \midrule - Part & roman & \measure{24}{36}{40} \\ - Chapter & italic & \measure{20}{30}{40} \\ - Section & italic & \measure{12}{16}{26} \\ - Subsection & italic & \measure{11}{15}{26} \\ - Paragraph & italic & 10/14 \\ - \bottomrule - \end{tabular} - \end{center} - \caption{Heading styles used in \BE.} - \label{tab:heading-styles} -\end{table} - -\paragraph{Paragraph} Paragraph headings (as shown here) are introduced by -italicized text and separated from the main paragraph by a bit of space. - -\section{Environments} - -The following characteristics define the various environments: - - -\begin{table}[h] - \begin{center} - \footnotesize% - \begin{tabular}{lcl} - \toprule - Environment & Font size & Notes \\ - \midrule - Body text & \measure{10}{14}{26} & \\ - Block quote & \measure{9}{12}{24} & Block indent (left and right) by \unit[1]{pc} \\ - Sidenotes & \measure{8}{10}{12} & Sidenote number is set inline, followed by word space \\ - Captions & \measure{8}{10}{12} & \\ - \bottomrule - \end{tabular} - \end{center} - \caption{Environment styles used in \BE.} - \label{tab:environment-styles} -\end{table} - - -\chapter{On the Use of the \texttt{tufte-book} Document Class} -\label{ch:tufte-book} - -The Tufte-\LaTeX\ document classes define a style similar to the -style Edward Tufte uses in his books and handouts. Tufte's style is known -for its extensive use of sidenotes, tight integration of graphics with -text, and well-set typography. This document aims to be at once a -demonstration of the features of the Tufte-\LaTeX\ document classes -and a style guide to their use. - -\section{Page Layout}\label{sec:page-layout} -\subsection{Headings}\label{sec:headings}\index{headings} -This style provides \textsc{a}- and \textsc{b}-heads (that is, -\Verb|\section| and \Verb|\subsection|), demonstrated above. - -If you need more than two levels of section headings, you'll have to define -them yourself at the moment; there are no pre-defined styles for anything below -a \Verb|\subsection|. As Bringhurst points out in \textit{The Elements of -Typographic Style},\cite{Bringhurst2005} you should ``use as many levels of -headings as you need: no more, and no fewer.'' - -The Tufte-\LaTeX\ classes will emit an error if you try to use -\linebreak\Verb|\subsubsection| and smaller headings. - -% let's start a new thought -- a new section -\newthought{In his later books},\cite{Tufte2006} Tufte -starts each section with a bit of vertical space, a non-indented paragraph, -and sets the first few words of the sentence in \textsc{small caps}. To -accomplish this using this style, use the \hl{\doccmd{newthought}} command: -\begin{docspec} - \doccmd{newthought}\{In his later books\}, Tufte starts\ldots -\end{docspec} - - -\section{Sidenotes}\label{sec:sidenotes} -One of the most prominent and distinctive features of this style is the -extensive use of sidenotes. There is a wide margin to provide ample room -for sidenotes and small figures. Any \doccmd{footnote}s will automatically -be converted to sidenotes.\footnote{This is a sidenote that was entered -using the \texttt{\textbackslash footnote} command.} If you'd like to place ancillary -information in the margin without the sidenote mark (the superscript -number), you can use the \hl{\doccmd{marginnote}} command.\marginnote{This is a -margin note. Notice that there isn't a number preceding the note, and -there is no number in the main text where this note was written.} - -The specification of the \hl{\doccmd{sidenote}} command is: -\begin{docspec} - \doccmd{sidenote}[\docopt{number}][\docopt{offset}]\{\docarg{Sidenote text.}\} -\end{docspec} - -Both the \docopt{number} and \docopt{offset} arguments are optional. If you -provide a \docopt{number} argument, then that number will be used as the -sidenote number. It will change of the number of the current sidenote only and -will not affect the numbering sequence of subsequent sidenotes. - -Sometimes a sidenote may run over the top of other text or graphics in the -margin space. If this happens, you can adjust the vertical position of the -sidenote by providing a dimension in the \docopt{offset} argument. Some -examples of valid dimensions are: -\begin{docspec} - \ttfamily 1.0in \qquad 2.54cm \qquad 254mm \qquad 6\Verb|\baselineskip| -\end{docspec} -If the dimension is positive it will push the sidenote down the page; if the -dimension is negative, it will move the sidenote up the page. - -While both the \docopt{number} and \docopt{offset} arguments are optional, they -must be provided in order. To adjust the vertical position of the sidenote -while leaving the sidenote number alone, use the following syntax: -\begin{docspec} - \doccmd{sidenote}[][\docopt{offset}]\{\docarg{Sidenote text.}\} -\end{docspec} -The empty brackets tell the \Verb|\sidenote| command to use the default -sidenote number. - -If you \emph{only} want to change the sidenote number, however, you may -completely omit the \docopt{offset} argument: -\begin{docspec} - \doccmd{sidenote}[\docopt{number}]\{\docarg{Sidenote text.}\} -\end{docspec} - -The \doccmd{marginnote} command has a similar \docarg{offset} argument: -\begin{docspec} - \doccmd{marginnote}[\docopt{offset}]\{\docarg{Margin note text.}\} -\end{docspec} - -\section{References} -References are placed alongside their citations as sidenotes, -as well. This can be accomplished using the normal \hl{\doccmd{cite}} -command.\sidenote{The first paragraph of this document includes a citation.} - -The complete list of references may also be printed automatically by using -the \hl{\doccmd{bibliography}} command. (See the end of this document for an -example.) If you do not want to print a bibliography at the end of your -document, use the \hl{\doccmd{nobibliography}} command in its place. - -To enter multiple citations at one location,\cite[-3\baselineskip]{Tufte2006,Tufte1990} you can -provide a list of keys separated by commas and the same optional vertical -offset argument: \Verb|\cite{Tufte2006,Tufte1990}|. -\begin{docspec} - \doccmd{cite}[\docopt{offset}]\{\docarg{bibkey1,bibkey2,\ldots}\} -\end{docspec} - -\section{Figures and Tables}\label{sec:figures-and-tables} -Images and graphics play an integral role in Tufte's work. -In addition to the standard \hl{\docenv{figure}} and \hl{\docenv{tabular}} environments, -this style provides special figure and table environments for full-width -floats. - -Full page--width figures and tables may be placed in \hl{\docenv{figure*}} or -\hl{\docenv{table*}} environments. To place figures or tables in the margin, -use the \hl{\docenv{marginfigure}} or \hl{\docenv{margintable}} environments as follows -(see figure~\ref{fig:marginfig}): - -\begin{marginfigure}% - \includegraphics[width=\linewidth]{helix} - \caption{This is a margin figure. The helix is defined by - $x = \cos(2\pi z)$, $y = \sin(2\pi z)$, and $z = [0, 2.7]$. The figure was - drawn using Asymptote (\url{http://asymptote.sf.net/}).} - \label{fig:marginfig} -\end{marginfigure} - -\begin{docspec} -\textbackslash begin\{marginfigure\}\\ - \qquad\textbackslash includegraphics\{helix\}\\ - \qquad\textbackslash caption\{This is a margin figure.\}\\ - \qquad\textbackslash label\{fig:marginfig\}\\ -\textbackslash end\{marginfigure\}\\ -\end{docspec} - -The \docenv{marginfigure} and \docenv{margintable} environments accept an optional parameter \docopt{offset} that adjusts the vertical position of the figure or table. See the ``\nameref{sec:sidenotes}'' section above for examples. The specifications are: -\begin{docspec} - \textbackslash{begin\{marginfigure\}[\docopt{offset}]}\\ - \qquad\ldots\\ - \textbackslash{end\{marginfigure\}}\\ - \mbox{}\\ - \textbackslash{begin\{margintable\}[\docopt{offset}]}\\ - \qquad\ldots\\ - \textbackslash{end\{margintable\}}\\ -\end{docspec} - -Figure~\ref{fig:fullfig} is an example of the \docenv{figure*} -environment and figure~\ref{fig:textfig} is an example of the normal -\docenv{figure} environment. - -\begin{figure*}[h] - \includegraphics[width=\linewidth]{sine.pdf}% - \caption{This graph shows $y = \sin x$ from about $x = [-10, 10]$. - \emph{Notice that this figure takes up the full page width.}}% - \label{fig:fullfig}% -\end{figure*} - -\begin{figure} - \includegraphics{hilbertcurves.pdf} -% \checkparity This is an \pageparity\ page.% - \caption{Hilbert curves of various degrees $n$. - \emph{Notice that this figure only takes up the main textblock width.}} - \label{fig:textfig} - %\zsavepos{pos:textfig} -\end{figure} - -Table~\ref{tab:normaltab} shows table created with the \docpkg{booktabs} -package. Notice the lack of vertical rules---they serve only to clutter -the table's data. - -\begin{table}[ht] - \centering - \fontfamily{ppl}\selectfont - \begin{tabular}{ll} - \toprule - Margin & Length \\ - \midrule - Paper width & \unit[8\nicefrac{1}{2}]{inches} \\ - Paper height & \unit[11]{inches} \\ - Textblock width & \unit[6\nicefrac{1}{2}]{inches} \\ - Textblock/sidenote gutter & \unit[\nicefrac{3}{8}]{inches} \\ - Sidenote width & \unit[2]{inches} \\ - \bottomrule - \end{tabular} - \caption{Here are the dimensions of the various margins used in the Tufte-handout class.} - \label{tab:normaltab} - %\zsavepos{pos:normaltab} -\end{table} - -\section{Full-width text blocks} - -In addition to the new float types, there is a \hl{\docenv{fullwidth}} -environment that stretches across the main text block and the sidenotes -area. - -\begin{Verbatim} -\begin{fullwidth} -Lorem ipsum dolor sit amet... -\end{fullwidth} -\end{Verbatim} - -\begin{fullwidth} -\small\itshape\lipsum[1] -\end{fullwidth} - -\section{Typography}\label{sec:typography} - -\subsection{Typefaces}\label{sec:typefaces}\index{typefaces} -If the Palatino, \textsf{Helvetica}, and \texttt{Bera Mono} typefaces are installed, this style -will use them automatically. Otherwise, we'll fall back on the Computer Modern -typefaces. - -\subsection{Letterspacing}\label{sec:letterspacing} -This document class includes two new commands and some improvements on -existing commands for letterspacing. - -When setting strings of \allcaps{ALL CAPS} or \smallcaps{small caps}, the -letter\-spacing---that is, the spacing between the letters---should be -increased slightly.\cite{Bringhurst2005} The \hl{\doccmd{allcaps}} command has proper letterspacing for -strings of \allcaps{FULL CAPITAL LETTERS}, and the \hl{\doccmd{smallcaps}} command -has letterspacing for \smallcaps{small capital letters}. These commands -will also automatically convert the case of the text to upper- or -lowercase, respectively. - -The \hl{\doccmd{textsc}} command has also been redefined to include -letterspacing. The case of the \doccmd{textsc} argument is left as is, -however. This allows one to use both uppercase and lowercase letters: -\textsc{The Initial Letters Of The Words In This Sentence Are Capitalized.} - - - -\section{Document Class Options}\label{sec:options} - -\index{class options|(} -The \doccls{tufte-book} class is based on the \LaTeX\ \doccls{book} -document class. Therefore, you can pass any of the typical book -options. There are a few options that are specific to the -\doccls{tufte-book} document class, however. - -The \hl{\docclsopt{a4paper}} option will set the paper size to \smallcaps{A4} instead of -the default \smallcaps{US} letter size. - -The \hl{\docclsopt{sfsidenotes}} option will set the sidenotes and title block in a -\textsf{sans serif} typeface instead of the default roman. - -The \hl{\docclsopt{twoside}} option will modify the running heads so that the page -number is printed on the outside edge (as opposed to always printing the page -number on the right-side edge in \hl{\docclsopt{oneside}} mode). - -The \hl{\docclsopt{symmetric}} option typesets the sidenotes on the outside edge of -the page. This is how books are traditionally printed, but is contrary to -Tufte's book design which sets the sidenotes on the right side of the page. -This option implicitly sets the \docclsopt{twoside} option. - -The \hl{\docclsopt{justified}} option sets all the text fully justified (flush left -and right). The default is to set the text ragged right. -The body text of Tufte's books are set ragged right. This prevents -needless hyphenation and makes it easier to read the text in the slightly -narrower column. - -The \hl{\docclsopt{bidi}} option loads the \docpkg{bidi} package which is used with -\tXeLaTeX\ to typeset bi-directional text. Since the \docpkg{bidi} -package needs to be loaded before the sidenotes and cite commands are defined, -it can't be loaded in the document preamble. - -The \hl{\docclsopt{debug}} option causes the Tufte-\LaTeX\ classes to output debug -information to the log file which is useful in troubleshooting bugs. It will -also cause the graphics to be replaced by outlines. - -The \hl{\docclsopt{nofonts}} option prevents the Tufte-\LaTeX\ classes from -automatically loading the Palatino and Helvetica typefaces. You should use -this option if you wish to load your own fonts. If you're using \tXeLaTeX, this -option is implied (\ie, the Palatino and Helvetica fonts aren't loaded if you -use \tXeLaTeX). - -The \hl{\docclsopt{nols}} option inhibits the letterspacing code. The Tufte-\LaTeX\ -classes try to load the appropriate letterspacing package (either pdf\TeX's -\docpkg{letterspace} package or the \docpkg{soul} package). If you're using -\tXeLaTeX\ with \docpkg{fontenc}, however, you should configure your own -letterspacing. - -The \hl{\docclsopt{notitlepage}} option causes \verb|\maketitle| to generate a title -block instead of a title page. The \doccls{book} class defaults to a title -page and the \doccls{handout} class defaults to the title block. There is an -analogous \hl{\docclsopt{titlepage}} option that forces \verb|\maketitle| to -generate a full title page instead of the title block. - -The \hl{\docclsopt{notoc}} option suppresses Tufte-\LaTeX's custom table of contents -(\textsc{toc}) design. The current \textsc{toc} design only shows unnumbered -chapter titles; it doesn't show sections or subsections. The \docclsopt{notoc} -option will revert to \LaTeX's \textsc{toc} design. - -\index{class options|)} - - -\chapter{Debug Stuff} - - -%% -% The back matter contains appendices, bibliographies, indices, glossaries, etc. - -\backmatter - - - -\bibliography{sample-handout} -\bibliographystyle{plainnat} - - -\printindex - -\end{document} - |