X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fintroduction.itexi;h=2f14efa1e1d5a5c55bbc347c3f8479038300cea8;hb=a066a93ee74edebb9d238a1bac93c3bc7e8e6e4a;hp=815fe760d3ff49109e2e46aa97073402860bebba;hpb=bf982420290accec610083a8cfa7a6c7768355f7;p=lilypond.git diff --git a/Documentation/web/introduction.itexi b/Documentation/web/introduction.itexi index 815fe760d3..2f14efa1e1 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 @@ -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,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 @@ -268,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 @@ -513,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. @@ -531,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 @@ -543,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} @@ -676,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? @@ -721,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. @@ -795,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? @@ -807,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} @@ -846,7 +1023,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. @@ -854,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} @@ -864,7 +1041,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 @@ -873,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,,,} @@ -886,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} @@ -897,108 +1100,127 @@ 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 @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 -@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}, -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, includes a score viewer and can +export to LilyPond. + @item -@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, can export to LilyPond. +@uref{http://www.musescore.org,MuseScore}, a score editor, has +incomplete LilyPond export but is being actively developed. + @item -@uref{http://musescore.org,MuseScore} can export to LilyPond. +@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 welcome though. +@uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, a +realtime monophonic MIDI to LilyPond converter. + @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://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 + +@itemize + @item -@uref{http://common-lisp.net/project/fomus/,FOMUS}, -a LISP library to generate music notation +@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://lilycomp.sourceforge.net, LilyComp} is a graphical +note entry program, acting much like a number-pad which produces +lilypond notes. + @end itemize + @divEnd @@ -1013,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}.