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 verisonDevel 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{column-left-top}
45 @c TODO: duplicate to avoid underlined refs in HTML? icky.
46 @ref{Unix, @sourceimage{logo-linux,,,}
47 @sourceimage{logo-freebsd,,,}}
48 @ref{Unix, Unix (Linux and FreeBSD)}
51 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
52 @ref{MacOS X, MacOS X}
55 @ref{Windows, @sourceimage{logo-windows,,,}}
56 @ref{Windows, Microsoft Windows}
62 @divClass{column-right-top}
63 @subheading For developers
75 @item @ref{Development}:
76 latest unstable version
82 @divClass{column-center-bottom}
84 @subheading Software License
86 LilyPond is published under the
87 @ref{GPL, GNU General Public License}.
95 Many thanks to @uref{http://www.vt.edu/, Virgina Tech} and
96 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
99 @sourceimage{VTlogo_ITF,,,}
100 @sourceimage{lao_banner_06_on_white_demo,,,}
105 All logos and product images are copyright and trademark
135 @divClass{heading-center}
139 @divClass{column-center-top}
140 @subheading Generic Packages or Distribution-Specific Packages?
142 Many distributions include LilyPond in their normal package
143 system. These versions are easier to install and uninstall than
144 the generic packages, but they may be older. If you wish to use
145 our generic packages, please uninstall the official version from
146 your system using the normal package manager for your distribution.
147 See your distribution's documentation about how to use their
153 @divClass{column-left-top}
154 @subheading Generic Packages
156 @subsubheading Download
161 @sourceimage{logo-linux,,,}
163 @downloadDevelLinuxNormal
166 @downloadStableLinuxNormal
169 (if in doubt, use this)
172 @sourceimage{logo-linux,,,}
173 @downloadStableLinuxBig
176 @sourceimage{logo-linux,,,}
177 @downloadStableLinuxPPC
180 @sourceimage{logo-freebsd,,,}
181 @downloadStableFreeBSDNormal
184 @sourceimage{logo-freebsd,,,}
185 @downloadStableFreeBSDBig
190 @subsubheading Install
195 cd PATH-TO-DOWNLOAD-DIRECTORY
196 sh lilypond-@versionStable{}-OS-TYPE.sh
199 @subsubheading Uninstall
211 @divClass{column-right-top}
212 @subheading Compiling a file
219 @divClass{column-left-top}
220 @subheading Distribution-specific Packages
222 Please use your distribution's package manager to install or
223 upgrade to these versions.
228 @sourceimage{logo-fedora,,,}
229 @uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447,
230 Fedora: LilyPond 2.12.3}
233 @sourceimage{logo-ubuntu,,,}
234 @uref{http://packages.ubuntu.com/search?keywords=lilypond,
235 Ubuntu: LilyPond 2.12.2}
238 @sourceimage{logo-slackware,,,}
239 @uref{http://www.johannes-schoepfer.de/lilypond/,
240 Slackware: LilyPond 2.12.3}
243 @sourceimage{logo-debian,,,}
244 @uref{http://packages.debian.org/search?keywords=lilypond,
245 Debian: LilyPond 2.12.2}
248 @sourceimage{logo-suse,,,}
249 @uref{http://software.opensuse.org/search?baseproject=openSUSE%3A11.2&p=1&q=lilypond,
250 openSUSE: LilyPond 2.12.3}
257 @divClass{column-center-bottom}
261 All logos and product images are copyright and trademark
273 @unnumberedsec MacOS X
275 @divClass{heading-center}
279 @divClass{column-left-top}
282 @subsubheading Download
287 @sourceimage{logo-macosx,,,}
288 @downloadStableDarwinNormal
289 For Intel chips (if in doubt, use this).
292 @sourceimage{logo-macosx,,,}
293 @downloadStableDarwinPPC
294 For G3 and G4 CPUs (old Apple computers).
298 @subsubheading Install
300 Double-click the downloaded file, then drag it to wherever you
303 @subsubheading Uninstall
305 Delete the LilyPond.app folder.
309 @divClass{column-right-top}
310 @subheading Compiling a file
317 @divClass{column-left-top}
318 @subheading Running on the command-line
320 @warning{If you are happy with the GUI, then please ignore these
323 @subsubheading MacOS X on the command line
325 The most convenient way to run lilypond scripts is by setting up
326 @qq{helper} scripts of your own.
331 Create a directory to store these scripts,
340 Create a file called @command{lilypond} which contains
342 @help obvious css issue to be dealt with. :(
343 @c we need a small font here to fit. -gp
345 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
348 @warning{@var{DIR} will generally be @code{/Applications/}}
352 Create similar files @command{lilypond-book},
353 @command{convert-ly}, and any other scripts you wish to use, by
354 replacing the @command{bin/lilypond} with @command{bin/convert-ly}
355 (or other program name).
359 Make the file executable,
367 Now, add this directory to your path. Modify (or create) a file
368 called @code{.profile} in your home directory such that it
372 export PATH=$PATH:~/bin
375 This file should end with a blank line.
380 @subsubheading Invoking individual scripts
382 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
383 @command{abc2ly}, and even @command{lilypond} itself --- are included
384 inside the @code{.app} file for MacOS@tie{}X.
386 Scripts can also be run from the command line by invoking them
390 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
393 The same is true for all other scripts in that directory, such as
394 @command{lilypond-book} and @command{convert-ly}.
399 @divClass{column-center-bottom}
403 All logos and product images are copyright and trademark
414 @unnumberedsec Windows
416 @divClass{heading-center}
420 @divClass{column-left-top}
423 @subsubheading Download
428 @sourceimage{logo-windows,,,}
429 @downloadStableWindows
430 For Windows ME, NT, 2000, XP, Vista, and Windows 7.
434 @subsubheading Install
439 Locate the downloaded file and double-click on it to start the
440 installer. Follow the instructions given to you by the installer;
441 we recommend that you leave all the install options checked and
442 use the default installation location. Click the @q{Finish} button
443 when the installer has completed. LilyPond is now installed.
447 @subsubheading Uninstall
449 To uninstall LilyPond either:
454 Locate the LilyPond folder from the @q{Start} menu and click on the
455 @q{Uninstall} icon. Click the @q{Finish} button when the uninstaller
459 Or from witin the Control Panel,locate and select LilyPond and then
460 choose the option to uninstall/remove the software. Click the @q{Finish}
461 button when the uninstaller has completed.
468 @divClass{column-right-top}
469 @subheading Compiling a file
476 @divClass{column-left-top}
477 @subheading Running on the command-line
479 @warning{If you are happy with the GUI, then please ignore these
482 @subsubheading Windows on the command line
485 CHECK: check the following descriptions.
486 I don't have English version of Windows.
489 The most convenient way to run LilyPond is by adding the folder
490 which contains LilyPond executable files to the environmental variable
496 Open your @qq{System} on the Control Panel,
497 select Advanced tab and click Environmental Variables button.
500 Select the Variable @qq{Path} from Environmental variables list
501 and click the Edit button.
502 You will be presented a window titled @qq{Edit System Variable};
503 append to @qq{Variable value} the name of the folder
504 which contains LilyPond executable files like this:
507 [@var{pre-set paths}];@var{DIR}\LilyPond\usr\bin
510 @warning{@var{DIR} will generally be @code{C:\Program Files}.}
513 and click @qq{OK} button to close the window.
517 @subsubheading Invoking individual excecutable files
519 LilyPond excecutable files
520 -- such as lilypond, lilypond-book, convert-ly, and so on --
521 can be run from the command-line by invoking them:
530 @divClass{column-center-bottom}
534 All logos and product images are copyright and trademark
545 @unnumberedsec Source
547 @divClass{heading-center}
551 @warning{We @strong{do not} recommend that you attempt to build
552 LilyPond yourself; almost all user needs are better met with the
555 @divClass{column-left-bottom}
556 @subheading Source tarball
558 @downloadStableSource{}
560 For an extensive listing of all versions (old and new), see our
561 @uref{http://download.linuxaudio.org/lilypond/source/?C=N;O=D,
566 @divClass{column-right-bottom}
567 @subheading Compiling instructions
569 Instructions are listed in @rcontrib{Compiling}.
575 @unnumberedsec Old downloads
577 @divClass{heading-center}
581 @divClass{column-center-top}
582 @subheading All versions
584 For an extensive listing of all versions (old and new), see our
585 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
594 @divClass{column-center-top}
595 @subheading Software license
597 GNU LilyPond is published under the GNU General Public License.
598 An introduction to this license, and our reasons for choosing it,
599 is given in @ref{Freedom}.
603 @divClass{column-center-bottom}
604 @subheading GNU General Public License