-#LyX 2.0 created this file. For more info see http://www.lyx.org/
-\lyxformat 413
+#LyX 2.3 created this file. For more info see http://www.lyx.org/
+\lyxformat 544
\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_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
+\use_microtype false
+\use_dash_ligatures false
\graphics default
\default_output_format default
\output_sync 0
\pdf_quoted_options "linkcolor=blue,urlcolor=blue,pdfstartview=XYZ"
\papersize default
\use_geometry true
-\use_amsmath 1
-\use_esint 1
-\use_mhchem 1
-\use_mathdots 1
+\use_package amsmath 1
+\use_package amssymb 1
+\use_package cancel 1
+\use_package esint 1
+\use_package mathdots 1
+\use_package mathtools 1
+\use_package mhchem 1
+\use_package stackrel 1
+\use_package stmaryrd 1
+\use_package undertilde 1
\cite_engine basic
+\cite_engine_type default
+\biblio_style plain
\use_bibtopic false
\use_indices false
\paperorientation portrait
\suppress_date true
+\justification true
\use_refstyle 0
+\use_minted 0
\index Index
\shortcut idx
\color #008000
\tocdepth 3
\paragraph_separation indent
\paragraph_indentation default
-\quotes_language english
+\is_math_indent 0
+\math_numbering_side default
+\quotes_style english
+\dynamic_quotes 0
\papercolumns 1
\papersides 1
\paperpagestyle default
\begin_body
\begin_layout Title
-LilyPond-book and LyX
-\end_layout
+LilyPond-book and \SpecialChar LyX
-\begin_layout Author
-The LyX Team
\end_layout
-\begin_layout Date
-Version 2.0.x
+\begin_layout Author
+The \SpecialChar LyX
+ Team
\end_layout
\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
While LilyPond itself supports the display of title, author information,
footnotes, endnotes, etc., its primary focus is on music typesetting.
For text typesetting, other programs are generally better suited.
- LilyPond-book is an utility provided by the LilyPond project that helps
- incorporate musical scores using the LilyPond notation into LaTeX documents,
+ LilyPond-book is a utility provided by the LilyPond project that helps
+ 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 Plain Layout
-[staffsize=28]
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+
+staffsize=28
+\end_layout
+
+\end_inset
+
+
\end_layout
\begin_layout Plain Layout
\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
\backslash
-begin{lilypond}
+begin{lilypond}[staffsize=28]
\end_layout
\begin_layout LyX-Code
-[staffsize=28]
+
\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 \SpecialChar LyX
+ from the
+\family sans
+Insert
+\family default
+ menu, in the same way that the LilyPond inset itself is inserted.
Here, we set the dimension of the staff to 28
\begin_inset space \thinspace{}
\end_inset
\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 Plain Layout
-[staffsize=12]
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+
+staffsize=12
+\end_layout
+
+\end_inset
+
+
\backslash
markup {
\backslash
\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
\begin_layout Plain Layout
-http://lsr.dsi.unimi.it/LSR/Item?id=627
+http://lsr.di.unimi.it/LSR/Item?id=627
\end_layout
\end_inset
Tablatures template
\begin_inset CommandInset label
LatexCommand label
-name "sub:Tablatures-template"
+name "subsec:Tablatures-template"
\end_inset
\begin_layout Plain Layout
-http://lsr.dsi.unimi.it/LSR/Item?id=634
+http://lsr.di.unimi.it/LSR/Item?id=634
\end_layout
\end_inset
projects / lyx.git / blobdiff