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

Side by Side Diff: Documentation/notation/input.itely

Issue 279140043: Doc: NR - Issue 4677 - input.itely: Various improvements (Closed)
Patch Set: Fix Typo that breaks make doc. Created 8 years, 1 month 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:
View unified diff | Download patch
« no previous file with comments | « no previous file | no next file » | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
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 1872 matching lines...) Expand 10 before | Expand all | Expand 10 after
1883 } 1883 }
1884 1884
1885 tocAct = 1885 tocAct =
1886 #(define-music-function (text) (markup?) 1886 #(define-music-function (text) (markup?)
1887 (add-toc-item! 'tocActMarkup text)) 1887 (add-toc-item! 'tocActMarkup text))
1888 1888
1889 \book { 1889 \book {
1890 \markuplist \table-of-contents 1890 \markuplist \table-of-contents
1891 \tocAct \markup { Atto Primo } 1891 \tocAct \markup { Atto Primo }
1892 \tocItem \markup { Coro. Viva il nostro Alcide } 1892 \tocItem \markup { Coro. Viva il nostro Alcide }
1893 \tocItem \markup { Cesare. Presti omai l'Egizzia terra } 1893 \tocItem \markup { Cesare. Presti omai l'Egizia terra }
1894 \tocAct \markup { Atto Secondo } 1894 \tocAct \markup { Atto Secondo }
1895 \tocItem \markup { Sinfonia } 1895 \tocItem \markup { Sinfonia }
1896 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore } 1896 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1897 \markup \null 1897 \markup \null
1898 } 1898 }
1899 @end lilypond 1899 @end lilypond
1900 1900
1901 1901
1902 Here is an example of the @code{\fill-with-pattern} command used within 1902 Here is an example of the @code{\fill-with-pattern} command used within
1903 the context of a table of contents; 1903 the context of a table of contents;
(...skipping 374 matching lines...) Expand 10 before | Expand all | Expand 10 after
2278 } 2278 }
2279 << 2279 <<
2280 \keepWithTag #'a \music 2280 \keepWithTag #'a \music
2281 \keepWithTag #'b \music 2281 \keepWithTag #'b \music
2282 \keepWithTag #'both \music 2282 \keepWithTag #'both \music
2283 >> 2283 >>
2284 @end lilypond 2284 @end lilypond
2285 2285
2286 Multiple @code{\removeWithTag} filters may be applied to a single 2286 Multiple @code{\removeWithTag} filters may be applied to a single
2287 music expression to remove several differently named tagged 2287 music expression to remove several differently named tagged
2288 sections. Alternatively, you can use a single 2288 sections. Alternatively, you can use a single @code{\removeWithTag}
2289 @code{\removeWithTag} with a list of tags. 2289 with a list of tags.
2290 2290
2291 @lilypond[verbatim,quote] 2291 @lilypond[verbatim,quote]
2292 music = \relative c'' { 2292 music = \relative c'' {
2293 \tag #'A { a4 a a a } 2293 \tag #'A { a4 a a a }
2294 \tag #'B { b4 b b b } 2294 \tag #'B { b4 b b b }
2295 \tag #'C { c4 c c c } 2295 \tag #'C { c4 c c c }
2296 \tag #'D { d4 d d d } 2296 \tag #'D { d4 d d d }
2297 } 2297 }
2298 \new Voice { 2298 \new Voice {
2299 \removeWithTag #'B 2299 \removeWithTag #'B
2300 \removeWithTag #'C 2300 \removeWithTag #'C
2301 \music 2301 \music
2302 \removeWithTag #'(B C) 2302 \removeWithTag #'(B C)
2303 \music 2303 \music
2304 } 2304 }
2305 @end lilypond 2305 @end lilypond
2306 2306
2307 Two or more @code{\keepWithTag} filters applied to a single music 2307 Using two or more @code{\keepWithTag} filters on a single music
2308 expression will cause @emph{all} tagged sections to be removed, as 2308 expression will cause @emph{all} of the tagged sections to be removed.
2309 the first filter will remove all tagged sections except the one 2309 The first filter will remove all except the one named and any subsequent
2310 named, and the second filter will remove even that tagged section. 2310 filters will remove the rest. Using one @code{\keepWithTag} command
2311 Usually you would rather want to use a single @code{\keepWithTag} 2311 with a list of multiple tags will only remove tagged sections that are
2312 command with a list of multiple tags: this will only remove tagged 2312 not specified in that list.
2313 sections not given in @emph{any} of the tags. 2313
fedelogy 2016/02/18 22:51:46 Sorry, I'm still confused. I cannot see any link b
pkx166h 2016/02/21 10:44:37 OK I'll remove it. It wasn't clear in your reque
2314 @lilypond[verbatim,quote]
2315 music = \relative c'' {
2316 \tagGroup #'(A B C)
2317 \tag #'A { a4 a a a }
2318 \tag #'B { b4 b b b }
2319 \tag #'C { c4 c c c }
2320 \tag #'D { d4 d d d }
2321 }
2322
2323 \new Staff {
2324 \keepWithTag #'A
2325 \music
2326 }
2327 @end lilypond
2328
2329 @noindent
2330 will print @code{\tag}s @code{#'A} and @code{#'D} but not @code{#'B} and
2331 @code{#'C}.
2314 2332
2315 @cindex tag groups 2333 @cindex tag groups
2316 @funindex \tagGroup 2334 @funindex \tagGroup
2317 While @code{\keepWithTag} is convenient when dealing with 2335 While @code{\keepWithTag} is convenient when dealing with
2318 @emph{one} set of alternatives, the removal of music tagged with 2336 @emph{one} set of alternatives, the removal of music tagged with
2319 @emph{unrelated} tags is problematic when using tags for more than 2337 @emph{unrelated} tags is problematic when using tags for more than
2320 one purpose. For that reason, @q{tag groups} of related tags can 2338 one purpose. For that reason, @q{tag groups} of related tags can
2321 be declared: 2339 be declared:
2322 2340
2323 @example 2341 @example
(...skipping 121 matching lines...) Expand 10 before | Expand all | Expand 10 after
2445 the mapping of a subset of the Unicode code points to glyphs. 2463 the mapping of a subset of the Unicode code points to glyphs.
2446 LilyPond uses the Pango library to layout and render multi-lingual 2464 LilyPond uses the Pango library to layout and render multi-lingual
2447 texts. 2465 texts.
2448 2466
2449 LilyPond does not perform any input-encoding conversions. This 2467 LilyPond does not perform any input-encoding conversions. This
2450 means that any text, be it title, lyric text, or musical 2468 means that any text, be it title, lyric text, or musical
2451 instruction containing non-ASCII characters, must be encoded in 2469 instruction containing non-ASCII characters, must be encoded in
2452 UTF-8. The easiest way to enter such text is by using a 2470 UTF-8. The easiest way to enter such text is by using a
2453 Unicode-aware editor and saving the file with UTF-8 encoding. Most 2471 Unicode-aware editor and saving the file with UTF-8 encoding. Most
2454 popular modern editors have UTF-8 support, for example, vim, Emacs, 2472 popular modern editors have UTF-8 support, for example, vim, Emacs,
2455 jEdit, and GEdit do. All MS Windows systems later than NT use 2473 jEdit, and Gedit do. All MS Windows systems later than NT use
2456 Unicode as their native character encoding, so even Notepad can 2474 Unicode as their native character encoding, so even Notepad can
2457 edit and save a file in UTF-8 format. A more functional 2475 edit and save a file in UTF-8 format. A more functional
2458 alternative for Windows is BabelPad. 2476 alternative for Windows is BabelPad.
2459 2477
2460 If a LilyPond input file containing a non-ASCII character is not 2478 If a LilyPond input file containing a non-ASCII character is not
2461 saved in UTF-8 format the error message 2479 saved in UTF-8 format the error message
2462 2480
2463 @example 2481 @example
2464 FT_Get_Glyph_Name () error: invalid argument 2482 FT_Get_Glyph_Name () error: invalid argument
2465 @end example 2483 @end example
2466 2484
2467 will be generated. 2485 will be generated.
2468 2486
2469 Here is an example showing Cyrillic, Hebrew and Portuguese 2487 Here is an example showing Cyrillic, Hebrew and Portuguese
2470 text: 2488 text:
2471 2489
2490 @c NOTE: No verbatim in the following example as the code does not
2491 @c display correctly in PDF Font settings for Cyrillic and Hebrew
2492
2472 @lilypond[quote] 2493 @lilypond[quote]
2473 %c No verbatim here as the code does not display correctly in PDF
2474 % Font settings for Cyrillic and Hebrew
2475 % Linux Libertine fonts contain Cyrillic and Hebrew glyphs. 2494 % Linux Libertine fonts contain Cyrillic and Hebrew glyphs.
2476 \paper { 2495 \paper {
2477 #(define fonts 2496 #(define fonts
2478 (set-global-fonts 2497 (set-global-fonts
2479 #:roman "Linux Libertine O,serif" 2498 #:roman "Linux Libertine O,serif"
2480 #:sans "Linux Biolinum O,sans-serif" 2499 #:sans "Linux Biolinum O,sans-serif"
2481 #:typewriter "Linux Libertine Mono O,monospace" 2500 #:typewriter "Linux Libertine Mono O,monospace"
2482 )) 2501 ))
2483 } 2502 }
2484 2503
(...skipping 174 matching lines...) Expand 10 before | Expand all | Expand 10 after
2659 file, but other formats such as @code{PDF} or @code{PNG} can also be 2678 file, but other formats such as @code{PDF} or @code{PNG} can also be
2660 created if required. The extracted music is output as if had been 2679 created if required. The extracted music is output as if had been
2661 literally @q{cut} from the original printed score so if a fragment runs 2680 literally @q{cut} from the original printed score so if a fragment runs
2662 over one or more lines, a separate output file for each line will be 2681 over one or more lines, a separate output file for each line will be
2663 generated. 2682 generated.
2664 2683
2665 @seealso 2684 @seealso
2666 Notation Reference: 2685 Notation Reference:
2667 @ref{The layout block}. 2686 @ref{The layout block}.
2668 2687
2669 Application Usage 2688 Application Usage:
2670 @rprogram{Command-line usage}. 2689 @rprogram{Command-line usage}.
2671 2690
2672 2691
2673 2692
2674 @node Skipping corrected music 2693 @node Skipping corrected music
2675 @subsection Skipping corrected music 2694 @subsection Skipping corrected music
2676 2695
2677 2696
2678 @funindex skipTypesetting 2697 @funindex skipTypesetting
2679 @funindex showFirstLength 2698 @funindex showFirstLength
(...skipping 153 matching lines...) Expand 10 before | Expand all | Expand 10 after
2833 @end itemize 2852 @end itemize
2834 2853
2835 Panning, balance, expression, reverb and chorus effects can also be 2854 Panning, balance, expression, reverb and chorus effects can also be
2836 controlled by setting context properties, 2855 controlled by setting context properties,
2837 see @ref{Context properties for MIDI effects}. 2856 see @ref{Context properties for MIDI effects}.
2838 2857
2839 When combined with the @file{articulate} script the following, 2858 When combined with the @file{articulate} script the following,
2840 additional musical notation can be output to MIDI; 2859 additional musical notation can be output to MIDI;
2841 2860
2842 @itemize 2861 @itemize
2843 @item Appogiaturas. These are made to take half the value of the note 2862 @item Appoggiaturas. These are made to take half the value of the note
2844 following (without taking dots into account). For example; 2863 following (without taking dots into account). For example;
2845 2864
2846 @example 2865 @example
2847 \appoggiatura c8 d2. 2866 \appoggiatura c8 d2.
2848 @end example 2867 @end example
2849 2868
2850 @noindent 2869 @noindent
2851 The c will take the value of a crotchet. 2870 The c will take the value of a crotchet.
2852 2871
2853 @item Ornaments (i.e. mordents, trills and turns et al.) 2872 @item Ornaments (i.e. mordents, trills and turns et al.)
(...skipping 672 matching lines...) Expand 10 before | Expand all | Expand 10 after
3526 3545
3527 Notation Reference: 3546 Notation Reference:
3528 @ref{Score layout}. 3547 @ref{Score layout}.
3529 3548
3530 Installed Files: 3549 Installed Files:
3531 @file{ly/articulate.ly}. 3550 @file{ly/articulate.ly}.
3532 3551
3533 @warning{The @file{articulate} script may shorten chords, which might 3552 @warning{The @file{articulate} script may shorten chords, which might
3534 not be appropriate for some types of instrument, such as organ music. 3553 not be appropriate for some types of instrument, such as organ music.
3535 Notes that do not have any articulations attached to them may also be 3554 Notes that do not have any articulations attached to them may also be
3536 shortened; so to compensate for this, restrict the use of the 3555 shortened; so to allow for this, restrict the use of the
3537 @code{\articulate} function to shorter segments of music or modify the 3556 @code{\articulate} function to shorter segments of music, or modify the
3538 values of the variables defined in the @file{articulate} script to 3557 values of the variables defined in the @file{articulate} script to
3539 compentate for the note-shortening behavior.} 3558 compensate for the note-shortening behavior.}
3540 3559
3541 3560
3542 3561
3543 @node Extracting musical information 3562 @node Extracting musical information
3544 @section Extracting musical information 3563 @section Extracting musical information
3545 3564
3546 In addition to creating graphical output and MIDI, LilyPond can 3565 In addition to creating graphical output and MIDI, LilyPond can
3547 display musical information as text. 3566 display musical information as text.
3548 3567
3549 @menu 3568 @menu
(...skipping 28 matching lines...) Expand all
3578 up these messages and save the results of @code{\displayLilyMusic}, 3597 up these messages and save the results of @code{\displayLilyMusic},
3579 redirect the output to a file. 3598 redirect the output to a file.
3580 3599
3581 @example 3600 @example
3582 lilypond file.ly >display.txt 3601 lilypond file.ly >display.txt
3583 @end example 3602 @end example
3584 3603
3585 @funindex \void 3604 @funindex \void
3586 Note that Lilypond does not just display the music expression, but 3605 Note that Lilypond does not just display the music expression, but
3587 also interprets it (since @code{\displayLilyMusic} returns it in 3606 also interprets it (since @code{\displayLilyMusic} returns it in
3588 addition to displaying it). This is convenient since you can just 3607 addition to displaying it). Just insert @code{\displayLilyMusic} into
3589 insert @code{\displayLilyMusic} into existing music in order to get 3608 the existing music in order to get information about it.
3590 information about it. If you don't actually want Lilypond to 3609
3591 interpret the displayed music as well as display it, use @code{\void} 3610 To interpret and display a music section in the console but, at the same
3592 in order to have it ignored: 3611 time, remove it from the output file use the @code{\void} command.
3593 3612
3594 @example 3613 @example
3595 @{ 3614 @{
3596 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @} 3615 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
3616 c1
3597 @} 3617 @}
3598 @end example 3618 @end example
3599 3619
3600 3620
3601 @node Displaying scheme music expressions 3621 @node Displaying scheme music expressions
3602 @subsection Displaying scheme music expressions 3622 @subsection Displaying scheme music expressions
3603 3623
3604 See @rextend{Displaying music expressions}. 3624 See @rextend{Displaying music expressions}.
3605 3625
3606 3626
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after
3642 3662
3643 3663
3644 @knownissues 3664 @knownissues
3645 3665
3646 Not all lilypond music events are supported by 3666 Not all lilypond music events are supported by
3647 @file{event-listener.ly}. It is intended to be a well-crafted 3667 @file{event-listener.ly}. It is intended to be a well-crafted
3648 @qq{proof of concept}. If some events that you want to see are 3668 @qq{proof of concept}. If some events that you want to see are
3649 not included, copy @file{event-listener.ly} into your lilypond 3669 not included, copy @file{event-listener.ly} into your lilypond
3650 directory and modify the file so that it outputs the information 3670 directory and modify the file so that it outputs the information
3651 you want. 3671 you want.
OLDNEW
« no previous file with comments | « no previous file | no next file » | no next file with comments »

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