Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(2216)

Delta Between Two Patch Sets: Documentation/notation/input.itely

Issue 4124056: Doc: NR rewrite of 3.2 Titles and Headers (Closed)
Left Patch Set: 6th Draft Created 12 years, 11 months ago
Right Patch Set: Draft 9 Created 12 years, 10 months ago
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
Left: Side by side diff | Download
Right: Side by side diff | Download
« no previous file with change/comment | « no previous file | no next file » | no next file with change/comment »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
LEFTRIGHT
1 @c -*- coding: utf-8; mode: texinfo; -*- 1 @c -*- coding: utf-8; mode: texinfo; -*-
2 2
3 @ignore 3 @ignore
4 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH 4 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
5 5
6 When revising a translation, copy the HEAD committish of the 6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors' 7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes.. 8 Guide, node Updating translation committishes..
9 @end ignore 9 @end ignore
10 10
(...skipping 527 matching lines...) Expand 10 before | Expand all | Expand 10 after
538 @c TODO: figure out how \bookpart titles work 538 @c TODO: figure out how \bookpart titles work
539 539
540 There are two types of title blocks: the main title block that appears 540 There are two types of title blocks: the main title block that appears
541 above of the first @code{\score} of a book, and individual title 541 above of the first @code{\score} of a book, and individual title
542 blocks that appear within each @code{\score} block. Text fields for 542 blocks that appear within each @code{\score} block. Text fields for
543 both types are entered using a @code{\header} block. 543 both types are entered using a @code{\header} block.
544 544
545 If the book only has a single score, the @code{\header} block may be 545 If the book only has a single score, the @code{\header} block may be
546 placed inside or outside of the @code{\score} block. 546 placed inside or outside of the @code{\score} block.
547 547
548 @warning{Remember when adding a @bs{}@code{header} block inside a
Graham Percival (old account) 2011/05/25 10:25:46 The first block inside a \score must be the music
549 @bs{}@code{score} block, that the music expression must come before the
550 @bs{}@code{header} block.}
551
548 @lilypond[papersize=a5,quote,verbatim,noragged-right] 552 @lilypond[papersize=a5,quote,verbatim,noragged-right]
549 %hello
550 \header { 553 \header {
551 title = "SUITE I." 554 title = "SUITE I."
552 composer = "J. S. Bach." 555 composer = "J. S. Bach."
553 } 556 }
554 557
555 \score { 558 \score {
556 \new Staff \relative g, { 559 \new Staff \relative g, {
557 \clef bass 560 \clef bass
558 \key g \major 561 \key g \major
559 \repeat unfold 2 { g16( d' b') a b d, b' d, } | 562 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
(...skipping 15 matching lines...) Expand all
575 \header { 578 \header {
576 piece = "Allemande." 579 piece = "Allemande."
577 } 580 }
578 } 581 }
579 @end lilypond 582 @end lilypond
580 583
581 Text fields from the main title block of a book can be displayed in all 584 Text fields from the main title block of a book can be displayed in all
582 @code{\score} blocks, or manually suppressed: 585 @code{\score} blocks, or manually suppressed:
583 586
584 @lilypond[papersize=a5,quote,verbatim,noragged-right] 587 @lilypond[papersize=a5,quote,verbatim,noragged-right]
585 % hello
586 \book { 588 \book {
587 \paper { 589 \paper {
588 print-all-headers = ##t 590 print-all-headers = ##t
589 } 591 }
590 \header { 592 \header {
591 title = "DAS WOHLTEMPERIRTE CLAVIER" 593 title = "DAS WOHLTEMPERIRTE CLAVIER"
592 subtitle = "TEIL I" 594 subtitle = "TEIL I"
593 % Do not display the tagline for this book 595 % Do not display the tagline for this book
594 tagline = ##f 596 tagline = ##f
595 } 597 }
(...skipping 34 matching lines...) Expand 10 before | Expand all | Expand 10 after
630 632
631 @node Default layout of book and score title blocks 633 @node Default layout of book and score title blocks
632 @unnumberedsubsubsec Default layout of book and score title blocks 634 @unnumberedsubsubsec Default layout of book and score title blocks
633 635
634 The layout and formatting of title blocks are controlled by two 636 The layout and formatting of title blocks are controlled by two
635 @code{\paper} variables; @code{bookTitleMarkup} for the main 637 @code{\paper} variables; @code{bookTitleMarkup} for the main
636 @code{\header} title block and @code{scoreTitleMarkup} for individual 638 @code{\header} title block and @code{scoreTitleMarkup} for individual
637 @code{\header} blocks within a @code{\score}. 639 @code{\header} blocks within a @code{\score}.
638 640
639 @lilypond[papersize=a6,quote,verbatim,noragged-right] 641 @lilypond[papersize=a6,quote,verbatim,noragged-right]
640 %hello
641 \header { 642 \header {
642 % The following fields are centered 643 % The following fields are centered
643 dedication = "Dedication" 644 dedication = "Dedication"
644 title = "Title" 645 title = "Title"
645 subtitle = "Subtitle" 646 subtitle = "Subtitle"
646 subsubtitle = "Subsubtitle" 647 subsubtitle = "Subsubtitle"
647 instrument = "Instrument" 648 instrument = "Instrument"
648 649
649 % The following fields are left-aligned on the left side 650 % The following fields are left-aligned on the left side
650 poet = "Poet" 651 poet = "Poet"
(...skipping 10 matching lines...) Expand all
661 % The following fields are placed at opposite ends of the same line 662 % The following fields are placed at opposite ends of the same line
662 piece = "Piece" 663 piece = "Piece"
663 opus = "Opus" 664 opus = "Opus"
664 } 665 }
665 } 666 }
666 @end lilypond 667 @end lilypond
667 668
668 @c Is the bit about \null markups true? -mp 669 @c Is the bit about \null markups true? -mp
669 670
670 Text fields left unset in a @code{\header} block are replaced with 671 Text fields left unset in a @code{\header} block are replaced with
671 @code{\null} markups so space is not wasted. The default settings for 672 @code{\null} markups so that the space is not wasted.
672 @code{scoreTitleMarkup} place the @code{piece} and @code{opus} text 673
673 fields at opposite ends of the same line. To force titles to start on a 674 The default settings for @code{scoreTitleMarkup} place the @code{piece}
Graham Percival (old account) 2011/05/25 10:25:46 delete this sentence; it's covered in the image.
674 new page, enter the following line in the appropriate @code{\header} 675 and @code{opus} text fields at opposite ends of the same line.
675 block: 676
676 677 @cindex breakbefore
677 @example 678
678 breakbefore = ##t 679 Use the @code{breakbefore} variable inside a @code{\header} block
679 @end example 680 that is itself in a @code{\score} block, to make the top-level
681 @code{\header} block titles appear on the first page on their own, with
682 the music (defined in the @code{\score} block) starting on the next.
683
684 @lilypond[papersize=a8landscape,verbatim,noragged-right]
685 \book {
686 \header {
687 title = "This is my Title"
688 subtitle = "This is my Subtitle"
689 copyright = "This is the bottom of the first page"
690 }
691 \score {
692 \repeat unfold 4 { e'' e'' e'' e'' }
693 \header {
694 piece = "This is the Music"
695 breakbefore = ##t
696 }
697 }
698 }
699 @end lilypond
680 700
681 @seealso 701 @seealso
702 Learning Manual:
703 @rlearning{How LilyPond input files work},
704
682 Notation Reference: 705 Notation Reference:
683 @ref{File structure}. 706 @ref{File structure}.
684 707
685 Installed Files: 708 Installed Files:
686 @file{ly/titling-init.ly}. 709 @file{ly/titling-init.ly}.
687 710
688 @node Default layout of headers and footers 711 @node Default layout of headers and footers
689 @unnumberedsubsubsec Default layout of headers and footers 712 @unnumberedsubsubsec Default layout of headers and footers
690 713
691 @emph{Headers} and @emph{footers} are lines of text appearing at 714 @emph{Headers} and @emph{footers} are lines of text appearing at
(...skipping 18 matching lines...) Expand all
710 top far right (if odd), starting from the second page. 733 top far right (if odd), starting from the second page.
711 734
712 @item 735 @item
713 the @code{instrument} text field is placed in the center of every 736 the @code{instrument} text field is placed in the center of every
714 page, starting from the second page. 737 page, starting from the second page.
715 738
716 @item 739 @item
717 the @code{copyright} text is centered on the bottom of the first page. 740 the @code{copyright} text is centered on the bottom of the first page.
718 741
719 @item 742 @item
720 the @code{tagline} is centered on the bottom of the last page (below the 743 the @code{tagline} is centered on the bottom of the last page, and below
721 @code{copyright} if there is only one page). The default tagline is a 744 the @code{copyright} text if there is only a single page.
722 clickable link (@url{http://www.lilypond.org}).
723 745
724 @end itemize 746 @end itemize
725 747
726 @lilypond[papersize=a8landscape] 748 @lilypond[papersize=a8landscape]
727 %hello
728 \book { 749 \book {
729 \header {
730 title = "A scale in LilyPond"
731 }
732 \score { 750 \score {
733 \relative c' { 751 \relative c' {
734 c4 d e f 752 c4 d e f
735 g4 a b c
736 } 753 }
737 } 754 }
738 } 755 }
739 @end lilypond 756 @end lilypond
740 757
741 The default tagline can be changed by adding a @code{tagline} in the 758 The default tagline can be changed by adding a @code{tagline} in the
742 top-level @code{\header} block. 759 top-level @code{\header} block.
743 760
744 @lilypond[papersize=a8landscape,verbatim] 761 @lilypond[papersize=a8landscape,verbatim]
745 %hello
746 \book { 762 \book {
747 \header { 763 \header {
748 title = "A scale in LilyPond"
749 tagline = "... music notation for Everyone" 764 tagline = "... music notation for Everyone"
750 } 765 }
751 \score { 766 \score {
752 \relative c' { 767 \relative c' {
753 c4 d e f 768 c4 d e f
754 g4 a b c
755 } 769 }
756 } 770 }
757 } 771 }
758 @end lilypond 772 @end lilypond
759 773
760 To remove the @code{tagline} set the value to to @code{##f}. 774 To remove the @code{tagline} set the value to @code{##f}.
761 775
762 776
763 @node Custom headers footers and titles 777 @node Custom headers footers and titles
764 @subsection Custom headers, footers, and titles 778 @subsection Custom headers, footers, and titles
765 779
766 @c TODO: somewhere put a link to header spacing info 780 @c TODO: somewhere put a link to header spacing info
767 @c (you'll have to explain it more in NR 4). 781 @c (you'll have to explain it more in NR 4).
768 782
769 @menu 783 @menu
770 * Custom text formatting for title blocks:: 784 * Custom text formatting for title blocks::
(...skipping 1746 matching lines...) Expand 10 before | Expand all | Expand 10 after
2517 2531
2518 Although not essential for the Articulate script to work, you may want 2532 Although not essential for the Articulate script to work, you may want
2519 to insert the @code{\unfoldRepeats} command as it appears in the 2533 to insert the @code{\unfoldRepeats} command as it appears in the
2520 example shown above as it enables performing abbreviatures such as 2534 example shown above as it enables performing abbreviatures such as
2521 @notation{trills}. 2535 @notation{trills}.
2522 2536
2523 @knownissues 2537 @knownissues
2524 2538
2525 Articulate shortens chords and some music (esp. organ music) could 2539 Articulate shortens chords and some music (esp. organ music) could
2526 sound worse. 2540 sound worse.
LEFTRIGHT
« no previous file | no next file » | Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Toggle Comments ('s')

Powered by Google App Engine
RSS Feeds Recent Issues | This issue
This is Rietveld f62528b