X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fintroduction.itexi;h=e33e5219003c434224d886674c6d6e2c88bb6685;hb=5d63c084289874d6f81f175e1415403c0c534e5e;hp=99ffba6772c4ecc5f317c6d2f6d8098bdec47e0b;hpb=662a550625b1b35f1030aa4a96b7e7cea1d14206;p=lilypond.git diff --git a/Documentation/web/introduction.itexi b/Documentation/web/introduction.itexi index 99ffba6772..e33e521900 100644 --- a/Documentation/web/introduction.itexi +++ b/Documentation/web/introduction.itexi @@ -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,7 @@ 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. Plugins are also available +music to OpenOffice.org with OOoLilyPond. Plugins are also available to allow LilyPond code in various blogs and wikis, making online collaboration possible. @@ -197,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 @@ -215,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 @@ -287,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 @@ -429,7 +432,7 @@ documentation explaining how to use these features -- we can achieve our goal with only a fraction of the individual effort. @item -@qq{Gift culture}: the Free Software (or @qq{Open Source}) +@qq{Gift culture}: the Free Software movement has created many great software projects, such as @uref{http://kernel.org/, GNU/Linux}, @uref{http://www.getfirefox.com/, Mozilla Firefox}, and @@ -438,7 +441,7 @@ 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 +Work experience: contributing to free software 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. @@ -495,13 +498,40 @@ Some highlights: @itemize @item -@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. +Mussorgsky's @emph{Pictures at an exhibition}, re-orchestrated and +conducted by @uref{http://www.aurelienbello.com/,Aurélien Bello} with +the @uref{http://www.junge-philharmonie-brandenburg.de/, +Junge Philharmonie Brandenburg} +on Oct 10 2011 and again on Apr 15-16 2012. + +@item +@uref{http://www.kierenmacmillan.info/, Kieren MacMillan}, composer and +musical director. His many, recent works include; @emph{Go Thy Way}, +performed by the @uref{http://www.saltlakechoralartists.org/, +Salt Lake Choral Artists} in March 2012; The +@emph{Just Out of Reach Suite} performed +by the +@uref{http://www.herald-dispatch.com/news/marshall/x1883873762/Music-duo-Chrysalis-to-perform-at-Marshall-University-on-Jan-19, +Chrysalis Duo} ; @emph{thrafsmata} performed in July 2011 by the +@uref{http://www.pnme.org/CurrentSeason/PreviousSeasons.html, Pittsburgh +New Music Ensemble}. + + +@item +@emph{Anonymous Student Compliment or Complaint}, by +@uref{http://www.mikesolomon.org, Mike Solomon}, winner chosen from among +172 entries from 22 countries of the +@uref{http://leftcoastensemble.org/contest, 2011 Left Coast Composition Contest}. +Other works include, Norman (age 1) for clarinet solo, performed at the +@uref{http://emu.music.ufl.edu/fems_concerts.html, University of Florida}'s +Electroacoustic Music Festival (FEMF), October 2010. + +@item +A modern edition of the @emph{Serenata Erminia} by Alessandro Scarlatti, +edited by Thomas Griffin, Musicologist (Rome, Italy). Performed on 22 +October 2010 in the Galleria of the Palazzo Zevallos Stigliano, Naples, +Italy. @uref{http://www.ascarlatti2010.net, Alessandro Scarlatti 2010}, +in celebration of the composer's 350th birthday. @item @uref{http://www.mercurybaroque.org/02/02109.aspx, Mercury Baroque}'s @@ -515,6 +545,15 @@ St. James's Church in Manhattan, May 8, 2009, by Frederick Renz and his ensemble @uref{http://www.earlymusicny.org/, Early Music New York} (engraving by Nicolas Sceaux). +@item +@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. + @end itemize @divEnd @@ -546,8 +585,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. @@ -558,11 +596,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 @@ -570,8 +609,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/website/pdf/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} @@ -703,6 +889,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? @@ -748,8 +956,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. @@ -822,6 +1030,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? @@ -834,34 +1043,18 @@ 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,,,} +@ignore +GNU policy forbids us from linking to non-Free software, so don't +add such links. -@uref{http://denemo.org} +In particular, don't link to: +- the LilyPond bundle for TextMate (a commercial editor for MacOS). -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. +@end ignore -@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 Mixed environment: LilyPondTool +@subheading LilyPondTool @imageClickable{lilypondtool-2.12-screenshot-400wide,png, (click to enlarge),lilypondtool-2.12-screenshot,png,right} @@ -883,26 +1076,48 @@ 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} @sourceimage{logo-linux,,,} @sourceimage{logo-freebsd,,,} +@sourceimage{logo-windows,,,} @uref{http://www.frescobaldi.org} -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 -systems. +Frescobaldi is lightweight, yet powerful LilyPond music and text editor +with a built-in PDF viewer. It is easy to use and will run on all major +operating systems (GNU/Linux, Mac OS X and Windows). @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,,,} @@ -915,7 +1130,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} @@ -926,16 +1144,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, @@ -946,69 +1158,90 @@ using the extensions available at: @uref{http://users.dimi.uniud.it/~nicola.vitacolonna/home/content/lilypond-scripts} @end example -@subsubheading TextMate +@divEnd -@sourceimage{logo-macosx,,,} +@divClass{column-center-top} +@subheading Programs that can export LilyPond code -There is a LilyPond bundle for TextMate. 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/ -@end example +@subsubheading Score, tab and MIDI editors: -@divEnd +@itemize -@divClass{column-center-top} -@subheading Other programs can export LilyPond code +@item +@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://enc2ly.sourceforge.net/en/,Enc2ly} is a GNU/Linux program +which converts an @uref{http://www.gvox.com/,Encore} music score into +a LilyPond one. -@subsubheading Graphical environments: +@item +@uref{https://github.com/hanwen/go-enc2ly,go-enc2ly} is a Go tool that converts +@uref{http://www.gvox.com/,Encore} files to LilyPond. It was created using +Felipe Castro's research and reverse engineering by tweaking existing .enc files +and loading them using the 4.55 demo version. -@itemize @item -@uref{http://www.rosegardenmusic.com,Rosegarden}, an audio and -MIDI sequencer, which also has a score editor for single-staff -editing. +@uref{http://www.musescore.org,MuseScore}, a score editor, has incomplete +LilyPond export but is being actively developed. @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. +@uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd}, 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. +@uref{http://www.holmessoft.co.uk/homepage/software/NWC2LY/index.htm,NW2LY} is +a C# program which converts a +@c @uref{http://www.noteworthysoftware.com/,NoteWorthy} +NoteWorthy composer song into LilyPond. @item -@uref{http://musescore.org,MuseScore} has incomplete LilyPond -export but is being actively developed. +@uref{https://github.com/ciconia/ripple/blob/master/README.markdown,Ripple} is +a program that helps create scores and parts, including a mode for mixing +different musical works together in a single score or part. @item -@uref{http://canorus.org,Canorus} can also export to LilyPond, but -is still beta-software. Testers are welcome, though. +@uref{http://www.rosegardenmusic.com,Rosegarden}, an audio and MIDI sequencer, +which also has a score editor for single-staff editing. @item -@uref{http://strasheela.sourceforge.net, Strasheela} is @qq{a -highly expressive constraint-based music composition system}. +@uref{https://launchpad.net/rumor/,Rumor}, a realtime monophonic MIDI to +LilyPond converter. + +@item +@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, a multitrack tablature editor +and player, includes a score viewer and can export to 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 @@ -1026,10 +1259,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 @@ -1052,7 +1281,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}.