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,,,}
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 within their normal package
146 repositories that are often @emph{significantly} older than the current
147 stable version. While these older packages may be easier to install, we
148 @emph{strongly} recommend that you use our generic packages. In this
149 case, check that your LilyPond editor is using the correct version.
150 See @ref{Easier editing}.
155 @divClass{column-left-top}
156 @subheading Generic Packages
158 @subsubheading Download
163 @sourceimage{logo-linux,,,}
165 @downloadDevelLinuxNormal
168 @downloadStableLinuxNormal
173 @sourceimage{logo-linux,,,}
174 @downloadStableLinuxBig
178 @sourceimage{logo-linux,,,}
179 @downloadStableLinuxPPC
182 @sourceimage{logo-freebsd,,,}
183 @downloadStableFreeBSDNormal
187 @sourceimage{logo-freebsd,,,}
188 @downloadStableFreeBSDBig
194 @subsubheading Install
199 cd PATH-TO-DOWNLOAD-DIRECTORY
200 sh lilypond-@versionStable{}-OS-TYPE.sh
203 @subsubheading Uninstall
216 sh lilypond-@versionStable{}-OS-TYPE.sh --help
223 @divClass{column-right-top}
224 @subheading Compiling a file
231 @divClass{column-center-bottom}
235 All logos and product images are copyright and trademark
247 @unnumberedsec MacOS X
249 @divClass{heading-center}
253 @divClass{column-left-top}
256 @subsubheading Download
261 @sourceimage{logo-macosx,,,}
262 @downloadStableDarwinNormal
263 For MacOS X 10.4 or higher, running on Intel CPUs (if in doubt,
268 @sourceimage{logo-macosx,,,}
269 @downloadStableDarwinPPC
270 For MacOS X 10.4 or higher, running on G3 and G4 CPUs (old Apple
276 @subsubheading Install
278 Double-click the downloaded file, then drag it to wherever you
281 @subsubheading Uninstall
283 Delete the LilyPond.app folder.
288 @divClass{column-right-top}
289 @subheading Running on the command-line
291 @warning{If you are happy with the GUI instructions below, then
292 please ignore these instructions.}
294 @subsubheading MacOS X on the command line
296 The most convenient way to run lilypond scripts is by setting up
297 @qq{helper} scripts of your own.
302 Create a directory to store these scripts,
311 Create a file called @command{lilypond} which contains
313 @divClass{h-scroll-auto}
316 exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
320 @warning{@var{DIR} will generally be @code{/Applications/}}
324 Create similar files @command{lilypond-book},
325 @command{convert-ly}, and any other scripts you wish to use, by
326 replacing the @command{bin/lilypond} with @command{bin/convert-ly}
327 (or other program name).
331 Make the file executable,
339 Now, add this directory to your path. Modify (or create) a file
340 called @code{.profile} in your home directory such that it
344 export PATH=$PATH:~/bin
347 This file should end with a blank line.
352 @subsubheading Invoking individual scripts
354 The scripts --- such as @command{lilypond-book}, @command{convert-ly},
355 @command{abc2ly}, and even @command{lilypond} itself --- are included
356 inside the @code{.app} file for MacOS@tie{}X.
358 Scripts can also be run from the command line by invoking them
361 @divClass{h-scroll-auto}
363 @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond
367 The same is true for all other scripts in that directory, such as
368 @command{lilypond-book} and @command{convert-ly}.
373 @divClass{column-center-top}
374 @subheading Compiling a file
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 2000, XP, Vista, Windows 7 and 8.
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 within 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 instructions below, then
454 please ignore these instructions.}
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:@bs{}Program Files}.}
487 and click @qq{OK} button to close the window.
491 @subsubheading Invoking individual executable files
493 LilyPond executable 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-top}
505 @subheading Compiling a file
512 @divClass{column-center-bottom}
516 All logos and product images are copyright and trademark
527 @unnumberedsec Source
529 @divClass{heading-center}
533 @warning{We @strong{do not} recommend that you attempt to build
534 LilyPond yourself; almost all user needs are better met with the
537 @divClass{column-left-bottom}
538 @subheading Source tarball
540 @downloadStableSource{}
542 For an extensive listing of all versions (old and new), see our
543 @uref{http://download.linuxaudio.org/lilypond/source/?C=N;O=D,
548 @divClass{column-right-bottom}
549 @subheading Compiling instructions
551 Instructions are listed in @rcontrib{Compiling}.
557 @unnumberedsec Old downloads
559 @divClass{heading-center}
563 @divClass{column-center-top}
564 @subheading All versions
566 For an extensive listing of all versions (old and new), see our
567 @uref{http://download.linuxaudio.org/lilypond/binaries/, download
576 @divClass{column-center-top}
577 @subheading Software license
579 GNU LilyPond is published under the GNU General Public License.
580 An introduction to this license, and our reasons for choosing it,
581 is given in @ref{Freedom}.
585 @divClass{column-center-bottom}
586 @subheading GNU General Public License