1 #LyX 1.6.5svn created this file. For more info see http://www.lyx.org/
5 \textclass tufte-handout
6 \use_default_options false
11 \font_typewriter default
12 \font_default_family default
19 \paperfontsize default
28 \paperorientation portrait
31 \paragraph_separation indent
33 \quotes_language english
36 \paperpagestyle default
37 \tracking_changes false
45 \begin_layout Standard
46 \begin_inset Note Note
49 \begin_layout Plain Layout
54 is left out, the current date will be used.
63 An Example of the Usage of the Tufte-Handout Style
71 \begin_layout Plain Layout
78 X Developers and The Ly
82 \begin_layout Plain Layout
92 \begin_layout Abstract
94 This document describes the
99 It also provides examples and comments on the style's use.
100 It is based on the example file shiped with
104 , but adapted for the use with LyX.
107 \begin_layout Standard
116 \begin_layout Plain Layout
119 \begin_inset Flex URL
122 \begin_layout Plain Layout
124 http://ctan.org/tex-archive/macros/latex/contrib/tufte-latex
134 defines a style similar to the style
138 uses in his books and handouts.
139 Tufte's style is known for its extensive use of sidenotes, tight integration
140 of graphics with text, and well-set typography.
141 This document aims to be at once a demonstration of the features of the
146 document class and a style guide to its use.
153 \begin_layout Section*
155 \begin_inset CommandInset label
157 name "sec:page-layout"
164 \begin_layout Subsection*
165 Headings and paragraph design
166 \begin_inset CommandInset label
175 \begin_layout Standard
192 , both numbered and non-numbered), as demonstrated above.
195 \begin_layout Standard
196 If you need more than two levels of section headings, you'll have to define
197 them yourself at the moment;
201 \begin_layout Plain Layout
203 \begin_inset Quotes eld
206 Defining new sections
207 \begin_inset Quotes erd
215 \begin_inset CommandInset ref
217 reference "sec:defining-sections"
221 for help with defining more heading levels.
226 there are no pre-defined styles for anything below a
237 The Elements of Typographic Style
240 \begin_inset CommandInset citation
247 \begin_inset Quotes eld
250 use as many levels of headings as you need: no more, and no fewer.
251 \begin_inset Quotes erd
257 \begin_layout Standard
258 \begin_inset Flex NewThought
261 \begin_layout Plain Layout
268 \begin_inset CommandInset citation
274 Tufte starts each section with a bit of vertical space, a non-indented
275 paragraph, and sets the first few words of the sentence in
280 To accomplish this, use the
286 Edit\SpecialChar \menuseparator
287 TextStyle\SpecialChar \menuseparator
293 \begin_layout Subsection*
295 \begin_inset CommandInset label
304 \begin_layout Standard
305 One of the most prominent and distinctive features of this style is the
306 extensive use of sidenotes.
307 There is a wide margin to provide ample room for sidenotes and small figures.
308 Any footnotes will automatically be converted to sidenotes.
312 \begin_layout Plain Layout
313 This is a sidenote that was entered using a
322 Alternatively, you can also use the
326 inset directly; you'll find it in the
328 Insert\SpecialChar \menuseparator
332 \begin_inset Flex Sidenote
335 \begin_layout Plain Layout
336 This is a sidenote that was entered using a
348 \begin_layout Standard
349 If you like to place ancillary information in the margin without the sidenote
350 mark (the superscript number), you can use the
356 \begin_inset Flex Marginnote
359 \begin_layout Plain Layout
360 This is Tufte's margin note.
361 Notice that there isn't a number preceding the note, and there is no number
362 in the main text where this note was written.
367 The normal margin note will work as well, but it will look rather odd.
368 \begin_inset Marginal
371 \begin_layout Plain Layout
372 This is a normal margin note.
381 \begin_layout Subsection*
385 \begin_layout Standard
386 References are placed alongside their citations as sidenotes, as well.
387 This can be accomplished using the normal citation command.
391 \begin_layout Plain Layout
392 The first paragraph of this document includes a citation.
400 \begin_layout Standard
401 The complete list of references may also be printed automatically by using
404 Insert\SpecialChar \menuseparator
405 Lists/TOC\SpecialChar \menuseparator
412 (see the end of this document for an example.) If you do not want to print
413 a bibliography at the end of your document, place the
421 inset inside a LyX note and use the LaTeX command
430 \begin_layout Section*
432 \begin_inset CommandInset label
434 name "sec:figures-and-tables"
441 \begin_layout Standard
442 Images and graphics play an integral role in Tufte's work.
443 In addition to the standard
451 floats, this class provides special figure and table environments for full-widt
455 \begin_layout Standard
456 Full page width figures and tables can be produced by using figure or table
462 To place figures or tables in the margin, use the
475 \begin_inset CommandInset ref
477 reference "fig:marginfig"
482 \begin_inset Note Note
485 \begin_layout Plain Layout
486 Note: unfortunately, the counting inside the LyX view is wrong.
487 Margin floats and normal floats are counted differently, whereas the use
488 the same counter in the output.
494 \begin_inset Float marginfigure
499 \begin_layout Plain Layout
500 \begin_inset Box Boxed
509 height_special "totalheight"
512 \begin_layout Plain Layout
514 replace the box by your figure!
522 \begin_layout Plain Layout
525 \begin_layout Plain Layout
526 This is a margin figure.
527 The figure will be put in the margin.
528 \begin_inset CommandInset label
547 \begin_layout Standard
553 \begin_inset CommandInset ref
555 reference "fig:fullfig"
559 is an example of the wide figure float and figure
564 \begin_inset CommandInset ref
566 reference "fig:textfig"
570 is an example of the normal figure float.
572 \begin_inset Float figure
577 \begin_layout Plain Layout
578 \begin_inset Box Boxed
587 height_special "totalheight"
590 \begin_layout Plain Layout
592 replace the box by your figure!
600 \begin_layout Plain Layout
603 \begin_layout Plain Layout
604 This is a wide figure (
611 Notice that this figure takes up the full page width.
614 \begin_inset CommandInset label
633 \begin_layout Standard
634 \begin_inset Float figure
640 \begin_layout Plain Layout
641 \begin_inset Box Boxed
650 height_special "totalheight"
653 \begin_layout Plain Layout
655 replace the box by your figure!
663 \begin_layout Plain Layout
666 \begin_layout Plain Layout
667 This is a normal figure.
670 Notice that this figure only takes up the main textblock width.
673 \begin_inset CommandInset label
692 \begin_layout Standard
698 \begin_inset CommandInset ref
700 reference "tab:normaltab"
704 shows a table created with the
708 package (this is border style
709 \begin_inset Quotes eld
713 \begin_inset Quotes erd
716 in the tabular dialog).
717 Notice the lack of vertical rules---they serve only to clutter the table's
721 \begin_layout Standard
722 \begin_inset Float table
728 \begin_layout Plain Layout
731 <lyxtabular version="3" rows="6" columns="2">
732 <features booktabs="true">
733 <column alignment="left" valignment="top" width="0">
734 <column alignment="left" valignment="top" width="0">
736 <cell alignment="left" valignment="top" topline="true" bottomline="true" usebox="none">
739 \begin_layout Plain Layout
745 <cell alignment="left" valignment="top" topline="true" bottomline="true" usebox="none">
748 \begin_layout Plain Layout
756 <cell alignment="left" valignment="top" usebox="none">
759 \begin_layout Plain Layout
765 <cell alignment="left" valignment="top" usebox="none">
768 \begin_layout Plain Layout
769 \begin_inset Formula $\unit[8\nicefrac{1}{2}]{inches}$
779 <cell alignment="left" valignment="top" usebox="none">
782 \begin_layout Plain Layout
788 <cell alignment="left" valignment="top" usebox="none">
791 \begin_layout Plain Layout
792 \begin_inset Formula $\unit[11]{inches}$
802 <cell alignment="left" valignment="top" usebox="none">
805 \begin_layout Plain Layout
811 <cell alignment="left" valignment="top" usebox="none">
814 \begin_layout Plain Layout
815 \begin_inset Formula $\unit[6\nicefrac{1}{2}]{inches}$
825 <cell alignment="left" valignment="top" usebox="none">
828 \begin_layout Plain Layout
829 Textblock/sidenote gutter
834 <cell alignment="left" valignment="top" usebox="none">
837 \begin_layout Plain Layout
838 \begin_inset Formula $\unit[\nicefrac{3}{8}]{inches}$
848 <cell alignment="left" valignment="top" bottomline="true" usebox="none">
851 \begin_layout Plain Layout
857 <cell alignment="left" valignment="top" bottomline="true" usebox="none">
860 \begin_layout Plain Layout
861 \begin_inset Formula $\unit[2]{inches}$
877 \begin_layout Plain Layout
880 \begin_layout Plain Layout
881 Here are the dimensions of the various margins used in the
886 \begin_inset CommandInset label
905 \begin_layout Section*
906 Full-width text blocks
909 \begin_layout Standard
910 In addition to the new float types, there is a
914 environment that stretches across the main text block and the sidenotes
915 area and ragged left:
918 \begin_layout Full Width
919 Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
920 Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis.
921 Curabitur dictum gravida mauris.
922 Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna.
923 Donec vehicula augue eu neque.
924 Pellentesque habitant morbi tristique senectus et netus et malesuada fames
927 Cras viverra metus rhoncus sem.
928 Nulla et lectus vestibulum urna fringilla ultrices.
929 Phasellus eu tellus sit amet tortor gravida placerat.
930 Integer sapien est, iaculis in, pretium quis, viverra ac, nunc.
931 Praesent eget sem vel leo ultrices bibendum.
933 Morbi dolor nulla, malesuada eu, pulvinar at, mollis ac, nulla.
934 Curabitur auctor semper nulla.
935 Donec varius orci eget risus.
936 Duis nibh mi, congue eu, accumsan eleifend, sagittis quis, diam.
937 Duis eget orci sit amet orci dignissim rutrum.
944 \begin_layout Section*
946 \begin_inset CommandInset label
948 name "sec:typography"
955 \begin_layout Subsection*
957 \begin_inset CommandInset label
966 \begin_layout Standard
975 typefaces are installed, this style will use them automatically.
976 Otherwise, we'll fall back on the
983 \begin_layout Subsection*
985 \begin_inset CommandInset label
987 name "sec:letterspacing"
994 \begin_layout Standard
995 This document class includes two new character styles and some improvements
996 on existing commands for letterspacing.
999 \begin_layout Standard
1000 When setting strings of
1001 \begin_inset Flex AllCaps
1004 \begin_layout Plain Layout
1011 \begin_inset Flex SmallCaps
1014 \begin_layout Plain Layout
1020 , the letterspacing---that is, the spacing between the letters---should
1021 be increased slightly.
1022 \begin_inset CommandInset citation
1024 key "Bringhurst2005"
1034 Edit\SpecialChar \menuseparator
1035 TextStyle\SpecialChar \menuseparator
1038 ) has proper letterspacing for strings of
1039 \begin_inset Flex AllCaps
1042 \begin_layout Plain Layout
1043 FULL CAPITAL LETTERS
1054 Edit\SpecialChar \menuseparator
1055 TextStyle\SpecialChar \menuseparator
1058 ) has letterspacing for
1059 \begin_inset Flex SmallCaps
1062 \begin_layout Plain Layout
1063 small capital letters
1069 These commands will also automatically convert the case of the text to
1070 upper- or lowercase, respectively.
1073 \begin_layout Standard
1078 shape has also been redefined to include letterspacing.
1079 Its case is left as is, however.
1080 This allows one to use both uppercase and lowercase letters:
1082 The Initial Letters Of The Words In This Sentence Are Capitalized.
1085 \begin_layout Section*
1087 \begin_inset CommandInset label
1089 name "sec:customization"
1096 \begin_layout Subsection*
1097 Document class options
1098 \begin_inset CommandInset label
1107 \begin_layout Standard
1112 class is based on the
1117 Therefore, you can pass any of the typical article options.
1118 There are a few options that are specific to the
1122 document class, however.
1125 \begin_layout Itemize
1130 option will set the paper size to A4 instead of the default US letter size.
1133 \begin_layout Itemize
1138 option will set the sidenotes in a
1142 typeface instead of the default roman.
1145 \begin_layout Itemize
1150 option will modify the running heads so that the page number is printed
1151 on the outside edge (as opposed to always printing the page number on the
1159 \begin_layout Itemize
1164 option typesets the sidenotes on the outside edge of the page.
1165 This is how books are traditionally printed, but is contrary to Tufte's
1166 book design which sets the sidenotes on the right side of the page.
1167 This option implicitly sets the
1174 \begin_layout Itemize
1179 option sets all the text fully justified (flush left and right).
1180 The default is to set the text ragged right.
1181 The body text of Tufte's books are set ragged right.
1182 This prevents needless hyphenation and makes it easier to read the text
1183 in the slightly narrower column.
1186 \begin_layout Subsection*
1187 Defining new sections
1188 \begin_inset CommandInset label
1190 name "sec:defining-sections"
1197 \begin_layout Standard
1198 As mentioned on page
1199 \begin_inset space ~
1203 \begin_inset CommandInset ref
1204 LatexCommand pageref
1205 reference "sec:headings"
1213 document class only defines
1224 \begin_layout Standard
1225 If you want to define, say, a
1229 heading, you could do it as follows:
1232 \begin_layout LyX-Code
1238 \begin_layout LyX-Code
1246 \begin_layout LyX-Code
1249 @startsection{paragraph}% the name of the new section
1252 \begin_layout LyX-Code
1253 {4}% the section level number
1256 \begin_layout LyX-Code
1257 {0em}% indentation amount
1260 \begin_layout LyX-Code
1263 baselineskip}% amount of space to leave before heading
1266 \begin_layout LyX-Code
1267 {-1.5em}% amount of space to leave after heading
1270 \begin_layout LyX-Code
1278 \begin_layout LyX-Code
1282 \begin_layout LyX-Code
1288 \begin_layout Standard
1291 Document\SpecialChar \menuseparator
1292 Settings\SpecialChar \menuseparator
1295 and you'll now be able to use
1304 \begin_layout Standard
1305 For more details on defining section levels, see
1308 \begin_inset space \space{}
1314 \begin_inset CommandInset citation
1327 \begin_layout Section*
1329 \begin_inset CommandInset label
1338 \begin_layout Subsection*
1339 Package Dependencies
1340 \begin_inset CommandInset label
1342 name "sec:dependencies"
1349 \begin_layout Standard
1350 The following is a list of packages that the
1354 document class relies upon.
1355 Packages marked with an asterisk are optional.
1358 \begin_layout Itemize
1362 \begin_layout Itemize
1366 \begin_layout Itemize
1370 \begin_layout Itemize
1374 \begin_layout Itemize
1378 \begin_layout Itemize
1382 \begin_layout Itemize
1386 \begin_layout Itemize
1390 \begin_layout Itemize
1394 \begin_layout Itemize
1398 \begin_layout Itemize
1402 \begin_layout Itemize
1406 \begin_layout Itemize
1410 \begin_layout Itemize
1414 \begin_layout Subsection*
1416 \begin_inset space \space{}
1420 \begin_inset CommandInset label
1429 \begin_layout Standard
1430 The website for the Tufte-LaTeX
1431 \begin_inset space \space{}
1434 packages is located at
1435 \begin_inset Flex URL
1438 \begin_layout Plain Layout
1440 http://code.google.com/p/tufte-latex/
1446 On this website, you'll find links to the
1447 \begin_inset Flex SmallCaps
1450 \begin_layout Plain Layout
1456 repository of the tufte-latex project, mailing lists, bug tracker, and
1460 \begin_layout Standard
1461 \begin_inset CommandInset bibtex
1463 bibfiles "biblioExample"