X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fintroduction.itexi;h=704a3e8a50f6a13660c21ed99864c013dcd0a054;hb=dfd1134c63655440bb971d47d223411ddeb4e4aa;hp=1d9703ae6eba281466a1b18138f154531111b8d6;hpb=46e296f5381495ce30108aa981e549d61e55a009;p=lilypond.git diff --git a/Documentation/web/introduction.itexi b/Documentation/web/introduction.itexi index 1d9703ae6e..704a3e8a50 100644 --- a/Documentation/web/introduction.itexi +++ b/Documentation/web/introduction.itexi @@ -20,10 +20,14 @@ 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. +The result is a program that creates beautiful sheet music +following the best traditions of classical music engraving. +It takes care of the details of layout programmatically, +allowing composers, transcribers and publishers to focus +on the @emph{music} instead of improving their software's +default output. Performers will get parts that let them +concentrate on @emph{playing} music instead of @emph{reading} it. + @divEnd @@ -100,8 +104,7 @@ traditions of classical music engraving. @divClass{column-center-top} -@subheading Elegance -@subsubheading Excellent classical engraving +@subheading Excellent classical engraving @imageFloat{flat-design,png,right} @@ -115,37 +118,69 @@ best-engraved classical scores. This is further explained in our @ref{Essay}. +@divEnd -@subsubheading Effective layout choices +@divClass{column-center-top} +@subheading Text input -Spend less time with tweaking the output; LilyPond gets the -formatting correct right from the start. It determines spacing by -itself, and breaks lines and pages to provide a tight and uniform -layout. Clashes between lyrics, notes, and chords are resolved -and slurs and beams are sloped, automatically! +@subsubheading Everything is explicit + +LilyPond processes text input, which contains all information +about the @emph{content} of your score and can easily be read +by any human or another program. There are no obscure +settings hidden behind menu items and binary file storage. + +Read more about this concept on @ref{Text input}. +@subsubheading Tweaks are robust and traceable + +If you have to change anything in the layout this tweak will +also be explicitly visible in the input file in human-readable +form, so you will always be able to retrace what you've done. +If you should accidentally break anything you can easily revert +or modify any decision without being at the mercy of an +@emph{Undo} function. + + +@subsubheading Text files are failure- and future-proof + +Text files are very robust against file corruption. And as they are +human-readable, you will always be able to interpret them even if +you don't have access to the programs that created them. + + +@subsubheading Manage your scores with version control + +Text files are applicable to be managed by version control. Go +for it and experience infinite and selective undo/redo mechanisms +and the full development history of your scores. Version control +may also open up new (collaborative) workflows for you. + @divEnd -@divClass{color2} -@subheading Ease of use +@divClass{column-center-top} +@subheading Usability @imageFloat{lilypond-book,png,right} -@subsubheading Text-based input -LilyPond takes ASCII input, which you can produce in your favorite -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 Effective layout choices + +Spend less time with tweaking the output; LilyPond gets the +formatting correct right from the start. It determines spacing by +itself, and breaks lines and pages to provide a tight and uniform +layout. Clashes between lyrics, notes, and chords are resolved +and slurs and beams are sloped, automatically! + @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. +music to OpenOffice.org/LibreOffice with OOoLilyPond. Plugins are +also available to allow LilyPond code in various blogs and wikis, making +online collaboration possible. @subsubheading Accessibility @@ -157,32 +192,74 @@ speech-recognition software to edit LilyPond files. Even users who are totally blind can use screen-reading software to write LilyPond files -- an impossible task in graphical-based score-writing programs. +You can see a spectacular score on @ref{Examples}. -@subsubheading Extensible design +@subsubheading Editor diversity -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 +Several developers, themselves active LilyPond users, +have written tools specifically aimed at making the process of editing +LilyPond files faster and more effective; you are not tied to +a single user interface but can use different tools for different tasks. +You can even use a full-fledged LilyPond editor at home and use your +mobile phone's notepad app to edit the files on the go. For some examples, +see @ref{Easier editing}. +@c TODO: Change this when the new pages have been written and pushed + + +@divEnd + +@divClass{column-center-top} + +@subheading Extensible design + +@subsubheading Easy management of style sheets + +All layout settings can be changed to suit your personal typographical +taste. So you can easily write style sheets that change every aspect of +LilyPond scores' default appearance. As these are also written as text +and can be stored in separate files you can simply switch between two +stylesheets to produce scores with a completely different appearance or +layout. +You want to print a score on A4 paper and project it with a beamer, +one system per page? LilyPond's layout engine will effortlessly produce +both from the same input. + +@subsubheading Add your own functions + +If that still is not enough, there is always the built-in +scripting language Scheme, which can access LilyPond's layout +engine at the same level as LilyPond itself does, making it +a @emph{very} powerful tool. +Settings, variables and functions are all documented in the comprehensive program reference manual. +@subsubheading Process scores programmatically + +LilyPond input files can fully be edited or even generated by programs +and scripts. This can for example be used for algorithmical composition. +But you can also access the musical content for analysis, or manage +input fragments in a database. There are no limitations except your +imagination. + + +@subsubheading Create new tools using LilyPond + +As LilyPond isn't a monolithic GUI program but a command line tool it +can be used from within other applications too. This way it is possible +to equip tools like e.g. web applications with LilyPond's engraving +power. There already exist several online tools using LilyPond. + +@c (TBD: Add a link to the new @ref{Applications} page. + + @divEnd -@divClass{color3} +@divClass{column-center-top} @subheading Environment @imageFloat{frescobaldi-lilypond-editor-small,png,right} -@subsubheading Free software - -LilyPond can be downloaded free of charge! Yep - It's free. Get -it from the download page. - -It's also free (as in @qq{speech}) software. It comes with source -code, and permission to change and copy it. So, are you irritated -by a bug, or yearning for a feature? Simply add it yourself, or -pay someone else to do it. @subsubheading Excellent support @@ -190,17 +267,24 @@ pay someone else to do it. 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 -team makes sure that problems are solved quickly. +questions on the lilypond-user mailing list, offering you friendly +help. The response time is usually very short, and often brillant +solutions to reported problems are developed. Thanks to the close +interaction with the development team such solutions are regularly +included in LilyPond itself. +Read more in @ref{Community}. -@subsubheading Enhanced editors +@subsubheading Free software +LilyPond can be downloaded free of charge! Yep - It's free. Get +it from the download page. -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}. +It's also free (as in @qq{speech}) software. It comes with source +code, and permission to change and copy it. So, are you irritated +by a bug, or yearning for a feature? Simply add it yourself, or +pay someone else to do it. +Read more on @ref{Freedom}. @divEnd @divClass{column-center-bottom} @@ -216,51 +300,56 @@ already decided to try LilyPond, first read about our @node Examples @unnumberedsec Examples +@divClass{column-center-top} + +@subheading Beautiful examples + LilyPond is a powerful and flexible tool for engraving tasks of all kinds. Please browse our gallery of examples and be inspired! +@divEnd -@newsItem -@subsubheading Classical Music +@divClass{column-center-middle-color2} +@subheading Classical Music This organ work by J.S. Bach is a fairly typical engraving project in LilyPond. @exampleImage{bach-bwv610} -@newsEnd +@divEnd -@newsItem -@subsubheading Complex Notation +@divClass{column-center-middle-color2} +@subheading Complex Notation This example from @emph{Goyescas} by Enrique Granados shows some of the more advanced features of typesetting, including kneed beams, cross-staff stems, and voice-follow lines. @exampleImage{granados} -@newsEnd +@divEnd -@newsItem -@subsubheading Early Music +@divClass{column-center-middle-color2} +@subheading Early Music LilyPond also supports various types of ancient notation, such as this passage of Gregorian chant. @exampleImage{ancient-headword} -@newsEnd +@divEnd -@newsItem -@subsubheading Modern Music +@divClass{column-center-middle-color2} +@subheading Modern Music 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. @exampleImage{cary} -@newsEnd +@divEnd -@newsItem -@subsubheading Efficient, flexible creation of performance materials +@divClass{column-center-middle-color2} +@subheading Efficient, flexible creation of performance materials Various performance materials can be created from the same source code. This is an excerpt of @uref{http://nicolas.sceaux.free.fr/, @@ -273,10 +362,10 @@ full score, piano-vocal reduction, and a violin part. @exampleImage{sesto-violin} -@newsEnd +@divEnd -@newsItem -@subsubheading Tablature +@divClass{column-center-middle-color2} +@subheading Tablature LilyPond supports tablature notation, which can be customized to suit any instrument that reads from tablature. The tablature @@ -284,10 +373,10 @@ staff is generated automatically from notes entered for the 5-line staff. @exampleImage{tab-example} -@newsEnd +@divEnd -@newsItem -@subsubheading Schenker Graphs +@divClass{column-center-middle-color2} +@subheading Schenker Graphs Standard output can be modified heavily. Here is an impressive Schenkerian analysis, created by Kris Schaffer, for an article @@ -295,10 +384,19 @@ in @uref{http://www.linuxjournal.com/article/8364 , Linux Journal}. The colors have been added for better visibility. @exampleImage{bach-schenker} -@newsEnd +@divEnd -@newsItem -@subsubheading Vocal Music +@divClass{column-center-middle-color2} +@subheading Customized Output + +A short excerpt from Stockhausen's Klavierstück II to demonstrate +Lilypond's ability to provide customised output. + +@exampleImage{Stockhausen_Klavierstueck2} +@divEnd + +@divClass{column-center-middle-color2} +@subheading Vocal Music LilyPond is excellent for vocal music of all kinds, from sacred hymns to opera. Here is a medieval motet with slightly unusual @@ -309,19 +407,19 @@ Vaticana style clefs, the slashed stems indicating plicated notes, and the ligature braces above certain groups of notes. @exampleImage{aucun-snippet} -@newsEnd +@divEnd -@newsItem -@subsubheading Educational Applications +@divClass{column-center-middle-color2} +@subheading Educational Applications LilyPond is perfectly suited for educational purposes as well. Here is an example of a simple counterpoint exercise. @exampleImage{theory} -@newsEnd +@divEnd -@newsItem -@subsubheading Popular Music +@divClass{column-center-middle-color2} +@subheading Popular Music It is simple to create pop lead sheets with melody, lyrics, chord names, and fretboards. In this example you see some of the @@ -329,10 +427,10 @@ predefined fretboard diagrams, but these can be heavily customized to suit nearly any situation. @exampleImage{chart} -@newsEnd +@divEnd -@newsItem -@subsubheading Large Projects +@divClass{column-center-middle-color2} +@subheading Large Projects LilyPond is excellent for large projects like operas or works for full symphony orchestra, as well. In addition, the text-based @@ -340,8 +438,7 @@ input provides greater accessibility -- this example was contributed by Hu Haipeng, a blind composer. @exampleImage{orchestra} -@newsEnd - +@divEnd @divClass{column-center-bottom} @subheading Where now? @@ -368,7 +465,7 @@ not require hundreds of dollars of software! @c @divClass{column-left-top} -@divClass{color2} +@divClass{column-center-middle-color2} @divClass{keep-bullets} @subheading What are the benefits to users? @@ -409,7 +506,7 @@ available for copying, modifications, and distribution. @c @divClass{column-right-top} -@divClass{color3} +@divClass{column-center-middle-color3} @divClass{keep-bullets} @subheading Why do LilyPond developers @qq{give away} their work for free? @@ -432,7 +529,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 @@ -441,7 +538,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. @@ -471,9 +568,11 @@ LilyPond, first read about our @ref{Text input}. We have an extensive essay describing computational aesthetics: the art of creating beauty with a computer. -If you just want a quick introduction to LilyPond, the essay might -be too much material to read. If you would like to read it now, -please progress to @ref{Essay}. +This is interesting reading if you are interested in an in-depth +discussion of our fundamental ideas. Due to its volume the +essay is available as a "manual". If you would like to read +it now, please progress to @ref{Essay}. However, if you just +want a quick introduction to LilyPond, you might skip it for now. @divEnd @divClass{column-center-bottom} @@ -488,6 +587,16 @@ try LilyPond, first read about our @ref{Text input}. @node Productions @unnumberedsec Productions +@divClass{column-center-top} + +@subheading Productions using LilyPond + +Here you can read about people who actually use LilyPond +in their productions, be it for performances of their +music or as published scores. + +@divEnd + @divClass{column-left-top} @subheading Concerts @@ -498,11 +607,56 @@ Some highlights: @itemize @item -Mussorgsky's @emph{Pictures at an exhibition}, re-orchestrated and +@uref{http://www.aurelienbello.com/,Aurélien Bello} has arranged a +version of Richard Strauss's @emph{Der Rosenkavalier} for four singers +and a chamber orchestra of thirteen players. This has been commissioned +by the Berlin Philharmonic Orchestra whose members will be the performers on +@uref{http://www.festspielhaus.de/veranstaltung/der-kleine-rosenkavalier-02-04-2015-1100/,April 2nd and 6th} +at the Festspielhaus, Baden-Baden, and on +@uref{http://www.berliner-philharmoniker.de/konzerte/kalender/details/21070/,April 26th} +in the @emph{Philharmonie (großer Saal)}, Berlin. We are pleased to see +musicians of such reputation playing from LilyPond scores -- and they are +reportedly very happy with them. + +Aurélien has also re-orchestrated @emph{Der Ring des Nibelungen} by Richard +Wagner to a +@uref{http://www.rsb-online.de/content/konzerte/wagnerzyklus-10-13/wagner-fuer-kinder/index_ger.html,100-minute version for children}. +Written for a standard symphony orchestra, but with a reduced cast of +singers, it was performed by the @emph{Radio-Sinfonieorchester Berlin} +in April 2014 at the Atze Musiktheater, Berlin. The Conductor was Heiko +Matthias Förster. + +@item +Joe Smeets created sheet music for the children's book @emph{Zing Mee} +(@emph{Sing along}) by Annie M.G. published by Querido -- ISBN +9789045106205: +@uref{http://www.queridokinderenjeugdboeken.nl/web/Boek.htm?dbid=18954&typeofpage=134707, www.queridokinderenjeugdboeken.nl}; choir +rehearsal scores for the Dutch translation of Benjamin Britten's +@emph{Saint Nicolas} performed by @emph{Muziektheater Hollands Diep} in +2011; +@uref{http://www.muziektheaterhollandsdiep.nl/nl/voorstellingen/sint_nicolaas_leeft, www.muziektheaterhollandsdiep.nl}. +He has also worked on the score and parts for an arrangement of +Moussurgsky’s @emph{Boris Godounov} for wind quartet, piano and +percussion which was performed in 2014, again by +@emph{Muziektheater Hollands Diep}. + +@item +A critical edition of Tommaso Traetta's @emph{Enea nel Lazio (1760)}, +opera series with libretto by Vittorio Amedeo Cigna-Santi, in four +parts: +@uref{http://www.academia.edu/1987651/Enea_nel_Lazio_opera_riformata_prima_lazione_poi_le_parole_-_Partitura_1_4_, Part One} +@uref{http://www.academia.edu/1994533/Enea_nel_Lazio_opera_riformata_prima_lazione_poi_le_parole_-_Partitura_2_4_, Part Two} +@uref{http://www.academia.edu/1994558/Enea_nel_Lazio_opera_riformata_prima_lazione_poi_le_parole_-_Partitura_3_4_, Part Three} +@uref{http://www.academia.edu/1996242/Enea_nel_Lazio_opera_riformata_prima_lazione_poi_le_parole_-_Partitura_4_4_, Part Four} +Created by +@uref{http://unito.academia.edu/LucaRossettoCasel, Luca Rossetto Casel} +for his Ph.D. Thesis. + +@item +Mussorgsky's @emph{Pictures at an exhibition}, was 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. +Junge Philharmonie Brandenburg} in October 2011 and April 2012. @item @uref{http://www.kierenmacmillan.info/, Kieren MacMillan}, composer and @@ -516,12 +670,11 @@ 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}. +@uref{http://leftcoastensemble.org, 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. @@ -534,16 +687,16 @@ 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 -performance of Lully's @emph{Armide}, May 15-16, 2009, in Houston, -Texas (engraving by @uref{http://nicolas.sceaux.free.fr/, -Nicolas Sceaux}). +@uref{http://www.mercurybaroque.org, Mercury Baroque}'s performance of +Lully's @emph{Armide}, May 15-16, 2009, in Houston, Texas (engraving by +@uref{http://nicolas.sceaux.free.fr/, Nicolas Sceaux}). @item Instrumental excerpts from Rameau's @emph{Hippolyte et Aricie} at 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). +New York} (engraving by +@uref{http://nicolas.sceaux.free.fr/, Nicolas Sceaux}). @item @emph{Affaire étrangère}, an opera by @@ -612,6 +765,12 @@ If you've already decided to try LilyPond, first read about our @node Reviews @unnumberedsec Reviews +@divClass{column-center-top} +@subheading What do people say about LilyPond? + +@divEnd + + @divClass{column-left-top} @subheading Published articles @@ -717,8 +876,8 @@ 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 +free (open source) software [@dots{}] The sheet music produced by +LilyPond is exceptionally pretty [@dots{}] a very powerful system that can do almost anything.} @item @@ -745,7 +904,7 @@ 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 +Diving into LilyPond}. @qq{@dots{} 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. @@ -801,12 +960,11 @@ the raw, untouched output.} work. I've never seen anything approaching the output that I get 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 -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}). [..]} - -@qq{Beat that, Finale/Sibelius/Igor/whatever!!!} +application. [@dots{}] basically untweaked LilyPond output +[@dots{}] 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}). [@dots{}]} @qq{Beat that, Finale/Sibelius/Igor/whatever!!!} @divEnd @@ -843,7 +1001,7 @@ time. I'm convinced that no commercial product can come close.} @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 [@dots{}] The more I learn about LilyPond the more I like it!} @divEnd @@ -851,7 +1009,7 @@ the more I like it!} @divClass{testimonial-item} @subsubheading Vaylor Trucks, Electric guitar player (Yes, @uref{http://www.allmanbrothersband.com/modules.php?op=modload&name=userpage&file=content&page_id=12, related to}) -@qq{I am super impressed with LilyPond [..]} +@qq{I am super impressed with LilyPond [@dots{}]} @qq{THIS IS THE BEST PROGRAM EVER!!!} @@ -864,7 +1022,7 @@ the more I like it!} @qq{I had a kind of hate-passion relationship with it. Passion because the first score I saw was so amazing! The description of -LilyPond lies about its beautifulness, it is too modest! [..] as +LilyPond lies about its beautifulness, it is too modest! [@dots{}] as LilyPond is getting always better, and as I look closer how things are done in scheme, I have less and less frustrations. Anyway, what I mean is: thank you for providing LilyPond, it is really @@ -925,6 +1083,7 @@ Read about our @ref{Text input}. @c TRANSLATORS, so far it's mostly from @c http://lilypond.org/web/switch/howto +@divClass{column-center-top} @subheading @qq{Compiling} Music @imageClickable{nereid-shot-small,png, (click to enlarge), nereid-shot,png, right} @@ -1007,12 +1166,16 @@ 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. +Occasionally new users are unnecessarily confused by some aspects +of LilyPond's behaviour. Please read this manual before doubting +whether LilyPond is working correctly. More in-depth information is available in @ref{Manuals}. +Ben Lemon, a LilyPond user, has created a range of +@uref{http://benlemon.me/blog/music/lilypond/operation-lilypond/,video tutorials} +on his blog and which are aimed at new users. + @subsubheading Easier editing environments @@ -1029,7 +1192,7 @@ command completion, and pre-made templates. Other programs actually provide a GUI which allows direct manipulation of a graphical score. For more information, see @ref{Easier editing}. - +@divEnd @divClass{column-center-bottom} @subheading Where now? @@ -1043,55 +1206,43 @@ convinced? Read about @ref{Easier editing}. @node Easier editing @unnumberedsec Easier editing +@ignore +GNU policy forbids us from linking to non-Free software, so don't +add such links. -@divClass{column-center-top} -@subheading LilyPondTool - -@imageClickable{lilypondtool-2.12-screenshot-400wide,png, - (click to enlarge),lilypondtool-2.12-screenshot,png,right} - -@sourceimage{logo-linux,,,} -@sourceimage{logo-freebsd,,,} -@sourceimage{logo-macosx,,,} -@sourceimage{logo-windows,,,} - -@uref{http://lilypondtool.organum.hu} - -Created as a plugin for the -@uref{http://www.jedit.org,jEdit} text editor, -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. +In particular, don't link to: +- the LilyPond bundle for TextMate (a commercial editor for MacOS). -@divEnd +@end ignore @divClass{column-center-top} -@subheading Frescobaldi +@subheading Front-end Applications +@subsubheading Frescobaldi @imageClickable{frescobaldi-lilypond-editor-small,png, (click to enlarge),frescobaldi-lilypond-editor,png,right} @sourceimage{logo-linux,,,} -@sourceimage{logo-freebsd,,,} +@sourceimage{logo-macosx,,,} +@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 a lightweight, yet powerful, music and text editor +with many features added and enhanced particularly for LilyPond. Major +features include point-and-click links between the code and music views, +detailed score wizards, built in LilyPond documentation browser, syntax +highlighting and automatic completion. Frescobaldi is written in +Python, with PyQt4 for its user interface, and will run on all major +operating systems (GNU/Linux, Mac OS X and Windows). -@divEnd - -@divClass{column-center-top} -@subheading Denemo +@subsubheading Denemo @imageClickable{screenshot-denemo-small,png, (click to enlarge),screenshot-denemo,png,right} @sourceimage{logo-linux,,,} +@sourceimage{logo-macosx,,,} @sourceimage{logo-windows,,,} @uref{http://denemo.org} @@ -1108,6 +1259,43 @@ the text view when printed from there. @divEnd +@divClass{column-center-top} +@subheading Browser-based editors + +@subsubheading LilyBin +@uref{http://lilybin.com} + +A web-based LilyPond editor where you can typeset your scores directly +online without needing to install LilyPond. + +@subsubheading Tunefl +@uref{http://www.tunefl.com} + +With tunefl, you can typeset your mini-scores directly online without +needing to install LilyPond locally. It allows trying out all the +program's features using a convenient web interface. + +@divEnd + +@divClass{column-center-top} +@subheading IDE Plug-ins + +@subsubheading Elysium + +@sourceimage{logo-linux,,,} +@sourceimage{logo-freebsd,,,} +@sourceimage{logo-macosx,,,} +@sourceimage{logo-windows,,,} + +@uref{http://elysium.thsoft.hu} + +Elysium is a LilyPond IDE for Eclipse with an integrated, side-by-side +view for source and score. It includes rapid visual & auditive feedback +without having to switch contexts, and comes with many wizard-driven +templates. + +@divEnd + @divClass{column-center-top} @subheading Text editors @@ -1116,33 +1304,37 @@ the text view when printed from there. @sourceimage{logo-macosx,,,} @sourceimage{logo-windows,,,} +@subsubheading Emacs @uref{http://www.gnu.org/software/emacs/} +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. A developer has written +@uref{https://github.com/nsceaux/lyqi,lyqi}, an Emacs major mode. -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. As well, one of -our developers has written -@uref{http://nicolas.sceaux.free.fr/lilypond/lyqi.html,lyqi}, an -Emacs major mode. +If you are not already familiar with Emacs then you may probably prefer +to use a different editor for writing LilyPond input files. -@uref{http://www.vim.org} +More information on setting up Emacs can be found in +@rprogram{Text editor support}. +@subsubheading Vim +@uref{http://www.vim.org} Vim is a minimal text editor and is an extension of the older Unix @command{vi} editor. It is also extensible and configurable. -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. +If you are not already familiar with Vi then you may probably prefer +to use a different editor for writing LilyPond input files. -More information on setting up Emacs and Vim can be found in +More information on setting up Vim can be found in @rprogram{Text editor support}. @sourceimage{logo-macosx,,,} +@subsubheading TeXShop @uref{http://www.uoregon.edu/~koch/texshop} -The TexShop editor for MacOS@tie{}X can be extended to run LilyPond, +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: @@ -1150,65 +1342,52 @@ using the extensions available at: @uref{http://users.dimi.uniud.it/~nicola.vitacolonna/home/content/lilypond-scripts} @end example -@sourceimage{logo-macosx,,,} -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 -git clone http://github.com/textmate/lilypond.tmbundle.git - -@end example - @divEnd @divClass{column-center-top} -@subheading Programs that can export LilyPond code - +@subheading Other programs that can export LilyPond code @subsubheading Score, tab and MIDI editors: @itemize @item -@uref{http://www.canorus.org,Canorus}, a score editor, can also -export to LilyPond, but is still beta-software. Testers are -welcome, though. +@uref{http://www.jezra.net/projects/bwwtolily,bwwtolily} attempts to +convert a @code{.bww} or @code{.bmw} file to LilyPond. While not all of +the embellishments may get converted properly (this is especially true +with piobaireachd), the program will list them. @item -@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. +@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://www.musescore.org,MuseScore}, a score editor, has -incomplete LilyPond export but is being actively developed. +@uref{http://enc2ly.sourceforge.net/en/,Enc2ly} is a GNU/Linux program +which converts an Encore music score into a LilyPond one. @item -@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. +@uref{https://github.com/hanwen/go-enc2ly,go-enc2ly} is a Go tool that +converts 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. @item -@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. +@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, it has experimental support for exporting to LilyPond. @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.holmessoft.co.uk/homepage/software/NWC2LY/index.htm,NW2LY} +is a C# program which converts a NoteWorthy composer song into LilyPond. @item -@uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, a -realtime monophonic MIDI to LilyPond converter. +@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://www.tuxguitar.com.ar/,TuxGuitar}, a multitrack tablature -editor and player, includes a score viewer and can export to LilyPond. +@uref{http://www.rosegardenmusic.com,Rosegarden}, an audio and MIDI +sequencer, which also has a score editor for single-staff editing. @end itemize @@ -1218,18 +1397,19 @@ editor and player, includes a score viewer and can export to LilyPond. @item @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. +@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://common-lisp.net/project/fomus/,FOMUS}, a LISP library -to generate music notation from computer music software -environments. +@uref{http://common-lisp.net/project/fomus/,FOMUS}, (FOrmat MUSic) is a +music notation tool for computer music composers. It is written in the +Lisp programming language, and has been tested in a variety of +interpreters. A C++ port is also available. @item -@uref{http://strasheela.sourceforge.net,Strasheela}, an -environment built on top of the +@uref{http://strasheela.sourceforge.net/strasheela/doc/index.html,Strasheela}, +an environment built on top of the @uref{http://www.mozart-oz.org/, Mozart/Oz} constraint programming language. @@ -1238,27 +1418,51 @@ language. @divClass{column-center-top} -@subheading Other programs not being actively developed +@subheading Other programs no longer being actively developed @itemize +@item +@uref{https://sourceforge.net/projects/lily4jedit,LilyPondTool} was +created as a plugin for the @uref{http://www.jedit.org,jEdit} text +editor. + @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. +@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://lilycomp.sourceforge.net, LilyComp} is a graphical note +entry program, acting much like a number-pad which produces LilyPond +notes. + +@item +@uref{http://www.musescore.org,MuseScore}, a score editor. LilyPond +export was dropped in version 2.0 but earlier versions are still +available for download at +@uref{http://sourceforge.net/projects/mscore/files/mscore/,Sourceforge}. @item @uref{http://noteedit.berlios.de,NoteEdit}, which imported -@uref{http://www.musicxml.com/xml.html,MusicXML}, has been forked -into +@uref{http://www.makemusic.com/musicxml,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://extensions.services.openoffice.org/en/project/OOoLilyPond,OOoLilypond}, +an OpenOffice.org extension that converts LilyPond files it into images +within OpenOffice.org documents. Although this is no longer being +developed, it appears to still work with version 4. + +@item +@uref{https://launchpad.net/rumor/,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://sourceforge.net/projects/tuxguitar/,TuxGuitar}, a +multitrack tablature editor and player, includes a score viewer and can +export to LilyPond. @end itemize @@ -1280,7 +1484,10 @@ like to review the @ref{Features}, @ref{Examples}, or the approach to the computational aesthetics of classical engraving is explained in our @ref{Background}. +@divEnd + +@divClass{column-center-bottom} @subheading Legalese @divClass{legal}