@imageFloat{flat-design,png,right}
LilyPond came about when two musicians wanted to go beyond the
-soulless look of computer-printed sheet music, to use the machine
-to produce elegance. 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 works, crafted
-in the best traditions of classical music engraving.
+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.
@divEnd
@node Features
@unnumberedsec Features
+@divClass{column-center-top}
-@subheading Why switch to LilyPond?
-
-
+@subheading Elegance
@subsubheading Excellent classical engraving
@imageFloat{flat-design,png,right}
@ref{Essay}.
-@subsubheading Less fiddling
+
+@subsubheading Effective layout choices
Spend less time with tweaking the output; LilyPond gets the
formatting correct right from the start. It determines spacing by
and slurs and beams are sloped, automatically!
+@divEnd
+
+@divClass{color2}
+@subheading Ease of use
+
+@imageFloat{lilypond-book,png,right}
+
@subsubheading Text-based input
LilyPond takes ASCII input, which you can produce in your favorite
information, so there is no need to remember complex command sequences:
simply save a file for later reference.
+@subsubheading Mix music and text
+
+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. Plugins are also available
+to allow LilyPond code in various blogs and wikis, making online
+collaboration possible.
+
@subsubheading Accessibility
LilyPond files -- an impossible task in graphical-based
score-writing programs.
+@subsubheading Extensible design
-@subsubheading Mix music and text
+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.
-@imageFloat{lilypond-book,png,right}
+@divEnd
-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.
+@divClass{color3}
+@subheading Environment
+@imageFloat{frescobaldi-lilypond-editor-small,png,right}
@subsubheading Free software
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 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: 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
+questions on the lilypond-user mailing list, while the development
team makes sure that problems are solved quickly.
+@subsubheading Enhanced editors
+
+Several developers, themselves active LilyPond users, have also
+written tools specifically aimed at making the process of editing
+LilyPond files faster and more effective. For some examples, see
+@ref{Easier editing}.
+
+@divEnd
@divClass{column-center-bottom}
@subheading Where now?
@node Examples
@unnumberedsec Examples
-Lilypond is a powerful and flexible tool for engraving tasks of
+LilyPond is a powerful and flexible tool for engraving tasks of
all kinds. Please browse our gallery of examples and be inspired!
-@ignore
-Here is a passage from Franz Liszt's solo piano transcription
-of the Overture to Wagner's @emph{Tannhäuser}. The spacing
-in this example was all performed by Lilypond's formatting
-algorithms, without tweaks of any kind. It
-handles cross-staff beaming gracefully and puts the system brace
-perfectly around all three staves.
-
-@exampleImage{liszt-wagner}
-@end ignore
@newsItem
@subsubheading Classical Music
This organ work by J.S. Bach is a fairly typical engraving project
-in Lilypond.
+in LilyPond.
@exampleImage{bach-bwv610}
@newsEnd
@newsItem
@subsubheading Early Music
-Lilypond also supports various types of ancient notation, such
+LilyPond also supports various types of ancient notation, such
as this passage of Gregorian chant.
@exampleImage{ancient-headword}
@newsItem
@subsubheading Modern Music
-Contemporary composers find Lilypond well-suited to displaying
+Contemporary composers find LilyPond well-suited to displaying
unusual notation. Here is an excerpt from Trevor Bača's
@emph{Čáry}, for unaccompanied bass flute.
@newsItem
@subsubheading Tablature
-Lilypond supports tablature notation, which can be customized to
+LilyPond supports tablature notation, which can be customized to
suit any instrument that reads from tablature. The tablature
staff is generated automatically from notes entered for the 5-line
staff.
@newsItem
@subsubheading Schenker Graphs
-Standard output can be modified heavily. Here someone has created
-an impressive Schenkerian analysis.
+Standard output can be modified heavily. Here is an impressive
+Schenkerian analysis, created by Kris Schaffer, for an article
+in @uref{http://www.linuxjournal.com/article/8364 , Linux Journal}
@exampleImage{bach-schenker}
@newsEnd
@newsItem
@subsubheading Vocal Music
-Lilypond is excellent for vocal music of all kinds, from sacred
+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
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.
@newsItem
@subsubheading Educational Applications
-Lilypond is perfectly suited for educational purposes as well.
+LilyPond is perfectly suited for educational purposes as well.
Here is an example of a simple counterpoint exercise.
@exampleImage{theory}
@newsItem
@subsubheading Large Projects
-Lilypond is excellent for large projects like operas or works for
+LilyPond is excellent for large projects like operas or works for
full symphony orchestra, as well. In addition, the text-based
input provides greater accessibility -- this example was
contributed by Hu Haipeng, a blind composer.
back} to the community.
@item
-Work experience: contributing to open-source projects is a great
-way to practice programming, documentation writing, or design.
-This experience has helped some developers gain job offers or
-scholarships.
+Work experience: contributing to open-source projects is a great way to
+practice programming, documentation writing, documentation translation,
+or design. This experience has helped some developers gain job offers
+or scholarships.
@end itemize
@divClass{column-left-top}
@subheading Concerts
-Lilypond engravings have been used for performances around the world.
+LilyPond engravings have been used for performances around the world.
Some highlights:
@divClass{keep-bullets}
@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
over 1500 pieces of classical sheet music for free download, and
the main showcase of LilyPond scores.
+@c don't make this "Mutopia" a link, since that looks silly.
+@item
+@uref{http://etudeapp.com, Etude}, @qq{sheet music on steroids} is
+an iPhone app which displays piano music engraved with LilyPond,
+including many pieces from Mutopia. The app includes a virtual
+piano keyboard showing which keys to press to help beginners learn
+how to read sheet music.
+
@item
@uref{http://www.adoromusicpub.com/, Adoro Music Publishing},
high-quality scores of sacred music, available for immediate
@qq{[..after the first orchestra rehearsal] I got numerous
compliments about the quality of the scores. Even more
-importantly, while Lilypond provides numerous hacks to improve the
+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
@qq{thanks and kudos to the development team for their incredible
work. I've never seen anything approaching the output that I get
-from Lilypond -- I'm totally confident that my music publishing
+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
-@qq{Lilypond is obviously the zillion-ton gorilla [of great music
+@qq{LilyPond is obviously the zillion-ton gorilla [of great music
typesetting].}
@divEnd
@divClass{testimonial-item}
@subsubheading David Bobroff, Bass Trombone, Iceland Symphony Orchestra
-@qq{I think Lilypond is great [..] The more I learn about LilyPond
+@qq{I think LilyPond is great [..] The more I learn about LilyPond
the more I like it!}
@divEnd
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 our @ref{Learning} Manual.
+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.
-The Learning Manual is the best place to start, as many questions
-are answered before they come up!
+More in-depth information is available in @ref{Manuals}.
-More in-depth information is available on the @ref{Manuals} page,
-with the Notation Manual explaining each LilyPond command and
-function, as well as the Internals Manual for those who want to
-get down to the underlying code.
@subsubheading Easier editing environments
@uref{http://denemo.org}
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.
+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.
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.
-
+@warning{Denemo officially supports an outdated Lilypond version 2.8.7,
+which lacks many of the features added since then. The Denemo developers
+are actively working to bring it up to our present stable version, 2.12.}
@divEnd
@divClass{column-center-top}
Created as a plugin for the
@uref{http://www.jedit.org,jEdit} text editor,
-LilyPondTool is one of the most feature-rich text-based tool for
+LilyPondTool is one of the most feature-rich text-based tools for
editing LilyPond scores. Its features include a Document Wizard
with lyrics support to set up documents easier, and embedded PDF
viewer with advanced point-and-click support.
@uref{http://www.frescobaldi.org}
-Frescobaldi is a dedicated LilyPond music and text editor with
+Frescobaldi is a dedicated LilyPond music and text editor with a
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
many different computer languages. Emacs is a highly extensible
editor and can be used as an Integrated Development Environment.
There is a @q{lilypond mode} which supplies the language
-definitions for working with Lilypond source files.
+definitions for working with LilyPond source files.
@uref{http://www.vim.org}
@subheading Other
-@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/}
-
-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,,,}
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}.
+using the extensions available at:
-@ignore
-TODO: ask somebody to sponsor/check these. -gp
+@example
+@uref{http://users.dimi.uniud.it/~nicola.vitacolonna/home/content/lilypond-scripts}
+@end example
@subsubheading TextMate
cd /Library/Application\ Support/TextMate/Bundles
svn co http://svn.textmate.org/trunk/Bundles/LilyPond.tmbundle/
@end example
-@end ignore
@divEnd
@itemize
@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}, an audio and
+MIDI sequencer, which also has a score editor for single-staff
+editing.
+
@item
@uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd},
+is based on the @uref{http://cairographics.org, Cairo} library and
has experimental export for LilyPond.
+
@item
-@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, can export to LilyPond.
+@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, a multitrack
+tablature editor and player, provides a score view as well as tab,
+and can export to LilyPond.
+
@item
-@uref{http://musescore.org,MuseScore} can export to LilyPond.
+@uref{http://musescore.org,MuseScore} has incomplete LilyPond
+export but is being actively developed.
+
@item
-@uref{http://canorus.org,Canorus} can also export to LilyPond, but is still
-beta-software. Testers welcome though.
+@uref{http://canorus.org,Canorus} can also export to LilyPond, but
+is still beta-software. Testers are 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.
+@uref{http://strasheela.sourceforge.net, Strasheela} is @qq{a
+highly expressive constraint-based music composition system}.
+
@end itemize
@subsubheading Command Line Tools:
@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.
+
+@end itemize
+
+@subheading Other programs not being actively developed
+
+@itemize
+
+@item
+@uref{http://lilykde.googlecode.com/,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.
+
+@item
+@uref{http://noteedit.berlios.de,NoteEdit}, which imported
+@uref{http://www.musicxml.com/xml.html,MusicXML}, has been forked
+into
+@uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd}
+and @uref{http://canorus.org,Canorus}.
+
+@item
+@uref{http://common-lisp.net/project/fomus/,FOMUS}, a LISP library
+to generate music notation a LISP library to generate music
+notation.
+
@item
-@uref{http://common-lisp.net/project/fomus/,FOMUS},
-a LISP library to generate music notation
+@uref{http://lilycomp.sourceforge.net, LilyComp} is a graphical
+note entry program, acting much like a number-pad which produces
+lilypond notes.
+
@end itemize
+
@divEnd