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-bottom}
87 @subheading Software License
89 LilyPond is published under the
90 @ref{GPL, GNU General Public License}.
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,,,}
108 All logos and product images are copyright and trademark
138 @divClass{heading-center}
142 @divClass{column-center-top}
143 @subheading Generic Packages or Distribution-Specific Packages?
145 Many distributions include LilyPond in their normal package
146 system. These versions are easier to install and uninstall than
147 the generic packages, but they may be older. If you wish to use
148 our generic packages, please uninstall the official version from
149 your system using the normal package manager for your distribution.
150 See your distribution's documentation about how to use their
156 @divClass{column-left-top}
157 @subheading Generic Packages
159 @subsubheading Download
164 @sourceimage{logo-linux,,,}
166 @downloadDevelLinuxNormal
169 @downloadStableLinuxNormal
172 (if in doubt, use this)
175 @sourceimage{logo-linux,,,}
176 @downloadStableLinuxBig
179 @sourceimage{logo-linux,,,}
180 @downloadStableLinuxPPC
183 @sourceimage{logo-freebsd,,,}
184 @downloadStableFreeBSDNormal
187 @sourceimage{logo-freebsd,,,}
188 @downloadStableFreeBSDBig
193 @subsubheading Install
198 cd PATH-TO-DOWNLOAD-DIRECTORY
199 sh lilypond-@versionStable{}-OS-TYPE.sh
202 @subsubheading Uninstall
215 sh lilypond-@versionStable{}-OS-TYPE.sh --help
222 @divClass{column-right-top}
223 @subheading Compiling a file
230 @divClass{column-left-top}
231 @subheading Distribution-specific Packages
233 Please use your distribution's package manager to install or
234 upgrade to these versions.
239 @sourceimage{logo-fedora,,,}
240 @uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447,
241 Fedora: LilyPond 2.14.2}
244 @sourceimage{logo-ubuntu,,,}
245 @uref{http://packages.ubuntu.com/search?keywords=lilypond,
246 Ubuntu: LilyPond 2.14.2}
249 @sourceimage{logo-slackware,,,}
250 @uref{http://www.johannes-schoepfer.de/lilypond/,
251 Slackware: LilyPond 2.14.2}
254 @sourceimage{logo-debian,,,}
255 @uref{http://packages.debian.org/search?keywords=lilypond,
256 Debian: LilyPond 2.12.3}
259 @sourceimage{logo-suse,,,}
260 @uref{http://software.opensuse.org/search?baseproject=openSUSE%3A11.2&p=1&q=lilypond,
261 openSUSE: LilyPond 2.12.3}
268 @divClass{column-center-bottom}
272 All logos and product images are copyright and trademark
284 @unnumberedsec MacOS X
286 @divClass{heading-center}
290 @divClass{column-left-top}
293 @subsubheading Download
298 @sourceimage{logo-macosx,,,}
299 @downloadStableDarwinNormal
300 For MacOS X 10.4 or higher, running on Intel CPUs (if in doubt,
303 MacOS X 10.7 Lion is not yet supported.
306 @sourceimage{logo-macosx,,,}
307 @downloadStableDarwinPPC
308 For MacOS X 10.4 or higher, running on G3 and G4 CPUs (old Apple
311 MacOS X 10.7 Lion is not yet supported.
315 @subsubheading Install
317 Double-click the downloaded file, then drag it to wherever you
320 @subsubheading Uninstall
322 Delete the LilyPond.app folder.
326 @divClass{column-right-top}
327 @subheading Compiling a file
334 @divClass{column-left-top}
335 @subheading Running on the command-line
337 @warning{If you are happy with the GUI, then please ignore these
340 @subsubheading MacOS X on the command line
342 The most convenient way to run lilypond scripts is by setting up
343 @qq{helper} scripts of your own.
348 Create a directory to store these scripts,
357 Create a file called @command{lilypond} which contains
359 @divClass{h-scroll-auto}
362 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
366 @warning{@var{DIR} will generally be @code{/Applications/}}
370 Create similar files @command{lilypond-book},
371 @command{convert-ly}, and any other scripts you wish to use, by
372 replacing the @command{bin/lilypond} with @command{bin/convert-ly}
373 (or other program name).
377 Make the file executable,
385 Now, add this directory to your path. Modify (or create) a file
386 called @code{.profile} in your home directory such that it
390 export PATH=$PATH:~/bin
393 This file should end with a blank line.
398 @subsubheading Invoking individual scripts
400 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
401 @command{abc2ly}, and even @command{lilypond} itself --- are included
402 inside the @code{.app} file for MacOS@tie{}X.
404 Scripts can also be run from the command line by invoking them
407 @divClass{h-scroll-auto}
409 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
413 The same is true for all other scripts in that directory, such as
414 @command{lilypond-book} and @command{convert-ly}.
419 @divClass{column-center-bottom}
423 All logos and product images are copyright and trademark
434 @unnumberedsec Windows
436 @divClass{heading-center}
440 @divClass{column-left-top}
443 @subsubheading Download
448 @sourceimage{logo-windows,,,}
449 @downloadStableWindows
450 For Windows 2000, XP, Vista and Windows 7.
454 @subsubheading Install
459 Locate the downloaded file and double-click on it to start the
460 installer. Follow the instructions given to you by the installer;
461 we recommend that you leave all the install options checked and
462 use the default installation location. Click the @q{Finish} button
463 when the installer has completed. LilyPond is now installed.
467 @subsubheading Uninstall
469 To uninstall LilyPond either:
474 Locate the LilyPond folder from the @q{Start} menu and click on the
475 @q{Uninstall} icon. Click the @q{Finish} button when the uninstaller
479 Or from within the Control Panel, locate and select LilyPond and then
480 choose the option to uninstall/remove the software. Click the @q{Finish}
481 button when the uninstaller has completed.
488 @divClass{column-right-top}
489 @subheading Compiling a file
496 @divClass{column-left-top}
497 @subheading Running on the command-line
499 @warning{If you are happy with the GUI, then please ignore these
502 @subsubheading Windows on the command line
505 CHECK: check the following descriptions.
506 I don't have English version of Windows.
509 The most convenient way to run LilyPond is by adding the folder
510 which contains LilyPond executable files to the environmental variable
516 Open your @qq{System} on the Control Panel,
517 select Advanced tab and click Environmental Variables button.
520 Select the Variable @qq{Path} from Environmental variables list
521 and click the Edit button.
522 You will be presented a window titled @qq{Edit System Variable};
523 append to @qq{Variable value} the name of the folder
524 which contains LilyPond executable files like this:
527 [@var{pre-set paths}];@var{DIR}\LilyPond\usr\bin
530 @warning{@var{DIR} will generally be @code{C:@bs{}Program Files}.}
533 and click @qq{OK} button to close the window.
537 @subsubheading Invoking individual executable files
539 LilyPond executable files
540 -- such as lilypond, lilypond-book, convert-ly, and so on --
541 can be run from the command-line by invoking them:
550 @divClass{column-center-bottom}
554 All logos and product images are copyright and trademark
565 @unnumberedsec Source
567 @divClass{heading-center}
571 @warning{We @strong{do not} recommend that you attempt to build
572 LilyPond yourself; almost all user needs are better met with the
575 @divClass{column-left-bottom}
576 @subheading Source tarball
578 @downloadStableSource{}
580 For an extensive listing of all versions (old and new), see our
581 @uref{http://download.linuxaudio.org/lilypond/source/?C=N;O=D,
586 @divClass{column-right-bottom}
587 @subheading Compiling instructions
589 Instructions are listed in @rcontrib{Compiling}.
595 @unnumberedsec Old downloads
597 @divClass{heading-center}
601 @divClass{column-center-top}
602 @subheading All versions
604 For an extensive listing of all versions (old and new), see our
605 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
614 @divClass{column-center-top}
615 @subheading Software license
617 GNU LilyPond is published under the GNU General Public License.
618 An introduction to this license, and our reasons for choosing it,
619 is given in @ref{Freedom}.
623 @divClass{column-center-bottom}
624 @subheading GNU General Public License