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 @macro warningTextBased
11 @warning{LilyPond is a @strong{text-based} music engraver; it is
12 more similar to a programming language than a graphical score
13 editing program. Before downloading LilyPond, please read about
14 our @ref{Text input}.}
20 @divClass{heading-center}
22 @c yes, we want verisonDevel here, since the online links
23 @c for @version won't be up yet!
24 @heading Downloads for LilyPond @versionDevel
26 @warning{Links for the stable version of LilyPond can be found at
27 @uref{http://lilypond.org, lilypond.org}}
30 @heading Downloads for LilyPond @versionStable
37 @divClass{column-left-top}
43 @c TODO: duplicate to avoid underlined refs in HTML? icky.
44 @ref{Unix, @sourceimage{logo-linux,,,}
45 @sourceimage{logo-freebsd,,,}}
46 @ref{Unix, Unix (Linux and FreeBSD)}
49 @ref{MacOS X, @sourceimage{logo-macosx,,,}}
50 @ref{MacOS X, MacOS X}
53 @ref{Windows, @sourceimage{logo-windows,,,}}
54 @ref{Windows, Microsoft Windows}
60 @divClass{column-right-top}
61 @subheading For developers
73 @item @ref{Development}:
74 latest unstable version
80 @divClass{column-center-bottom}
82 @subheading Software License
84 LilyPond is published under the
85 @ref{GPL, GNU General Public License}.
93 Many thanks to @uref{http://www.vt.edu/, Virgina Tech} and
94 @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring
97 @sourceimage{VTlogo_ITF,,,}
98 @sourceimage{lao_banner_06_on_white_demo,,,}
103 All logos and product images are copyright and trademark
133 @divClass{heading-center}
137 @divClass{column-center-top}
138 @subheading Generic Packages or Distribution-Specific Packages?
140 Many distributions include LilyPond in their normal package
141 system. These versions are easier to install and uninstall than
142 the generic packages, but they may be older. If you wish to use
143 our generic packages, please uninstall the official version from
144 your system using the normal package manager for your distribution.
145 See your distribution's documentation about how to use their
151 @divClass{column-left-top}
152 @subheading Generic Packages
154 @subsubheading Download
159 @sourceimage{logo-linux,,,}
161 @downloadDevelLinuxNormal
164 @downloadStableLinuxNormal
167 (if in doubt, use this)
170 @sourceimage{logo-linux,,,}
171 @downloadStableLinuxBig
174 @sourceimage{logo-linux,,,}
175 @downloadStableLinuxPPC
178 @sourceimage{logo-freebsd,,,}
179 @downloadStableFreeBSDNormal
182 @sourceimage{logo-freebsd,,,}
183 @downloadStableFreeBSDBig
188 @subsubheading Install
193 cd PATH-TO-DOWNLOAD-DIRECTORY
194 sh lilypond-@versionStable{}-OS-TYPE.sh
197 @subsubheading Uninstall
208 @divClass{column-right-top}
209 @subheading Distribution-specific Packages
211 Please use your distribution's package manager to install or
212 upgrade to these versions.
217 @sourceimage{logo-fedora,,,}
218 @uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447,
219 Fedora: LilyPond 2.12.3}
222 @sourceimage{logo-ubuntu,,,}
223 @uref{http://packages.ubuntu.com/search?keywords=lilypond,
224 Ubuntu: LilyPond 2.12.2}
227 @sourceimage{logo-slackware,,,}
228 @uref{http://www.johannes-schoepfer.de/lilypond/,
229 Slackware: LilyPond 2.12.3}
232 @sourceimage{logo-debian,,,}
233 @uref{http://packages.debian.org/search?keywords=lilypond,
234 Debian: LilyPond 2.12.2}
237 @sourceimage{logo-suse,,,}
238 @uref{http://software.opensuse.org/search?baseproject=openSUSE%3A11.2&p=1&q=lilypond,
239 openSUSE: LilyPond 2.12.3}
246 @divClass{column-center-bottom}
250 All logos and product images are copyright and trademark
262 @unnumberedsec MacOS X
264 @divClass{heading-center}
268 @divClass{column-left-top}
271 @subsubheading Download
276 @sourceimage{logo-macosx,,,}
277 @downloadStableDarwinNormal
278 For Intel chips (if in doubt, use this).
281 @sourceimage{logo-macosx,,,}
282 @downloadStableDarwinPPC
283 For G3 and G4 CPUs (old Apple computers).
287 @subsubheading Install
289 Double-click the downloaded file, then drag it to wherever you
292 @subsubheading Uninstall
294 Delete the LilyPond.app folder.
299 @divClass{column-right-top}
300 @subheading Running on the command-line
302 @warning{If you are happy with the GUI, then please ignore these
305 @subsubheading MacOS X on the command line
307 The most convenient way to run lilypond scripts is by setting up
308 @qq{helper} scripts of your own.
313 Create a directory to store these scripts,
322 Create a file called @command{lilypond} which contains
324 @help obvious css issue to be dealt with. :(
325 @c we need a small font here to fit. -gp
327 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
330 @warning{@var{DIR} will generally be @code{/Applications/}}
334 Create similar files @command{lilypond-book},
335 @command{convert-ly}, and any other scripts you wish to use, by
336 replacing the @command{bin/lilypond} with @command{bin/convert-ly}
337 (or other program name).
341 Make the file executable,
349 Now, add this directory to your path. Modify (or create) a file
350 called @code{.profile} in your home directory such that it
354 export PATH=$PATH:~/bin
357 This file should end with a blank line.
362 @subsubheading Invoking individual scripts
364 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
365 @command{abc2ly}, and even @command{lilypond} itself --- are included
366 inside the @code{.app} file for MacOS@tie{}X.
368 Scripts can also be run from the command line by invoking them
372 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
375 The same is true for all other scripts in that directory, such as
376 @command{lilypond-book} and @command{convert-ly}.
381 @divClass{column-center-bottom}
385 All logos and product images are copyright and trademark
396 @unnumberedsec Windows
398 @divClass{heading-center}
402 @divClass{column-left-top}
405 @subsubheading Download
410 @sourceimage{logo-windows,,,}
411 @downloadStableWindows
412 For Windows ME, NT, 2000, XP, Vista, and Windows 7.
416 @subsubheading Install
421 Locate the downloaded file and double-click on it to start the
422 installer. Follow the instructions given to you by the installer;
423 we recommend that you leave all the install options checked and
424 use the default installation location. Click the @q{Finish} button
425 when the installer has completed. Lilypond is now installed.
429 @subsubheading Uninstall
431 To uninstall Lilypond either:
436 Locate the Lilypond folder from the @q{Start} menu and click on the
437 @q{Uninstall} icon. Click the @q{Finish} button when the uninstaller
441 Or from witin the Control Panel,locate and select Lilypond and then
442 choose the option to uninstall/remove the software. Click the @q{Finish}
443 button when the uninstaller has completed.
450 @divClass{column-right-top}
451 @subheading Running on the command-line
453 @warning{If you are happy with the GUI, then please ignore these
456 @subsubheading Windows on the command line
459 CHECK: check the following descriptions.
460 I don't have English version of Windows.
463 The most convenient way to run LilyPond is by adding the folder
464 which contains LilyPond executable files to the environmental variable
470 Open your @qq{System} on the Control Panel,
471 select Advanced tab and click Environmental Variables button.
474 Select the Variable @qq{Path} from Environmental variables list
475 and click the Edit button.
476 You will be presented a window titled @qq{Edit System Variable};
477 append to @qq{Variable value} the name of the folder
478 which contains LilyPond executable files like this:
481 [@var{pre-set paths}];@var{DIR}\LilyPond\usr\bin
484 @warning{@var{DIR} will generally be @code{C:\Program Files}.}
487 and click @qq{OK} button to close the window.
491 @subsubheading Invoking individual excecutable files
493 LilyPond excecutable files
494 -- such as lilypond, lilypond-book, convert-ly, and so on --
495 can be run from the command-line by invoking them:
504 @divClass{column-center-bottom}
508 All logos and product images are copyright and trademark
519 @unnumberedsec Source
521 @divClass{heading-center}
525 @warning{We @strong{do not} recommend that you attempt to build
526 LilyPond yourself; almost all user needs are better met with the
529 @divClass{column-left-bottom}
530 @subheading Source tarball
532 @downloadStableSource{}
534 For an extensive listing of all versions (old and new), see our
535 @uref{http://download.linuxaudio.org/lilypond/source/?C=N;O=D,
540 @divClass{column-right-bottom}
541 @subheading Compiling instructions
543 Instructions are listed in @rcontrib{Compiling LilyPond}.
549 @unnumberedsec Old downloads
551 @divClass{heading-center}
555 @divClass{column-center-top}
556 @subheading All versions
558 For an extensive listing of all versions (old and new), see our
559 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
568 @divClass{column-center-top}
569 @subheading Software license
571 GNU LilyPond is published under the GNU General Public License.
572 An introduction to this license, and our reasons for choosing it,
573 is given in @ref{Freedom}.
577 @divClass{column-center-bottom}
578 @subheading GNU General Public License