]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/web/introduction.itexi
Merge branch 'master' into lilypond/translation
[lilypond.git] / Documentation / web / introduction.itexi
index c68eff19eb61759116667e6a8ae7edb633684a34..2f14efa1e1d5a5c55bbc347c3f8479038300cea8 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
@@ -141,7 +143,9 @@ simply save a file for later reference.
 
 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.
+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
@@ -195,7 +199,7 @@ team makes sure that problems are solved quickly.
 
 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
+LilyPond files faster and more effective.  For some examples, see
 @ref{Easier editing}.
 
 @divEnd
@@ -213,7 +217,7 @@ 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!
 
 
 @newsItem
@@ -285,9 +289,10 @@ staff.
 @newsItem
 @subsubheading Schenker Graphs
 
-Standard output can be modified heavily. Here is an impressive
+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}
+in @uref{http://www.linuxjournal.com/article/8364 , Linux Journal}.
+The colors have been added for better visibility.
 
 @exampleImage{bach-schenker}
 @newsEnd
@@ -544,8 +549,7 @@ 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.
@@ -556,11 +560,12 @@ lovers.
 
 @divEnd
 
+@contactUsAbout{concerts or sheet music}
 
 @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
@@ -568,8 +573,155 @@ 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
+April 2011
+
+@uref{http://www.linux-magazine.com,Linux Magazine} publishes an
+article titled
+@uref{http://www.linux-magazine.com/w3/issue/126/088-090_projects.pdf,
+Projects on the Move}.  It is an introductory article on MuseScore,
+LilyPond and Chordii.  Author Carla Schroder states @qq{LilyPond is
+driven from the command line, but don’t let the lack of a GUI scare
+you away; LilyPond is user-friendly and easy to learn}, and provides
+a hands-on example.
+
+@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
+June 2009
+
+In an @uref{http://news.lilynet.net/Free-Music-Now, article}
+published in the French @emph{National Conservatory Parent
+Association}'s yearly magazine, French composer and LilyPond
+contributor Valentin Villenave explains how Free licenses, and
+specifically LilyPond-engraved scores, are instrumental in
+making written music accessible to all.
+
+@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}
@@ -701,6 +853,28 @@ potential.}
 @divEnd
 
 
+@divClass{testimonial-item}
+@subsubheading @uref{http://webusers.siba.fi/~mkuuskan/, Dr. Mika Kuuskankare}, researcher at the @uref{http://siba.fi, Sibelius Academy Finland}, composer and author of Expressive Notation Package (ENP)
+
+@qq{I have the deepest respect towards LilyPond and towards its creators
+and maintainers as I know from personal experience how difficult this
+kind of software can be.}
+@divEnd
+
+
+@divClass{testimonial-item}
+@subsubheading @uref{http://camerondh.blogspot.com, David Cameron}, Musician, professional typesetter and long time SCORE user
+
+@qq{My heartfelt thanks to everyone who contributes to this project.  I
+was a power SCORE user for big typesetting houses way back in the '90s,
+but I feel LilyPond finally makes it possible for me to get exactly what
+I want on the page, especially when it isn't "standard" practice.}
+@divEnd
+
+@divEnd
+
+@contactUsAbout{news articles or testimonals}
+
 @divClass{column-center-bottom}
 @subheading Where now?
 
@@ -746,8 +920,8 @@ entered with backslashes.
 @imageFloat{text-input-1-annotate,png,center}
 @imageFloat{text-input-1-output,png,center}
 
-Alterations are made with different names: add @code{-is} for
-sharp, and @code{-es} for flat (these are Dutch note names, other
+Alterations are made with different names: add @w{@code{-is}} for
+sharp, and @w{@code{-es}} for flat (these are Dutch note names, other
 languages are available).  LilyPond figures out where to put
 accidentals.
 
@@ -820,6 +994,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?
 
@@ -832,32 +1007,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}
@@ -879,7 +1031,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}
@@ -898,7 +1050,30 @@ 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.
+
+@divEnd
+
+@divClass{column-center-top}
+@subheading Text editors
 
 @sourceimage{logo-linux,,,}
 @sourceimage{logo-freebsd,,,}
@@ -911,7 +1086,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}
 
@@ -922,16 +1100,10 @@ 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 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,
@@ -942,26 +1114,24 @@ using the extensions available at:
 @uref{http://users.dimi.uniud.it/~nicola.vitacolonna/home/content/lilypond-scripts}
 @end example
 
-@subsubheading TextMate
-
 @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
 
 @divEnd
 
 @divClass{column-center-top}
-@subheading Other programs can export LilyPond code
+@subheading Programs that can export LilyPond code
 
 
-@subsubheading Graphical environments:
+@subsubheading Score, tab and MIDI editors:
 
 @itemize
 @item
@@ -971,40 +1141,61 @@ 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.
+a score editor based on the
+@uref{http://www.cairographics.org,Cairo} library, has
+experimental support for exporting to 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.
+tablature editor and player, includes a score viewer and can
+export to LilyPond.
+
+@item
+@uref{http://www.musescore.org,MuseScore}, a score editor, has
+incomplete LilyPond export but is being actively developed.
 
 @item
-@uref{http://musescore.org,MuseScore} has incomplete LilyPond
-export but is being actively developed.
+@uref{http://www.canorus.org,Canorus}, a score editor, can also
+export to LilyPond, but is still beta-software.  Testers are
+welcome, though.
 
 @item
-@uref{http://canorus.org,Canorus} can also export to LilyPond, but
-is still beta-software. Testers are welcome, though.
+@uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, a
+realtime monophonic MIDI to LilyPond converter.
 
 @item
-@uref{http://strasheela.sourceforge.net, Strasheela} is @qq{a
-highly expressive constraint-based music composition system}.
+@uref{http://www.holmessoft.co.uk/homepage/software/NWC2LY/index.htm,
+NW2LY} is a C# program which converts a
+@uref{http://www.noteworthysoftware.com/, NoteWorthy} song into
+LilyPond.
 
 @end itemize
 
-@subsubheading Command Line Tools:
+@subsubheading Algorithmic code generators
 
 @itemize
+
 @item
-@uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, a realtime
-monophonic MIDI to LilyPond converter.
+@uref{http://www.projectabjad.org/,Abjad}, a
+@uref{http://www.python.org/,Python} API for Formalized Score
+Control designed to help composers build up complex pieces of
+LilyPond notation in an iterative and incremental way.
 
 @item
-@uref{http://nicolas.sceaux.free.fr/lilypond/lyqi.html,lyqi}, an
-Emacs major mode.
+@uref{http://common-lisp.net/project/fomus/,FOMUS}, a LISP library
+to generate music notation from computer music software
+environments.
+
+@item
+@uref{http://strasheela.sourceforge.net,Strasheela}, an
+environment built on top of the
+@uref{http://www.mozart-oz.org/, Mozart/Oz} constraint programming
+language.
 
 @end itemize
+@divEnd
+
+@divClass{column-center-top}
 
 @subheading Other programs not being actively developed
 
@@ -1022,10 +1213,6 @@ 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://lilycomp.sourceforge.net, LilyComp} is a graphical
@@ -1048,7 +1235,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}.