Left: | ||
Right: |
LEFT | RIGHT |
---|---|
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 Loading... | |
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 Loading... | |
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 Loading... | |
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 Loading... | |
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 Loading... | |
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 Loading... | |
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. |
LEFT | RIGHT |