Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
@end ignore
@node Introduction
@imageFloat{flat-design,png,right}
-The inspiration for LilyPond came when two musicians became
-annoyed with the bland and boring look of computer-printed
-sheet music. All musicians prefer reading beautiful music, so why
-couldn't programmers write software to produce better printed
-parts?
+LilyPond came about when two musicians wanted to go beyond the
+soulless look of computer-printed sheet music. Musicians prefer
+reading beautiful music, so why couldn't programmers write
+software to produce elegant printed parts?
+
+The result is a system which frees musicians from the details of
+layout, allowing them to focus on making music. LilyPond works
+with them to create publication-quality parts, crafted in the best
+traditions of classical music engraving.
-This software just does that: it prints music in the best
-traditions of classical engraving with minimum fuss. Don't waste
-time on tuning spacing, moving around symbols, or shaping slurs.
-Impress friends and colleagues with sharp sheet music!
@divEnd
@divClass{column-left-top}
@ref{Text input}: You write music as @emph{text}?!
@item
-@ref{Alternate input}: Other ways of working with LilyPond.
+@ref{Easier editing}: Other ways of working with LilyPond.
@end itemize
@divEnd
-
+@c TRANSLATORS, translations are not yet compiled in Info format, so
+@c it's not worth translating the right column of the following
+@c menu. -JM
@divClass{hide}
@menu
* Features:: What can LilyPond do?
* Productions:: Real-life use of LilyPond.
* Testimonials:: What do people say about it?
* Text input:: You write music as text?!
-* Alternate input:: Other ways of working with LilyPond.
+* Easier editing:: Other ways of working with LilyPond.
@end menu
@divEnd
@node Features
@unnumberedsec Features
-@help{hoping to delegate this. Desired: an enthusiastic
-attempt to sway people towards trying lilypond. The warnings
-about writing music as text come in Crash Course, not here.}
-
-Maybe draw inspiration from
-@uref{http://lilypond.org/web/about/features} and
-@uref{http://lilypond.org/web/switch/tour} and
-@uref{http://lilypond.org/web/switch/advantages}
-
-
@subheading Why switch to LilyPond?
@imageFloat{flat-design,png,right}
-The point of using LilyPond is to produce elegant sheet music that
-is easy to read. LilyPond's developer community has spent
-thousands of hours developing powerful music engraving software
-that results in beautifully engraved music. All of LilyPond's
-style settings, font designs and algorithms have been inspired by
-the finest hand-engraved music. LilyPond output has the same
-strong, balanced and elegant look as the best-engraved classical
-scores. This is further explained in our @ref{Essay}.
+LilyPond allows musicians to produce elegant sheet music that is
+easy to read. Its developer community has spent thousands of hours
+developing powerful music engraving software that results in beautifully
+engraved music. All of LilyPond's style settings, font designs and
+algorithms have been inspired by the finest hand-engraved music.
+LilyPond output has the same strong, balanced and elegant look as the
+best-engraved classical scores. This is further explained in our
+@ref{Essay}.
@subsubheading Less fiddling
@subsubheading Text-based input
LilyPond takes ASCII input, which you can produce in your favorite
-text editor, quickly and comfortably. No more futzing with the
-mouse. The input contains all the information, so there is no
-need to remember complex command sequences. Simply save an input
-for later reference.
+text editor, quickly and comfortably. The input contains all the
+information, so there is no need to remember complex command sequences:
+simply save a file for later reference.
@subsubheading Accessibility
@imageFloat{lilypond-book,png,right}
Put fragments of music into texts without cutting and pasting
-pictures. Integrate music into LaTeX or HTML seamlessly, or add
-music to OpenOffice.org with ooolilypond.
+pictures. Integrate music into @LaTeX{} or HTML seamlessly, or add
+music to OpenOffice.org with OOoLilyPond.
@subsubheading Free software
-LilyPond can be downloaded free of charge! Yep - It's free. Get
+LilyPond can be downloaded free of charge! Yep - It's free. Get
it from the download page.
-It's also free (as in @qq{speech}) software. It comes with source
-code, and permission to change and copy it. So, are you irritated
+It's also free (as in @qq{speech}) software. It comes with source
+code, and permission to change and copy it. So, are you irritated
by a bug, or yearning for a feature? Simply add it yourself, or
pay someone else to do it.
@subsubheading Extensible design
-All settings can be changed to suit your personal
-typographical taste. If that still is not enough, there is always
-the built-in scripting language, a dialect of the powerful
-language LISP. Settings, variables and functions are all
-documented in the comprehensive program reference manual.
+All settings can be changed to suit your personal typographical
+taste. If that still is not enough, there is always the built-in
+scripting language Scheme, a dialect of the powerful language
+LISP. Settings, variables and functions are all documented in the
+comprehensive program reference manual.
@subsubheading Excellent support
-LilyPond runs on all popular platforms: Linux, MacOS X, and
+LilyPond runs on all popular platforms: GNU/Linux, MacOS X, and
Windows. LilyPond comes with extensive documentation and hundreds
of example files. There is an active user community answering
questions on the Lilypond user mailing list, while the development
@divClass{column-center-bottom}
@subheading Where now?
-Still not convinced? Look at some neat @ref{Examples}. If you've
+Still not convinced? Look at some specific @ref{Examples}. If you've
already decided to try LilyPond, first read about our
@ref{Text input}.
@divEnd
@subsubheading Modern Music
Contemporary composers find Lilypond well-suited to displaying
-unusual notation. Here is an excerpt from Trevor Baca's
-@emph{Cáry}, for unaccompanied bass flute.
+unusual notation. Here is an excerpt from Trevor Bača's
+@emph{Čáry}, for unaccompanied bass flute.
@exampleImage{cary}
@newsEnd
@subsubheading Efficient, flexible creation of performance materials
Various performance materials can be created from the same source
-code. This is an excerpt of @uref{http://nicolas.sceaux.free.fr/,
+code. This is an excerpt of @uref{http://nicolas.sceaux.free.fr/,
Nicolas Sceaux's} engraving of Handel's @emph{Giulio Cesare}, in
full score, piano-vocal reduction, and a violin part.
@subsubheading Vocal Music
Lilypond is excellent for vocal music of all kinds, from sacred
-hymns to opera. Here is a medieval motet with slightly unusual
-requirements. The tenor voice is written in a different meter
+hymns to opera. Here is a medieval motet with slightly unusual
+requirements. The tenor voice is written in a different meter
than the others, but must line up as if it were in the same meter.
-Lilypond handles this most elegantly. Note also the incipits with
+Lilypond handles this most elegantly. Note also the incipits with
Vaticana style clefs, the slashed stems indicating plicated notes,
and the ligature braces above certain groups of notes.
@subsubheading Popular Music
It is simple to create pop lead sheets with melody, lyrics,
-chord names, and fretboards. In this example you see some of the
+chord names, and fretboards. In this example you see some of the
predefined fretboard diagrams, but these can be heavily customized
to suit nearly any situation.
@itemize
@item
-@emph{Affaire Étrangère}, an opera by Valentin Villenave, with
-libretto by Lewis Trondheim, premiered February 1, 2009, by
-@uref{http://www.orchestre-montpellier.com/, L'Opéra Montpellier}.
+@emph{Affaire étrangère}, an opera by
+@uref{http://valentin.villenave.net/,Valentin Villenave}
+to a French libretto by
+@uref{http://en.wikipedia.org/wiki/Lewis_Trondheim, Lewis
+Trondheim}, premiered February 1, 2009 at
+@uref{http://www.orchestre-montpellier.com/, L'Opéra National de
+Montpellier}, France.
@item
@uref{http://www.mercurybaroque.org/02/02109.aspx, Mercury Baroque}'s
@ref{Text input}.
@divEnd
+@c TRANSLATORS, so far it's mostly from
+@c http://lilypond.org/web/switch/testimonials
@node Testimonials
@unnumberedsec Testimonials
@imageFloat{carter-brey,jpg, right}
@subsubheading @uref{http://nyphil.org/meet/orchestra/index.cfm?page=profile&personNum=7, Carter Brey}, Principal Cellist, New York Philharmonic
-@qq{... I've written a couple of encore pieces for solo cello
+@qq{@dots{} I've written a couple of encore pieces for solo cello
which I've printed with LilyPond and which I'm going to submit to
-Schirmer for publication. I'll bet their engraved version wouldn't
+Schirmer for publication. I'll bet their engraved version wouldn't
look half as sharp as mine!}
@divEnd
@subsubheading @uref{http://icem-www.folkwang-hochschule.de/~finnendahl/, Orm Finnendahl}, professor of Composition, Musikhochschule Freiburg
@qq{Although I don't know [LilyPond] very well yet, I'm
-@strong{*very} impressed. I used the program to input a motet of
+@strong{*very} impressed. I used the program to input a motet of
Josquin Desprez in mensural notation and there's no doubt that
lilypond outscores all other notation programs easily concerning
-speed, ease of use and look!} @divEnd
+speed, ease of use and look!}
+@divEnd
@divClass{testimonial-item}
@subsubheading Darius Blasband, composer (Brussels, Belgium)
@qq{[..after the first orchestra rehearsal] I got numerous
-compliments about the quality of the scores. Even more
+compliments about the quality of the scores. Even more
importantly, while Lilypond provides numerous hacks to improve the
way its scores look, what the orchestra got from me is basically
the raw, untouched output.}
-
@divEnd
@subsubheading Kieren MacMillan, composer (Toronto, Canada)
@qq{thanks and kudos to the development team for their incredible
-work. I've never seen anything approaching the output that I get
+work. I've never seen anything approaching the output that I get
from Lilypond -- I'm totally confident that my music publishing
needs will be fulfilled beyond my expectations using this great
-application. [..] basically untweaked Lilypond output [..] looks
+application. [..] basically untweaked Lilypond output [..] looks
better than most recent @q{professional} publications I've compared
it to (q.v., just about any Warner Bros. score, and even many of
the most recent by @q{the old houses}). [..]}
@divClass{testimonial-item}
-@subsubheading Chris Cannam, lead programmer of the @uref{http://www.rosegardenmusic.com/, RoseGarden} project.
+@subsubheading Chris Cannam, lead programmer of the @uref{http://www.rosegardenmusic.com/, RoseGarden} project
@qq{Lilypond is obviously the zillion-ton gorilla [of great music
typesetting].}
to work in my dual editor+engraver role.}
@qq{I've been using LilyPond exclusively for my fledgling music
-publishing business. Virtually without exception, every composer
+publishing business. Virtually without exception, every composer
has been blown away by the quality of the engraving when presented
-with the proofs of their music about to be published. I deserve
+with the proofs of their music about to be published. I deserve
some of the credit for this -- I spend a lot of time tweaking
output, especially ties (mainly in chords) -- but LilyPond gives
me an excellent starting point, a very intuitive interface, and
the ability to modify absolutely anything if I want to take the
-time. I'm convinced that no commercial product can come close.}
+time. I'm convinced that no commercial product can come close.}
@divEnd
@divClass{testimonial-item}
@subsubheading @uref{http://nicolas.sceaux.free.fr/, Nicolas Sceaux}, @uref{http://www.mutopiaproject.org/, Mutopia} contributor
-@qq{I had a kind of hate-passion relationship with it. Passion
+@qq{I had a kind of hate-passion relationship with it. Passion
because the first score I saw was so amazing! The description of
LilyPond lies about its beautifulness, it is too modest! [..] as
LilyPond is getting always better, and as I look closer how things
-are done in scheme, I have less and less frustrations. Anyway,
+are done in scheme, I have less and less frustrations. Anyway,
what I mean is: thank you for providing LilyPond, it is really
good.}
@divEnd
@divClass{testimonial-item}
-@subsubheading @uref{http://www.troff.org/whoswho.html#werner, Werner Lemberg}, Conductor at the Theatre in Koblenz, Germany and distinguished GNU Hacker.
+@subsubheading @uref{http://www.troff.org/whoswho.html#werner, Werner Lemberg}, Conductor at the Theatre in Koblenz, Germany and distinguished GNU Hacker
@qq{Anyway, LilyPond does an amazingly good job!}
@divEnd
@divClass{testimonial-item}
-@subsubheading Paul Davis, developer of @uref{http://jackaudio.org/, JACK} and @uref{http://www.ardour.org/, Ardour}.
+@subsubheading Paul Davis, developer of @uref{http://jackaudio.org/, JACK} and @uref{http://www.ardour.org/, Ardour}
@qq{I think [LilyPond is] an incredible program, and it produces
-wonderful, wonderful output. when i read an interview about it
+wonderful, wonderful output. when i read an interview about it
last year, i was raving to several friends of mine about its
potential.}
@divEnd
@node Text input
@unnumberedsec Text input
-@c TRANSLATORS: so far it's mostly from
+@c TRANSLATORS, so far it's mostly from
@c http://lilypond.org/web/switch/howto
@subheading @qq{Compiling} Music
@imageClickable{nereid-shot-small,png, (click to enlarge), nereid-shot,png, right}
LilyPond is a @emph{compiled} system: it is run on a text file
-containing the notes. The resulting output is viewed on-screen or
+describing the music. The resulting output is viewed on-screen or
printed. In some ways, LilyPond is more similar to a programming
language than graphical score editing software.
@subsubheading Orchestral parts
-The input file contains the notes of piece. Score and parts can
-be made from a single input file. So, changing a note always
-affects both parts and score. To share the notes, the music is
-assigned to a variable:
+The input file contains the notes of piece of music. Score and
+parts can be made from a single input file, so that changing a
+note always affects the score and parts. To be able to include
+the same music in multiple places, the music is assigned to a
+@qq{variable} (a name).
@imageFloat{text-input-parts-both-annotate,png,center}
This variable is then used in a single part (here transposed, with
-condensed multi rests):
+condensed rests spanning several measures):
@imageFloat{text-input-parts-single-annotate,png,center}
@imageFloat{text-input-parts-single-output,png,center}
We realize that many users find this way of entering music a bit
odd. For this reason, we have written extensive documentation to
-help new users, beginning with @ref{Learning}.
+help new users, beginning with @ref{Learning}. The Learning
+Manual is the best place to start, as many questions are answered
+before they come up!
Please read the Learning Manual before complaining about bugs!
New users occasionally believe that LilyPond is not working
correctly, when in fact it is working precisely as designed.
-@help{any suggestions for a picture here?}
+More in-depth information is available in @ref{Manuals}.
@subsubheading Easier editing environments
+@imageClickable{lilykde-screenshot-small,png,
+ (click to enlarge),lilykde-screenshot,png,right}
+
LilyPond is primarily concerned with producing top-quality
engraved sheet music; creating a Graphical User Interface (GUI)
would distract us from this goal. However, there are other
Some editing environments include syntax highlighting, automatic
command completion, and pre-made templates. Other programs
actually provide a GUI which allows direct manipulation of a
-graphical score. For more information, see our documentation
-about @ref{Alternate input}.
+graphical score. For more information, see @ref{Easier editing}.
@divClass{column-center-bottom}
@subheading Where now?
You are now ready to @ref{Download, Download LilyPond}. Still not
-convinced? Read about easier editing environments in
-@ref{Alternate input}.
+convinced? Read about @ref{Easier editing}.
@divEnd
-@node Alternate input
-@unnumberedsec Alternate input
+@node Easier editing
+@unnumberedsec Easier editing
@divClass{column-center-top}
@subheading Graphical environment: Denemo
@uref{http://denemo.org}
-Denemo is graphical editor which generates LilyPond source code
-and also allows audio playback. It is currently in development
-and generates code for older versions of LilyPond (V2.8.7). It
-allows users to view the LilyPond source code in parallel to the
-graphical view.
+Denemo is a graphical editor which generates LilyPond source code,
+at release 2.8.7, and also allows audio playback. It allows users
+to view the LilyPond source code in parallel to the graphical view.
+Extra LilyPond tweaks can be attached to notes, chords etc. and are
+stored with the Denemo file, so that users can continue to edit graphically.
-@ignore
-Import: LilyPond, MIDI
+Moving the cursor in the LilyPond text moves the cursor in the graphical
+view, and any syntax errors in your LilyPond tweaks are highlighted in
+the text view when printed from there.
-Export: Lilypond, MIDI, ABC, CSound Score File, PDF
-@end ignore
@divEnd
@sourceimage{logo-macosx,,,}
@sourceimage{logo-windows,,,}
-@uref{http://lilypondtool@/.organum@/.hu}
+@uref{http://lilypondtool.organum.hu}
Created as a plugin for the
-@uref{http://@/www@/.jedit@/.org@/,jEdit} text editor,
+@uref{http://www.jedit.org,jEdit} text editor,
LilyPondTool is one of the most feature-rich text-based tool for
editing LilyPond scores. Its features include a Document Wizard
with lyrics support to set up documents easier, and embedded PDF
@divEnd
+@divClass{column-center-top}
+@subheading Mixed environment: Frescobaldi
+
+@imageClickable{frescobaldi-lilypond-editor-small,png,
+ (click to enlarge),frescobaldi-lilypond-editor,png,right}
+
+@sourceimage{logo-linux,,,}
+@sourceimage{logo-freebsd,,,}
+
+@uref{http://www.frescobaldi.org}
+
+Frescobaldi is a dedicated LilyPond music and text editor with
+built-in PDF previewer, a powerful score wizard and many editing
+features. It is built on top of the KDE4 libraries and runs
+currently on all flavours of Linux and other UNIX-like operating
+systems.
+
+@divEnd
+
@divClass{column-center-top}
@subheading Text environment: Emacs and Vim
@sourceimage{logo-macosx,,,}
@sourceimage{logo-windows,,,}
-@uref{http://FIXME}
+@uref{http://www.gnu.org/software/emacs/}
Emacs is a text editor with language-sensitive capabilities for
many different computer languages. Emacs is a highly extensible
There is a @q{lilypond mode} which supplies the language
definitions for working with Lilypond source files.
+@uref{http://www.vim.org}
+
Vim is a minimal text editor and is an extension of the older Unix
@command{vi} editor. It is also extensible and configurable.
-As a general rule, if you are not already familiar with emacs or
-vim, then you would probably prefer to use a different editor for
+As a general rule, if you are not already familiar with Emacs or
+Vim, then you would probably prefer to use a different editor for
writing LilyPond input files.
@divEnd
@divClass{column-center-top}
@subheading Other
-@help insert text and a graphic(s)
-@subsubheading Mixed environment: Frescobaldi
+@subsubheading Mixed environment: LilyKDE
-@imageClickable{frescobaldi-lilypond-editor-small,png,
- (click to enlarge),frescobaldi-lilypond-editor,png,right}
+@imageClickable{lilykde-screenshot-small,png,
+ (click to enlarge),lilykde-screenshot,png,right}
@sourceimage{logo-linux,,,}
@sourceimage{logo-freebsd,,,}
-@uref{http://www.frescobaldi.org}
+@uref{http://lilykde.googlecode.com/}
-Frescobaldi is a dedicated LilyPond music and text editor with
-built-in PDF previewer, a powerful score wizard and many editing
-features. It is built on top of the KDE4 libraries and runs
-currently on all flavours of Linux and other UNIX-like operating
-systems.
+LilyKDE has been replaced by @uref{http://www.frescobaldi.org/,Frescobaldi},
+and exists as LilyKDE3 for KDE 3.5 and lilypond-KDE4 for KDE 4.1 only.
+
+LilyKDE is a plugin for KDE's text editor
+@uref{http://kate-editor.org/,Kate}. It has a powerful Score
+Wizard to quickly setup a LilyPond document and an embedded
+PDF viewer.
+
+LilyKDE can use @uref{http://www.volny.cz/smilauer/rumor/,Rumor},
+so music can entered by playing on a MIDI keyboard.
+
+Other features are lyric hyphenation and running LilyPond on
+multiple files at once from within the KDE file manager.
@subsubheading Text environment: TexShop
@sourceimage{logo-macosx,,,}
-@uref{http://@/www@/.uoregon@/.edu/~koch/texshop}
+@uref{http://www.uoregon.edu/~koch/texshop}
-The
-@uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop}
-editor for MacOS@tie{}X can be extended to run LilyPond,
+The TexShop editor for MacOS@tie{}X can be extended to run LilyPond,
@command{lilypond-book} and @command{convert-ly} from within the editor,
using the extensions available at
-@uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html#desktoppub}.
-
+@uref{http://www.dimi.uniud.it/vitacolo/freesoftware.html#desktoppub}.
@ignore
TODO: ask somebody to sponsor/check these. -gp
@example
mkdir -p /Library/Application\ Support/TextMate/Bundles
cd /Library/Application\ Support/TextMate/Bundles
-svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/
+svn co http://svn.textmate.org/trunk/Bundles/LilyPond.tmbundle/
@end example
@end ignore
-@subsubheading Mixed environment: LilyKDE
-
-@imageClickable{lilykde-screenshot-small,png,
- (click to enlarge),lilykde-screenshot,png,right}
-
-@sourceimage{logo-linux,,,}
-@sourceimage{logo-freebsd,,,}
-
-@uref{http://lilykde.googlecode.com/}
-
-@uref{http://lilykde.googlecode.com/,LilyKDE} is a plugin for
-KDE's text editor @uref{http://kate-editor.org/,Kate}. It has a
-powerful Score Wizard to quickly setup a LilyPond document and an
-embedded PDF viewer.
-
-LilyKDE can use @uref{http://www.volny.cz/smilauer/rumor/,Rumor},
-so music can entered by playing on a MIDI keyboard.
-
-Other features are lyric hyphenation and running LilyPond on
-multiple files at once from within the KDE file manager.
+@divEnd
+@divClass{column-center-top}
+@subheading Other programs can export LilyPond code
-@help clean up this list, check links, etc.
-Other programs can export LilyPond code:
+@subsubheading Graphical environments:
@itemize
@item
-@uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, a realtime
-monophonic MIDI to LilyPond converter.
-@item
-@uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, an
-Emacs major mode.
-@item
-@uref{http://@/www@/.nongnu@/.org/@/xml2ly/,xml2ly}, which imports
-@uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
-@item
-@uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
-a LISP library to generate music notation
+@uref{http://noteedit.berlios.de,NoteEdit}
+which imports @uref{http://www.musicxml.com/xml.html,MusicXML}
@item
-@uref{http://@/noteedit@/.berlios@/.de,NoteEdit}
-which imports @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
-@item
-@uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
-which imports MIDI
+@uref{http://www.rosegardenmusic.com,Rosegarden},
+which imports MIDI.
@item
@uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd},
has experimental export for LilyPond.
@item
@uref{http://canorus.org,Canorus} can also export to LilyPond, but is still
beta-software. Testers welcome though.
+@item
+@uref{http://lilycomp.sourceforge.net, LilyComp} is a graphical note entry
+program, acting much like a number-pad which produces lilypond notes.
+@end itemize
+
+@subsubheading Command Line Tools:
+
+@itemize
+@item
+@uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, a realtime
+monophonic MIDI to LilyPond converter.
+@item
+@uref{http://nicolas.sceaux.free.fr/lilypond/lyqi.html,lyqi}, an
+Emacs major mode.
+@item
+@uref{http://common-lisp.net/project/fomus/,FOMUS},
+a LISP library to generate music notation
@end itemize
@divEnd
@divEnd
@divEnd
-
-
-
-