1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
13 @macro details{reference}
15 (@ref{\reference\, details of \reference\})
19 @divClass{heading-center}
21 @heading Manuals for LilyPond @version
24 @heading Manuals for LilyPond @versionStable
29 @divClass{link-headings}
31 @divClass{column-center-top}
32 @subheading Introduction
38 LilyPond is a @strong{text-based} music engraver. Read this first!
41 @ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Learning}}
42 a @qq{must-read} gentle introduction to LilyPond.
46 @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}}
47 @emph{(optional reading)} musical terms and translations.
51 @ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essay}}
52 @emph{(optional reading)} background information about computer engraving.
59 @divClass{column-left-top}
60 @subheading Regular use
65 @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
70 @ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}}
75 @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}}
76 short tricks and tips.
84 @divClass{column-right-top}
85 @subheading Infrequent Use
91 Frequently Asked Questions.
99 @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}}
104 @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}}
109 @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}}
118 @divClass{column-center-bottom}
119 @subheading Other material
125 translation status for non-English readers.
129 downloadable and old manuals.
133 manuals for the unstable version.
137 these manuals are published under the GNU Free Documentation License.
148 * Learning:: Learning.
149 * Glossary:: Glossary.
151 * Notation:: Reference.
153 * Snippets:: Snippets.
157 * Extending:: Programming.
158 * Internals:: Internals.
159 * Translated:: Translation.
167 @c TRANSLATORS, most of the text in this file came from
168 @c LM 1.1 About the documentation (before this section was
169 @c removed in July 2009).
172 @unnumberedsec Learning
174 @divClass{column-left-top}
175 @subheading Learning manual
177 This book explains how to begin learning LilyPond, as well as
178 explaining some key concepts in easy terms. You should read these
179 chapters in a linear fashion.
181 There is a paragraph @strong{See also} at the end of each section,
182 which contains cross-references to other sections: you should not
183 follow these cross-references at first reading. When you have
184 read all of the manual, you may want to read some sections again
185 and follow those cross-references for more information.
188 @divClass{column-right-bottom}
190 @docLinks{Learning, learning,
191 @rlearningnamed{Top,Learning},
192 @manualStableLearningSplit,
193 @manualStableLearningBig, 1.5 MB,
194 @manualStableLearningPdf, 3 MB}
200 @unnumberedsec Glossary
202 @divClass{column-left-top}
205 This explains musical terms, and includes translations to various
206 languages. If you are not familiar with music notation or music
207 terminology (especially if you are a non-native English speaker),
208 it is highly advisable to consult the glossary.
212 @divClass{column-right-bottom}
214 @docLinks{Music glossary, music-glossary,
215 @rglosnamed{Top,Music glossary},
216 @manualStableGlossarySplit,
217 @manualStableGlossaryBig, 1 MB,
218 @manualStableGlossaryPdf, 1.5 MB}
226 @divClass{column-left-top}
229 This book gives a brief history of music typography, followed by
230 an examination of LilyPond's engraving techniques. A comparison
231 between LilyPond and other music engraving systems is given.
233 @warning{the detailed typographical examples are easier to analyze
234 in the PDF version due to its higher resolution.}
238 @divClass{column-right-bottom}
240 @docLinks{Essay, essay,
241 @ressaynamed{Top,Essay},
242 @manualStableEssaySplit,
243 @manualStableEssayBig, 2 MB,
244 @manualStableEssayPdf, 2.5 MB}
250 @unnumberedsec Notation
252 @divClass{column-left-top}
253 @subheading Notation reference
255 This book explains all the LilyPond commands which produce
258 @warning{the Notation reference assumes that the reader knows
259 basic material covered in the Learning manual and is familiar with
260 the English musical terms presented in the glossary.}
264 @divClass{column-right-bottom}
266 @docLinks{Notation, notation,
267 @rusernamed{Top,Notation},
268 @manualStableNotationSplit,
269 @manualStableNotationBig, 7 MB,
270 @manualStableNotationPdf, 18 MB}
278 @divClass{column-left-top}
279 @subheading Usage manual
281 This book explains how to execute the programs, how to integrate
282 LilyPond notation with other programs, and suggests @qq{best
283 practices} for efficient use. It is recommended reading before
284 attempting any large projects.
288 @divClass{column-right-bottom}
290 @docLinks{Usage, usage,
291 @rprogramnamed{Top,Usage},
292 @manualStableUsageSplit,
293 @manualStableUsageBig, 300 KB,
294 @manualStableUsagePdf, 400 KB}
300 @unnumberedsec Snippets
302 @divClass{column-left-top}
305 This shows a selected set of LilyPond snippets from the
306 @uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
307 (LSR). All the snippets are in the public domain.
309 Please note that this document is not an exact subset of LSR. LSR
310 is running a stable LilyPond version, so any snippet which
311 demonstrates new features of a development version must be added
312 separately. These are stored in @file{Documentation/snippets/new/} in the LilyPond
315 The list of snippets for each subsection of the Notation are also
316 linked from the @strong{See also} portion.
319 @divClass{column-right-bottom}
321 @docLinks{Snippets, snippets,
322 @rlsrnamed{Top,Snippets},
323 @manualStableSnippetsSplit,
324 @manualStableSnippetsBig, 2.5 MB,
325 @manualStableSnippetsPdf, 8 MB}
333 @divClass{column-center-top}
334 @subheading Introductory questions
336 @subsubheading Where are the graphical canvas, menus, and toolbars?
338 LilyPond requires you to write music as text. Please read about
339 our @ref{Text input}.
342 @subsubheading There's a lot of documentation! Do I need to read it?
344 You need to read the @ref{Learning, Learning manual}. As for the
345 rest of documentation, you only need to read the sections which
346 discuss the notation that you wish to create.
349 @subsubheading That's still a lot of reading! Is it worth it?
351 Please decide for yourself; the reasons why you might want to use
352 LilyPond are given in the @ref{Introduction}.
356 @divClass{column-center-bottom}
357 @subheading Usage questions
359 @subsubheading Something isn't working! How do I fix it?
361 This is explained in @rprogram{Troubleshooting}.
364 @subsubheading Why do you change the syntax?
366 This is explained in @rprogram{Why does the syntax change?}.
374 @divClass{column-left-top}
377 This manual supplies general information about LilyPond. It also
378 contains information about various community forums, bug
379 reporting, and development.
383 @divClass{column-right-bottom}
386 @subsubheading Latest manual
388 @divClass{keep-bullets}
394 @subsubheading Web manual in @versionDevel
396 @docLinksBare{Web, web,
398 @manualDevelWebSplit,
399 @manualDevelWebBig, 1 MB,
400 @manualDevelWebPdf, 2 MB}
406 @unnumberedsec Changes
408 @divClass{column-left-top}
411 This is a summary of important changes and new features in
412 LilyPond since the previous stable version.
416 @divClass{column-right-bottom}
418 @docLinks{Changes, changes,
419 @rchangesnamed{Top,Changes},
420 @manualStableChangesSplit,
421 @manualStableChangesBig, 6 KB,
422 @manualStableChangesPdf, 200 KB}
428 @unnumberedsec Extending
430 @divClass{column-left-top}
431 @subheading Extending LilyPond
433 This manual explains how to write extensions to LilyPond.
437 @divClass{column-right-bottom}
439 @docLinks{Extending, extending,
440 @rextendnamed{Top,Extending},
441 @manualStableExtendingSplit,
442 @manualStableExtendingBig, 200 KB,
443 @manualStableExtendingPdf, 400 KB}
449 @unnumberedsec Internals
451 @divClass{column-left-top}
452 @subheading Internals reference
454 This is a set of heavily cross linked pages which document
455 the nitty-gritty details of each and every LilyPond class, object,
456 and function. It is produced directly from the formatting
457 definitions in the source code.
459 Almost all formatting functionality that is used internally is
460 available directly to the user. For example, most variables that
461 control thickness values, distances, etc., can be changed in input
462 files. There are a huge number of formatting options, and all of
463 them are described in this document. Each section of the Notation
464 Reference has a @b{See also} subsection, which refers to the
465 generated documentation.
469 @divClass{column-right-bottom}
471 @docLinks{Internals, internals,
472 @rinternalsnamed{Top,Internals},
473 @manualStableInternalsSplit,
474 @manualStableInternalsBig, 2.5 MB,
475 @manualStableInternalsPdf, 2.8 MB}
481 @unnumberedsec Translated
483 @divClass{column-center-bottom}
484 @subheading Translations status
486 @include translations.itexi
494 @divClass{column-left-top}
495 @subheading Downloadable versions
498 Downloadable tarballs only available at @uref{http://lilypond.org}
502 @divClass{keep-bullets}
505 @item @doctarballStable
514 @divClass{column-right-bottom}
515 @subheading Previous stable versions
517 @divClass{keep-bullets}
520 @item @uref{http://lilypond.org/doc/v2.12/Documentation/,
521 LilyPond 2.12 Documentation}
523 @item @uref{http://lilypond.org/doc/v2.11/Documentation/,
524 LilyPond 2.11 Documentation}
526 @item @uref{http://lilypond.org/doc/v2.10/Documentation/,
527 LilyPond 2.10 Documentation}
529 @item @uref{http://lilypond.org/doc/v2.8/Documentation/,
530 LilyPond 2.8 Documentation}
532 @item @uref{http://lilypond.org/doc/v2.6/Documentation/,
533 LilyPond 2.6 Documentation}
535 @item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/,
536 LilyPond 2.4 Documentation}
538 @item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/,
539 LilyPond 2.2 Documentation}
541 @item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/,
542 LilyPond 2.0 Documentation}
544 @item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/,
545 LilyPond 1.8 Documentation}
547 @item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/,
548 LilyPond 1.6 Documentation}
559 @divClass{column-center-top}
560 @subheading Documentation license
562 The documentation for GNU LilyPond is published under the GNU Free
563 Documentation License. An introduction to this license, and our
564 reasons for choosing it, is given in @ref{Freedom}.
568 @divClass{column-center-bottom}
569 @subheading GNU Free Documentation License 1.1