X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fweb%2Fdownload.itexi;h=91bd1a334ca98a8b106c7cffdbe0dbcd1d7c0d92;hb=2970311021cf68958850e43911e0cecf51f68fbc;hp=5382c20f532601e6ad22f4c0ea5ab1be0acc8193;hpb=3dd2729c9b45d88b531874a342e3b18ef516ded8;p=lilypond.git diff --git a/Documentation/web/download.itexi b/Documentation/web/download.itexi index 5382c20f53..91bd1a334c 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,6 +80,7 @@ latest unstable version @end itemize @divEnd +@divEnd @divClass{column-center-bottom} @@ -79,7 +95,7 @@ LilyPond is published under the @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. @@ -146,7 +162,13 @@ package manager. @item @sourceimage{logo-linux,,,} -@downloadStableLinuxNormal +@ifclear web_version + @downloadDevelLinuxNormal +@end ifclear +@ifset web_version + @downloadStableLinuxNormal +@end ifset + (if in doubt, use this) @item @@ -185,9 +207,18 @@ In the shell, type: uninstall-lilypond @end example +@subsubheading Help + +In the shell, type: + +@example +sh lilypond-@versionStable{}-OS-TYPE.sh --help +@end example + @divEnd + @divClass{column-right-top} @subheading Distribution-specific Packages @@ -199,33 +230,41 @@ upgrade to these versions. @item @sourceimage{logo-fedora,,,} @uref{http://koji.fedoraproject.org/koji/packageinfo?packageID=2447, -Fedora: LilyPond 2.12.2} +Fedora: LilyPond 2.14.2} @item @sourceimage{logo-ubuntu,,,} @uref{http://packages.ubuntu.com/search?keywords=lilypond, -Ubuntu: LilyPond 2.12.2} +Ubuntu: LilyPond 2.14.2} @item @sourceimage{logo-slackware,,,} @uref{http://www.johannes-schoepfer.de/lilypond/, -Slackware: LilyPond 2.12.2} +Slackware: LilyPond 2.14.2} @item @sourceimage{logo-debian,,,} @uref{http://packages.debian.org/search?keywords=lilypond, -Debian: LilyPond 2.12.2} +Debian: LilyPond 2.12.3} @item @sourceimage{logo-suse,,,} -@uref{http://download.opensuse.org/repositories/openSUSE:/Factory:/Contrib/standard/, -openSUSE: LilyPond 2.12.2} +@uref{http://software.opensuse.org/search?baseproject=openSUSE%3A11.2&p=1&q=lilypond, +openSUSE: LilyPond 2.12.3} @end itemize @divEnd +@divClass{column-center-top} +@subheading Compiling a file + +@lilypadCommandLine + +@divEnd + + @divClass{column-center-bottom} @subheading Legalese @@ -258,12 +297,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 +325,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 +347,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 +395,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 +407,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 +446,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 +456,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 +487,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}.} -@help{don't know} +@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 + +@lilypadWindows @divEnd @@ -498,15 +577,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 +625,3 @@ is given in @ref{Freedom}. @include gpl.itexi @divEnd - - -