-#LyX 2.1 created this file. For more info see http://www.lyx.org/
-\lyxformat 474
+#LyX 2.2 created this file. For more info see http://www.lyx.org/
+\lyxformat 508
\begin_document
\begin_header
+\save_transient_properties true
+\origin /systemlyxdir/examples/
\textclass article
\use_default_options true
\begin_modules
\language_package default
\inputencoding auto
\fontencoding global
-\font_roman lmodern
-\font_sans lmss
-\font_typewriter lmtt
-\font_math auto
+\font_roman "lmodern" "default"
+\font_sans "lmss" "default"
+\font_typewriter "lmtt" "default"
+\font_math "auto" "auto"
\font_default_family default
\use_non_tex_fonts false
\font_sc false
\font_osf false
-\font_sf_scale 100
-\font_tt_scale 100
+\font_sf_scale 100 100
+\font_tt_scale 100 100
\graphics default
\default_output_format default
\output_sync 0
\begin_body
\begin_layout Title
-LilyPond-book and LyX
+LilyPond-book and \SpecialChar LyX
+
\end_layout
\begin_layout Author
-The LyX Team
+The \SpecialChar LyX
+ Team
\end_layout
\begin_layout Date
\begin_layout Abstract
This document explains and demonstrates the inclusion of musical snippets
- in a LyX document, using the LilyPond syntax for music notation and the
- LilyPond-book utility for processing.
+ in a \SpecialChar LyX
+ document, using the LilyPond syntax for music notation and the LilyPond-b
+ook utility for processing.
\end_layout
\begin_layout Section
footnotes, endnotes, etc., its primary focus is on music typesetting.
For text typesetting, other programs are generally better suited.
LilyPond-book is a utility provided by the LilyPond project that helps
- incorporate musical scores using the LilyPond notation into LaTeX documents,
+ incorporate musical scores using the LilyPond notation into \SpecialChar LaTeX
+ documents,
among other formats.
\end_layout
\begin_layout Standard
-This document describes the use of the LilyPond music notation within LyX
- documents that use a LaTeX-based layout, thus combining the beauty and
- quality of the typesetting achieved by both LaTeX and LilyPond.
+This document describes the use of the LilyPond music notation within \SpecialChar LyX
+ documents
+ that use a \SpecialChar LaTeX
+-based layout, thus combining the beauty and quality of the
+ typesetting achieved by both \SpecialChar LaTeX
+ and LilyPond.
While a basic understanding of the LilyPond syntax for music notation is
- in order, knowledge of LaTeX is not necessary when using LyX.
+ in order, knowledge of \SpecialChar LaTeX
+ is not necessary when using \SpecialChar LyX
+.
\end_layout
\begin_layout Standard
\end_inset
explains the requirements, usage instructions, and shortcomings of LilyPond
- music notation within LyX.
+ music notation within \SpecialChar LyX
+.
Section
\begin_inset CommandInset ref
LatexCommand ref
\end_layout
\begin_layout Section
-Using LilyPond code within LyX
+Using LilyPond code within \SpecialChar LyX
+
\begin_inset CommandInset label
LatexCommand label
name "sec:Using-LilyPond-code"
\end_layout
\begin_layout Standard
-Support for LilyPond music notation (LilyPond code) within LyX is enabled
- by adding the LilyPond module to your document.
+Support for LilyPond music notation (LilyPond code) within \SpecialChar LyX
+ is enabled by
+ adding the LilyPond module to your document.
This is done from the menu
\family sans
-Document\SpecialChar \menuseparator
+Document\SpecialChar menuseparator
Settings
\family default
, then selecting LilyPond in the list of modules.
- You can use any LaTeX-based LyX layout and use the regular preview and
- export mechanism; LyX will take care of processing the mixed LaTeX/LilyPond
- code through LilyPond-book for you.
+ You can use any \SpecialChar LaTeX
+-based \SpecialChar LyX
+ layout and use the regular preview and export mechanism
+; \SpecialChar LyX
+ will take care of processing the mixed \SpecialChar LaTeX
+/LilyPond code through LilyPond-book
+ for you.
LilyPond-book can also handle DocBook and HTML documents, but the integration
- of these document types with LilyPond-book and LyX is missing at the moment.
+ of these document types with LilyPond-book and \SpecialChar LyX
+ is missing at the moment.
\end_layout
\begin_layout Subsection
status collapsed
\begin_layout Plain Layout
-LilyPond-book supports LaTeX output since version 2.1.
- However, some features used by LyX are available only in recent versions:
- PDFLaTeX support (version 2.9), the
+LilyPond-book supports \SpecialChar LaTeX
+ output since version 2.1.
+ However, some features used by \SpecialChar LyX
+ are available only in recent versions:
+ PDF\SpecialChar LaTeX
+ support (version 2.9), the
\family typewriter
--lily-output-dir
\family default
\begin_layout Standard
The module provides a LilyPond inset which you insert from the menu
\family sans
-Insert\SpecialChar \menuseparator
+Insert\SpecialChar menuseparator
Custom
\begin_inset space ~
\end_inset
\begin_layout Standard
\noindent
-The previous LyX inset produces the following LaTeX-lookalike code:
+The previous \SpecialChar LyX
+ inset produces the following \SpecialChar LaTeX
+-lookalike code:
\end_layout
\begin_layout LyX-Code
\begin_layout Standard
What appear first inside square brackets are options to pass to LilyPond-book.
- This is inserted in LyX from the
+ This is inserted in \SpecialChar LyX
+ from the
\family sans
Insert
\family default
\begin_layout Standard
What follows after the options block is the textual representation in LilyPond
syntax of a musical fragment.
- This code is not, in fact, processed by LaTeX, but is preprocessed by LilyPond-
-book, which creates the graphics files and includes them in the LaTeX document
- by replacing the above with a
+ This code is not, in fact, processed by \SpecialChar LaTeX
+, but is preprocessed by LilyPond-book,
+ which creates the graphics files and includes them in the \SpecialChar LaTeX
+ document by
+ replacing the above with a
\family typewriter
\backslash
-includegraphics{\SpecialChar \ldots{}
+includegraphics{\SpecialChar ldots
}
\family default
command.
\begin_layout Standard
Thus, the conversion process is as follow:
\family sans
-LyX\SpecialChar \menuseparator
-LilyPond-book\SpecialChar \menuseparator
-LaTeX
+\SpecialChar LyX
+\SpecialChar menuseparator
+LilyPond-book\SpecialChar menuseparator
+\SpecialChar LaTeX
+
\family default
.
- LyX creates a .lytex file, LilyPond-book creates a .tex files and the accompanyin
-g image files, and LaTeX creates the final document.
+ \SpecialChar LyX
+ creates a .lytex file, LilyPond-book creates a .tex files and the accompanying
+ image files, and \SpecialChar LaTeX
+ creates the final document.
Every step of the tool chain obeys your spacing, so whether you put the
musical extract inline, or in its own paragraph, centered, left-aligned,
- etc., what you see in the LyX window should be respected in the final format.
+ etc., what you see in the \SpecialChar LyX
+ window should be respected in the final format.
An example of inline use may be to display a chord name, such as
\begin_inset Flex LilyPond
status open
\begin_layout Standard
It is possible to have a direct feedback of what the music notation looks
- like from within LyX.
+ like from within \SpecialChar LyX
+.
To do this, wrap a LilyPond inset inside a Preview inset, which you find
from the menu
\family sans
-Insert\SpecialChar \menuseparator
+Insert\SpecialChar menuseparator
Preview
\family default
.
- This only affects the display within LyX, not the output:
+ This only affects the display within \SpecialChar LyX
+, not the output:
\end_layout
\begin_layout Standard
\begin_layout Standard
A few gotchas that have been experienced with the integration of LilyPond-book
- and LyX are reported here.
+ and \SpecialChar LyX
+ are reported here.
\end_layout
\begin_layout Subsubsection
\end_layout
\begin_layout Standard
-A LyX document using the LilyPond module cannot have child documents using
+A \SpecialChar LyX
+ document using the LilyPond module cannot have child documents using
the
\begin_inset Quotes eld
\end_inset
under
\family sans
-Insert\SpecialChar \menuseparator
-File\SpecialChar \menuseparator
+Insert\SpecialChar menuseparator
+File\SpecialChar menuseparator
Child
\begin_inset space ~
\end_inset
\begin_layout Standard
to your master document's preamble under
\family sans
-Document\SpecialChar \menuseparator
+Document\SpecialChar menuseparator
Settings
\family default
.
command.
With this command, the LilyPond code is processed as if it was typed inside
the document and the output score follows the typesetting determined by
- LaTeX with respect to line width, page breaks, and so on.
- This is in contrast to the long-standing LyX feature to include LilyPond
- scores as external material, which calls LilyPond on the external file
- to produce a rigid figure, and includes this figure in the document, leaving
- the typesetting decisions to LilyPond.
+ \SpecialChar LaTeX
+ with respect to line width, page breaks, and so on.
+ This is in contrast to the long-standing \SpecialChar LyX
+ feature to include LilyPond scores
+ as external material, which calls LilyPond on the external file to produce
+ a rigid figure, and includes this figure in the document, leaving the typesetti
+ng decisions to LilyPond.
Unfortunately, support for the
\family typewriter
\backslash
lilypondfile
\family default
- command in LyX is not implemented yet, but it is possible to use it inside
- a TeX-Code block, provided that one writes the complete, absolute path
- to the desired file.
+ command in \SpecialChar LyX
+ is not implemented yet, but it is possible to use it inside
+ a \SpecialChar TeX
+-Code block, provided that one writes the complete, absolute path to
+ the desired file.
\end_layout
\begin_layout Section
Example
\begin_inset CommandInset ref
LatexCommand ref
-reference "sub:Editorial-headword"
+reference "subsec:Editorial-headword"
\end_inset
Example
\begin_inset CommandInset ref
LatexCommand ref
-reference "sub:Tablatures-template"
+reference "subsec:Tablatures-template"
\end_inset
Editorial headword
\begin_inset CommandInset label
LatexCommand label
-name "sub:Editorial-headword"
+name "subsec:Editorial-headword"
\end_inset
\begin_layout Standard
NR 1.7 Editorial annotations Beethoven, Op.
31, No.
- 3 Piano sonata 18, Movt II, Scherzo Measures 9--14.
+ 3 Piano sonata 18, Movt II, Scherzo Measures 9–14.
\end_layout
\begin_layout Standard
Tablatures template
\begin_inset CommandInset label
LatexCommand label
-name "sub:Tablatures-template"
+name "subsec:Tablatures-template"
\end_inset