X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fintroduction.itexi;h=704a3e8a50f6a13660c21ed99864c013dcd0a054;hb=dfd1134c63655440bb971d47d223411ddeb4e4aa;hp=bfd02c09b83e1e8288557e2894608283f708c0cd;hpb=ec36bdf4bd3a8a2091baa1685fd54a4c6a570fb4;p=lilypond.git diff --git a/Documentation/web/introduction.itexi b/Documentation/web/introduction.itexi index bfd02c09b8..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 @@ -303,48 +307,49 @@ already decided to try LilyPond, first read about our 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/, @@ -357,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 @@ -368,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 @@ -379,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 + +@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 -@newsItem -@subsubheading Vocal Music +@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 @@ -393,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 @@ -413,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 @@ -424,8 +438,6 @@ input provides greater accessibility -- this example was contributed by Hu Haipeng, a blind composer. @exampleImage{orchestra} -@newsEnd - @divEnd @divClass{column-center-bottom} @@ -453,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? @@ -494,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? @@ -556,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} @@ -592,6 +606,26 @@ Some highlights: @divClass{keep-bullets} @itemize +@item +@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 @@ -599,11 +633,12 @@ Joe Smeets created sheet music for the children's book @emph{Zing Mee} @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}; and is currently -working on the score and parts for an arrangement of Moussurgsky's -@emph{Boris Godounov} for wind quartet, piano and percussion. To be -performed in 2014, again by @emph{Muziektheater Hollands Diep}. +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)}, @@ -618,11 +653,10 @@ Created by for his Ph.D. Thesis. @item -Mussorgsky's @emph{Pictures at an exhibition}, re-orchestrated and +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 @@ -731,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 @@ -1043,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} @@ -1125,9 +1166,9 @@ 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}. @@ -1151,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? @@ -1175,69 +1216,33 @@ In particular, don't link to: @end ignore @divClass{column-center-top} -@subheading Tunefl - -@sourceimage{logo-linux,,,} -@sourceimage{logo-freebsd,,,} -@sourceimage{logo-macosx,,,} -@sourceimage{logo-windows,,,} - -@uref{http://www.tunefl.com} - -With tunefl you can typeset your 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 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. - -@divEnd - -@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 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 +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} @@ -1255,7 +1260,27 @@ the text view when printed from there. @divEnd @divClass{column-center-top} -@subheading Text editors +@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,,,} @@ -1269,32 +1294,47 @@ 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 + +@sourceimage{logo-linux,,,} +@sourceimage{logo-freebsd,,,} +@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. A developer -has written @uref{https://github.com/nsceaux/lyqi,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: @@ -1305,8 +1345,7 @@ using the extensions available at: @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: @@ -1324,19 +1363,13 @@ 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. +which converts an Encore music score into a LilyPond one. @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. - -@item -@uref{http://www.musescore.org,MuseScore}, a score editor, has -incomplete LilyPond export but is being actively developed. +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{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd}, @@ -1356,14 +1389,6 @@ mixing different musical works together in a single score or part. @uref{http://www.rosegardenmusic.com,Rosegarden}, an audio and MIDI sequencer, which also has a score editor for single-staff editing. -@item -@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 Algorithmic code generators @@ -1393,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. +@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.makemusic.com/musicxml,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{http://lilycomp.sourceforge.net, LilyComp} is a graphical -note entry program, acting much like a number-pad which produces -LilyPond notes. +@uref{https://launchpad.net/rumor/,Rumor}, a realtime monophonic +MIDI-to-LilyPond converter. + +@item +@uref{http://sourceforge.net/projects/tuxguitar/,TuxGuitar}, a +multitrack tablature editor and player, includes a score viewer and can +export to LilyPond. @end itemize @@ -1435,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}