]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/introduction.itexi
Doc [web]: Add Peter Kirn's LilyPond review.
[lilypond.git] / Documentation / web / introduction.itexi
index 545f9b6a7f45b878e25122f61338961e38a0c93b..3c52a11ff4dcb3bba0b5982685d2a2c378e961c0 100644 (file)
@@ -27,8 +27,10 @@ traditions of classical music engraving.
 
 @divEnd
 
+@divClass{link-headings}
+
 @divClass{column-left-top}
-@subheading Why use LilyPond?
+@subheading What LilyPond does
 
 @itemize
 
@@ -48,22 +50,20 @@ traditions of classical music engraving.
 @divEnd
 
 @divClass{column-right-top}
-@subheading Who uses it?
-
+@subheading LilyPond in use
 @itemize
 
 @item
 @ref{Productions}: Real-life use of LilyPond.
 
 @item
-@ref{Testimonials}: What do people say?
+@ref{Reviews}: What do people say?
 
 @end itemize
 @divEnd
 
 @divClass{column-center-bottom}
-@subheading Why not use LilyPond?
-
+@subheading How LilyPond works
 @itemize
 
 @item
@@ -75,6 +75,8 @@ traditions of classical music engraving.
 @end itemize
 @divEnd
 
+@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
@@ -85,7 +87,7 @@ traditions of classical music engraving.
 * Freedom::                     Freedom and the GPL.
 * Background::                  Computational aesthetics.
 * Productions::                 Real-life use of LilyPond.
-* Testimonials::                What do people say about it?
+* Reviews::                     What do people say about it?
 * Text input::                  You write music as text?!
 * Easier editing::              Other ways of working with LilyPond.
 @end menu
@@ -95,11 +97,10 @@ traditions of classical music engraving.
 
 @node Features
 @unnumberedsec Features
+@divClass{column-center-top}
 
 
-@subheading Why switch to LilyPond?
-
-
+@subheading Elegance
 @subsubheading Excellent classical engraving
 
 @imageFloat{flat-design,png,right}
@@ -114,7 +115,8 @@ best-engraved classical scores.  This is further explained in our
 @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
@@ -123,6 +125,13 @@ layout.  Clashes between lyrics, notes, and chords are resolved
 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
@@ -130,6 +139,14 @@ 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 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
 
@@ -141,16 +158,21 @@ who are totally blind can use screen-reading software to write
 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
 
@@ -163,15 +185,6 @@ 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 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
@@ -181,7 +194,15 @@ 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?
 
@@ -196,18 +217,8 @@ already decided to try LilyPond, first read about our
 @unnumberedsec Examples
 
 LilyPond is a powerful and flexible tool for engraving tasks of
-all kinds. Please browse our gallery of examples and be inspired!
+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
@@ -278,8 +289,10 @@ 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.}.
+The colors have been added for better visibility.
 
 @exampleImage{bach-schenker}
 @newsEnd
@@ -428,10 +441,10 @@ benefitted from these projects, some developers want to @qq{give
 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
@@ -522,14 +535,21 @@ New York} (engraving by Nicolas Sceaux).
 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
 download or in traditional paper format.
 
 @item
-@uref{http://theshadylanepublishing.com/, The Shady Lane
-Publishing},
+@uref{http://www.shadylane.fr, The Shady Lane Publishing},
 a @qq{micro musical publishing house} whose goal is to promote a
 new form of musical economy closer to the musicians and music
 lovers.
@@ -544,7 +564,7 @@ lovers.
 @divClass{column-center-bottom}
 @subheading Where now?
 
-Still not convinced?  Read some of our users' @ref{Testimonials}.
+Still not convinced?  Read some of our users' @ref{Reviews}.
 If you've already decided to try LilyPond, first read about our
 @ref{Text input}.
 @divEnd
@@ -552,8 +572,133 @@ If you've already decided to try LilyPond, first read about our
 @c TRANSLATORS, so far it's mostly from
 @c http://lilypond.org/web/switch/testimonials
 
-@node Testimonials
-@unnumberedsec Testimonials
+@node Reviews
+@unnumberedsec Reviews
+
+@divClass{column-left-top}
+@subheading Published articles
+
+@divClass{keep-bullets}
+@itemize
+
+@item
+May 2010
+
+Peter Kirn, on the Create Digital Music website, publishes a
+@uref{http://createdigitalmusic.com/2010/05/14/lilypond-free-beautiful-music-notation-engraving-for-anyone/,LilyPond
+review}.  He takes a balanced view on usage, praises LilyPond's
+high-quality notation and suggests to try it out.
+
+@item
+September 2009
+
+The German LinuxUser magazine wrote an
+@uref{http://www.linux-community.de/Internal/Artikel/Print-Artikel/LinuxUser/2009/10/Digitaler-Notenschluessel,
+article about LilyPond}.
+
+@item
+August 2009
+
+Ann Drinan, on the
+@uref{http://www.polyphonic.org/article.php?id=188, Polyphonic.org}
+website, presents comments by two orchestra librarians who
+talk about using software to maintain their libraries.
+
+@item
+February 2008
+
+In @uref{http://www.musicbyandrew.ca/finale-lilypond-1.html,
+articles on his personal site}, Andrew Hawryluk compares Finale
+and LilyPond in general terms, and evaluates engraving
+capabilities of both pieces of software in detail.  The second
+article is an instructive analysis of engraving issues in
+Rachmaninoff's Piano Prelude No. 6, including comparisons with a
+hand-engraved reference edition.
+
+@item
+June 2006
+
+@uref{http://distrowatch.com,DistroWatch} awards LilyPond and
+@uref{http://distrowatch.com/weekly.php?issue=20060605,writes}
+@qq{Ladies and Gentleman, we are pleased to announce that, based
+on readers' requests, the DistroWatch May 2006 donation has been
+awarded to LilyPond (@euro{}190.00) and Lua (US$250.00).}
+
+@item
+December 2005
+
+@uref{http://linuxjournal.com,Linux Journal} publishes an article
+titled @uref{http://www.linuxjournal.com/article/8364, Make
+Stunning Schenker Graphs with GNU LilyPond}.  It is an in-depth
+but hands-on feature article with crisp LilyPond graphics.  Author
+Kris Shaffer remarks @qq{GNU LilyPond generates beautiful graphics
+that make commercial alternatives seem second-rate.}
+
+@item
+August 20, 2005
+
+The Belgian newspaper De Standaard investigates what drives Free
+Software authors in an article titled
+@uref{http://www.standaard.be/Artikel/Detail.aspx?artikelId=G42H5GD6,
+Delen van KENNIS zonder WINSTBEJAG} (Non-profit sharing of
+knowlegde) in its @q{DS2 bijlage}.  LilyPond is used as an example
+and the article is interspersed with quotes from an email
+interview with Jan Nieuwenhuizen.  This marks LilyPond's first
+appearance in mainstream printed press.
+
+@item
+June 2005
+
+A French article on the LilyPond 2.6 release appeared on
+@uref{http://linuxfr.org/2005/06/27/19210.html, linuxfr.org}.
+
+@item
+October 2004
+
+The editors of Computer!Totaal, a Dutch computer magazine,
+@uref{http://lilypond.org/web/images/computer-totaal.jpeg,
+describe LilyPond} in the October 2004 issue as: @qq{Wonderful
+free (open source) software [..] The sheet music produced by
+LilyPond is exceptionally pretty [..] a very powerful system that
+can do almost anything.}
+
+@item
+July, August 2004
+
+Dave Phillips wrote an introductory article for
+@uref{http://linuxjournal.com,Linux Journal}: At
+the sounding edge: LilyPond, parts
+@uref{http://www.linuxjournal.com/article/7657, one} and
+@uref{http://www.linuxjournal.com/article/7719, two}.
+
+@item
+March 2004
+
+Chris Cannam
+@uref{http://www.all-day-breakfast.com/cannam/linux-musician/lilypond.html,interviewed}
+Han-Wen Nienhuys and Jan Nieuwenhuizen on linuxmusician.com
+(original site defunct).  This interview was also reviewed in a
+@uref{http://slashdot.org/article.pl?sid=04/03/13/2054227&tid=,
+slashdot story}.
+
+@item
+February 2004
+
+Jazz singer Gail Selkirk writes about
+@uref{http://www.songbirdofswing.com/editorial_page/lilypond/,
+Diving into LilyPond}.  @qq{... you can make lead sheets or full
+orchestral parts, and the results can be stunning.}
+@uref{http://www.computermusic.co.uk/, Computer Music Special},
+issue CMS06.
+
+@end itemize
+
+@divEnd
+@divEnd
+
+
+@divClass{column-right-top}
+@subheading User testimonials
 
 @divClass{testimonial-item}
 @imageFloat{carter-brey,jpg, right}
@@ -684,6 +829,7 @@ last year, i was raving to several friends of mine about its
 potential.}
 @divEnd
 
+@divEnd
 
 @divClass{column-center-bottom}
 @subheading Where now?
@@ -804,6 +950,7 @@ actually provide a GUI which allows direct manipulation of a
 graphical score.  For more information, see @ref{Easier editing}.
 
 
+
 @divClass{column-center-bottom}
 @subheading Where now?
 
@@ -816,32 +963,9 @@ convinced?  Read about @ref{Easier editing}.
 @node Easier editing
 @unnumberedsec Easier editing
 
-@divClass{column-center-top}
-@subheading Graphical environment: Denemo
-
-@imageClickable{screenshot-denemo-small,png,
-  (click to enlarge),screenshot-denemo,png,right}
-
-@sourceimage{logo-linux,,,}
-@sourceimage{logo-windows,,,}
-
-@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.
-
-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.
-
-
-@divEnd
 
 @divClass{column-center-top}
-@subheading Mixed environment: LilyPondTool
+@subheading LilyPondTool
 
 @imageClickable{lilypondtool-2.12-screenshot-400wide,png,
   (click to enlarge),lilypondtool-2.12-screenshot,png,right}
@@ -855,7 +979,7 @@ the text view when printed from there.
 
 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.
@@ -863,7 +987,7 @@ viewer with advanced point-and-click support.
 @divEnd
 
 @divClass{column-center-top}
-@subheading Mixed environment: Frescobaldi
+@subheading Frescobaldi
 
 @imageClickable{frescobaldi-lilypond-editor-small,png,
   (click to enlarge),frescobaldi-lilypond-editor,png,right}
@@ -873,7 +997,7 @@ 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
@@ -882,7 +1006,33 @@ systems.
 @divEnd
 
 @divClass{column-center-top}
-@subheading Text environment: Emacs and Vim
+@subheading Denemo
+
+@imageClickable{screenshot-denemo-small,png,
+  (click to enlarge),screenshot-denemo,png,right}
+
+@sourceimage{logo-linux,,,}
+@sourceimage{logo-windows,,,}
+
+@uref{http://denemo.org}
+
+Denemo is a graphical editor which generates LilyPond source code,
+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}
+@subheading Text editors
 
 @sourceimage{logo-linux,,,}
 @sourceimage{logo-freebsd,,,}
@@ -895,7 +1045,10 @@ Emacs is a text editor with language-sensitive capabilities for
 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.  As well, one of
+our developers has written
+@uref{http://nicolas.sceaux.free.fr/lilypond/lyqi.html,lyqi}, an
+Emacs major mode.
 
 @uref{http://www.vim.org}
 
@@ -906,64 +1059,30 @@ 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
-
-
-@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
+More information on setting up Emacs and Vim can be found in
+@rprogram{Text editor support}.
 
 @sourceimage{logo-macosx,,,}
-
 @uref{http://www.uoregon.edu/~koch/texshop}
 
 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}.
-
-@ignore
-TODO: ask somebody to sponsor/check these.  -gp
+using the extensions available at:
 
-@subsubheading TextMate
+@example
+@uref{http://users.dimi.uniud.it/~nicola.vitacolonna/home/content/lilypond-scripts}
+@end example
 
 @sourceimage{logo-macosx,,,}
-
-There is a LilyPond bundle for TextMate.  It may be installed by
-running:
+There is a LilyPond bundle for TextMate, a commercial editor for MacOS.
+It may be installed by running:
 
 @example
 mkdir -p /Library/Application\ Support/TextMate/Bundles
 cd /Library/Application\ Support/TextMate/Bundles
-svn co http://svn.textmate.org/trunk/Bundles/LilyPond.tmbundle/
+git clone http://github.com/textmate/lilypond.tmbundle.git
+
 @end example
-@end ignore
 
 @divEnd
 
@@ -971,43 +1090,79 @@ svn co http://svn.textmate.org/trunk/Bundles/LilyPond.tmbundle/
 @subheading Other programs can export LilyPond code
 
 
-@subsubheading Graphical environments:
+@subsubheading Score, tab and MIDI editors:
 
 @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}, 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} has incomplete LilyPond
+export but is being actively developed.
+
 @item
-@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, can export to LilyPond.
+@uref{http://canorus.org,Canorus} can also export to LilyPond, but
+is still beta-software.  Testers are welcome, though.
+
 @item
-@uref{http://musescore.org,MuseScore} can export to LilyPond.
+@uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, a realtime
+monophonic MIDI to LilyPond converter.
+
+@end itemize
+
+@subsubheading Algorithmic code generators
+
+@itemize
+
 @item
-@uref{http://canorus.org,Canorus} can also export to LilyPond, but is still
-beta-software. Testers welcome though.
+@uref{http://strasheela.sourceforge.net, Strasheela} is @qq{a
+highly expressive constraint-based music composition system}.
+
 @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://common-lisp.net/project/fomus/,FOMUS}, a LISP library
+to generate music notation from computer music software environments.
+
 @end itemize
+@divEnd
 
-@subsubheading Command Line Tools:
+@divClass{column-center-top}
+
+@subheading Other programs not being actively developed
 
 @itemize
+
 @item
-@uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, a realtime
-monophonic MIDI to LilyPond converter.
+@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://nicolas.sceaux.free.fr/lilypond/lyqi.html,lyqi}, an
-Emacs major mode.
+@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
+@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
 
 
@@ -1022,7 +1177,7 @@ users even report that they can enter a full score in LilyPond
 faster than with a piano keyboard or mouse+GUI!  Perhaps you would
 like to review the @ref{Features}, @ref{Examples}, or the
 @ref{Freedom} that LilyPond provides, or read about users'
-@ref{Productions} and @ref{Testimonials}.  In addition, our
+@ref{Productions} and @ref{Reviews}.  In addition, our
 approach to the computational aesthetics of classical engraving is
 explained in our @ref{Background}.