No release in over 3 years
Low commit activity in last 3 years
Automatically identify LilyPond code snippets in Markdown blog posts and, during conversion to HTML, replace snippets with links to generated SVG images
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.14
~> 3.6

Runtime

~> 3.0
 Project Readme

Jekyll LilyPond Converter

Add lily code blocks to your markdown blog post and automatically convert the code to sheet music using LilyPond.

Installation and Usage

  • Install LilyPond and ensure the lilypond executable is on your $PATH

  • Add this gem to your Jekyll-based static site repository's Gemfile

  • Add lily_images/ to your .gitignore

  • Add the converter to your _config.yml file:

    gems:
    - jekyll-lilypond-converter
    
  • (Optional) specify LilyPond image format in _config.yml (default is svg, alternative option is png)

    lilypond-image-format: png
    
  • Add lily code to a markdown post:

    This is a C major chord:
    
    ```lilypond
    \relative {
      <c' e g>
    }
    ```