Zim - A Desktop Wiki


Score Editor


The score editor is a simple dialog that allows you to insert a score into a page using GNU Lilypond.


In order to be able to use this plugin, you must have GNU Lilypond installed and the following commands must be available on your system: "lilypond" and "convert-ly" (why?). You can control the look of the scores using the special template "_Score.ly".


Dependencies: This plugin requires GNU Lilypond to be installed. Specifically, the "lilypond" and "convert-ly" commands should be available in the system path.


Syntax


Refer to the References section for information on GNU Lilypond syntax.


Following are a few examples generated by the plugin:


Example 1: Pachelbel's Canon

\relative c {
        \clef bass
        \key d \major
        \time 4/4

        d4 a b fis
        g4 d g a
}


Example 2: With Chords, Staff and Lyrics

<<
    \chords {
        c1:m7 f2:7 c2
    }
    \relative c'' {
        g2 es8( c4) es8
        f8 es d c~ c2
    }
    \addlyrics {
        You are
        the sky and my rain,
    }
>>


Example 3: With multiple Staffs

hornNotes =
  \relative c {
    \time 2/4
    R2*3
    r4 f8 a cis4 f e d
  }

bassoonNotes =
  \relative c {
    \clef bass
    r4 d,8 f gis4 g b bes
    a8 e f4 g d gis f
  }


<<
  \new Staff \hornNotes
  \new Staff \bassoonNotes
>>


Example 4: With Strumming rhythm and FretBoard

<<
  \new ChordNames {
    \chordmode {
      c1 | f | g | c
    }
  }
  \new FretBoards {
    \chordmode {
      c1 | f | g | c
    }
  }
  \new Voice \with {
    \consists "Pitch_squash_engraver"
  } {
    \relative c'' {
      \improvisationOn
      c4 c8 c c4 c8 c
      f4 f8 f f4 f8 f
      g4 g8 g g4 g8 g
      c4 c8 c c4 c8 c
    }
  }
  \new Voice = "melody" {
    \relative c'' {
      c2 e4 e4
      f2. r4
      g2. a4
      e4 c2.
    }
  }
  \new Lyrics {
    \lyricsto "melody" {
      This is my song.
      I like to sing.
    }
  }
>>


Template


The Score plugin's template has following three variables to customize your GNU Lilypond document, used for generating the score images:


Feel free to tailor the template file for your needs.


GNU Lilypond Version


Syntax of GNU Lilypond could change with new releases, and these changes need not be backward compatible. For this reason, the version of GNU Lilypond when the score was created is inserted into the score text by the plugin.


When a different version of GNU Lilypond is installed, the plugin will use convert-ly (packaged with GNU Lilypond) to convert the score file to be compatible with installed version before rendering the score.


References