]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/general/introduction.itexi
Merge branch 'lilypond/translation' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond
[lilypond.git] / Documentation / general / introduction.itexi
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore
3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
4
5     When revising a translation, copy the HEAD committish of the
6     version that you are working on.  See TRANSLATION for details.
7 @end ignore
8
9 @node Introduction
10 @unnumbered Introduction
11
12 @divClass{column-center-top}
13 @subheading Our Goal
14
15 @imageFloat{flat-design,png,right}
16
17 The inspiration for LilyPond came when two musicians became
18 annoyed with the bland and boring look of computer-printed
19 sheet music.  All musicians prefer reading beautiful music, so why
20 couldn't programmers write software to produce better printed
21 parts?
22
23 This software just does that: it prints music in the best
24 traditions of classical engraving with minimum fuss.  Don't waste
25 time on tuning spacing, moving around symbols, or shaping slurs.
26 Impress friends and colleagues with sharp sheet music!
27 @divEnd
28
29 @divClass{column-left-top}
30 @subheading Why use LilyPond?
31
32 @itemize
33
34 @item
35 @ref{Features}: What can LilyPond do?
36
37 @item
38 @ref{Examples}: I want to see some music!
39
40 @item
41 @ref{Freedom}: LilyPond is Free Software.
42
43 @item
44 @ref{Background}: Our computational aesthetics.
45
46 @end itemize
47 @divEnd
48
49 @divClass{column-right-top}
50 @subheading Who uses it?
51
52 @itemize
53
54 @item
55 @ref{Productions}: Real-life use of LilyPond.
56
57 @item
58 @ref{Testimonials}: What do people say?
59
60 @end itemize
61 @divEnd
62
63 @divClass{column-center-bottom}
64 @subheading Why not use LilyPond?
65
66 @itemize
67
68 @item
69 @ref{Text input}: You write music as @emph{text}?!
70
71 @item
72 @ref{Alternate input}: Other ways of working with LilyPond.
73
74 @end itemize
75 @divEnd
76
77
78 @divClass{hide}
79 @menu
80 * Features::                    What can LilyPond do?
81 * Examples::                    I want to see some music!
82 * Freedom::                     Freedom and the GPL.
83 * Background::                  Computational aesthetics.
84 * Productions::                 Real-life use of LilyPond.
85 * Testimonials::                What do people say about it?
86 * Text input::                  You write music as text?!
87 * Alternate input::             Other ways of working with LilyPond.
88 @end menu
89 @divEnd
90
91
92
93 @node Features
94 @unnumberedsec Features
95
96 @help{hoping to delegate this.  Desired: an enthusiastic
97 attempt to sway people towards trying lilypond.  The warnings
98 about writing music as text come in Crash Course, not here.}
99
100 Maybe draw inspiration from
101 @uref{http://lilypond.org/web/about/features} and
102 @uref{http://lilypond.org/web/switch/tour} and
103 @uref{http://lilypond.org/web/switch/advantages}
104
105
106
107 @subheading Why switch to LilyPond?
108
109
110 @subsubheading Excellent classical engraving
111
112 @imageFloat{flat-design,png,right}
113
114 The point of using LilyPond is to produce elegant sheet music that
115 is easy to read.  LilyPond's developer community has spent
116 thousands of hours developing powerful music engraving software
117 that results in beautifully engraved music.  All of LilyPond's
118 style settings, font designs and algorithms have been inspired by
119 the finest hand-engraved music.  LilyPond output has the same
120 strong, balanced and elegant look as the best-engraved classical
121 scores.  This is further explained in our @ref{Essay}.
122
123
124 @subsubheading Less fiddling
125
126 Spend less time with tweaking the output; LilyPond gets the
127 formatting correct right from the start.  It determines spacing by
128 itself, and breaks lines and pages to provide a tight and uniform
129 layout.  Clashes between lyrics, notes, and chords are resolved
130 and slurs and beams are sloped, automatically!
131
132
133 @subsubheading Text-based input
134
135 LilyPond takes ASCII input, which you can produce in your favorite
136 text editor, quickly and comfortably.  No more futzing with the
137 mouse.  The input contains all the information, so there is no
138 need to remember complex command sequences.  Simply save an input
139 for later reference.
140
141
142 @subsubheading Accessibility
143
144 Text-based input also makes score-writing possible for users with
145 severe physical disabilities.  Dexterity-impaired users who are
146 unable to type or control a computer mouse can use
147 speech-recognition software to edit LilyPond files.  Even users
148 who are totally blind can use screen-reading software to write
149 LilyPond files -- an impossible task in graphical-based
150 score-writing programs.
151
152
153 @subsubheading Mix music and text
154
155 @imageFloat{lilypond-book,png,right}
156
157 Put fragments of music into texts without cutting and pasting
158 pictures. Integrate music into LaTeX or HTML seamlessly, or add
159 music to OpenOffice.org with ooolilypond.
160
161
162
163 @subsubheading Free software
164
165 LilyPond can be downloaded free of charge! Yep - It's free.  Get
166 it from the download page.
167
168 It's also free (as in @qq{speech}) software. It comes with source
169 code, and permission to change and copy it. So, are you irritated
170 by a bug, or yearning for a feature? Simply add it yourself, or
171 pay someone else to do it.
172
173
174 @subsubheading Extensible design
175
176 All settings can be changed to suit your personal
177 typographical taste. If that still is not enough, there is always
178 the built-in scripting language, a dialect of the powerful
179 language LISP. Settings, variables and functions are all
180 documented in the comprehensive program reference manual.
181
182
183 @subsubheading Excellent support
184
185 LilyPond runs on all popular platforms: Linux, MacOS X, and
186 Windows.  LilyPond comes with extensive documentation and hundreds
187 of example files.  There is an active user community answering
188 questions on the Lilypond user mailing list, while the development
189 team makes sure that problems are solved quickly.
190
191
192
193 @divClass{column-center-bottom}
194 @subheading Where now?
195
196 Still not convinced?  Look at some neat @ref{Examples}.  If you've
197 already decided to try LilyPond, first read about our
198 @ref{Text input}.
199 @divEnd
200
201
202
203 @node Examples
204 @unnumberedsec Examples
205
206 Lilypond is a powerful and flexible tool for engraving tasks of
207 all kinds. Please browse our gallery of examples and be inspired!
208
209 @ignore
210 Here is a passage from Franz Liszt's solo piano transcription
211 of the Overture to Wagner's @emph{Tannhäuser}. The spacing
212 in this example was all performed by Lilypond's formatting
213 algorithms, without tweaks of any kind. It
214 handles cross-staff beaming gracefully and puts the system brace
215 perfectly around all three staves.
216
217 @exampleImage{liszt-wagner}
218 @end ignore
219
220 @newsItem
221 @subsubheading Classical Music
222 This organ work by J.S. Bach is a fairly typical engraving project
223 in Lilypond.
224
225 @exampleImage{bach-bwv610}
226 @newsEnd
227
228 @newsItem
229 @subsubheading Complex Notation
230
231 This example from @emph{Goyescas} by Enrique Granados shows some
232 of the more advanced features of typesetting, including kneed
233 beams, cross-staff stems, and voice-follow lines.
234
235 @exampleImage{granados}
236 @newsEnd
237
238 @newsItem
239 @subsubheading Early Music
240 Lilypond also supports various types of ancient notation, such
241 as this passage of Gregorian chant.
242
243 @exampleImage{ancient-headword}
244 @newsEnd
245
246 @newsItem
247 @subsubheading Modern Music
248 Contemporary composers find Lilypond well-suited to displaying
249 unusual notation. Here is an excerpt from Trevor Bača's
250 @emph{Čáry}, for unaccompanied bass flute.
251
252 @exampleImage{cary}
253 @newsEnd
254
255
256 @newsItem
257 @subsubheading Efficient, flexible creation of performance materials
258 Various performance materials can be created from the same source
259 code. This is an excerpt of @uref{http://nicolas.sceaux.free.fr/,
260 Nicolas Sceaux's} engraving of Handel's @emph{Giulio Cesare}, in
261 full score, piano-vocal reduction, and a violin part.
262
263 @exampleImage{sesto-full}
264
265 @exampleImage{sesto-piano}
266
267 @exampleImage{sesto-violin}
268
269 @newsEnd
270
271 @help NEED BETTER TABLATURE EXAMPLE!!
272
273 @newsItem
274 @subsubheading Tablature
275 Lilypond supports tablature notation, which can be customized to
276 suit any instrument that reads from tablature. Here is a passage
277 from a Bach Lute Suite, with tablature generated automatically
278 from the notes entered for the traditional staff.
279
280 @exampleImage{bach-tab-example}
281 @newsEnd
282
283 @newsItem
284 @subsubheading Schenker Graphs
285 Standard output can be modified heavily. Here someone has created
286 an impressive Schenkerian analysis.
287
288 @exampleImage{bach-schenker}
289 @newsEnd
290
291 @newsItem
292 @subsubheading Vocal Music
293 Lilypond is excellent for vocal music of all kinds, from sacred
294 hymns to opera. Here is a medieval motet with slightly unusual
295 requirements. The tenor voice is written in a different meter
296 than the others, but must line up as if it were in the same meter.
297 Lilypond handles this most elegantly. Note also the incipits with
298 Vaticana style clefs, the slashed stems indicating plicated notes,
299 and the ligature braces above certain groups of notes.
300
301 @exampleImage{aucun-snippet}
302 @newsEnd
303
304 @newsItem
305 @subsubheading Educational Applications
306 Lilypond is perfectly suited for educational purposes as well.
307 Here is an example of a simple counterpoint exercise.
308
309 @exampleImage{theory}
310 @newsEnd
311
312 @help NEED BETTER POP EXAMPLE!! Also a better theory example would be nice.
313
314 @newsItem
315 @subsubheading Popular Music
316 It is simple to create pop lead sheets with melody, lyrics,
317 chord names, and fretboards. In this example you see some of the
318 predefined fretboard diagrams, but these can be heavily customized
319 to suit nearly any situation.
320
321 @exampleImage{chart}
322 @newsEnd
323
324 @help NEED DIFFERENT ORCHESTRAL OR OPERA EXAMPLE?!
325
326 @newsItem
327 @subsubheading Large Projects
328 Lilypond is excellent for large projects like operas or works for
329 full symphony orchestra, as well. Score, parts, piano reductions,
330 and conductors' scores can be produced from the same source files.
331
332 @exampleImage{orchestral}
333 @newsEnd
334
335
336 @divClass{column-center-bottom}
337 @subheading Where now?
338
339 Still not convinced?  LilyPond is Free software, granting you
340 @ref{Freedom}.  If you've already decided to try LilyPond, first
341 read about our @ref{Text input}.
342 @divEnd
343
344
345 @node Freedom
346 @unnumberedsec Freedom
347
348 @divClass{column-center-top}
349 @subheading Free Software
350
351 @uref{http://www.gnu.org/, GNU} LilyPond is written and maintained
352 by a community of enthusiasts.  It is published under the
353 @ref{GPL, GNU General Public License} and the @ref{FDL, GNU Free
354 Documentation License}, giving everybody the freedom to fix,
355 modify, and extend the program.  Creating beautiful music should
356 not require hundreds of dollars of software!
357 @divEnd
358
359
360 @c @divClass{column-left-top}
361 @divClass{color2}
362 @divClass{keep-bullets}
363 @subheading What are the benefits to users?
364
365 @itemize
366
367 @item
368 No cost: download and try it out!  What do you have to lose?
369
370 @item
371 Sharing: if you like the program, give a copy to your friends,
372 teachers, students, and colleagues!
373
374 @item
375 Source available: if you are curious about how LilyPond creates
376 some notation, you can see exactly how it is done.
377
378 @item
379 Extendible: you can add features, fix bugs, and change the
380 functionality.  If you are not a programmer, you can hire somebody
381 to do those tasks.
382
383 This may not seem appealing to casual musicians, but the ability
384 to extend software can be highly valuable to serious composers,
385 companies, and academics.
386
387 @item
388 Future safety: if a commercial company goes bankrupt, what happens
389 to any electronic music which depends on their products?  This is
390 not a concern with LilyPond; even if the entire development team
391 quits (extremely unlikely), the program will still be legally
392 available for copying, modifications, and distribution.
393
394
395 @end itemize
396
397 @divEnd
398 @divEnd
399
400
401 @c @divClass{column-right-top}
402 @divClass{color3}
403 @divClass{keep-bullets}
404 @subheading Why do LilyPond developers @qq{give away} their work for free?
405
406 Most of us view LilyPond development as a hobby or volunteer work.
407 So this question is really asking @qq{why do people volunteer}?
408
409 @itemize
410
411 @item
412 Fun: working towards a goal can be enjoyable, especially when you
413 work as a team!
414
415 @item
416 Shared goals: we all want beautiful sheet music, but few people
417 have the expertise (and nobody has the time!), to create a program
418 which can handle all situations.  By working together -- one
419 person improves the automatic beaming code, another person
420 improves the shape of slurs, and a third person writes
421 documentation explaining how to use these features -- we can
422 achieve our goal with only a fraction of the individual effort.
423
424 @item
425 @qq{Gift culture}: the Free Software (or @qq{Open Source})
426 movement has created many great software projects, such as
427 @uref{http://kernel.org/, GNU/Linux},
428 @uref{http://www.getfirefox.com/, Mozilla Firefox}, and
429 @uref{http://www.wesnoth.org/, Battle for Wesnoth}.  Having
430 benefitted from these projects, some developers want to @qq{give
431 back} to the community.
432
433 @item
434 Work experience: contributing to open-source projects is a great
435 way to practice programming, documentation writing, or design.
436 This experience has helped some developers gain job offers or
437 scholarships.
438
439
440 @end itemize
441
442 @divEnd
443 @divEnd
444
445
446 @divClass{column-center-bottom}
447 @subheading Where now?
448
449 Still not convinced?  Read our extensive essay about our engraving
450 philosophy in @ref{Background}.  If you've already decided to try
451 LilyPond, first read about our @ref{Text input}.
452 @divEnd
453
454
455 @node Background
456 @unnumberedsec Background
457
458 @divClass{column-center-top}
459 @subheading Background essay
460
461 We have an extensive essay describing computational aesthetics:
462 the art of creating beauty with a computer.
463
464 If you just want a quick introduction to LilyPond, the essay might
465 be too much material to read.  If you would like to read it now,
466 please progress to @ref{Essay}.
467 @divEnd
468
469 @divClass{column-center-bottom}
470 @subheading Where now?
471
472 Still not convinced?  Read about some of our users'
473 @ref{Productions} and sheet music.  If you've already decided to
474 try LilyPond, first read about our @ref{Text input}.
475 @divEnd
476
477
478 @node Productions
479 @unnumberedsec Productions
480
481 @divClass{column-left-top}
482 @subheading Concerts
483
484 Lilypond engravings have been used for performances around the world.
485 Some highlights:
486
487 @divClass{keep-bullets}
488 @itemize
489
490 @item
491 @emph{Affaire Étrangère}, an opera by Valentin Villenave, with
492 libretto by Lewis Trondheim, premiered February 1, 2009, by
493 @uref{http://www.orchestre-montpellier.com/, L'Opéra Montpellier}.
494
495 @item
496 @uref{http://www.mercurybaroque.org/02/02109.aspx, Mercury Baroque}'s
497 performance of Lully's @emph{Armide}, May 15-16, 2009, in Houston,
498 Texas (engraving by @uref{http://nicolas.sceaux.free.fr/,
499 Nicolas Sceaux}).
500
501 @item
502 Instrumental excerpts from Rameau's @emph{Hippolyte et Aricie} at
503 St. James's Church in Manhattan, May 8, 2009, by Frederick Renz
504 and his ensemble @uref{http://www.earlymusicny.org/, Early Music
505 New York} (engraving by Nicolas Sceaux).
506
507 @end itemize
508 @divEnd
509
510 @divEnd
511
512
513 @divClass{column-right-top}
514 @subheading Published sheet music
515
516 @divClass{keep-bullets}
517 @itemize
518
519 @item
520 @uref{http://www.mutopiaproject.org/index.html, Mutopia Project},
521 over 1500 pieces of classical sheet music for free download, and
522 the main showcase of LilyPond scores.
523
524 @item
525 @uref{http://www.adoromusicpub.com/, Adoro Music Publishing},
526 high-quality scores of sacred music, available for immediate
527 download or in traditional paper format.
528
529 @item
530 @uref{http://theshadylanepublishing.com/, The Shady Lane
531 Publishing},
532 a @qq{micro musical publishing house} whose goal is to promote a
533 new form of musical economy closer to the musicians and music
534 lovers.
535
536 @end itemize
537
538 @divEnd
539
540 @divEnd
541
542
543 @divClass{column-center-bottom}
544 @subheading Where now?
545
546 Still not convinced?  Read some of our users' @ref{Testimonials}.
547 If you've already decided to try LilyPond, first read about our
548 @ref{Text input}.
549 @divEnd
550
551
552 @node Testimonials
553 @unnumberedsec Testimonials
554
555 @divClass{testimonial-item}
556 @imageFloat{carter-brey,jpg, right}
557 @subsubheading @uref{http://nyphil.org/meet/orchestra/index.cfm?page=profile&personNum=7, Carter Brey}, Principal Cellist, New York Philharmonic
558
559 @qq{... I've written a couple of encore pieces for solo cello
560 which I've printed with LilyPond and which I'm going to submit to
561 Schirmer for publication. I'll bet their engraved version wouldn't
562 look half as sharp as mine!}
563 @divEnd
564
565
566 @divClass{testimonial-item}
567 @imageFloat{orm-finnendahl,jpg, left}
568 @subsubheading @uref{http://icem-www.folkwang-hochschule.de/~finnendahl/, Orm Finnendahl}, professor of Composition, Musikhochschule Freiburg
569
570 @qq{Although I don't know [LilyPond] very well yet, I'm
571 @strong{*very} impressed. I used the program to input a motet of
572 Josquin Desprez in mensural notation and there's no doubt that
573 lilypond outscores all other notation programs easily concerning
574 speed, ease of use and look!} @divEnd
575
576
577 @divClass{testimonial-item}
578 @imageFloat{darius-blasband,jpg, right}
579 @subsubheading Darius Blasband, composer (Brussels, Belgium)
580
581 @qq{[..after the first orchestra rehearsal] I got numerous
582 compliments about the quality of the scores. Even more
583 importantly, while Lilypond provides numerous hacks to improve the
584 way its scores look, what the orchestra got from me is basically
585 the raw, untouched output.}
586
587 @divEnd
588
589
590 @divClass{testimonial-item}
591 @subsubheading Kieren MacMillan, composer (Toronto, Canada)
592
593 @qq{thanks and kudos to the development team for their incredible
594 work. I've never seen anything approaching the output that I get
595 from Lilypond -- I'm totally confident that my music publishing
596 needs will be fulfilled beyond my expectations using this great
597 application. [..] basically untweaked Lilypond output [..] looks
598 better than most recent @q{professional} publications I've compared
599 it to (q.v., just about any Warner Bros. score, and even many of
600 the most recent by @q{the old houses}). [..]}
601
602 @qq{Beat that, Finale/Sibelius/Igor/whatever!!!}
603 @divEnd
604
605
606 @divClass{testimonial-item}
607 @subsubheading Chris Cannam, lead programmer of the @uref{http://www.rosegardenmusic.com/, RoseGarden} project.
608
609 @qq{Lilypond is obviously the zillion-ton gorilla [of great music
610 typesetting].}
611 @divEnd
612
613
614 @divClass{testimonial-item}
615 @subsubheading Chris Snyder, @uref{http://www.adoromusicpub.com/, Adoro Music Publishing}
616
617 @qq{The way that music is entered for LilyPond causes me to think in a
618 more musical way -- there have been times when I've been stumped as
619 to how to tell Lily to engrave something, only to realize that
620 even if I did get it exactly as the composer wanted, the music
621 would be confusing to read.  LilyPond makes it much easier for me
622 to work in my dual editor+engraver role.}
623
624 @qq{I've been using LilyPond exclusively for my fledgling music
625 publishing business. Virtually without exception, every composer
626 has been blown away by the quality of the engraving when presented
627 with the proofs of their music about to be published. I deserve
628 some of the credit for this -- I spend a lot of time tweaking
629 output, especially ties (mainly in chords) -- but LilyPond gives
630 me an excellent starting point, a very intuitive interface, and
631 the ability to modify absolutely anything if I want to take the
632 time. I'm convinced that no commercial product can come close.}
633 @divEnd
634
635
636 @divClass{testimonial-item}
637 @subsubheading David Bobroff, Bass Trombone, Iceland Symphony Orchestra
638
639 @qq{I think Lilypond is great [..] The more I learn about LilyPond
640 the more I like it!}
641 @divEnd
642
643
644 @divClass{testimonial-item}
645 @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})
646
647 @qq{I am super impressed with LilyPond [..]}
648
649 @qq{THIS IS THE BEST PROGRAM EVER!!!}
650
651 @qq{Thank you all SO MUCH for your hard work and dedication!}
652 @divEnd
653
654
655 @divClass{testimonial-item}
656 @subsubheading @uref{http://nicolas.sceaux.free.fr/, Nicolas Sceaux}, @uref{http://www.mutopiaproject.org/, Mutopia} contributor
657
658 @qq{I had a kind of hate-passion relationship with it. Passion
659 because the first score I saw was so amazing! The description of
660 LilyPond lies about its beautifulness, it is too modest! [..] as
661 LilyPond is getting always better, and as I look closer how things
662 are done in scheme, I have less and less frustrations. Anyway,
663 what I mean is: thank you for providing LilyPond, it is really
664 good.}
665 @divEnd
666
667
668 @divClass{testimonial-item}
669 @subsubheading @uref{http://www.troff.org/whoswho.html#werner, Werner Lemberg}, Conductor at the Theatre in Koblenz, Germany and distinguished GNU Hacker.
670
671 @qq{Anyway, LilyPond does an amazingly good job!}
672 @divEnd
673
674
675 @divClass{testimonial-item}
676 @subsubheading Paul Davis, developer of @uref{http://jackaudio.org/, JACK} and @uref{http://www.ardour.org/, Ardour}.
677
678 @qq{I think [LilyPond is] an incredible program, and it produces
679 wonderful, wonderful output. when i read an interview about it
680 last year, i was raving to several friends of mine about its
681 potential.}
682 @divEnd
683
684
685 @divClass{column-center-bottom}
686 @subheading Where now?
687
688 Read about our @ref{Text input}.
689 @divEnd
690
691
692
693 @node Text input
694 @unnumberedsec Text input
695
696 @c TRANSLATORS: so far it's mostly from
697 @c http://lilypond.org/web/switch/howto
698
699 @subheading @qq{Compiling} Music
700
701 @imageClickable{nereid-shot-small,png, (click to enlarge), nereid-shot,png, right}
702
703 LilyPond is a @emph{compiled} system: it is run on a text file
704 containing the notes.  The resulting output is viewed on-screen or
705 printed.  In some ways, LilyPond is more similar to a programming
706 language than graphical score editing software.
707
708 You do not write music by dragging notes from a graphical toolbar
709 and placing them on a dynamically refreshing score; you write
710 music by typing text.  This text is interpreted (or @qq{compiled})
711 by LilyPond, which produces beautifully engraved sheet music.
712
713 People accustomed to graphical user interfaces might need to learn
714 a new way of working, but the results are definitely worth it!
715
716 @warning{We present a quick overview of our text input -- it's not
717 as complicated as it sounds!  Don't worry about understanding
718 every detail in these examples; our beginner documentation covers
719 everything at a much more gradual pace.}
720
721
722 @subsubheading It's as simple as A B C
723
724 Notes are encoded with letters and numbers.  Special commands are
725 entered with backslashes.
726
727 @imageFloat{text-input-1-annotate,png,center}
728 @imageFloat{text-input-1-output,png,center}
729
730 Alterations are made with different names: add @code{-is} for
731 sharp, and @code{-es} for flat (these are Dutch note names, other
732 languages are available).  LilyPond figures out where to put
733 accidentals.
734
735 @imageFloat{text-input-2-annotate,png,center}
736 @imageFloat{text-input-2-output,png,center}
737
738
739 @subsubheading Pop music
740
741 Put chords and lyrics together to get a lead sheet:
742
743 @imageFloat{text-input-pop-annotate,png,center}
744 @imageFloat{text-input-pop-output,png,center}
745
746
747
748 @subsubheading Orchestral parts
749
750 The input file contains the notes of piece.  Score and parts can
751 be made from a single input file.  So, changing a note always
752 affects both parts and score.  To share the notes, the music is
753 assigned to a variable:
754
755 @imageFloat{text-input-parts-both-annotate,png,center}
756
757
758 This variable is then used in a single part (here transposed, with
759 condensed multi rests):
760
761 @imageFloat{text-input-parts-single-annotate,png,center}
762 @imageFloat{text-input-parts-single-output,png,center}
763
764
765 The same variable is used in the full score (here in concert
766 pitch):
767
768 @imageFloat{text-input-score-annotate,png,center}
769 @imageFloat{text-input-score-output,png,center}
770
771
772 @subsubheading Beginner Documentation
773
774 We realize that many users find this way of entering music a bit
775 odd.  For this reason, we have written extensive documentation to
776 help new users, beginning with @ref{Learning}.
777
778 Please read the Learning Manual before complaining about bugs!
779 New users occasionally believe that LilyPond is not working
780 correctly, when in fact it is working precisely as designed.
781
782 @help{any suggestions for a picture here?}
783
784
785 @subsubheading Easier editing environments
786
787 LilyPond is primarily concerned with producing top-quality
788 engraved sheet music; creating a Graphical User Interface (GUI)
789 would distract us from this goal.  However, there are other
790 projects aimed at making it easier to create LilyPond input files.
791
792 Some editing environments include syntax highlighting, automatic
793 command completion, and pre-made templates.  Other programs
794 actually provide a GUI which allows direct manipulation of a
795 graphical score.  For more information, see our documentation
796 about @ref{Alternate input}.
797
798
799 @divClass{column-center-bottom}
800 @subheading Where now?
801
802 You are now ready to @ref{Download, Download LilyPond}.  Still not
803 convinced?  Read about easier editing environments in
804 @ref{Alternate input}.
805
806 @divEnd
807
808
809 @node Alternate input
810 @unnumberedsec Alternate input
811
812 @divClass{column-center-top}
813 @subheading Graphical environment: Denemo
814
815 @sourceimage{logo-linux,,,}
816
817 FIXME: insert text and a graphic
818
819 @divEnd
820
821 @divClass{column-center-top}
822 @subheading Mixed environment: LilyPondTool
823
824 @sourceimage{logo-linux,,,}
825 @sourceimage{logo-freebsd,,,}
826 @sourceimage{logo-macosx,,,}
827 @sourceimage{logo-windows,,,}
828
829 Created as a plugin for the
830 @uref{http://@/www@/.jedit@/.org@/,jEdit} text editor,
831 LilyPondTool is one of the most feature-rich text-based tool for
832 editing LilyPond scores.  Its features include a Document Wizard
833 with lyrics support to set up documents easier, and embedded PDF
834 viewer with advanced point-and-click support.  For screenshots,
835 demos, and installation instructions, visit
836 @uref{http://lilypondtool@/.organum@/.hu}
837
838
839 @divEnd
840
841 @divClass{column-center-top}
842 @subheading Text environment: Emacs and Vim
843
844 @sourceimage{logo-linux,,,}
845 @sourceimage{logo-freebsd,,,}
846 @sourceimage{logo-macosx,,,}
847 @sourceimage{logo-windows,,,}
848
849
850 FIXME: insert text and a graphic
851
852 @divEnd
853
854 @divClass{column-center-top}
855 @subheading Other
856
857 FIXME: insert text and a graphic(s)
858
859 @subsubheading TexShop
860
861 @sourceimage{logo-macosx,,,}
862
863 The
864 @uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop}
865 editor for MacOS@tie{}X can be extended to run LilyPond,
866 lilypond-book and convert-ly from within the editor, using the
867 extensions available at
868 @uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html}.
869
870
871 @ignore
872 TODO: ask somebody to sponsor/check these.  -gp
873
874 @subsubheading TextMate
875
876 @sourceimage{logo-macosx,,,}
877
878 There is a LilyPond bundle for TextMate.  It may be installed by
879 running:
880
881 @example
882 mkdir -p /Library/Application\ Support/TextMate/Bundles
883 cd /Library/Application\ Support/TextMate/Bundles
884 svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/
885 @end example
886 @end ignore
887
888 @subsubheading LilyKDE
889
890 @sourceimage{logo-linux,,,}
891 @sourceimage{logo-freebsd,,,}
892
893 @uref{http://lilykde.googlecode.com/,LilyKDE} is a plugin for
894 KDE's text editor @uref{http://kate-editor.org/,Kate}.  It has a
895 powerful Score Wizard to quickly setup a LilyPond document and an
896 embedded PDF viewer.
897
898 LilyKDE can use @uref{http://www.volny.cz/smilauer/rumor/,Rumor},
899 so music can entered by playing on a MIDI keyboard.
900
901 Other features are lyric hyphenation and running LilyPond on
902 multiple files at once from within the KDE file manager.
903
904
905 @divEnd
906
907
908 @divClass{column-center-bottom}
909 @subheading Where now?
910
911 You are now ready to @ref{Download, Download LilyPond}.
912
913 Still not convinced?  Many composers, musicians, and conductors
914 have learned how to write music in our input format.  Experienced
915 users even report that they can enter a full score in LilyPond
916 faster than with a piano keyboard or mouse+GUI!  Perhaps you would
917 like to review the @ref{Features}, @ref{Examples}, or the
918 @ref{Freedom} that LilyPond provides, or read about users'
919 @ref{Productions} and @ref{Testimonials}.  In addition, our
920 approach to the computational aesthetics of classical engraving is
921 explained in our @ref{Background}.
922
923
924 @subheading Legalese
925
926 @divClass{legal}
927 All logos and product images are copyright and trademark
928 acknowledged.
929
930 @logoLegalLinux
931
932 @logoLegalFreeBSD
933
934 @logoLegalMacOSX
935
936 @logoLegalWindows
937
938 @divEnd
939
940 @divEnd
941
942
943
944