Skip to content

stfwn/sphinx_abcnotation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sphinx ABC Notation

This extension adds an abc directive to Sphinx in order to write sheet music as text. The content of the directive will be rendered to SVG by abcm2ps and included in the rendered document.

Usage

Here are some inversions of a D-major triad.

.. abc::

    X:1
    L:1/4
    K:C
    "Root position"[D^FA] [DA^f] | "First inversion"[^FAd] [^Fda] | "Second inversion"[Ad^f] [Ad'^f] |
    w: closed open closed open closed open

Here are some inversions of a D-major triad.

Install

  1. Install abcm2ps.

  2. Install this extension: pip install sphinx_abcnotation --user

  3. Edit conf.py to include sphinx_abcnotation in the extensions list:

    extensions = ['sphinx_abcnotation']
    
  4. Use the .. abc :: directive in your reStructuredText documents.

For info on abc notation itself I recommend this page by Steve Mansfield.

About

Adds an abc directive to Sphinx.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages