Skip to main content

Lilypond plugin for Sphinx

sphinxcontrib-lilypond license sphinxcontrib-lilypond python version

sphinxcontrib-lilypond last version

This plugin implements a lily role and directive to include Music score formatted by Lilypond.

Changelog

  • 2017-xx SVG format is waiting a cropping solution

  • 2017-11 Cleanup for Python 3

Credits

Installation

Using pip:

pip install sphinxcontrib-lilypond

Functionalities

  • A lily role to include a standalone music markup. For example, a G clef can be inserted by:

    :lily:`\musicglyph #"clefs.G"`

    The purpose of the ‘lily’ role is writing music comments or learning notes. So only one markup is allowed.

  • A lily directive to include a score, for example:

    .. lily::
    
       \relative c'' {
         c4 a d c
       }

Settings

The lilypond_fontsize variable can be used to set the font size:

lilypond_fontsize = [6, -3]
  • The first value is for lily role setting in absolute font size.

  • The second value is for lily directive setting in relative font size.

Default settings:

lilypond_preamble = ''
lilypond_fontsize = [10, -3]
lilypond_command = 'lilypond'
lilypond_args = []

Metadata

Release history Release notifications | RSS feed

This release

1.1.0 This release

1.0.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page