X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fdownload.itexi;h=ece6c7b39f72c2c75cd6e0d44134ed27687e1325;hb=d2762a4f1add2bb04d6fc34d3c7ae03eeb7d500f;hp=625d04963f851eb7cfb15f0f5dd2d18141b4a1a2;hpb=eabaea3732b3c8cfa3b0324aeaca2c5bb39c4be7;p=lilypond.git diff --git a/Documentation/web/download.itexi b/Documentation/web/download.itexi index 625d04963f..ece6c7b39f 100644 --- a/Documentation/web/download.itexi +++ b/Documentation/web/download.itexi @@ -3,9 +3,12 @@ Translation of GIT committish: FILL-IN-HEAD-COMMITTISH When revising a translation, copy the HEAD committish of the - version that you are working on. See TRANSLATION for details. + version that you are working on. For details, see the Contributors' + Guide, node Updating translation committishes.. @end ignore +@include included/generating-output.itexi + @macro warningTextBased @warning{LilyPond is a @strong{text-based} music engraver; it is more similar to a programming language than a graphical score @@ -17,22 +20,34 @@ our @ref{Text input}.} @unnumbered Download @divClass{heading-center} -@heading Downloads for LilyPond @versionStable +@ifclear web_version + @c yes, we want versionDevel here, since the online links + @c for @version won't be up yet! + @heading Downloads for LilyPond @versionDevel + +@warning{Links for the stable version of LilyPond can be found at +@uref{http://lilypond.org, lilypond.org}} +@end ifclear +@ifset web_version + @heading Downloads for LilyPond @versionStable +@end ifset @warningTextBased @divEnd +@divClass{link-headings} + @divClass{column-left-top} @subheading For users @itemize @item -@c TODO: duplicate to avoid underlined refs in HTML? icky. +@c ref is duplicated to avoid underlining ref as image. @ref{Unix, @sourceimage{logo-linux,,,} @sourceimage{logo-freebsd,,,}} -@ref{Unix, Unix (Linux and FreeBSD)} +@ref{Unix, Unix (GNU/Linux and FreeBSD)} @item @ref{MacOS X, @sourceimage{logo-macosx,,,}} @@ -65,8 +80,9 @@ latest unstable version @end itemize @divEnd +@divEnd -@divClass{column-center-bottom} +@divClass{column-center-middle-color2} @subheading Software License @@ -75,11 +91,11 @@ LilyPond is published under the @divEnd -@divClass{color1} +@divClass{column-center-bottom} @subheading Sponsors -Many thanks to @uref{http://www.vt.edu/, Virgina Tech} and +Many thanks to @uref{http://www.vt.edu/, Virginia Tech} and @uref{http://www.linuxaudio.org/, linuxaudio.org} for sponsoring our bandwidth. @@ -126,13 +142,12 @@ acknowledged. @divClass{column-center-top} @subheading Generic Packages or Distribution-Specific Packages? -Many distributions include LilyPond in their normal package -system. These versions are easier to install and uninstall than -the generic packages, but they may be older. If you wish to use -our generic packages, please uninstall the official version from -your system using the normal package manager for your distribution. -See your distribution's documentation about how to use their -package manager. +Many distributions include LilyPond within their normal package +repositories that are often @emph{significantly} older than the current +stable version. While these older packages may be easier to install, we +@emph{strongly} recommend that you use our generic packages. In this +case, check that your LilyPond editor is using the correct version. +See @ref{Easier editing}. @divEnd @@ -146,12 +161,18 @@ package manager. @item @sourceimage{logo-linux,,,} -@downloadStableLinuxNormal -(if in doubt, use this) +@ifclear web_version + @downloadDevelLinuxNormal +@end ifclear +@ifset web_version + @downloadStableLinuxNormal +@end ifset +32bit Systems. @item @sourceimage{logo-linux,,,} @downloadStableLinuxBig +64bit Systems. @item @sourceimage{logo-linux,,,} @@ -160,10 +181,12 @@ package manager. @item @sourceimage{logo-freebsd,,,} @downloadStableFreeBSDNormal +32bit Systems. @item @sourceimage{logo-freebsd,,,} @downloadStableFreeBSDBig +64bit Systems @end itemize @@ -185,43 +208,22 @@ In the shell, type: uninstall-lilypond @end example -@divEnd +@subsubheading Help +In the shell, type: -@divClass{column-right-top} -@subheading Distribution-specific Packages - -Please use your distribution's package manager to install or -upgrade to these versions. - -@itemize +@example +sh lilypond-@versionStable{}-OS-TYPE.sh --help +@end example -@item -@sourceimage{logo-fedora,,,} -@uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447 -Fedora: LilyPond 2.12.0} +@divEnd -@item -@sourceimage{logo-ubuntu,,,} -@uref{http://packages.ubuntu.com/search?keywords=lilypond, -Ubuntu: LilyPond 2.12.2} -@item -@sourceimage{logo-slackware,,,} -@uref{http://www.johannes-schoepfer.de/lilypond/, -Slackware: LilyPond 2.12.2} -@item -@sourceimage{logo-debian,,,} -@uref{http://packages.debian.org/search?keywords=lilypond, -Debian: LilyPond 2.12.2} +@divClass{column-right-top} +@subheading Compiling a file -@item -@sourceimage{logo-suse,,,} -@uref{http://download.opensuse.org/repositories/openSUSE:/Factory:/Contrib/standard/ -openSUSE: LilyPond 2.12.2} - -@end itemize +@lilypadCommandLine @divEnd @@ -258,12 +260,16 @@ acknowledged. @item @sourceimage{logo-macosx,,,} @downloadStableDarwinNormal -For Intel chips (if in doubt, use this). +For MacOS X 10.4 or higher, running on Intel CPUs (if in doubt, +use this). + @item @sourceimage{logo-macosx,,,} @downloadStableDarwinPPC -For G3 and G4 CPUs (old Apple computers). +For MacOS X 10.4 or higher, running on G3 and G4 CPUs (old Apple +computers). + @end itemize @@ -282,34 +288,8 @@ Delete the LilyPond.app folder. @divClass{column-right-top} @subheading Running on the command-line -@warning{If you are happy with the GUI, then please ignore these -instructions.} - -@ignore -FIXME: I had one report that we don't need this stuff; will delete -after confirmation. -gp - -@subsubheading Using Python scripts on MacOS 10.3 or 10.4 - -LilyPond binaries for MacOS X do not provide Python, but Python 2.4 or -newer is required by @command{convert-ly}. Therefore, if you use MacOS -10.3 or 10.4, you must install a newer Python version from -@uref{http://python.org/download/}, then edit the first line of -@command{convert-ly} and @command{lilypond-book} as follows: if the -Python binary you just installed is in your @var{PATH}, the first line -should be - -@example -#!/usr/bin/env python -@end example - -@noindent -otherwise it should be - -@example -#!@var{/path/to/newly_installed/python} -@end example -@end ignore +@warning{If you are happy with the GUI instructions below, then +please ignore these instructions.} @subsubheading MacOS X on the command line @@ -330,11 +310,12 @@ cd ~/bin @item Create a file called @command{lilypond} which contains -@help obvious css issue to be dealt with. :( -@c we need a small font here to fit. -gp -@smallexample +@divClass{h-scroll-auto} +@example +#!/bin/bash exec @var{DIR}/LilyPond.app/Contents/Resources/bin/lilypond "$@@" -@end smallexample +@end example +@divEnd @warning{@var{DIR} will generally be @code{/Applications/}} @@ -377,9 +358,11 @@ inside the @code{.app} file for MacOS@tie{}X. Scripts can also be run from the command line by invoking them directly: +@divClass{h-scroll-auto} @example @var{path/to}/LilyPond.app/Contents/Resources/bin/lilypond @end example +@divEnd The same is true for all other scripts in that directory, such as @command{lilypond-book} and @command{convert-ly}. @@ -387,6 +370,14 @@ The same is true for all other scripts in that directory, such as @divEnd +@divClass{column-center-top} +@subheading Compiling a file + +@lilypadOSX + +@divEnd + + @divClass{column-center-bottom} @subheading Legalese @@ -418,7 +409,7 @@ acknowledged. @item @sourceimage{logo-windows,,,} @downloadStableWindows -For Windows ME, NT, 2000, XP, Vista, and Windows 7. +For Windows 2000, XP, Vista, Windows 7 and 8. @end itemize @@ -428,27 +419,27 @@ For Windows ME, NT, 2000, XP, Vista, and Windows 7. @item Locate the downloaded file and double-click on it to start the -installer. Follow the instructions given to you by the installer; +installer. Follow the instructions given to you by the installer; we recommend that you leave all the install options checked and -use the default installation location. Click the @q{Finish} button -when the installer has completed. Lilypond is now installed. +use the default installation location. Click the @q{Finish} button +when the installer has completed. LilyPond is now installed. @end enumerate @subsubheading Uninstall -To uninstall Lilypond either: +To uninstall LilyPond either: @enumerate @item -Locate the Lilypond folder from the @q{Start} menu and click on the -@q{Uninstall} icon. Click the @q{Finish} button when the uninstaller +Locate the LilyPond folder from the @q{Start} menu and click on the +@q{Uninstall} icon. Click the @q{Finish} button when the uninstaller has completed. @item -Or from witin the Control Panel,locate and select Lilypond and then -choose the option to uninstall/remove the software. Click the @q{Finish} +Or from within the Control Panel, locate and select LilyPond and then +choose the option to uninstall/remove the software. Click the @q{Finish} button when the uninstaller has completed. @end enumerate @@ -459,10 +450,61 @@ button when the uninstaller has completed. @divClass{column-right-top} @subheading Running on the command-line -@warning{If you are happy with the GUI, then please ignore these -instructions.} +@warning{If you are happy with the GUI instructions below, then +please ignore these instructions.} + +@subsubheading Windows on the command line + +@ignore +CHECK: check the following descriptions. +I don't have English version of Windows. +@end ignore + +The most convenient way to run LilyPond is by adding the folder +which contains LilyPond executable files to the environmental variable +@qq{Path}. + + +@enumerate +@item +Open your @qq{System} on the Control Panel, +select Advanced tab and click Environmental Variables button. + +@item +Select the Variable @qq{Path} from Environmental variables list +and click the Edit button. +You will be presented a window titled @qq{Edit System Variable}; +append to @qq{Variable value} the name of the folder +which contains LilyPond executable files like this: + +@example +[@var{pre-set paths}];@var{DIR}\LilyPond\usr\bin +@end example + +@warning{@var{DIR} will generally be @code{C:@bs{}Program Files}.} + +@noindent +and click @qq{OK} button to close the window. + +@end enumerate + +@subsubheading Invoking individual executable files + +LilyPond executable files +-- such as lilypond, lilypond-book, convert-ly, and so on -- +can be run from the command-line by invoking them: + +@example +lilypond test.ly +@end example + +@divEnd + + +@divClass{column-center-top} +@subheading Compiling a file -@help{don't know} +@lilypadWindows @divEnd @@ -498,15 +540,15 @@ pre-built version.} @downloadStableSource{} For an extensive listing of all versions (old and new), see our -@uref{http://download.linuxaudio.org/lilypond/binaries/, download -site}. +@uref{http://download.linuxaudio.org/lilypond/source/?C=N;O=D, +download site}. @divEnd @divClass{column-right-bottom} @subheading Compiling instructions -Instructions are listed in @rcontrib{Compiling LilyPond}. +Instructions are listed in @rcontrib{Compiling}. @divEnd @@ -546,6 +588,3 @@ is given in @ref{Freedom}. @include gpl.itexi @divEnd - - -