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..
10 @include included/generating-output.itexi
12 @macro warningTextBased
13 @warning{LilyPond is a @strong{text-based} music engraver; it is
14 more similar to a programming language than a graphical score
15 editing program. Before downloading LilyPond, please read about
16 our @ref{Text input}.}
22 @divClass{heading-center}
24 @c yes, we want versionDevel here, since the online links
25 @c for @version won't be up yet!
26 @heading Downloads for LilyPond @versionDevel
28 @warning{Links for the stable version of LilyPond can be found at
29 @uref{http://lilypond.org, lilypond.org}}
32 @heading Downloads for LilyPond @versionStable
39 @divClass{link-headings}
41 @divClass{column-left-top}
47 @c ref is duplicated to avoid underlining ref as image.
48 @ref{Unix, @sourceimage{logo-linux,,,}
49 @sourceimage{logo-freebsd,,,}}
50 @ref{Unix, Unix (GNU/Linux and FreeBSD)}
53 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
54 @ref{MacOS X, MacOS X}
57 @ref{Windows, @sourceimage{logo-windows,,,}}
58 @ref{Windows, Microsoft Windows}
64 @divClass{column-right-top}
65 @subheading For developers
77 @item @ref{Development}:
78 latest unstable version
85 @divClass{column-center-middle-color2}
87 @subheading Software License
89 LilyPond is published under the
90 @ref{GPL, GNU General Public License}.
94 @divClass{column-center-bottom}
98 Many thanks to @uref{http://www.vt.edu/, Virginia Tech} and
99 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
102 @sourceimage{VTlogo_ITF,,,}
103 @sourceimage{lao_banner_06_on_white_demo,,,}
107 @divClass{column-center-bottom}
111 All logos and product images are copyright and trademark
141 @divClass{heading-center}
145 @divClass{column-center-top}
146 @subheading Generic Packages or Distribution-Specific Packages?
148 Many distributions include LilyPond within their normal package
149 repositories that are often @emph{significantly} older than the current
150 stable version. While these older packages may be easier to install, we
151 @emph{strongly} recommend that you use our generic packages. In this
152 case, check that your LilyPond editor is using the correct version.
153 See @ref{Easier editing}.
158 @divClass{column-left-top}
159 @subheading Generic Packages
161 @subsubheading Download
166 @sourceimage{logo-linux,,,}
168 @downloadDevelLinuxNormal
171 @downloadStableLinuxNormal
176 @sourceimage{logo-linux,,,}
177 @downloadStableLinuxBig
181 @sourceimage{logo-linux,,,}
182 @downloadStableLinuxPPC
185 @sourceimage{logo-freebsd,,,}
186 @downloadStableFreeBSDNormal
190 @sourceimage{logo-freebsd,,,}
191 @downloadStableFreeBSDBig
197 @subsubheading Install
202 cd PATH-TO-DOWNLOAD-DIRECTORY
203 sh lilypond-@versionStable{}-OS-TYPE.sh
206 @subsubheading Uninstall
219 sh lilypond-@versionStable{}-OS-TYPE.sh --help
226 @divClass{column-right-top}
227 @subheading Compiling a file
234 @divClass{column-center-bottom}
238 All logos and product images are copyright and trademark
250 @unnumberedsec MacOS X
252 @divClass{heading-center}
256 @divClass{column-left-top}
259 @subsubheading Download
264 @sourceimage{logo-macosx,,,}
265 @downloadStableDarwinNormal
266 For MacOS X 10.4 or higher, running on Intel CPUs (if in doubt,
271 @sourceimage{logo-macosx,,,}
272 @downloadStableDarwinPPC
273 For MacOS X 10.4 or higher, running on G3 and G4 CPUs (old Apple
279 @subsubheading Install
281 Double-click the downloaded file, then drag it to wherever you
284 @subsubheading Uninstall
286 Delete the LilyPond.app folder.
291 @divClass{column-right-top}
292 @subheading Running on the command-line
294 @warning{If you are happy with the GUI instructions below, then
295 please ignore these instructions.}
297 @subsubheading MacOS X on the command line
299 The most convenient way to run lilypond scripts is by setting up
300 @qq{helper} scripts of your own.
305 Create a directory to store these scripts,
314 Create a file called @command{lilypond} which contains
316 @divClass{h-scroll-auto}
319 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
323 @warning{@var{DIR} will generally be @code{/Applications/}}
327 Create similar files @command{lilypond-book},
328 @command{convert-ly}, and any other scripts you wish to use, by
329 replacing the @command{bin/lilypond} with @command{bin/convert-ly}
330 (or other program name).
334 Make the file executable,
342 Now, add this directory to your path. Modify (or create) a file
343 called @code{.profile} in your home directory such that it
347 export PATH=$PATH:~/bin
350 This file should end with a blank line.
355 @subsubheading Invoking individual scripts
357 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
358 @command{abc2ly}, and even @command{lilypond} itself --- are included
359 inside the @code{.app} file for MacOS@tie{}X.
361 Scripts can also be run from the command line by invoking them
364 @divClass{h-scroll-auto}
366 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
370 The same is true for all other scripts in that directory, such as
371 @command{lilypond-book} and @command{convert-ly}.
376 @divClass{column-center-top}
377 @subheading Compiling a file
384 @divClass{column-center-bottom}
388 All logos and product images are copyright and trademark
399 @unnumberedsec Windows
401 @divClass{heading-center}
405 @divClass{column-left-top}
408 @subsubheading Download
413 @sourceimage{logo-windows,,,}
414 @downloadStableWindows
415 For Windows 2000, XP, Vista, Windows 7 and 8.
419 @subsubheading Install
424 Locate the downloaded file and double-click on it to start the
425 installer. Follow the instructions given to you by the installer;
426 we recommend that you leave all the install options checked and
427 use the default installation location. Click the @q{Finish} button
428 when the installer has completed. LilyPond is now installed.
432 @subsubheading Uninstall
434 To uninstall LilyPond either:
439 Locate the LilyPond folder from the @q{Start} menu and click on the
440 @q{Uninstall} icon. Click the @q{Finish} button when the uninstaller
444 Or from within the Control Panel, locate and select LilyPond and then
445 choose the option to uninstall/remove the software. Click the @q{Finish}
446 button when the uninstaller has completed.
453 @divClass{column-right-top}
454 @subheading Running on the command-line
456 @warning{If you are happy with the GUI instructions below, then
457 please ignore these instructions.}
459 @subsubheading Windows on the command line
462 CHECK: check the following descriptions.
463 I don't have English version of Windows.
466 The most convenient way to run LilyPond is by adding the folder
467 which contains LilyPond executable files to the environmental variable
473 Open your @qq{System} on the Control Panel,
474 select Advanced tab and click Environmental Variables button.
477 Select the Variable @qq{Path} from Environmental variables list
478 and click the Edit button.
479 You will be presented a window titled @qq{Edit System Variable};
480 append to @qq{Variable value} the name of the folder
481 which contains LilyPond executable files like this:
484 [@var{pre-set paths}];@var{DIR}\LilyPond\usr\bin
487 @warning{@var{DIR} will generally be @code{C:@bs{}Program Files (x86)}
488 for 64 bit or @code{C:@bs{}Program Files} for 32 bit systems.}
491 and click @qq{OK} button to close the window.
495 @subsubheading Invoking individual executable files
497 LilyPond executable files
498 -- such as lilypond, lilypond-book, convert-ly, and so on --
499 can be run from the command-line by invoking them:
508 @divClass{column-center-top}
509 @subheading Compiling a file
516 @divClass{column-center-bottom}
520 All logos and product images are copyright and trademark
531 @unnumberedsec Source
533 @divClass{heading-center}
537 @warning{We @strong{do not} recommend that you attempt to build
538 LilyPond yourself; almost all user needs are better met with the
541 @divClass{column-left-bottom}
542 @subheading Source tarball
544 @downloadStableSource{}
546 For an extensive listing of all versions (old and new), see our
547 @uref{http://download.linuxaudio.org/lilypond/source/?C=N;O=D,
552 @divClass{column-right-bottom}
553 @subheading Compiling instructions
555 Instructions are listed in @rcontrib{Compiling}.
561 @unnumberedsec Old downloads
563 @divClass{heading-center}
567 @divClass{column-center-top}
568 @subheading All versions
570 For an extensive listing of all versions (old and new), see our
571 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
580 @divClass{column-center-top}
581 @subheading Software license
583 GNU LilyPond is published under the GNU General Public License.
584 An introduction to this license, and our reasons for choosing it,
585 is given in @ref{Freedom}.
589 @divClass{column-center-bottom}
590 @subheading GNU General Public License