clean up the tufte-book example file (demonstrate class's default settings, omit too subjective remarks)

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@31849 a592a061-630c-0410-9148-cb99ea01b6c8

lib/examples/tufte-book.lyx

@@ -3,7 +3,6 @@
 \begin_document
 \begin_header
 \textclass tufte-book
-\options justified
 \use_default_options true
 \language english
 \inputencoding auto
@@ -75,7 +74,7 @@ Settings
 \end_layout
 
 \begin_layout Title
-Random Tufte Examples
+Tufte Examples
 \end_layout
 
 \begin_layout Author
@@ -107,9 +106,13 @@ The Features of the Tufte-book Class
 
 \begin_layout Standard
 In this document, it was endeavored to show some of the features of the
- Tufte-book class.
+ 
+\family sans
+Tufte-book
+\family default
+ class.
  In the first chapter, their use is outlined.
- In the second chapter, their use through a handout thjat was created in
+ In the second chapter, their use through a handout that was created in
  a calculus class is demonstrated.
 \end_layout
 
@@ -118,16 +121,27 @@ Features
 \end_layout
 
 \begin_layout Standard
-The Tufte-book class is based on the work of Edward Tufte.
+The 
- It provides the same functionality as the Tufte-handout class with book-specifi
+\family sans
-c additions.
+Tufte-book
- Tufte's documents consist of a column of text beside a wide column of margin
+\family default
- notes and margin figures.
+ class is based on the work of 
+\noun on
+Edward Tufte
+\noun default
+.
+ It provides the same functionality as the 
+\family sans
+Tufte-handout
+\family default
+ class with book-specific additions.
+ Tufte's documents consist of a rather narrow column of text and a wide
+ column of margin notes and margin figures.
  This is to improve readability.
 \end_layout
 
 \begin_layout Standard
-Features included in this format include:
+The features provided by this format include:
 \end_layout
 
 \begin_layout Itemize
@@ -159,7 +173,7 @@ Limited layers of sections and subsections
 
 \begin_layout Standard
 In this sample document, some of these features are demonstrated.
- For a full demonstration, visit the tufte-latex webpage: 
+ For a full demonstration, visit the tufte-latex website: 
 \begin_inset Flex URL
 status collapsed
 
@@ -188,32 +202,64 @@ ragged right
 
  rather than justified.
 \begin_inset Flex Sidenote
-status collapsed
+status open
 
 \begin_layout Plain Layout
-This document is justified.
+To get justified text, add the option 
- Add the option "justified" to the Custom line of the Document Class part
+\emph on
- of the Document Settings.
+justified
+\emph default
+ to the 
+\emph on
+Custom
+\emph default
+ field in 
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+Document Class
+\family default
+.
 \end_layout
 
 \end_inset
 
- The ragged right is used in most of his works, but the option exists for
+ Ragged right text is used in most of his works, but the class option 
- justified text.
+\emph on
+justified
+\emph default
+ is provided to change this.
 \end_layout
 
 \begin_layout Standard
-Tufte also formats his pages so that they are not symmetric.
+Tufte also formats his pages asymmetrically.
- Instead, each page is the same and all the marginalia appear on the right
+ This means that the marginalia appear on the right side on each page, whether
- side of each page.
+ odd or even.
- After experimentation, I agree that this option is best.
+ If you prefer, you can change that and have symmetric layout, as common
- A symmetric layout appeared strange, to say the least.
+ in traditional book typography, by using the 
+\emph on
+symmetric
+\emph default
+ class option.
 \begin_inset Flex Sidenote
-status collapsed
+status open
 
 \begin_layout Plain Layout
-To create a symmetric layout, add the option "symmetric" to the Custom line
+To create a symmetric layout, add the option 
- of the Document Class part of the Document Settings.
+\emph on
+symmetric
+\emph default
+ to the 
+\emph on
+Custom
+\emph default
+ field in 
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+Document Class
+\family default
+.
 \end_layout
 
 \end_inset
@@ -222,10 +268,18 @@ To create a symmetric layout, add the option "symmetric" to the Custom line
 \end_layout
 
 \begin_layout Standard
-Finally, by default, Tufte does not number his chapters or his sections.
+Finally, Tufte does not number his chapters or his sections.
- Since I like to refer to sections by number, I changed this section in
+ If you like to refer to sections by number, move the 
- the Document Settings by moving the slider under the Numbering and TOC
+\emph on
- section.
+Numbering
+\emph default
+ slider in 
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+Numbering & TOC
+\family default
+ to the very right (as done in this document).
 \begin_inset Flex Marginnote
 status collapsed
 
@@ -243,7 +297,7 @@ Figures
 \end_layout
 
 \begin_layout Standard
-Tufte uses ordinary figure floats like this:
+Tufte uses ordinary figure floats such as the following:
 \end_layout
 
 \begin_layout Standard
@@ -289,8 +343,18 @@ An ordinary figure float.
 \end_layout
 
 \begin_layout Standard
-Tufte also uses margin figures, a feature I wish I could apply to the Memoir
+Furthermore, he uses margin figures, as shown in Fig.
- class.
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "fig:margin-figure"
+
+\end_inset
+
+.
 \end_layout
 
 \begin_layout Standard
@@ -323,7 +387,14 @@ Imagine your favorite photograph of a squirrel inside this box instead of
 \begin_inset Caption
 
 \begin_layout Plain Layout
-A margin figure
+A margin figure.
+\begin_inset CommandInset label
+LatexCommand label
+name "fig:margin-figure"
+
+\end_inset
+
+
 \end_layout
 
 \end_inset
@@ -337,10 +408,13 @@ A margin figure
 \end_layout
 
 \begin_layout Standard
-Naturally, the Tufte-book class also allows the use of tables in the margins
+In the same vein, the 
- and in the text in the same way that the figures are used.
+\family sans
- I would use the margin tables for a small set of data to illustrate a concept
+Tufte-book
- such as 
+\family default
+ class allows the use of tables, both in the margins and in the text.
+ The margin tables are recommended for a small set of data to illustrate
+ a concept such as 
 \begin_inset Quotes eld
 \end_inset
 
@@ -348,22 +422,33 @@ Look, distance-time data is quadratic when the object is falling.
 \begin_inset Quotes erd
 \end_inset
 
- I might put flame test results and comments in a full-width table.
+ More detailed data such as flame test results and comments should be put
+ in a full-width table instead.
 \end_layout
 
 \begin_layout Standard
-I did attempt to use the figure-wrap float with Tufte.
+Finally, 
- LyX interpreted it as a figure float and sometimes didn't show it at all.
+\family sans
- With only the narrow column of text available, I think that it should probably
+Tufte-book
- be suppressed when someone edits the layout file!
+\family default
-\end_layout
+ provides a full-width figure.
+ This one takes up the entire width of the page, i.
+\begin_inset space \thinspace{}
+\end_inset
 
-\begin_layout Standard
+e., text and margin.
-A final type of figure is a full-width figure.
+ See Fig.
- This is one which takes up the entire width of the page: text and margin
+\begin_inset space ~
- alike.
+\end_inset
- I'm proud of this because this was my one original contribution as it does
+
- not seem to be in the Tufte-handout.layout file.
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "fig:full-width-figure"
+
+\end_inset
+
+ for an example.
 \end_layout
 
 \begin_layout Standard
@@ -401,6 +486,13 @@ Imagine a photograph of a squirrel stretched out on its side in this box.
 
 \begin_layout Plain Layout
 A full-width figure.
+\begin_inset CommandInset label
+LatexCommand label
+name "fig:full-width-figure"
+
+\end_inset
+
+
 \end_layout
 
 \end_inset
@@ -435,7 +527,16 @@ footnote
 
 \end_inset
 
- Alternatively, you can also use directly the sidenote 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
 
@@ -496,12 +597,6 @@ Another useful
 \end_inset
 
  innovation is Tufte's 
-\series bold
-new thought
-\series default
- command.
- It introduces new thoughts, such as this paragraph, with small capitals.
- To accomplish this, use the 
 \family typewriter
 NewThought
 \family default
@@ -512,11 +607,14 @@ TextStyle\SpecialChar \menuseparator
 NewThought
 \family default
 ).
+ It introduces new thoughts by means of small caps, as demonstrated in this
+ paragraph.
+ 
 \end_layout
 
 \begin_layout Standard
-The Tufte document classes includes two new character styles and some improvemen
+The Tufte document classes include two new character styles and some improvement
-ts on existing commands for letterspacing.
+s on existing commands for letterspacing.
 \end_layout
 
 \begin_layout Standard
@@ -605,35 +703,88 @@ Small Caps
 The Initial Letters Of The Words In This Sentence Are Capitalized.
 \end_layout
 
-\begin_layout Full Width
+\begin_layout Standard
-This is full width text.
+Finally, the
- I'm not going to quote a text because I don't want to mess with citations
+\emph on
- and I haven't yet figured out how to use BiBTeX.
+ Full Width
- I thought about quoting from some of my own materials, but then I decided
+\emph default
- not to.
+ paragraph environment provides a paragraph layout that stretches across
- Instead, I decided to just type for a while and fill up 3 lines on my screen
+ the main text block and the sidenotes area:
- with whatever nonsense came into my head.
+\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 Section
-Conclusions
+References
 \end_layout
 
 \begin_layout Standard
-I like a lot of what Tufte has done.
+References are placed alongside their citations as sidenotes, as well.
- At the moment, however, I only use his style in my Calculus class.
+ This can be accomplished using the normal citation command.
- I have a good Calculus book, but it requires extensive notes to adapt it
+\begin_inset Foot
- for the high school level.
+status collapsed
- For my Physics, Chemistry, and Biology courses, the Memoir class seems
+
- more suited.
+\begin_layout Plain Layout
- I wish it were possible to take the idea of margin figures from Tufte and
+The previous section includes a citation.
- put it into Memoir.
+\end_layout
- I also prefer Tufte's method of dealing with margin notes.
+
+\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
+BibTeX
+\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
+BibTeX
+\begin_inset space ~
+\end_inset
+
+Bibliography
+\family default
+ inset inside a LyX note and use the LaTeX command 
+\family typewriter
+
+\backslash
+nobibliography
+\family default
+ the text.
 \end_layout
 
 \begin_layout Chapter
-Calculation of Volume: Sections 2.12-2.13
+Calculation of Volume: Sections 2.12--2.13
 \end_layout
 
 \begin_layout Abstract