From 2f1c00601a68a6df215ab6087adb3e830d91a225 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 9 Jun 2008 17:52:38 +0000 Subject: new xelatex package fontwrap (8jun08) git-svn-id: svn://tug.org/texlive/trunk@8619 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/tufte-latex/History.txt | 61 ++++ Master/texmf-dist/doc/latex/tufte-latex/README | 61 ++++ .../doc/latex/tufte-latex/graphics/helix.asy | 25 ++ .../doc/latex/tufte-latex/graphics/helix.pdf | Bin 0 -> 9436 bytes .../tufte-latex/graphics/hilberpgfcvs.tex.bak | 43 +++ .../latex/tufte-latex/graphics/hilbertcurves.pdf | Bin 0 -> 29629 bytes .../tufte-latex/graphics/hilbertrecursive.tex | 72 +++++ .../latex/tufte-latex/graphics/nasa_vision_sm.png | Bin 0 -> 47420 bytes .../doc/latex/tufte-latex/graphics/satir_graph.png | Bin 0 -> 9305 bytes .../doc/latex/tufte-latex/graphics/sine.asy | 16 + .../doc/latex/tufte-latex/graphics/sine.pdf | Bin 0 -> 6069 bytes .../doc/latex/tufte-latex/sample-handout.bib | 57 ++++ .../doc/latex/tufte-latex/sample-handout.pdf | Bin 0 -> 115605 bytes .../doc/latex/tufte-latex/sample-handout.tex | 329 +++++++++++++++++++++ 14 files changed, 664 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/History.txt create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/README create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.asy create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.pdf create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/graphics/hilberpgfcvs.tex.bak create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertcurves.pdf create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertrecursive.tex create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/graphics/nasa_vision_sm.png create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/graphics/satir_graph.png create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.asy create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.pdf create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/sample-handout.bib create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/sample-handout.pdf create mode 100644 Master/texmf-dist/doc/latex/tufte-latex/sample-handout.tex (limited to 'Master/texmf-dist/doc/latex/tufte-latex') diff --git a/Master/texmf-dist/doc/latex/tufte-latex/History.txt b/Master/texmf-dist/doc/latex/tufte-latex/History.txt new file mode 100644 index 00000000000..fb28daf9d80 --- /dev/null +++ b/Master/texmf-dist/doc/latex/tufte-latex/History.txt @@ -0,0 +1,61 @@ +== 2.0.0 / 2008-06-06 + +* Added `sfsidenotes' option to set the sidenotes and captions in the sans + serif font. +* Use the Palatino fonts if they're installed. +* Created `marginfig' and `margintab' environments. +* Added running heads. +* Fixed the alignment of sidenote numbers. +* Added \section and \subsection headings. +* Uses the Bera Mono fonts if they're installed. +* Added `symmetric' option to produce outside-margin sidenotes in two-sided + spreads. +* Added `justified' option to set the text fully justified. +* Rewrote sample-handout to illustrate the tufte-handout usage and serve as an + example of its features. + +== 1.2.3 / 2008-02-11 + +* To remove References section from sample-handout. +* Updated README.txt + +== 1.2.2 / 2008-02-09 + +* Use footmisc package to set \footnotes as sidenotes +* Use natbib package to set bibliography entries as sidenotes + +== 1.2.1 / 2007-10-21 + +* To assure existing \footnotes become \sidenotes + +== 1.2.0 / 2007-10-20 + +* Enhancements + * Added a4paper option (Kevin Godby) + * Have \margin{note,figure,table} use \@tufteh@marginfont +* Bug fix + * \@tufteh@overhang typo in figure*, table*, and fullwidth environments (Kevin Godby) + +== 1.1.0 / 2007-10-18 + +* To add some missing environments and commands: + * sidenote + * marginnote (no mark) + * marginfigure/table + * text-width figure/table (figure/table) + * page-width figure/table (figure*/table*) + * page-width environment (for custom minipage displays) +* To namespace raggedright +* To add margin font hook + +== 1.0.1 / 2007-09-24 + +* To correct README instructions. + +== 1.0.0 / 2007-09-24 + +* First public release + +== 0.1.0 / 2004-02-04 + +* Birthday! diff --git a/Master/texmf-dist/doc/latex/tufte-latex/README b/Master/texmf-dist/doc/latex/tufte-latex/README new file mode 100644 index 00000000000..741c5a32d3a --- /dev/null +++ b/Master/texmf-dist/doc/latex/tufte-latex/README @@ -0,0 +1,61 @@ +Hi, + +Welcome to the beginnings of Tufte LaTeX package to help you +produce Tufte style handouts, reports, and notes. + +== Quick Start + +Try typesetting sample.tex with the following sequence +of commands, + + pdflatex sample-handout + bibtex sample-handout + pdflatex sample-handout + pdflatex sample-handout + +The result should look like sample-handout.pdf. + +== Troubleshooting + +If you encounter errors of the form, + + ! LaTeX Error: File `paralist.sty' not found. + +you will need to obtain missing packages from CTAN . +For package installation instructions and answers to many other +questions, see the UK TeX FAQ, + + http://www.tex.ac.uk/cgi-bin/texfaq2html?introduction=yes + +or search the news:comp.text.tex group via, + + http://groups.google.com/group/comp.text.tex + +== Bugs/Features/Support + +For kudos, feature requests, patches, or support requests that you +feel are /particular/ to this Tufte LaTeX package, i.e. not a general +LaTeX issue, please use this project's issue tracker available at + + http://tufte-latex.googlecode.com + +== Contributing + +Patches are most welcome via the issue tracker! Submit a series of +high quality patches, and you'll find yourself a developer on this project. + +== License + +Copyright 2007-2008 Bil Kleb, Bill Wood, and Kevin Godby + +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 + + 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 "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. diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.asy b/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.asy new file mode 100644 index 00000000000..3d2ce8c9dc8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.asy @@ -0,0 +1,25 @@ +import graph3; + +size(0,200); + +usepackage("palatino"); +usepackage("mathpazo"); + +currentprojection=orthographic(4,6,3); + +real x(real t) {return cos(2pi*t);} +real y(real t) {return sin(2pi*t);} +real z(real t) {return t;} + +defaultpen(overwrite(SuppressQuiet)); + +path3 p=graph(x,y,z,0,2.7,operator ..); +bbox3 b=autolimits(min(p),max(p)); +aspect(b,1,1,1); + +xaxis(rotate(X)*"$x$",all=true,b,red,RightTicks(rotate(X)*Label,2,2)); +yaxis(rotate(Y)*"$y$",all=true,b,red,RightTicks(rotate(Y)*Label,2,2)); +zaxis("$z$",all=true,b,red,RightTicks); + +draw(p,Arrow); + diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.pdf b/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.pdf new file mode 100644 index 00000000000..b0b9116a041 Binary files /dev/null and b/Master/texmf-dist/doc/latex/tufte-latex/graphics/helix.pdf differ diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilberpgfcvs.tex.bak b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilberpgfcvs.tex.bak new file mode 100644 index 00000000000..3e781bd21e1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilberpgfcvs.tex.bak @@ -0,0 +1,43 @@ +\title{Hilbert Curves} +\author{} +\date{} + +\documentclass{tufte-handout} + +\usepackage{tikz} + +\usepackage[active,tightpage]{preview} +\PreviewEnvironment{tikzpicture} +\usetikzlibrary{lindenmayersystems,positioning} + +\begin{document} + +\pgfdeclarelindenmayersystem{Hilbert curve}{ + \symbol{X}{\pgflsystemdrawforward} + \symbol{+}{\pgflsystemturnright} % Explicitly define + and - symbols. + \symbol{-}{\pgflsystemturnleft} + \rule{A -> +BX-AXA-XB+} + \rule{B -> -AX+BXB+XA-} +} + +\def\scalefac{0.6} +% Draw a hilbert curve of order n +% Usage: +% \hilbertvurve[scale]{order} +\newcommand\hilbertcurve[2][1]{ +\tikz \draw[scale=\scalefac*#1,rotate=90,lindenmayer system={Hilbert curve, axiom=A, order=#2,angle=90}] + lindenmayer system; +} +\maketitle + +\begin{figure}[h!] +\begin{tikzpicture}[node distance=0cm,every path/.style={thin}] + \node[label={above:$n=1$}] (n1) {\hilbertcurve[18]{1}}; + \node[label={above:$n=2$},right=of n1] (n2) {\hilbertcurve[6]{2}}; + \node[label={above:$n=3$},right=of n2] (n3) {\hilbertcurve[2.6]{3}}; + \node[label={above:$n=4$},right=of n3] (n4) {\hilbertcurve[1.2]{4}}; + \node[label={above:$n=5$},right=of n4] (n5) {\hilbertcurve[0.58]{5}}; +\end{tikzpicture} +\end{figure} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertcurves.pdf b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertcurves.pdf new file mode 100644 index 00000000000..737c921bef2 Binary files /dev/null and b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertcurves.pdf differ diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertrecursive.tex b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertrecursive.tex new file mode 100644 index 00000000000..dc30ec12893 --- /dev/null +++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/hilbertrecursive.tex @@ -0,0 +1,72 @@ +% Draw Hilbert curves. +% Credits: Based on code by Marc van Dongen +% See: http://www.fauskes.net/pgftikzexamples/hilbert-curve/ +\title{Hilbert Curves} +\author{} +\date{} + +\documentclass{tufte-handout} + +\usepackage{tikz} + +\usepackage[active,tightpage]{preview} +\PreviewEnvironment{tikzpicture} +\usetikzlibrary{positioning} + +\begin{document} + +\newdimen\HilbertLastX +\newdimen\HilbertLastY +\newcounter{HilbertOrder} + +\def\DrawToNext#1#2{% + \advance \HilbertLastX by #1 + \advance \HilbertLastY by #2 + \pgfpathlineto{\pgfqpoint{\HilbertLastX}{\HilbertLastY}} + % Alternative implementation using plot streams: + % \pgfplotstreampoint{\pgfqpoint{\HilbertLastX}{\HilbertLastY}} +} + +% \Hilbert[right_x,right_y,left_x,left_x,up_x,up_y,down_x,down_y] +\def\Hilbert[#1,#2,#3,#4,#5,#6,#7,#8] { + \ifnum\value{HilbertOrder} > 0% + \addtocounter{HilbertOrder}{-1} + \Hilbert[#5,#6,#7,#8,#1,#2,#3,#4] + \DrawToNext {#1} {#2} + \Hilbert[#1,#2,#3,#4,#5,#6,#7,#8] + \DrawToNext {#5} {#6} + \Hilbert[#1,#2,#3,#4,#5,#6,#7,#8] + \DrawToNext {#3} {#4} + \Hilbert[#7,#8,#5,#6,#3,#4,#1,#2] + \addtocounter{HilbertOrder}{1} + \fi +} + + +% \hilbert((x,y),order) +\def\hilbert((#1,#2),#3){% + \advance \HilbertLastX by #1 + \advance \HilbertLastY by #2 + \pgfpathmoveto{\pgfqpoint{\HilbertLastX}{\HilbertLastY}} + % Alternative implementation using plot streams: + % \pgfplothandlerlineto + % \pgfplotstreamstart + % \pgfplotstreampoint{\pgfqpoint{\HilbertLastX}{\HilbertLastY}} + \setcounter{HilbertOrder}{#3} + \Hilbert[1mm,0mm,-1mm,0mm,0mm,1mm,0mm,-1mm] + \pgfusepath{stroke}% +} + +\def\scalefac{1} +\maketitle + +\begin{figure}[h!] +\begin{tikzpicture}[node distance=0cm,every path/.style={thin}] + \node[label={above:$n=1$}] (n1) {\tikz[scale=\scalefac*18] \hilbert((0mm,0mm),1);}; + \node[label={above:$n=2$},right=of n1] (n2) {\tikz[scale=\scalefac*6] \hilbert((0mm,0mm),2);}; + \node[label={above:$n=3$},right=of n2] (n3) {\tikz[scale=\scalefac*2.6] \hilbert((0mm,0mm),3);}; + \node[label={above:$n=4$},right=of n3] (n4) {\tikz[scale=\scalefac*1.2] \hilbert((0mm,0mm),4);}; + \node[label={above:$n=5$},right=of n4] (n5) {\tikz[scale=\scalefac*0.58] \hilbert((0mm,0mm),5);}; +\end{tikzpicture} +\end{figure} +\end{document} diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/nasa_vision_sm.png b/Master/texmf-dist/doc/latex/tufte-latex/graphics/nasa_vision_sm.png new file mode 100644 index 00000000000..2f1c324e679 Binary files /dev/null and b/Master/texmf-dist/doc/latex/tufte-latex/graphics/nasa_vision_sm.png differ diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/satir_graph.png b/Master/texmf-dist/doc/latex/tufte-latex/graphics/satir_graph.png new file mode 100644 index 00000000000..d9509bc791d Binary files /dev/null and b/Master/texmf-dist/doc/latex/tufte-latex/graphics/satir_graph.png differ diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.asy b/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.asy new file mode 100644 index 00000000000..6904735a10f --- /dev/null +++ b/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.asy @@ -0,0 +1,16 @@ +import graph; + +usepackage("palatino"); +usepackage("mathpazo"); + +size(7inches,3inches); +scale(true); + +real f(real x) { return sin(x); } +pair F(real x) { return (x, f(x)); } + +xaxis("$x$"); +yaxis("$y$"); + +draw(graph(f,-10.,10,operator ..), red); + diff --git a/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.pdf b/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.pdf new file mode 100644 index 00000000000..94331fabb79 Binary files /dev/null and b/Master/texmf-dist/doc/latex/tufte-latex/graphics/sine.pdf differ diff --git a/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.bib b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.bib new file mode 100644 index 00000000000..81715a5dd0c --- /dev/null +++ b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.bib @@ -0,0 +1,57 @@ +@BOOK{Tufte2006, + author = {Edward R. Tufte}, + title = {Beautiful Evidence}, + year = {2006}, + publisher = {Graphics Press, {LLC}}, + month = {May}, + edition = {First}, + place = {Cheshire, Connecticut}, + isbn = {0961392177} +} + +@BOOK{Tufte2001, + author = {Edward R. Tufte}, + title = {The Visual Display of Quantitative Information}, + publisher = {Graphics Press}, + year = {2001}, + address = {Cheshire, Connecticut}, + isbn = {0961392142} +} + +@BOOK{Tufte1990, + author = {Edward R. Tufte}, + title = {Envisioning Information}, + publisher = {Graphics Press}, + year = {1990}, + address = {Cheshire, Connecticut}, + isbn = {0961392118} +} + +@BOOK{Tufte1997, + author = {Edward R. Tufte}, + title = {Visual Explanations}, + publisher = {Graphics Press}, + year = {1997}, + address = {Cheshire, Connecticut}, + isbn = {0-9613921-2-6} +} + +@BOOK{Bringhurst2005, + author = {Robert Bringhurst}, + title = {The Elements of Typography}, + publisher = {Hartley \& Marks}, + year = {2005}, + edition = {3.1}, + isbn = {0-88179-205-5} +} + +@BOOK{Mittelbach2004, + author = {Frank Mittelbach and Michel Goossens}, + title = {The \LaTeX\ Companion}, + publisher = {Addison--Wesley}, + year = {2004}, + edition = {Second}, + isbn = {0-201-36299-6} +} + + diff --git a/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.pdf b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.pdf new file mode 100644 index 00000000000..c6eae315520 Binary files /dev/null and b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.pdf differ diff --git a/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.tex b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.tex new file mode 100644 index 00000000000..d4e56b2ce77 --- /dev/null +++ b/Master/texmf-dist/doc/latex/tufte-latex/sample-handout.tex @@ -0,0 +1,329 @@ +\documentclass{tufte-handout} + +\usepackage{amsmath} + +% Set up the images/graphics package +\usepackage{graphicx} +\setkeys{Gin}{width=\linewidth,totalheight=\textheight,keepaspectratio} +\graphicspath{{graphics/}} + +\usepackage{mcaption} % FIXME move to .cls file + +%\title{An Example of the Usage of the Tufte-Handout Style\thanks{Inspired by Edward~R. Tufte!}} +\title{An Example of the Usage of the Tufte-Handout Style} +\author{The Tufte-\LaTeX\ Developers} +%\date{22 February 2008} % if the \date{} command is left out, the current date will be used + +\usepackage{helvet} + +% The following package makes prettier tables. We're all about the bling! +\usepackage{booktabs} + +% The units package provides nice, non-stacked fractions and better spacing +% for units. +\usepackage{units} + +% The fancyvrb package lets us customize the formatting of verbatim +% environments. We use a slightly smaller font. +\usepackage{fancyvrb} +\fvset{fontsize=\normalsize} + +\usepackage{multicol} + +\usepackage[savepos]{zref} + +\usepackage{lipsum} + +\usepackage{url} +\urldef{\asyurl}\url{http://asymptote.sf.net/} + +\begin{document} + +\maketitle % this prints the handout title, author, and date + +\begin{abstract} +\noindent This document describes the Tufte handout \LaTeX\ document style. +It also provides examples and comments on the style's use. +\end{abstract} + +%\printclassoptions + +The \Verb|tufte-handout| document class defines 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 \Verb|tufte-handout| document class +and a style guide to its use. + +\section{Page Layout}\label{sec:page-layout} +\subsection{Headings}\label{sec: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;\sidenote{See see ``Defining new sections'' on +page~\pageref{sec:defining-sections} for help with defining more heading +levels.} 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-handout class will emit an error if you try to use +\Verb|\subsubsection| and smaller headings. + +%\medskip +%\begin{fullwidth} +%\begin{Verbatim} +%! Package tufte-handout Error: \subsubsection is undefined by this class. +%(tufte-handout) See Robert Bringhurst's _The Elements of +%(tufte-handout) Typographic Style_, section 4.2.2. +%(tufte-handout) \subsubsection was used. +%\end{Verbatim} +%\end{fullwidth} +%\medskip + +% 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 \Verb|\newthought| command: + +\Verb|\newthought{In his later books}, Tufte starts|\ldots + +\subsection{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 \Verb|\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 \Verb|\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.} + +\subsection{References} +References are placed alongside their citations as sidenotes, +as well. This can be accomplished using the normal \Verb|\cite| +command.\footnote{The first paragraph of this document includes a citation.} + +The complete list of references may also be printed automatically by using +the \Verb|\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 \Verb|\nobibliography| command in its place. + +To enter multiple citations at one +location,\cite{Tufte2006}\cite{Tufte1990} you will need to use multiple +\Verb|\cite| commands: \Verb|\cite{Tufte2006}| \Verb|\cite{Tufte1990}|. Each +\Verb|\cite| command will generate its own sidenote and its own sidenote +number. + + +\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 \Verb|figure| and \Verb|tabular| environments, +this style provides special figure and table environments for full-width +floats. + +Full page width figures and tables may be placed in \texttt{figure*} or +\texttt{table*} environments. To place figures or tables in the margin, +use the \Verb|marginfigure| or \Verb|margintable| environments as follows +(see figure~\ref{fig:marginfig}): +\begin{marginfigure} + \includegraphics[width=\marginparwidth]{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 (\asyurl).} + \label{fig:marginfig} +\end{marginfigure} +\begin{Verbatim} +\begin{marginfigure} + \includegraphics{blah} + \caption{This figure is in the margin.} +\end{marginfigure} +\end{Verbatim} + + +Figure~\ref{fig:fullfig} is an example of the \Verb|figure*| +environment and figure~\ref{fig:textfig} is an example of the normal +\Verb|figure| environment. +\begin{figure*} + \includegraphics{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} + \zsavepos{pos:fullfig} +\end{figure*} + +\begin{figure} + \includegraphics{hilbertcurves.pdf} + \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 \texttt{booktabs} +package. Notice the lack of vertical rules---they serve only to clutter +the table's data. + +\begin{table}[ht] + \centering + \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 \texttt{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} +If the Palatino and 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 +letterspacing---that is, the spacing between the letters---should be +increased slightly.\cite{Bringhurst2005} The \Verb|\allcaps| command has proper letterspacing for +strings of \allcaps{FULL CAPITAL LETTERS}, and the \Verb|\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 \Verb|\textsc| command has also been redefined to include +letterspacing. The case of the \Verb|\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{Customization}\label{sec:customization} +\subsection{Document class options}\label{sec:options} +The \Verb|tufte-handout| class is based on the \LaTeX\ \Verb|article| +document class. Therefore, you can pass any of the typical article +options. There are a few options that are specific to the +\Verb|tufte-handout| document class, however. + +The \Verb|a4paper| option will set the paper size to \smallcaps{A4} instead of +the default \smallcaps{US} letter size. + +The \Verb|sfsidenotes| option will set the sidenotes in a \textsf{sans +serif} typeface instead of the default roman. + +The \Verb|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 \Verb|oneside| mode). + +The \Verb|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 \Verb|twoside| option. + +The \Verb|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. + +\subsection{Defining new sections}\label{sec:defining-sections} +As mentioned on page~\pageref{sec:headings}, the \Verb|tufte-handout| +document class only defines \Verb|\section| and \Verb|\subsection| +headings. + +If you wanted to define, say, a \Verb|\paragraph| heading, you could do it +as follows: + +\begin{Verbatim} +\makeatletter +\renewcommand\paragraph{\@startsection{paragraph}% the name of the new section + {4}% the section level number + {0em}% indentation amount + {\baselineskip}% amount of space to leave before heading + {-1.5em}% amount of space to leave after heading + {\normalfont\itshape}% style +} +\makeatother +\end{Verbatim} + +Place that code in the preamble of your document and you'll now be able to use +\Verb|\paragraph|. + +For more details on defining section levels, see \textit{The \LaTeX\ +Companion},\cite{Mittelbach2004} or use the \Verb|titlesec| package. + + +\section{Installation}\label{sec:installation} +To install the \Verb|tufte-handout| class, simply drop the +\Verb|tufte-handout.cls| file into the same directory as your \Verb|.tex| +file. + +% TODO add instructions for installing it globally + + +\section{Support}\label{sec:support} + +\subsection{Package Dependencies}\label{sec:dependencies} +The following is a list of packages that the \Verb|tufte-handout| document +class relies upon. Packages marked with an asterisk are optional. +\begin{multicols}{2} +\begin{itemize} + \item geometry + \item ragged2e + \item chngpage + \item paralist + \item textcase + \item footmisc + \item natbib and bibentry + \item placeins + \item caption + \item fancyhdr + \item microtype* + \item soul* + \item palatino* + \item beramono* +\end{itemize} +\end{multicols} + +\subsection{Tufte-\LaTeX\ Website}\label{sec:website} +The website for the Tufte-\LaTeX\ packages is located at +\url{http://code.google.com/p/tufte-latex/}. On our website, you'll find +links to our \smallcaps{svn} repository, mailing lists, bug tracker, and documentation. + + +\bibliography{sample-handout} +\bibliographystyle{plainnat} + +%\section{Float Positions---DEBUG} +%Full figure: $x=\zposx{pos:fullfig}$, $y=\zposy{pos:fullfig}$ +%Text figure: $x=\zposx{pos:textfig}$, $y=\zposy{pos:textfig}$ +%Normal table: $x=\zposx{pos:normaltab}$, $y=\zposy{pos:normaltab}$ + +\end{document} -- cgit v1.2.3