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. See TRANSLATION for details.
9 @macro warningTextBased
10 @warning{LilyPond is a @strong{text-based} music engraver; it is
11 more similar to a programming language than a graphical score
12 editing program. Before downloading LilyPond, please read about
13 our @ref{Text input}.}
19 @divClass{heading-center}
21 @c yes, we want verisonDevel here, since the online links
22 @c for @version won't be up yet!
23 @heading Downloads for LilyPond @versionDevel
25 Links for the stable version of LilyPond can be found on
26 @uref{http://lilypond.org, lilypond.org}
29 @heading Downloads for LilyPond @versionStable
36 @divClass{column-left-top}
42 @c TODO: duplicate to avoid underlined refs in HTML? icky.
43 @ref{Unix, @sourceimage{logo-linux,,,}
44 @sourceimage{logo-freebsd,,,}}
45 @ref{Unix, Unix (Linux and FreeBSD)}
48 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
49 @ref{MacOS X, MacOS X}
52 @ref{Windows, @sourceimage{logo-windows,,,}}
53 @ref{Windows, Microsoft Windows}
59 @divClass{column-right-top}
60 @subheading For developers
72 @item @ref{Development}:
73 latest unstable version
79 @divClass{column-center-bottom}
81 @subheading Software License
83 LilyPond is published under the
84 @ref{GPL, GNU General Public License}.
92 Many thanks to @uref{http://www.vt.edu/, Virgina Tech} and
93 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
96 @sourceimage{VTlogo_ITF,,,}
97 @sourceimage{lao_banner_06_on_white_demo,,,}
102 All logos and product images are copyright and trademark
132 @divClass{heading-center}
136 @divClass{column-center-top}
137 @subheading Generic Packages or Distribution-Specific Packages?
139 Many distributions include LilyPond in their normal package
140 system. These versions are easier to install and uninstall than
141 the generic packages, but they may be older. If you wish to use
142 our generic packages, please uninstall the official version from
143 your system using the normal package manager for your distribution.
144 See your distribution's documentation about how to use their
150 @divClass{column-left-top}
151 @subheading Generic Packages
153 @subsubheading Download
158 @sourceimage{logo-linux,,,}
160 @downloadDevelLinuxNormal
163 @downloadStableLinuxNormal
166 (if in doubt, use this)
169 @sourceimage{logo-linux,,,}
170 @downloadStableLinuxBig
173 @sourceimage{logo-linux,,,}
174 @downloadStableLinuxPPC
177 @sourceimage{logo-freebsd,,,}
178 @downloadStableFreeBSDNormal
181 @sourceimage{logo-freebsd,,,}
182 @downloadStableFreeBSDBig
187 @subsubheading Install
192 cd PATH-TO-DOWNLOAD-DIRECTORY
193 sh lilypond-@versionStable{}-OS-TYPE.sh
196 @subsubheading Uninstall
207 @divClass{column-right-top}
208 @subheading Distribution-specific Packages
210 Please use your distribution's package manager to install or
211 upgrade to these versions.
216 @sourceimage{logo-fedora,,,}
217 @uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447,
218 Fedora: LilyPond 2.12.2}
221 @sourceimage{logo-ubuntu,,,}
222 @uref{http://packages.ubuntu.com/search?keywords=lilypond,
223 Ubuntu: LilyPond 2.12.2}
226 @sourceimage{logo-slackware,,,}
227 @uref{http://www.johannes-schoepfer.de/lilypond/,
228 Slackware: LilyPond 2.12.2}
231 @sourceimage{logo-debian,,,}
232 @uref{http://packages.debian.org/search?keywords=lilypond,
233 Debian: LilyPond 2.12.2}
236 @sourceimage{logo-suse,,,}
237 @uref{http://download.opensuse.org/repositories/openSUSE:/Factory:/Contrib/standard/,
238 openSUSE: LilyPond 2.12.2}
245 @divClass{column-center-bottom}
249 All logos and product images are copyright and trademark
261 @unnumberedsec MacOS X
263 @divClass{heading-center}
267 @divClass{column-left-top}
270 @subsubheading Download
275 @sourceimage{logo-macosx,,,}
276 @downloadStableDarwinNormal
277 For Intel chips (if in doubt, use this).
280 @sourceimage{logo-macosx,,,}
281 @downloadStableDarwinPPC
282 For G3 and G4 CPUs (old Apple computers).
286 @subsubheading Install
288 Double-click the downloaded file, then drag it to wherever you
291 @subsubheading Uninstall
293 Delete the LilyPond.app folder.
298 @divClass{column-right-top}
299 @subheading Running on the command-line
301 @warning{If you are happy with the GUI, then please ignore these
305 FIXME: I had one report that we don't need this stuff; will delete
306 after confirmation. -gp
308 @subsubheading Using Python scripts on MacOS 10.3 or 10.4
310 LilyPond binaries for MacOS X do not provide Python, but Python 2.4 or
311 newer is required by @command{convert-ly}. Therefore, if you use MacOS
312 10.3 or 10.4, you must install a newer Python version from
313 @uref{http://python.org/download/}, then edit the first line of
314 @command{convert-ly} and @command{lilypond-book} as follows: if the
315 Python binary you just installed is in your @var{PATH}, the first line
319 #!/usr/bin/env python
323 otherwise it should be
326 #!@var{/path/to/newly_installed/python}
330 @subsubheading MacOS X on the command line
332 The most convenient way to run lilypond scripts is by setting up
333 @qq{helper} scripts of your own.
338 Create a directory to store these scripts,
347 Create a file called @command{lilypond} which contains
349 @help obvious css issue to be dealt with. :(
350 @c we need a small font here to fit. -gp
352 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
355 @warning{@var{DIR} will generally be @code{/Applications/}}
359 Create similar files @command{lilypond-book},
360 @command{convert-ly}, and any other scripts you wish to use, by
361 replacing the @command{bin/lilypond} with @command{bin/convert-ly}
362 (or other program name).
366 Make the file executable,
374 Now, add this directory to your path. Modify (or create) a file
375 called @code{.profile} in your home directory such that it
379 export PATH=$PATH:~/bin
382 This file should end with a blank line.
387 @subsubheading Invoking individual scripts
389 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
390 @command{abc2ly}, and even @command{lilypond} itself --- are included
391 inside the @code{.app} file for MacOS@tie{}X.
393 Scripts can also be run from the command line by invoking them
397 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
400 The same is true for all other scripts in that directory, such as
401 @command{lilypond-book} and @command{convert-ly}.
406 @divClass{column-center-bottom}
410 All logos and product images are copyright and trademark
421 @unnumberedsec Windows
423 @divClass{heading-center}
427 @divClass{column-left-top}
430 @subsubheading Download
435 @sourceimage{logo-windows,,,}
436 @downloadStableWindows
437 For Windows ME, NT, 2000, XP, Vista, and Windows 7.
441 @subsubheading Install
446 Locate the downloaded file and double-click on it to start the
447 installer. Follow the instructions given to you by the installer;
448 we recommend that you leave all the install options checked and
449 use the default installation location. Click the @q{Finish} button
450 when the installer has completed. Lilypond is now installed.
454 @subsubheading Uninstall
456 To uninstall Lilypond either:
461 Locate the Lilypond folder from the @q{Start} menu and click on the
462 @q{Uninstall} icon. Click the @q{Finish} button when the uninstaller
466 Or from witin the Control Panel,locate and select Lilypond and then
467 choose the option to uninstall/remove the software. Click the @q{Finish}
468 button when the uninstaller has completed.
475 @divClass{column-right-top}
476 @subheading Running on the command-line
478 @warning{If you are happy with the GUI, then please ignore these
481 @subsubheading Windows on the command line
484 CHECK: check the following descriptions.
485 I don't have English version of Windows.
488 The most convenient way to run LilyPond is by adding the folder
489 which contains LilyPond executable files to the environmental variable
495 Open your @qq{System} on the Control Panel,
496 select Advanced tab and click Environmental Variables button.
499 Select the Variable @qq{Path} from Environmental variables list
500 and click the Edit button.
501 You will be presented a window titled @qq{Edit System Variable};
502 append to @qq{Variable value} the name of the folder
503 which contains LilyPond executable files like this:
506 [@var{pre-set paths}];@var{DIR}\LilyPond\usr\bin
509 @warning{@var{DIR} will generally be @code{C:\Program Files}.}
512 and click @qq{OK} button to close the window.
516 @subsubheading Invoking individual excecutable files
518 LilyPond excecutable files
519 -- such as lilypond, lilypond-book, convert-ly, and so on --
520 can be run from the command-line by invoking them:
529 @divClass{column-center-bottom}
533 All logos and product images are copyright and trademark
544 @unnumberedsec Source
546 @divClass{heading-center}
550 @warning{We @strong{do not} recommend that you attempt to build
551 LilyPond yourself; almost all user needs are better met with the
554 @divClass{column-left-bottom}
555 @subheading Source tarball
557 @downloadStableSource{}
559 For an extensive listing of all versions (old and new), see our
560 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
565 @divClass{column-right-bottom}
566 @subheading Compiling instructions
568 Instructions are listed in @rcontrib{Compiling LilyPond}.
574 @unnumberedsec Old downloads
576 @divClass{heading-center}
580 @divClass{column-center-top}
581 @subheading All versions
583 For an extensive listing of all versions (old and new), see our
584 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
593 @divClass{column-center-top}
594 @subheading Software license
596 GNU LilyPond is published under the GNU General Public License.
597 An introduction to this license, and our reasons for choosing it,
598 is given in @ref{Freedom}.
602 @divClass{column-center-bottom}
603 @subheading GNU General Public License