1 #LyX 2.2 created this file. For more info see http://www.lyx.org/
5 \save_transient_properties true
6 \origin /systemlyxdir/examples/
7 \textclass tufte-handout
8 \use_default_options true
9 \maintain_unincluded_children false
11 \language_package default
14 \font_roman "default" "default"
15 \font_sans "helvet" "default"
16 \font_typewriter "default" "default"
17 \font_math "auto" "auto"
18 \font_default_family default
19 \use_non_tex_fonts false
22 \font_sf_scale 100 100
23 \font_tt_scale 100 100
25 \default_output_format pdf2
27 \bibtex_command bibtex
28 \index_command default
29 \paperfontsize default
33 \pdf_bookmarksnumbered true
34 \pdf_bookmarksopen true
35 \pdf_bookmarksopenlevel 1
43 \use_package amsmath 1
44 \use_package amssymb 1
47 \use_package mathdots 1
48 \use_package mathtools 0
50 \use_package stackrel 0
51 \use_package stmaryrd 0
52 \use_package undertilde 0
54 \cite_engine_type default
58 \paperorientation portrait
62 \notefontcolor #0000ff
69 \paragraph_separation indent
70 \paragraph_indentation default
71 \quotes_language english
74 \paperpagestyle default
75 \tracking_changes false
84 \begin_layout Standard
85 \begin_inset Note Note
88 \begin_layout Plain Layout
93 : To be able to view your file as PDF you must have the \SpecialChar LaTeX
98 installed to your \SpecialChar LaTeX
100 If you are using MiK\SpecialChar TeX
101 , you will automatically be asked to install this package
102 when previewing your file, if you are using \SpecialChar TeX
103 Live, use \SpecialChar TeX
104 Live's package manager.
107 \begin_layout Plain Layout
112 : If you wish to compile to PDF with plain \SpecialChar LaTeX
113 (instead of pdf\SpecialChar TeX
114 ), there is currently
115 a bug in the Tufte class that causes errors.
116 You can add the class option 'nols' (put this in the
117 \begin_inset Quotes eld
121 \begin_inset Quotes erd
124 field of Document\SpecialChar menuseparator
125 Settings \SpecialChar menuseparator
126 Document Class) to get rid of the errors, but
127 this also removes letterspacing, an important part of the Tufte design.
135 \begin_layout Standard
136 \begin_inset Note Note
139 \begin_layout Plain Layout
144 is left out, the current date will be used.
153 An Example of the Usage of the Tufte-Handout Style
161 \begin_layout Plain Layout
168 X Developers and The Ly
172 \begin_layout Plain Layout
182 \begin_layout Abstract
184 This document describes the
190 It also provides examples and comments on the style's use.
191 It is based on the example file shiped with
195 , but adapted for the use with \SpecialChar LyX
199 \begin_layout Standard
208 \begin_layout Plain Layout
211 \begin_inset Flex URL
214 \begin_layout Plain Layout
216 http://ctan.org/tex-archive/macros/latex/contrib/tufte-latex
226 defines a style similar to the style
230 uses in his books and handouts.
231 Tufte's style is known for its extensive use of sidenotes, tight integration
232 of graphics with text, and well-set typography.
233 This document aims to be at once a demonstration of the features of the
238 document class and a style guide to its use.
245 \begin_layout Section
249 \begin_layout Subsection
250 Headings and paragraph design
251 \begin_inset CommandInset label
260 \begin_layout Standard
277 , both numbered and non-numbered), as demonstrated above.
280 \begin_layout Standard
281 If you need more than two levels of section headings, you'll have to define
282 them yourself at the moment;
286 \begin_layout Plain Layout
288 \begin_inset Quotes eld
291 Defining new sections
292 \begin_inset Quotes erd
300 \begin_inset CommandInset ref
302 reference "sec:defining-sections"
306 for help with defining more heading levels.
311 there are no pre-defined styles for anything below a
322 The Elements of Typographic Style
325 \begin_inset CommandInset citation
332 \begin_inset Quotes eld
335 use as many levels of headings as you need: no more, and no fewer.
336 \begin_inset Quotes erd
342 \begin_layout Standard
343 \begin_inset Flex NewThought
346 \begin_layout Plain Layout
353 \begin_inset CommandInset citation
359 Tufte starts each section with a bit of vertical space, a non-indented
360 paragraph, and sets the first few words of the sentence in
365 To accomplish this, use the
371 Edit\SpecialChar menuseparator
372 TextStyle\SpecialChar menuseparator
378 \begin_layout Subsection
382 \begin_layout Standard
383 One of the most prominent and distinctive features of this style is the
384 extensive use of sidenotes.
385 There is a wide margin to provide ample room for sidenotes and small figures.
386 Any footnotes will automatically be converted to sidenotes.
390 \begin_layout Plain Layout
391 This is a sidenote that was entered using a
400 Alternatively, you can also use the
404 inset directly; you'll find it in the
406 Insert\SpecialChar menuseparator
410 \begin_inset Flex Sidenote
413 \begin_layout Plain Layout
414 This is a sidenote that was entered using a
426 \begin_layout Standard
427 If you like to place ancillary information in the margin without the sidenote
428 mark (the superscript number), you can use the
434 \begin_inset Flex Marginnote
437 \begin_layout Plain Layout
438 This is Tufte's margin note.
439 Notice that there isn't a number preceding the note, and there is no number
440 in the main text where this note was written.
445 The normal margin note will work as well, but it will look rather odd.
446 \begin_inset Marginal
449 \begin_layout Plain Layout
450 This is a normal margin note.
459 \begin_layout Subsection
463 \begin_layout Standard
464 References are placed alongside their citations as sidenotes, as well.
465 This can be accomplished using the normal citation command.
469 \begin_layout Plain Layout
470 The first paragraph of this document includes a citation.
478 \begin_layout Standard
479 The complete list of references may also be printed automatically by using
482 Insert\SpecialChar menuseparator
483 Lists/TOC\SpecialChar menuseparator
491 (see the end of this document for an example.) If you do not want to print
492 a bibliography at the end of your document, place the
501 inset inside a \SpecialChar LyX
502 note and use the \SpecialChar LaTeX
512 \begin_layout Section
516 \begin_layout Standard
517 Images and graphics play an integral role in Tufte's work.
518 In addition to the standard
526 floats, this class provides special figure and table environments for full-widt
530 \begin_layout Standard
531 Full page width figures and tables can be produced by using figure or table
537 To place figures or tables in the margin, use the
550 \begin_inset CommandInset ref
552 reference "fig:marginfig"
557 \begin_inset Note Note
560 \begin_layout Plain Layout
561 Note: unfortunately, the counting inside the \SpecialChar LyX
563 Margin floats and normal floats are counted differently, whereas the use
564 the same counter in the output.
570 \begin_inset Float marginfigure
575 \begin_layout Plain Layout
576 \begin_inset Box Boxed
586 height_special "totalheight"
591 backgroundcolor "none"
594 \begin_layout Plain Layout
596 replace the box by your figure!
604 \begin_layout Plain Layout
605 \begin_inset Caption Standard
607 \begin_layout Plain Layout
608 This is a margin figure.
609 The figure will be put in the margin.
610 \begin_inset CommandInset label
629 \begin_layout Standard
630 \begin_inset Note Greyedout
633 \begin_layout Plain Layout
638 If you are using margin figures or tables you must use the default float
639 placement option in the document settings under
655 \begin_layout Standard
661 \begin_inset CommandInset ref
663 reference "fig:fullfig"
667 is an example of the wide figure float and figure
672 \begin_inset CommandInset ref
674 reference "fig:textfig"
678 is an example of the normal figure float.
680 \begin_inset Float figure
685 \begin_layout Plain Layout
686 \begin_inset Box Boxed
696 height_special "totalheight"
701 backgroundcolor "none"
704 \begin_layout Plain Layout
706 replace the box by your figure!
714 \begin_layout Plain Layout
715 \begin_inset Caption Standard
717 \begin_layout Plain Layout
718 This is a wide figure (
725 Notice that this figure takes up the full page width.
728 \begin_inset CommandInset label
747 \begin_layout Standard
748 \begin_inset VSpace 6theight%
754 \begin_layout Standard
755 \begin_inset Float figure
761 \begin_layout Plain Layout
762 \begin_inset Box Boxed
772 height_special "totalheight"
777 backgroundcolor "none"
780 \begin_layout Plain Layout
782 replace the box by your figure!
790 \begin_layout Plain Layout
791 \begin_inset Caption Standard
793 \begin_layout Plain Layout
794 This is a normal figure.
797 Notice that this figure only takes up the main textblock width.
800 \begin_inset CommandInset label
819 \begin_layout Standard
825 \begin_inset CommandInset ref
827 reference "tab:normaltab"
831 shows a table created with the
835 package (this is border style
836 \begin_inset Quotes eld
840 \begin_inset Quotes erd
843 in the tabular dialog).
844 Notice the lack of vertical rules—they serve only to clutter the table's
848 \begin_layout Standard
849 \begin_inset Float table
855 \begin_layout Plain Layout
858 <lyxtabular version="3" rows="6" columns="2">
859 <features booktabs="true" tabularvalignment="middle">
860 <column alignment="left" valignment="top">
861 <column alignment="left" valignment="top">
863 <cell alignment="left" valignment="top" topline="true" bottomline="true" usebox="none">
866 \begin_layout Plain Layout
872 <cell alignment="left" valignment="top" topline="true" bottomline="true" usebox="none">
875 \begin_layout Plain Layout
883 <cell alignment="left" valignment="top" usebox="none">
886 \begin_layout Plain Layout
892 <cell alignment="left" valignment="top" usebox="none">
895 \begin_layout Plain Layout
896 \begin_inset Formula $\unit[8\nicefrac{1}{2}]{inches}$
906 <cell alignment="left" valignment="top" usebox="none">
909 \begin_layout Plain Layout
915 <cell alignment="left" valignment="top" usebox="none">
918 \begin_layout Plain Layout
919 \begin_inset Formula $\unit[11]{inches}$
929 <cell alignment="left" valignment="top" usebox="none">
932 \begin_layout Plain Layout
938 <cell alignment="left" valignment="top" usebox="none">
941 \begin_layout Plain Layout
942 \begin_inset Formula $\unit[6\nicefrac{1}{2}]{inches}$
952 <cell alignment="left" valignment="top" usebox="none">
955 \begin_layout Plain Layout
956 Textblock/sidenote gutter
961 <cell alignment="left" valignment="top" usebox="none">
964 \begin_layout Plain Layout
965 \begin_inset Formula $\unit[\nicefrac{3}{8}]{inches}$
975 <cell alignment="left" valignment="top" bottomline="true" usebox="none">
978 \begin_layout Plain Layout
984 <cell alignment="left" valignment="top" bottomline="true" usebox="none">
987 \begin_layout Plain Layout
988 \begin_inset Formula $\unit[2]{inches}$
1004 \begin_layout Plain Layout
1005 \begin_inset Caption Standard
1007 \begin_layout Plain Layout
1008 Here are the dimensions of the various margins used in the
1013 \begin_inset CommandInset label
1015 name "tab:normaltab"
1032 \begin_layout Section
1033 Full-width text blocks
1036 \begin_layout Standard
1037 In addition to the new float types, there is a
1041 environment that stretches across the main text block and the sidenotes
1042 area and ragged left:
1045 \begin_layout Full Width
1046 Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
1047 Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis.
1048 Curabitur dictum gravida mauris.
1049 Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna.
1050 Donec vehicula augue eu neque.
1051 Pellentesque habitant morbi tristique senectus et netus et malesuada fames
1054 Cras viverra metus rhoncus sem.
1055 Nulla et lectus vestibulum urna fringilla ultrices.
1056 Phasellus eu tellus sit amet tortor gravida placerat.
1057 Integer sapien est, iaculis in, pretium quis, viverra ac, nunc.
1058 Praesent eget sem vel leo ultrices bibendum.
1060 Morbi dolor nulla, malesuada eu, pulvinar at, mollis ac, nulla.
1061 Curabitur auctor semper nulla.
1062 Donec varius orci eget risus.
1063 Duis nibh mi, congue eu, accumsan eleifend, sagittis quis, diam.
1064 Duis eget orci sit amet orci dignissim rutrum.
1071 \begin_layout Section
1075 \begin_layout Subsection
1079 \begin_layout Standard
1088 typefaces are installed, this style will use them automatically.
1089 Otherwise, we'll fall back on the
1096 \begin_layout Subsection
1100 \begin_layout Standard
1101 This document class includes two new character styles and some improvements
1102 on existing commands for letterspacing.
1105 \begin_layout Standard
1106 When setting strings of
1107 \begin_inset Flex AllCaps
1110 \begin_layout Plain Layout
1117 \begin_inset Flex SmallCaps
1120 \begin_layout Plain Layout
1126 , the letterspacing—that is, the spacing between the letters—should be increased
1128 \begin_inset CommandInset citation
1130 key "Bringhurst2005"
1140 Edit\SpecialChar menuseparator
1141 TextStyle\SpecialChar menuseparator
1144 ) has proper letterspacing for strings of
1145 \begin_inset Flex AllCaps
1148 \begin_layout Plain Layout
1149 FULL CAPITAL LETTERS
1160 Edit\SpecialChar menuseparator
1161 TextStyle\SpecialChar menuseparator
1164 ) has letterspacing for
1165 \begin_inset Flex SmallCaps
1168 \begin_layout Plain Layout
1169 small capital letters
1175 These commands will also automatically convert the case of the text to
1176 upper- or lowercase, respectively.
1179 \begin_layout Standard
1184 shape has also been redefined to include letterspacing.
1185 Its case is left as is, however.
1186 This allows one to use both uppercase and lowercase letters:
1188 The Initial Letters Of The Words In This Sentence Are Capitalized.
1191 \begin_layout Section
1195 \begin_layout Subsection
1196 Document class options
1199 \begin_layout Standard
1204 class is based on the
1209 Therefore, you can pass any of the typical article options.
1210 There are a few options that are specific to the
1214 document class, however.
1217 \begin_layout Itemize
1222 option will set the paper size to A4 instead of the default US letter size.
1225 \begin_layout Itemize
1230 option will set the sidenotes in a
1234 typeface instead of the default roman.
1237 \begin_layout Itemize
1242 option will modify the running heads so that the page number is printed
1243 on the outside edge (as opposed to always printing the page number on the
1251 \begin_layout Itemize
1256 option typesets the sidenotes on the outside edge of the page.
1257 This is how books are traditionally printed, but is contrary to Tufte's
1258 book design which sets the sidenotes on the right side of the page.
1259 This option implicitly sets the
1266 \begin_layout Itemize
1271 option sets all the text fully justified (flush left and right).
1272 The default is to set the text ragged right.
1273 The body text of Tufte's books are set ragged right.
1274 This prevents needless hyphenation and makes it easier to read the text
1275 in the slightly narrower column.
1278 \begin_layout Subsection
1279 Defining new sections
1280 \begin_inset CommandInset label
1282 name "sec:defining-sections"
1289 \begin_layout Standard
1290 As mentioned on page
1291 \begin_inset space ~
1295 \begin_inset CommandInset ref
1296 LatexCommand pageref
1297 reference "sec:headings"
1305 document class only defines
1316 \begin_layout Standard
1317 If you want to define, say, a
1321 heading, you could do it as follows:
1324 \begin_layout LyX-Code
1330 \begin_layout LyX-Code
1338 \begin_layout LyX-Code
1341 @startsection{paragraph}% the name of the new section
1344 \begin_layout LyX-Code
1345 {4}% the section level number
1348 \begin_layout LyX-Code
1349 {0em}% indentation amount
1352 \begin_layout LyX-Code
1355 baselineskip}% amount of space to leave before heading
1358 \begin_layout LyX-Code
1359 {-1.5em}% amount of space to leave after heading
1362 \begin_layout LyX-Code
1370 \begin_layout LyX-Code
1374 \begin_layout LyX-Code
1380 \begin_layout Standard
1383 Document\SpecialChar menuseparator
1384 Settings\SpecialChar menuseparator
1387 and you'll now be able to use
1393 in \SpecialChar LaTeX
1397 \begin_layout Standard
1398 For more details on defining section levels, see
1400 The \SpecialChar LaTeX
1402 \begin_inset space \space{}
1408 \begin_inset CommandInset citation
1421 \begin_layout Section
1425 \begin_layout Subsection
1426 Package Dependencies
1429 \begin_layout Standard
1430 The following is a list of packages that the
1434 document class relies upon.
1435 Packages marked with an asterisk are optional.
1438 \begin_layout Itemize
1442 \begin_layout Itemize
1446 \begin_layout Itemize
1450 \begin_layout Itemize
1454 \begin_layout Itemize
1458 \begin_layout Itemize
1462 \begin_layout Itemize
1466 \begin_layout Itemize
1470 \begin_layout Itemize
1474 \begin_layout Itemize
1478 \begin_layout Itemize
1482 \begin_layout Itemize
1486 \begin_layout Itemize
1490 \begin_layout Itemize
1494 \begin_layout Subsection
1495 Tufte-\SpecialChar LaTeX
1497 \begin_inset space \space{}
1503 \begin_layout Standard
1504 The website for the Tufte-\SpecialChar LaTeX
1506 \begin_inset space \space{}
1509 packages is located at
1510 \begin_inset Flex URL
1513 \begin_layout Plain Layout
1515 https://tufte-latex.github.io/tufte-latex/
1521 On this website, you'll find links to the
1522 \begin_inset Flex SmallCaps
1525 \begin_layout Plain Layout
1531 repository of the tufte-latex project, mailing lists, bug tracker, and
1535 \begin_layout Standard
1536 \begin_inset CommandInset bibtex
1538 bibfiles "biblioExample"