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
+editing program. Before downloading LilyPond, please read about
+our @ref{Text input}.}
+@end macro
+
@node Download
@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
-@warning{LilyPond is a @strong{text-based} music engraver; it is
-more similar to a programming language than a graphical score
-editing program. Before downloading LilyPond, please read about
-our @ref{Text input}.}
+@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,,,}}
@end itemize
@divEnd
+@divEnd
-@divClass{column-center-bottom}
+@divClass{column-center-middle-color2}
@subheading Software License
@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.
@sourceimage{VTlogo_ITF,,,}
@sourceimage{lao_banner_06_on_white_demo,,,}
+@divEnd
+
+@divClass{column-center-bottom}
@subheading Legalese
@divClass{legal}
All logos and product images are copyright and trademark
-acknowledged.
+acknowledged.
@logoLegalLinux
@divClass{hide}
@menu
-* Unix::
-* MacOS X::
-* Windows::
-* Source::
-* Old downloads::
-* GPL::
+* Unix::
+* MacOS X::
+* Windows::
+* Source::
+* Old downloads::
+* GPL::
@end menu
@divEnd
@node Unix
@unnumberedsec Unix
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
@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
@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,,,}
@item
@sourceimage{logo-freebsd,,,}
@downloadStableFreeBSDNormal
+32bit Systems.
@item
@sourceimage{logo-freebsd,,,}
@downloadStableFreeBSDBig
+64bit Systems.
@end itemize
uninstall-lilypond
@end example
-@divEnd
-
-
-@divClass{column-right-top}
-@subheading Distribution-specific Packages
+@subsubheading Help
-Please use your distribution's package manager to install or
-upgrade to these versions.
-
-@itemize
+In the shell, type:
-@item
-@sourceimage{logo-fedora,,,}
-@uref{https://admin.fedoraproject.org/pkgdb/packages/name/lilypond,
-Fedora: LilyPond 2.12.0}
+@example
+sh lilypond-@versionStable{}-OS-TYPE.sh --help
+@end example
-@item
-@sourceimage{logo-ubuntu,,,}
-@uref{https://launchpad.net/ubuntu/+source/lilypond,
-Ubuntu: LilyPond 2.12.1}
+@divEnd
-@item
-@sourceimage{logo-slackware,,,}
-@uref{http://www.johannes-schoepfer.de/lilypond/,
-Slackware: LilyPond 2.12.1}
-@item
-@sourceimage{logo-debian,,,}
-@uref{http://packages.debian.org/search?keywords=lilypond,
-Debian: LilyPond 2.10.33}
-@item
-@sourceimage{logo-suse,,,}
-@uref{http://opensuse.org/?fixme=urg-no-lilypond-package-page,
-openSUSE: LilyPond 2.10.33}
+@divClass{column-right-top}
+@subheading Compiling a file
-@end itemize
+@lilypadCommandLine
@divEnd
@node MacOS X
@unnumberedsec MacOS X
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
@divClass{column-left-top}
@subheading Packages
@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
@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
@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/}}
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}.
@divEnd
+@divClass{column-center-top}
+@subheading Compiling a file
+
+@lilypadOSX
+
+@divEnd
+
+
@divClass{column-center-bottom}
@subheading Legalese
@node Windows
@unnumberedsec Windows
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
@divClass{column-left-top}
@subheading Packages
@item
@sourceimage{logo-windows,,,}
@downloadStableWindows
-For Windows ME, NT, 2000, XP, and Vista.
+For Windows 2000, XP, Vista, Windows 7 and 8.
@end itemize
@item
Locate the downloaded file and double-click on it to start the
-installer. You will be presented a window titled @qq{Open File -
-Security Warning}, click on Run to continue.
+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.
-@item
-You will be presented the License Agreement; read this carefully,
-and click on the Next button if you accept it.
+@end enumerate
-@item
-Preferably leave the destination folder to the default, else
-browse to choose a different location, and click on the Next
-button.
+@subsubheading Uninstall
-@item
-Next is the Installation Options window, leave the three options
-checked, as you will want to have all of these installed. Click
-on the Next button.
+To uninstall LilyPond either:
+
+@enumerate
@item
-Installation now commences, wait a minute or less for installation
-to complete. There is a Show Details button that when clicked on
-will show all the files installed and where, nothing you
-necessarily need to look at. Click on the Finish button.
+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
-Lilypond is now installed.
+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
-@subsubheading Uninstall
+@divEnd
-There are two uninstallation routes -
-@enumerate
+@divClass{column-right-top}
+@subheading Running on the command-line
+
+@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
-Choose Uninstall from the Lilypond menu from the start menu
+Open your @qq{System} on the Control Panel,
+select Advanced tab and click Environmental Variables button.
@item
-Open your Install/Uninstall Applications on the Control Panel,
-scroll down to Lilypond and click on the Uninstall buttom.
+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 (x86)}
+for 64 bit or @code{C:@bs{}Program Files} for 32 bit systems.}
+
+@noindent
+and click @qq{OK} button to close the window.
@end enumerate
-@divEnd
+@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:
-@divClass{column-right-top}
-@subheading Running on the command-line
+@example
+lilypond test.ly
+@end example
-@warning{If you are happy with the GUI, then please ignore these
-instructions.}
+@divEnd
-@help{don't know}
+
+@divClass{column-center-top}
+@subheading Compiling a file
+
+@lilypadWindows
@divEnd
@node Source
@unnumberedsec Source
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
@warning{We @strong{do not} recommend that you attempt to build
LilyPond yourself; almost all user needs are better met with the
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
@node Old downloads
@unnumberedsec Old downloads
+@divClass{heading-center}
+@warningTextBased
+@divEnd
+
@divClass{column-center-top}
@subheading All versions
@divEnd
@divClass{column-center-bottom}
-@subheading GNU General Public License version 2
+@subheading GNU General Public License
-@include gpl-2.0.itexi
+@include gpl.itexi
@divEnd
-
-
-
projects / lilypond.git / blobdiff