Next: Cheat sheet, Previous: Notation manual details, Up: Top
Point and click lets you find notes in the input by clicking on them in the PDF viewer. This makes it easier to find input that causes some error in the sheet music.
When this functionality is active, LilyPond adds hyperlinks to the PDF file. These hyperlinks are sent to the web-browser, which opens a text-editor with the cursor in the right place.
To make this chain work, the following should done:
For Xpdf on Unix, the following should be present in xpdfrc1
urlCommand "firefox -remote 'OpenURL(%s)'"
textedit
protocol,
For Mozilla and Mozilla Firefox, this is done by adding following lines to the user.js2
user_pref("network.protocol-handler.app.textedit", "lilypond-invoke-editor"); user_pref("network.protocol-handler.warn-external.textedit", false);
The program lilypond-invoke-editor is a small helper program.
It tests the environment variable EDITOR
for the following
patterns,
emacs
emacsclient --no-wait +line:column file
vim
gvim --remote +:line:normchar file
nedit
nc -noask +line file'
The environment variable LYEDITOR
is used to override this. It
contains the command line to start the editor, where %(file)s
,
%(column)s
, %(line)s
is replaced with the file, column
and line respectively. The setting
emacsclient --no-wait +%(line)s:%(column)s %(file)s
for LYEDITOR
is equivalent to the standard emacsclient
invocation.
The point and click links enlarge the output files significantly. For reducing the size of PDF and PS files, point and click may be switched off by issuing
#(ly:set-option 'point-and-click #f)
in a .ly file. Alternately, you may pass this as an command-line option
lilypond -dno-point-and-click file.ly
[1] On unix, this file is found either in /etc/xpdfrc or as .xpdfrc in your home directory.
[2] On a typical unix system, this file exists or must be created in your home-directory as .mozilla/firefox/default.trn/user.js or .firefox/default/xxxxxxxx.xxx/user.js, see location and profile.
This page is for LilyPond-2.6.3 (stable-branch).