[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
ANN: Pygments support for LilyPond
From: |
Jean Abou Samra |
Subject: |
ANN: Pygments support for LilyPond |
Date: |
Sun, 21 Nov 2021 23:47:45 +0100 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.3.1 |
Pygments, a syntax highlighter written in Python,
just received support for LilyPond. This means that,
using the latest version of Pygments, you can get
highlighted LilyPond source in LaTeX documents,
Sphinx documentation, Wordpress sites, the output
of various other tools, and any format you like.
(It's also used on Wikipedia, but we'll have to
wait until a release.) To get the latest Pygments,
the short story is
python3 -m pip install --user
https://github.com/pygments/pygments/archive/master.zip
The long story is that you should start by installing
Python. On most GNU/Linux systems, it comes out of the
box or in package managers. On macOS or Windows, download
it from https://www.python.org/downloads/. Then, you need
pip to install packages. If you don't have pip yet, do
'sudo apt install python3-pip' on Debian/Ubuntu, or
'python3 -m ensurepip --user' pretty much anywhere. Finally,
run the command above to let pip install Pygments.
Importantly, you must use the 'lilypond' style. Other styles
(such as the default one) will not produce good-looking
output because they don't know about LilyPond's concepts
(grobs, engravers, etc.).
To use with Sphinx, add to your conf.py:
highlight_language = "lilypond"
pygments_style = "lilypond"
Here is an example of how to use it in LaTeX with the
minted package:
\documentclass{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{minted}
\usemintedstyle{lilypond}
\begin{document}
\begin{minted}{lilypond}
\version "2.23.4"
\header {
title = \markup \bold "Yes!"
}
\relative { c' }
\addlyrics { Oh! }
\end{minted}
\end{document}
Please report any issues at
https://github.com/pygments/pygments/issues
and mention me (@Jean-Abou-Samra).
Thanks go to Matthaüs G. Chajdas, one of the two Pygments
maintainers, for reviewing the code, and to Dan Eble and
Jonas Hahnfeld for their feedback.
- ANN: Pygments support for LilyPond,
Jean Abou Samra <=
- Re: ANN: Pygments support for LilyPond, Jean Abou Samra, 2021/11/21
- Re: ANN: Pygments support for LilyPond, Werner LEMBERG, 2021/11/22
- Re: ANN: Pygments support for LilyPond, Jean Abou Samra, 2021/11/22
- Re: ANN: Pygments support for LilyPond, Werner LEMBERG, 2021/11/22
- Re: ANN: Pygments support for LilyPond, Jean Abou Samra, 2021/11/22
- Re: ANN: Pygments support for LilyPond, Werner LEMBERG, 2021/11/22
- Re: ANN: Pygments support for LilyPond, Jean Abou Samra, 2021/11/23
- Re: ANN: Pygments support for LilyPond, Jean Abou Samra, 2021/11/23
- Re: ANN: Pygments support for LilyPond, Werner LEMBERG, 2021/11/23
- Re: ANN: Pygments support for LilyPond, Jean Abou Samra, 2021/11/24