LaTeX. Пакет minted

1 Общая информация

• Репозиторий: https://github.com/gpoore/minted
• CTAN: https://ctan.org/pkg/minted

2 Тонкости набора

• LaTeX. Греческие буквы в листингах

3 Параметры команды и окружения Minted

• Команды minted принимают один и тот же набор опций в виде списка пар ключ=значение, разделённых запятыми.
• В булевых опциях можно опустить часть true и просто написать имя опции.
• Список наиболее популярных:
  • autogobble (boolean): автоматически удаляет из кода все обычные пробельные символы.
  • gobble (integer): количество символов для удаления из начала всех строк.
  • breaklines (boolean): автоматически разрывать длинные строки в minted-окружениях и \mint-командах, и оборачивать длинные строки в \mintinline.
    • По умолчанию автоматические разрывы происходят только на символах пробела.
    • Вы можете установить breakanywhere=true, чтобы включить разрыв в любом месте.
    • Опции разрыва: breakbytoken, breakbytokenanywhere, breakbefore, breakafter.
  • bgcolor (строка): установить цвет фона листинга (строка должна быть именем ранее определенного цвета).
  • codetagify (список строк): выделение специальных тегов кода в комментариях и документах.
  • curlyquotes (булево): minted по умолчанию задаёт кавычки буквально, но если эта опция установлена в true, то они заменяются фигурными левыми и правыми кавычками.
  • escapeinside (string): заставляет minted выполнять выход в LaTeX между двумя символами, указанными в строке.
    • Весь код между этими двумя символами будет интерпретирован как LaTeX и напечатан соответствующим образом.
    • Символы экранирования не обязательно должны быть одинаковыми.
    • Экранирование не работает внутри строк и комментариев (в последнем случае лучше использовать опцию texcomments).
  • fontfamily, fontseries, fontsize, fontshape: настройка шрифта для minted .
  • linenos (булево): включает нумерацию строк.
    • Параметр numberblanklines (boolean), который включает или отключает нумерацию пустых строк.
  • mathescape (boolean): включает обычный математический режим внутри комментариев.
  • samepage (boolean): заставляет весь листинг отображаться на одной странице, даже если он не помещается.
  • showpaces (boolean): включает отображение видимых пробелов.
    • Можно переопределить символ пробела, передав новый макрос в опцию space (macro); по умолчанию передается макрос \textvisiblespace.
  • stripall (boolean): удаляет из ввода все ведущие и завершающие пробельные символы.
  • tabsize (целое число): количество пробелов, в которое будет преобразована табуляция, если только не активна опция obeytabs (boolean), в этом случае табуляция будет сохранена.

4 Плавающие листинги

• Можно задавать листинги кода как плавающие объекты.
• Для этого в minted предусмотрено окружение listing.
• Можно задать \label{} и \caption{}, а также спецификаторы размещения.
• Индекс всех плавающих листингов в документе задаётся с помощью \listoflistings.
• Можно задать нумерацию от главы или раздела.
• Для этого нужно загрузить пакет с опцией главы или раздела:

  1%% Counts follows sections' numbering
  2\usepackage[section]{minted}
  3
  4%% Counts follows chapters' numbering
  5\usepackage[chapter]{minted}