Adding links to objects - Revision history

Lemzwerg: Mark some text for not being included in official documentation

2025-12-25T07:22:18Z

Mark some text for not being included in official documentation

← Older revision		Revision as of 07:22, 25 December 2025
Line 5:		Line 5:
	Limitation: Works for PDF only.		Limitation: Works for PDF only.

	The linked objects are colored with a separate command. Note that the links are not displayed and are not clickable from inside this Wiki for technical reasons.		The linked objects are colored with a separate command. <span class="nodoc">Note that the links are not displayed and are not clickable from inside this Wiki for technical reasons.</span>

	<lilypond version="2.24">		<lilypond version="2.24">

Lemzwerg at 10:58, 11 December 2025

2025-12-11T10:58:36Z

← Older revision		Revision as of 10:58, 11 December 2025
Line 5:		Line 5:
	Limitation: Works for PDF only.		Limitation: Works for PDF only.

	The linked objects are colored with a separate command. Note that the links are not displayed and are not clickable from inside ~~the LSR~~.		The linked objects are colored with a separate command. Note that the links are not displayed and are not clickable from inside this Wiki for technical reasons.

	<lilypond version="2.24">		<lilypond version="2.24">
Line 95:		Line 95:

	[[Category:Editorial annotations]]		[[Category:Editorial annotations]]
			[[Category:Scheme]]
	[[Category:Tweaks and overrides]]		[[Category:Tweaks and overrides]]
	~~[[Category:Scheme]]~~
	[[Category:Included in the official documentation]]		[[Category:Included in the official documentation]]
	[[Category:Snippet]]		[[Category:Snippet]]

Lemzwerg: New category

2025-11-21T23:12:56Z

New category

← Older revision		Revision as of 23:12, 21 November 2025
Line 97:		Line 97:
	[[Category:Tweaks and overrides]]		[[Category:Tweaks and overrides]]
	[[Category:Scheme]]		[[Category:Scheme]]
	[[Category:Included in the official documentation]][[Category:Snippet]]		[[Category:Included in the official documentation]]
			[[Category:Snippet]]

Lemzwerg at 22:46, 21 November 2025

2025-11-21T22:46:08Z

← Older revision		Revision as of 22:46, 21 November 2025
Line 97:		Line 97:
	[[Category:Tweaks and overrides]]		[[Category:Tweaks and overrides]]
	[[Category:Scheme]]		[[Category:Scheme]]
	[[Category:Included in the official documentation]]		[[Category:Included in the official documentation]][[Category:Snippet]]

Jean Abou Samra: Replace version="2.24.0" with version="2.24" now that the LilyWiki extension supports auto-selecting the latest release in a stable series

2025-11-16T18:45:10Z

Replace version="2.24.0" with version="2.24" now that the LilyWiki extension supports auto-selecting the latest release in a stable series

← Older revision		Revision as of 18:45, 16 November 2025
Line 7:		Line 7:
	The linked objects are colored with a separate command. Note that the links are not displayed and are not clickable from inside the LSR.		The linked objects are colored with a separate command. Note that the links are not displayed and are not clickable from inside the LSR.

	<lilypond version="2.24.0">		<lilypond version="2.24">
	#(define (add-link url-strg)		#(define (add-link url-strg)
	(lambda (grob)		(lambda (grob)

Jean Abou Samra: Import snippet from LSR

2025-10-26T22:49:22Z

Import snippet from LSR

New page

To add a link to a grob stencil you can use <code>add-link</code> as defined here. It works both with <code>\override</code> and <code>\tweak</code>.

Drawback: <code>point-and-click</code> is disturbed for the linked grobs.

Limitation: Works for PDF only.

The linked objects are colored with a separate command. Note that the links are not displayed and are not clickable from inside the LSR.

<lilypond version="2.24.0">
#(define (add-link url-strg)
(lambda (grob)
(let* ((stil (ly:grob-property grob 'stencil)))
(if (ly:stencil? stil)
(let* ((x-ext (ly:stencil-extent stil X))
(y-ext (ly:stencil-extent stil Y))
(url-expr `(url-link ,url-strg ,x-ext ,y-ext))
(new-stil
(ly:stencil-add
(ly:make-stencil url-expr x-ext y-ext)
stil)))
(ly:grob-set-property! grob 'stencil new-stil))))))

%%%% test

%% For easier maintenance of this snippet the URL is formatted to use the
%% actually used LilyPond version.
%% Of course a literal URL would work as well.

#(define major.minor-version
(string-join (take (string-split (lilypond-version) #\.) 2) "."))

urlI =
#(format #f
"http://lilypond.org/doc/v~a/Documentation/notation/writing-pitches"
major.minor-version)

urlII =
#(format #f
"http://lilypond.org/doc/v~a/Documentation/notation/rhythms"
major.minor-version)

urlIII =
#(format #f
"http://lilypond.org/doc/v~a/Documentation/notation/note-heads"
major.minor-version)

urlIV =
#(format #f
"http://lilypond.org/doc/v~a/Documentation/notation/beams"
major.minor-version)

urlV =
#(format #f
"http://lilypond.org/doc/v~a/Documentation/notation/note-head-styles"
major.minor-version)

urlVI =
#(format #f
"http://lilypond.org/doc/v~a/Documentation/notation/writing-pitches"
major.minor-version)

\relative c' {
\key cis \minor

\once \override Staff.Clef.color = #green
\once \override Staff.Clef.after-line-breaking =
#(add-link urlI)

\once \override Staff.TimeSignature.color = #green
\once \override Staff.TimeSignature.after-line-breaking =
#(add-link urlII)

\once \override NoteHead.color = #green
\once \override NoteHead.after-line-breaking =
#(add-link urlIII)

cis'1
\once \override Beam.color = #green
\once \override Beam.after-line-breaking =
#(add-link urlIV)
cis8 dis e fis gis2
<gis,
\tweak Accidental.color #green
\tweak Accidental.after-line-breaking #(add-link urlVI)
\tweak color #green
\tweak after-line-breaking #(add-link urlV)
\tweak style #'harmonic
bis
dis
fis
>1
<cis, cis' e>
}
</lilypond>

[[Category:Editorial annotations]]
[[Category:Tweaks and overrides]]
[[Category:Scheme]]
[[Category:Included in the official documentation]]