X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;ds=sidebyside;f=Documentation%2Fuser%2Fsetup.itely;h=da5bbe90ae5c2dc94b4bd02befdd168c31aa78bf;hb=b97565a9af1c13369ac7e7e9ea80c2638dbc0e51;hp=63599d440dc33fe7de77be7c322ac8c21c10b5bb;hpb=555d8e498a31380d62be9f4853ab514b3786e986;p=lilypond.git diff --git a/Documentation/user/setup.itely b/Documentation/user/setup.itely index 63599d440d..da5bbe90ae 100644 --- a/Documentation/user/setup.itely +++ b/Documentation/user/setup.itely @@ -7,6 +7,8 @@ version that you are working on. See TRANSLATION for details. @end ignore +@c \version "2.12.0" + @node Setup @chapter Setup @@ -15,9 +17,9 @@ LilyPond and various other programs. This chapter may be safely treated as a reference: only read a section if it applies to you. @menu -* Setup for specific Operating Systems:: -* Text editor support:: -* Point and click:: +* Setup for specific Operating Systems:: +* Text editor support:: +* Point and click:: @end menu @@ -28,15 +30,39 @@ This section explains how to perform additional setup for specific operating systems. @menu -* MacOS X on the command-line:: +* Setup for MacOS X:: @end menu +@node Setup for MacOS X +@subsection Setup for MacOS X + +@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 + -@node MacOS X on the command-line -@subsection MacOS X on the command-line +@subsubheading MacOS X on the command line -The scripts (such as lilypond-book, convert-ly, abc2ly, and even -lilypond itself) are included inside MacOS X .app. They can be run from +The scripts --- such as @command{lilypond-book}, @command{convert-ly}, +@command{abc2ly}, and even @command{lilypond} itself --- are included +inside the @code{.app} file for MacOS@tie{}X. They can be run from the command line by invoking them directly, e.g. @example @@ -45,7 +71,7 @@ the command line by invoking them directly, e.g. @noindent The same is true of the other scripts in that directory, including -lilypond-book, convert-ly, abc2ly, etc. +@command{lilypond-book}, @command{convert-ly}, @command{abc2ly}, etc. Alternatively, you may create scripts which add the path automatically. Create a directory to store these scripts, @@ -98,11 +124,12 @@ Note that @var{path/to} will generally be @code{/Applications/}. There is support from different text editors for LilyPond. @menu -* Emacs mode:: -* Vim mode:: -* jEdit:: -* TexShop:: -* TextMate:: +* Emacs mode:: +* Vim mode:: +* jEdit:: +* TexShop:: +* TextMate:: +* LilyKDE:: @end menu @node Emacs mode @@ -146,7 +173,7 @@ if exists("did_load_filetypes") finish endif augroup filetypedetect - au! BufNewFile,BufRead *.ly setf lilypond + au! BufNewFile,BufRead *.ly,*.ily setf lilypond augroup END @end example @@ -158,7 +185,7 @@ set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/ @end example @noindent -where $@{LILYPOND_VERSION@} is your lilypond version. If Lilypond was not +where $@{LILYPOND_VERSION@} is your LilyPond version. If LilyPond was not installed in @file{/usr/local/}, then change this path accordingly. @@ -178,8 +205,8 @@ installation instructions, visit @subsection TexShop The @uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop} -editor for Mac OS X can be extended to run LilyPond, lilypond-book and -convert-ly from within the editor, using the extensions available at +editor for MacOS@tie{}X can be extended to run LilyPond, lilypond-book and +convert-ly from within the editor, using the extensions available at @uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html}. @@ -195,6 +222,19 @@ svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/ @end example +@node LilyKDE +@subsection LilyKDE + +@uref{http://lilykde.googlecode.com/,LilyKDE} is a plugin for KDE's +text editor @uref{http://kate-editor.org/,Kate}. It has a powerful Score +Wizard to quickly setup a LilyPond document and an embedded PDF viewer. + +LilyKDE can use @uref{http://www.volny.cz/smilauer/rumor/,Rumor}, +so music can entered by playing on a MIDI keyboard. + +Other features are lyric hyphenation and running LilyPond on multiple files +at once from within the KDE file manager. + @node Point and click @section Point and click @@ -213,8 +253,8 @@ To make this chain work, you should configure your PDF viewer to follow hyperlinks using the @file{lilypond-invoke-editor} script supplied with LilyPond. -For Xpdf on Unix, the following should be present in -@file{xpdfrc}@footnote{On unix, this file is found either in +For Xpdf on UNIX, the following should be present in +@file{xpdfrc}@footnote{On UNIX, this file is found either in @file{/etc/xpdfrc} or as @file{.xpdfrc} in your home directory.} @example @@ -266,14 +306,23 @@ reducing the size of PDF and PS files, point and click may be switched off by issuing @example -#(ly:set-option 'point-and-click #f) +\pointAndClickOff @end example @noindent -in a @file{.ly} file. Alternately, you may pass this as an command-line -option +in a @file{.ly} file. Point and click may be explicitly enabled with + +@example +\pointAndClickOn +@end example + +Alternately, you may disable point and click with a command-line +option: @example lilypond -dno-point-and-click file.ly @end example +@warning{You should always turn off point and click in any LilyPond +files to be distributed to avoid including path information about +your computer in the .pdf file, which can pose a security risk.}