-#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/
-\lyxformat 404
+#LyX 2.0 created this file. For more info see http://www.lyx.org/
+\lyxformat 413
\begin_document
\begin_header
\textclass article
-\begin_preamble
-\date{}
-\end_preamble
\use_default_options true
\begin_modules
lilypond
\end_modules
\maintain_unincluded_children false
\language english
+\language_package default
\inputencoding auto
\fontencoding global
\font_roman default
\font_sans default
\font_typewriter default
\font_default_family default
-\use_xetex false
+\use_non_tex_fonts false
\font_sc false
\font_osf false
\font_sf_scale 100
\index_command default
\paperfontsize default
\spacing single
-\use_hyperref false
+\use_hyperref true
+\pdf_title "LilyPond-book and LyX"
+\pdf_author "Julien Rioux"
+\pdf_bookmarks true
+\pdf_bookmarksnumbered false
+\pdf_bookmarksopen false
+\pdf_bookmarksopenlevel 1
+\pdf_breaklinks false
+\pdf_pdfborder false
+\pdf_colorlinks false
+\pdf_backref false
+\pdf_pdfusetitle true
\papersize default
\use_geometry true
\use_amsmath 1
\use_bibtopic false
\use_indices false
\paperorientation portrait
-\suppress_date false
+\suppress_date true
\use_refstyle 0
\index Index
\shortcut idx
\tracking_changes false
\output_changes false
\html_math_output 0
+\html_css_as_file 0
\html_be_strict true
\end_header
\begin_body
\begin_layout Title
-LilyPond-book + LyX
+LilyPond-book and LyX
\end_layout
\begin_layout Abstract
-This is an example file demonstrating the use of LilyPond music notation
- with LyX.
+This is an example file demonstrating the inclusion of musical snippets
+ in a LyX document, using the LilyPond music notation and the LilyPond-book
+ utility for processing.
\end_layout
\begin_layout Section
\end_layout
\begin_layout Standard
-Thus, the conversion toolchain is as follow: LyX\SpecialChar \menuseparator
+Thus, the conversion path is as follow: LyX\SpecialChar \menuseparator
LilyPond-book\SpecialChar \menuseparator
LaTeX.
- Every step of the toolchain obeys your spacing, so whether you put the
- musical extract inline or in its own paragraph, centered or left-aligned,
+ Every step of the tool chain obeys your spacing, so whether you put the
+ musical extract in line, or in its own paragraph, centered, left-aligned,
etc., what you see in the LyX window should be respected in the final format.
- An example of inline use may be to display a chord name, such as
+ An example of in-line use may be to display a chord name, such as
\begin_inset Flex LilyPond
status open
Gotchas
\end_layout
+\begin_layout Subsubsection
+Child documents
+\end_layout
+
+\begin_layout Standard
+A LyX document using the LilyPond module cannot have child documents using
+ the
+\begin_inset Quotes eld
+\end_inset
+
+Input
+\begin_inset Quotes erd
+\end_inset
+
+ method.
+ If you select
+\begin_inset Quotes eld
+\end_inset
+
+Input
+\begin_inset Quotes erd
+\end_inset
+
+ as the
+\begin_inset Quotes eld
+\end_inset
+
+Include Type
+\begin_inset Quotes erd
+\end_inset
+
+ under Insert\SpecialChar \menuseparator
+File\SpecialChar \menuseparator
+Child Document, you will get an error when producing output.
+ This is due to the way LilyPond-book automatically processes these input
+ files recursively.
+ Since there is currently no command-line option to turn off this behavior
+ of LilyPond-book, it is suggested to use the
+\begin_inset Quotes eld
+\end_inset
+
+Include
+\begin_inset Quotes erd
+\end_inset
+
+ method instead.
+\end_layout
+
+\begin_layout Standard
+Note that it is possible to insert child documents which make use of the
+ LilyPond module, using either the
+\begin_inset Quotes eld
+\end_inset
+
+Input
+\begin_inset Quotes erd
+\end_inset
+
+ or
+\begin_inset Quotes eld
+\end_inset
+
+Include
+\begin_inset Quotes erd
+\end_inset
+
+ method, in a master document which does not make use of the LilyPond module.
+ For this to work you might have to add the line
+\end_layout
+
+\begin_layout LyX-Code
+
+\backslash
+usepackage{graphicx}
+\end_layout
+
+\begin_layout Standard
+to your master document's preamble under Document\SpecialChar \menuseparator
+Settings.
+\end_layout
+
+\begin_layout Subsubsection
+Surrounding braces
+\end_layout
+
\begin_layout Standard
LilyPond-book searches for a
\family typewriter
\end_layout
+\begin_layout Subsubsection
+Fret diagrams
+\end_layout
+
\begin_layout Standard
Another gotcha is with subsequent lilypond snippets with
\family typewriter
\end_inset
- shows a complex example using many LilyPond constructs; some inline scheme
- code has been removed to be able to run in safe mode.
+ shows a complex example using many LilyPond constructs; some scheme code
+ has been removed from the original source of this snippet, to be able to
+ run in safe mode.
Example
\begin_inset CommandInset ref
LatexCommand ref
\end_inset
-; inline scheme code removed, centering applied through the paragraph settings]
+; scheme code removed, centering applied through the paragraph settings]
\end_layout
\begin_layout Subsection