Table of contents section command - Revision history

Lemzwerg: Lemzwerg moved page Toc Section Command to Table of contents section command without leaving a redirect: Better title

2025-11-24T05:49:09Z

Lemzwerg moved page Toc Section Command to Table of contents section command without leaving a redirect: Better title

← Older revision	Revision as of 05:49, 24 November 2025
(No difference)

Lemzwerg: New category

2025-11-21T23:26:33Z

New category

← Older revision		Revision as of 23:26, 21 November 2025
Line 88:		Line 88:

	[[Category:Titles]]		[[Category:Titles]]
	[[Category:Paper and layout]][[Category:Snippet]]		[[Category:Paper and layout]]
			[[Category:Snippet]]

Lemzwerg at 23:01, 21 November 2025

2025-11-21T23:01:45Z

← Older revision		Revision as of 23:01, 21 November 2025
Line 88:		Line 88:

	[[Category:Titles]]		[[Category:Titles]]
	[[Category:Paper and layout]]		[[Category:Paper and layout]][[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:54:40Z

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:54, 16 November 2025
Line 17:		Line 17:
	Now every section is introduced with a section line in the table of contents only if the section title was set before. If you reorder the parts (includes), the sections will still appear in the right place. This is meant for compiling a collection of pieces, which also compile themselves. For a complete opus with pieces Please see snippet [http://lsr.di.unimi.it/LSR/Item?id=368 368]		Now every section is introduced with a section line in the table of contents only if the section title was set before. If you reorder the parts (includes), the sections will still appear in the right place. This is meant for compiling a collection of pieces, which also compile themselves. For a complete opus with pieces Please see snippet [http://lsr.di.unimi.it/LSR/Item?id=368 368]

	<lilypond version="2.24.0" full>		<lilypond version="2.24" full>
	%% http://lsr.di.unimi.it/LSR/Item?id=738		%% http://lsr.di.unimi.it/LSR/Item?id=738
	%% see also http://lsr.di.unimi.it/LSR/Item?id=368		%% see also http://lsr.di.unimi.it/LSR/Item?id=368

Jean Abou Samra: Import snippet from LSR

2025-10-26T22:46:18Z

Import snippet from LSR

New page

If you have several pieces in several files, you might want to build a book from that. Assume you have a master file which includes the pieces:

<pre>
\include "tune1.ly"
\include "tune2.ly"
</pre>
In your piece-files you might have <code>\tocItem</code> commands to build the table of contents.

If you replace those <code>\tocItem</code> commands with the newly defined <code>\part</code> command, you can use <code>#(set-toc-section! "</code>''<code>section</code>''<code>")</code> in the master file:

<pre>#(set-toc-section! "tunes")
\include "tune1.ly"
\include "tune2.ly"
#(set-toc-section! "parts")
\include "part1.ly"
\include "part2.ly"</pre>
Now every section is introduced with a section line in the table of contents only if the section title was set before. If you reorder the parts (includes), the sections will still appear in the right place. This is meant for compiling a collection of pieces, which also compile themselves. For a complete opus with pieces Please see snippet [http://lsr.di.unimi.it/LSR/Item?id=368 368]

<lilypond version="2.24.0" full>
%% http://lsr.di.unimi.it/LSR/Item?id=738
%% see also http://lsr.di.unimi.it/LSR/Item?id=368

% define toc-section commands
#(begin
(define-public (set-toc-section! text) #f)
(define-public (get-toc-section text) #f)
(let ((toc-section #f))
(set! set-toc-section! (lambda (text)(set! toc-section text)))
(set! get-toc-section (lambda ()(begin toc-section)))))

% define section-aware piece-toc-item-command
piece = #(define-music-function (text) (markup?)
(begin
(if (get-toc-section) (add-toc-item! 'tocCollMarkup (get-toc-section)))
(set-toc-section! #f)
(add-toc-item! 'tocPartMarkup text)))

\paper {
#(set-paper-size "a5 landscape")
% this will not know the page number!
tocCollMarkup = \markup { \fill-line { \bold \fromproperty #'toc:text \vspace #1 \null } }
tocPartMarkup = \markup { \fill-line { \concat { \hspace #2 \fromproperty #'toc:text } \vspace #0 \fromproperty #'toc:page } }
}

% some music pieces ...
\bookpart {
\markuplist {
\override-lines #'(baseline-skip . 2.3)
\table-of-contents
}
}
#(set-toc-section! "section 1")
\bookpart {
\piece \markup { "piece 1" }
\score {
\relative c' {
c d e f g
}
}
}
\bookpart {
\piece \markup { "piece 2" }
\score {
\relative c' {
c d e f
}
}
}
#(set-toc-section! "section 2")
\bookpart {
\piece \markup { "piece 1" }
\score {
\relative c' {
c d e f
}
}
}
\bookpart {
\piece \markup { "piece 2" }
\score {
\relative c' {
c d e f
}
}
}
</lilypond>

[[Category:Titles]]
[[Category:Paper and layout]]