#LyX 2.2 created this file. For more info see http://www.lyx.org/ \lyxformat 506 \begin_document \begin_header \save_transient_properties true \origin /systemlyxdir/examples/ \textclass tufte-handout \use_default_options true \maintain_unincluded_children false \language english \language_package default \inputencoding auto \fontencoding global \font_roman "default" "default" \font_sans "helvet" "default" \font_typewriter "default" "default" \font_math "auto" "auto" \font_default_family default \use_non_tex_fonts false \font_sc false \font_osf false \font_sf_scale 100 100 \font_tt_scale 100 100 \graphics default \default_output_format pdf2 \output_sync 0 \bibtex_command bibtex \index_command default \paperfontsize default \spacing single \use_hyperref true \pdf_bookmarks true \pdf_bookmarksnumbered true \pdf_bookmarksopen true \pdf_bookmarksopenlevel 1 \pdf_breaklinks true \pdf_pdfborder true \pdf_colorlinks false \pdf_backref false \pdf_pdfusetitle true \papersize default \use_geometry true \use_package amsmath 1 \use_package amssymb 1 \use_package cancel 0 \use_package esint 1 \use_package mathdots 1 \use_package mathtools 0 \use_package mhchem 1 \use_package stackrel 0 \use_package stmaryrd 0 \use_package undertilde 0 \cite_engine basic \cite_engine_type default \biblio_style plain \use_bibtopic false \use_indices false \paperorientation portrait \suppress_date false \justification true \use_refstyle 0 \notefontcolor #0000ff \index Index \shortcut idx \color #008000 \end_index \secnumdepth 2 \tocdepth 2 \paragraph_separation indent \paragraph_indentation default \quotes_language english \papercolumns 1 \papersides 1 \paperpagestyle default \tracking_changes false \output_changes false \html_math_output 0 \html_css_as_file 0 \html_be_strict false \end_header \begin_body \begin_layout Standard \begin_inset Note Note status open \begin_layout Plain Layout \series bold Note \series default : To be able to view your file as PDF you must have the \SpecialChar LaTeX -package \family sans fpl \family default installed to your \SpecialChar LaTeX system. If you are using MiK\SpecialChar TeX , you will automatically be asked to install this package when previewing your file, if you are using \SpecialChar TeX Live, use \SpecialChar TeX Live's package manager. \end_layout \begin_layout Plain Layout \series bold Note 2 \series default : If you wish to compile to PDF with plain \SpecialChar LaTeX (instead of pdf\SpecialChar TeX ), there is currently a bug in the Tufte class that causes errors. You can add the class option 'nols' (put this in the \begin_inset Quotes eld \end_inset Custom \begin_inset Quotes erd \end_inset field of Document\SpecialChar menuseparator Settings \SpecialChar menuseparator Document Class) to get rid of the errors, but this also removes letterspacing, an important part of the Tufte design. \end_layout \end_inset \end_layout \begin_layout Standard \begin_inset Note Note status open \begin_layout Plain Layout If the \emph on Date \emph default is left out, the current date will be used. \end_layout \end_inset \end_layout \begin_layout Title An Example of the Usage of the Tufte-Handout Style \end_layout \begin_layout Author Tufte-LaTe \begin_inset ERT status collapsed \begin_layout Plain Layout {} \end_layout \end_inset X Developers and The Ly \begin_inset ERT status collapsed \begin_layout Plain Layout {} \end_layout \end_inset X Team \end_layout \begin_layout Abstract \noindent This document describes the \emph on Tufte handout \emph default \SpecialChar LaTeX document style. It also provides examples and comments on the style's use. It is based on the example file shiped with \emph on tufte-handout.cls \emph default , but adapted for the use with \SpecialChar LyX . \end_layout \begin_layout Standard The \family sans tufte-handout \family default document class \begin_inset Foot status collapsed \begin_layout Plain Layout Cf. \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://ctan.org/tex-archive/macros/latex/contrib/tufte-latex \end_layout \end_inset . \end_layout \end_inset defines a style similar to the style \noun on Edward Tufte \noun default 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 \family sans tufte-handout \family default document class and a style guide to its use. \end_layout \begin_layout Part First part \end_layout \begin_layout Section Page Layout \end_layout \begin_layout Subsection Headings and paragraph design \begin_inset CommandInset label LatexCommand label name "sec:headings" \end_inset \end_layout \begin_layout Standard This style provides \shape smallcaps a \shape default - and \shape smallcaps b \shape default -heads (that is, \emph on section \emph default and \emph on subsection \emph default , both numbered and non-numbered), as demonstrated above. \end_layout \begin_layout Standard If you need more than two levels of section headings, you'll have to define them yourself at the moment; \begin_inset Foot status collapsed \begin_layout Plain Layout See \begin_inset Quotes eld \end_inset Defining new sections \begin_inset Quotes erd \end_inset on page \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand pageref reference "sec:defining-sections" \end_inset for help with defining more heading levels. \end_layout \end_inset there are no pre-defined styles for anything below a \emph on subsection \emph default . As \noun on Bringhurst \noun default points out in \shape italic The Elements of Typographic Style \shape default , \begin_inset CommandInset citation LatexCommand cite key "Bringhurst2005" \end_inset you should \begin_inset Quotes eld \end_inset use as many levels of headings as you need: no more, and no fewer. \begin_inset Quotes erd \end_inset \end_layout \begin_layout Standard \begin_inset Flex NewThought status open \begin_layout Plain Layout In his later books \end_layout \end_inset , \begin_inset CommandInset citation LatexCommand cite key "Tufte2006" \end_inset Tufte starts each section with a bit of vertical space, a non-indented paragraph, and sets the first few words of the sentence in \shape smallcaps small caps \shape default . To accomplish this, use the \family typewriter NewThought \family default character style ( \family sans Edit\SpecialChar menuseparator TextStyle\SpecialChar menuseparator NewThought \family default ). \end_layout \begin_layout Subsection Sidenotes \end_layout \begin_layout Standard 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 footnotes will automatically be converted to sidenotes. \begin_inset Foot status open \begin_layout Plain Layout This is a sidenote that was entered using a \family typewriter footnote \family default . \end_layout \end_inset Alternatively, you can also use the \family typewriter Sidenote \family default inset directly; you'll find it in the \family sans Insert\SpecialChar menuseparator Custom Insets \family default menu. \begin_inset Flex Sidenote status open \begin_layout Plain Layout This is a sidenote that was entered using a \family typewriter sidenote \family default . \end_layout \end_inset \end_layout \begin_layout Standard If you like to place ancillary information in the margin without the sidenote mark (the superscript number), you can use the \family typewriter Marginnote \family default inset. \begin_inset Flex Marginnote status open \begin_layout Plain Layout This is Tufte's 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. \end_layout \end_inset The normal margin note will work as well, but it will look rather odd. \begin_inset Marginal status open \begin_layout Plain Layout This is a normal margin note. Don't use it. \end_layout \end_inset \end_layout \begin_layout Subsection References \end_layout \begin_layout Standard References are placed alongside their citations as sidenotes, as well. This can be accomplished using the normal citation command. \begin_inset Foot status collapsed \begin_layout Plain Layout The first paragraph of this document includes a citation. \end_layout \end_inset \end_layout \begin_layout Standard The complete list of references may also be printed automatically by using \family sans Insert\SpecialChar menuseparator Lists/TOC\SpecialChar menuseparator Bib\SpecialChar TeX \begin_inset space ~ \end_inset Bibliography \family default (see the end of this document for an example.) If you do not want to print a bibliography at the end of your document, place the \family sans Bib\SpecialChar TeX \begin_inset space ~ \end_inset Bibliography \family default inset inside a \SpecialChar LyX note and use the \SpecialChar LaTeX command \family typewriter \backslash nobibliography \family default the text. \end_layout \begin_layout Section Figures and Tables \end_layout \begin_layout Standard Images and graphics play an integral role in Tufte's work. In addition to the standard \emph on figure \emph default and \emph on tabular \emph default floats, this class provides special figure and table environments for full-widt h floats. \end_layout \begin_layout Standard Full page width figures and tables can be produced by using figure or table floats and clicking \emph on Span Columns \emph default in the float dialog. To place figures or tables in the margin, use the \emph on MarginFigure \emph default or \emph on MarginTable \emph default floats (see figure \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand ref reference "fig:marginfig" \end_inset ). \begin_inset Note Note status collapsed \begin_layout Plain Layout Note: unfortunately, the counting inside the \SpecialChar LyX view is wrong. Margin floats and normal floats are counted differently, whereas the use the same counter in the output. \end_layout \end_inset \begin_inset Float marginfigure wide false sideways false status open \begin_layout Plain Layout \begin_inset Box Boxed position "t" hor_pos "c" has_inner_box 1 inner_pos "t" use_parbox 0 use_makebox 0 width "100line%" special "none" height "1in" height_special "totalheight" thickness "0.4pt" separation "3pt" shadowsize "4pt" framecolor "black" backgroundcolor "none" status open \begin_layout Plain Layout \align center replace the box by your figure! \end_layout \end_inset \end_layout \begin_layout Plain Layout \begin_inset Caption Standard \begin_layout Plain Layout This is a margin figure. The figure will be put in the margin. \begin_inset CommandInset label LatexCommand label name "fig:marginfig" \end_inset \end_layout \end_inset \end_layout \end_inset \end_layout \begin_layout Standard \begin_inset Note Greyedout status open \begin_layout Plain Layout \series bold Note: \series default If you are using margin figures or tables you must use the default float placement option in the document settings under \family sans Float \begin_inset space ~ \end_inset Placement \family default . \end_layout \end_inset \end_layout \begin_layout Standard Figure \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand ref reference "fig:fullfig" \end_inset is an example of the wide figure float and figure \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand ref reference "fig:textfig" \end_inset is an example of the normal figure float. \begin_inset Float figure wide true sideways false status open \begin_layout Plain Layout \begin_inset Box Boxed position "t" hor_pos "c" has_inner_box 1 inner_pos "t" use_parbox 0 use_makebox 0 width "100line%" special "none" height "1in" height_special "totalheight" thickness "0.4pt" separation "3pt" shadowsize "4pt" framecolor "black" backgroundcolor "none" status open \begin_layout Plain Layout \align center replace the box by your figure! \end_layout \end_inset \end_layout \begin_layout Plain Layout \begin_inset Caption Standard \begin_layout Plain Layout This is a wide figure ( \emph on span columns \emph default ). \emph on Notice that this figure takes up the full page width. \emph default \begin_inset CommandInset label LatexCommand label name "fig:fullfig" \end_inset \end_layout \end_inset \end_layout \end_inset \end_layout \begin_layout Standard \begin_inset VSpace 6theight% \end_inset \end_layout \begin_layout Standard \begin_inset Float figure placement h wide false sideways false status open \begin_layout Plain Layout \begin_inset Box Boxed position "t" hor_pos "c" has_inner_box 1 inner_pos "t" use_parbox 0 use_makebox 0 width "100line%" special "none" height "1in" height_special "totalheight" thickness "0.4pt" separation "3pt" shadowsize "4pt" framecolor "black" backgroundcolor "none" status open \begin_layout Plain Layout \align center replace the box by your figure! \end_layout \end_inset \end_layout \begin_layout Plain Layout \begin_inset Caption Standard \begin_layout Plain Layout This is a normal figure. \emph on Notice that this figure only takes up the main textblock width. \emph default \begin_inset CommandInset label LatexCommand label name "fig:textfig" \end_inset \end_layout \end_inset \end_layout \end_inset \end_layout \begin_layout Standard Table \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand ref reference "tab:normaltab" \end_inset shows a table created with the \family typewriter booktabs \family default package (this is border style \begin_inset Quotes eld \end_inset formal \begin_inset Quotes erd \end_inset in the tabular dialog). Notice the lack of vertical rules—they serve only to clutter the table's data. \end_layout \begin_layout Standard \begin_inset Float table placement ht wide false sideways false status open \begin_layout Plain Layout \align center \begin_inset Tabular \begin_inset Text \begin_layout Plain Layout Margin \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout Length \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout Paper width \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout \begin_inset Formula $\unit[8\nicefrac{1}{2}]{inches}$ \end_inset \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout Paper height \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout \begin_inset Formula $\unit[11]{inches}$ \end_inset \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout Textblock width \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout \begin_inset Formula $\unit[6\nicefrac{1}{2}]{inches}$ \end_inset \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout Textblock/sidenote gutter \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout \begin_inset Formula $\unit[\nicefrac{3}{8}]{inches}$ \end_inset \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout Sidenote width \end_layout \end_inset \begin_inset Text \begin_layout Plain Layout \begin_inset Formula $\unit[2]{inches}$ \end_inset \end_layout \end_inset \end_inset \end_layout \begin_layout Plain Layout \begin_inset Caption Standard \begin_layout Plain Layout Here are the dimensions of the various margins used in the \emph on Tufte-handout \emph default class. \begin_inset CommandInset label LatexCommand label name "tab:normaltab" \end_inset \end_layout \end_inset \end_layout \end_inset \end_layout \begin_layout Section Full-width text blocks \end_layout \begin_layout Standard In addition to the new float types, there is a \emph on Full Width \emph default environment that stretches across the main text block and the sidenotes area and ragged left: \end_layout \begin_layout Full Width Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris. Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna. Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Mauris ut leo. Cras viverra metus rhoncus sem. Nulla et lectus vestibulum urna fringilla ultrices. Phasellus eu tellus sit amet tortor gravida placerat. Integer sapien est, iaculis in, pretium quis, viverra ac, nunc. Praesent eget sem vel leo ultrices bibendum. Aenean faucibus. Morbi dolor nulla, malesuada eu, pulvinar at, mollis ac, nulla. Curabitur auctor semper nulla. Donec varius orci eget risus. Duis nibh mi, congue eu, accumsan eleifend, sagittis quis, diam. Duis eget orci sit amet orci dignissim rutrum. \end_layout \begin_layout Part Second part \end_layout \begin_layout Section Typography \end_layout \begin_layout Subsection Typefaces \end_layout \begin_layout Standard If the \emph on Palatino \emph default and \emph on Bera Mono \emph default typefaces are installed, this style will use them automatically. Otherwise, we'll fall back on the \emph on Computer Modern \emph default typefaces. \end_layout \begin_layout Subsection Letterspacing \end_layout \begin_layout Standard This document class includes two new character styles and some improvements on existing commands for letterspacing. \end_layout \begin_layout Standard When setting strings of \begin_inset Flex AllCaps status open \begin_layout Plain Layout ALL CAPS \end_layout \end_inset or \begin_inset Flex SmallCaps status open \begin_layout Plain Layout small caps \end_layout \end_inset , the letterspacing—that is, the spacing between the letters—should be increased slightly. \begin_inset CommandInset citation LatexCommand cite key "Bringhurst2005" \end_inset The \emph on AllCaps \emph default character style ( \family sans Edit\SpecialChar menuseparator TextStyle\SpecialChar menuseparator AllCaps \family default ) has proper letterspacing for strings of \begin_inset Flex AllCaps status open \begin_layout Plain Layout FULL CAPITAL LETTERS \end_layout \end_inset , and the \emph on SmallCaps \emph default character style ( \family sans Edit\SpecialChar menuseparator TextStyle\SpecialChar menuseparator SmallCaps \family default ) has letterspacing for \begin_inset Flex SmallCaps status open \begin_layout Plain Layout small capital letters \end_layout \end_inset . These commands will also automatically convert the case of the text to upper- or lowercase, respectively. \end_layout \begin_layout Standard The normal \emph on Small Caps \emph default shape has also been redefined to include letterspacing. Its case is left as is, however. This allows one to use both uppercase and lowercase letters: \shape smallcaps The Initial Letters Of The Words In This Sentence Are Capitalized. \end_layout \begin_layout Section Customization \end_layout \begin_layout Subsection Document class options \end_layout \begin_layout Standard The \family sans tufte-handout \family default class is based on the \family sans article \family default document class. Therefore, you can pass any of the typical article options. There are a few options that are specific to the \family sans tufte-handout \family default document class, however. \end_layout \begin_layout Itemize The \emph on a4paper \emph default option will set the paper size to A4 instead of the default US letter size. \end_layout \begin_layout Itemize The \emph on sfsidenotes \emph default option will set the sidenotes in a \family sans sans serif \family default typeface instead of the default roman. \end_layout \begin_layout Itemize The \emph on twoside \emph default 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 \emph on oneside \emph default mode). \end_layout \begin_layout Itemize The \emph on symmetric \emph default 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 \emph on twoside \emph default option. \end_layout \begin_layout Itemize The \emph on justified \emph default 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. \end_layout \begin_layout Subsection Defining new sections \begin_inset CommandInset label LatexCommand label name "sec:defining-sections" \end_inset \end_layout \begin_layout Standard As mentioned on page \begin_inset space ~ \end_inset \begin_inset CommandInset ref LatexCommand pageref reference "sec:headings" \end_inset , the \family sans tufte-handout \family default document class only defines \emph on section \emph default and \emph on subsection \emph default headings. \end_layout \begin_layout Standard If you want to define, say, a \emph on paragraph \emph default heading, you could do it as follows: \end_layout \begin_layout LyX-Code \backslash makeatletter \end_layout \begin_layout LyX-Code \backslash renewcommand \backslash paragraph{% \end_layout \begin_layout LyX-Code \backslash @startsection{paragraph}% the name of the new section \end_layout \begin_layout LyX-Code {4}% the section level number \end_layout \begin_layout LyX-Code {0em}% indentation amount \end_layout \begin_layout LyX-Code { \backslash baselineskip}% amount of space to leave before heading \end_layout \begin_layout LyX-Code {-1.5em}% amount of space to leave after heading \end_layout \begin_layout LyX-Code { \backslash normalfont \backslash itshape}% style \end_layout \begin_layout LyX-Code } \end_layout \begin_layout LyX-Code \backslash makeatother \end_layout \begin_layout Standard Place that code in \family sans Document\SpecialChar menuseparator Settings\SpecialChar menuseparator Preamble \family default and you'll now be able to use \family typewriter \backslash paragraph \family default in \SpecialChar LaTeX mode. \end_layout \begin_layout Standard For more details on defining section levels, see \shape italic The \SpecialChar LaTeX \begin_inset space \space{} \end_inset Companion \shape default , \begin_inset CommandInset citation LatexCommand cite key "LComp2004" \end_inset or use the \emph on titlesec \emph default package. \end_layout \begin_layout Section Support \end_layout \begin_layout Subsection Package Dependencies \end_layout \begin_layout Standard The following is a list of packages that the \family sans tufte-handout \family default document class relies upon. Packages marked with an asterisk are optional. \end_layout \begin_layout Itemize geometry \end_layout \begin_layout Itemize ragged2e \end_layout \begin_layout Itemize chngpage \end_layout \begin_layout Itemize paralist \end_layout \begin_layout Itemize textcase \end_layout \begin_layout Itemize footmisc \end_layout \begin_layout Itemize natbib and bibentry \end_layout \begin_layout Itemize placeins \end_layout \begin_layout Itemize caption \end_layout \begin_layout Itemize fancyhdr \end_layout \begin_layout Itemize microtype* \end_layout \begin_layout Itemize soul* \end_layout \begin_layout Itemize palatino* \end_layout \begin_layout Itemize beramono* \end_layout \begin_layout Subsection Tufte-\SpecialChar LaTeX \begin_inset space \space{} \end_inset Website \end_layout \begin_layout Standard The website for the Tufte-\SpecialChar LaTeX \begin_inset space \space{} \end_inset packages is located at \begin_inset Flex URL status collapsed \begin_layout Plain Layout http://code.google.com/p/tufte-latex/ \end_layout \end_inset . On this website, you'll find links to the \begin_inset Flex SmallCaps status open \begin_layout Plain Layout svn \end_layout \end_inset repository of the tufte-latex project, mailing lists, bug tracker, and documentation. \end_layout \begin_layout Standard \begin_inset CommandInset bibtex LatexCommand bibtex bibfiles "biblioExample" options "plainnat" \end_inset \end_layout \end_body \end_document