lstlistings и кириллица

При использовании кириллицы в листингах возникает ряд проблем, решение которых разбросано где-то по интернетам. Здесь я опишу некоторые приёмы, позволяющие решить возникающие проблемы.

Основные проблемы, с которыми сталкиваются люди при попытке использовать кириллицу в листингах - не компилится исходник и теряются пробелы в комментах. Лично я ещё столкнулся с тем, что комменты и строки в кириллице не подсвечиваются нужным цветом.


Итак, задача: напечатать в документе листинг программы

#include <stdio.h>

/**
 * Программа выведет сообщение "Привет, мир"
 */
int main()
{
    printf("Привет, мир\n");        // печатаем сообщение

}

Кодировка utf8. Как обычно помещаем это внутрь lstlisting, но при компиляции возникает ошибка.

Поэтому первое, что делаем - включаем поддержку расширенных символов:
\lstset{extendedchars=\true}

Отлично, теперь оно компилируется, но результат не совсем тот, который нужен:

Видим здесь 2 проблемы: в комментариях съелись пробелы и криво расставлены кавычки. Первая проблема решается легко добавлением опции keepspaces=true. Нормально решить вторую не получится в принципе. Но можно сделать костыль двумя способами.

Первый вариант костыля - ставить пробел сразу после кавычки и тогда они постаявятся перед буквой 'П'. Но такой вариант делает комментарий неправильным. Поэтому можно воспользоваться вторым вариантом - escapechar. Эта команда задаёт символ, после которого тест трактуется как стандартный текст в Latex со всеми вытекающими. К сожалению, при использовании цветных комментов это ничем не поможет. Есть вариант как раскрасить однострочные комменты - опция texcl=true, но если цвет однострочного коммента отличается от многострочного - то Вам не повезло. В результате получаем следующий код:

Опции пакета:
\lstset{tabsize=2,
    breaklines,
    columns=fullflexible,
    flexiblecolumns,
    numbers=left,
    numberstyle={\footnotesize},
    extendedchars=\true
}
\lstdefinelanguage{MyC}{
  language=C,
  ndkeywordstyle=\color{darkgray}\bfseries,
  identifierstyle=\color{black},
  morecomment=[n]{/**}{*/},
  commentstyle=\color{blue}\ttfamily,
  stringstyle=\color{red}\ttfamily,
  morestring=[b]",
  showstringspaces=false,
  morecomment=[l][\color{gray}]{//},
  keepspaces=true,
  escapechar=\%,
  texcl=true
}

Сам листинг:
\begin{lstlisting}[language=MyC]
#include <stdio.h>

/**
 * %Программа выведет сообщение <<Привет, мир>>%
 */
int main()
{
    printf("Привет, мир\n");        // печатаем сообщение

}
\end{lstlisting}

Выглядеть результат будет так:

Проблему с цветом решить так и не удалось. В случае использования однобайтовых кодировок можно воспользоваться приёмом вроде

literate={а}{{\selectfont\char224}}1

но для  utf8 оно не подойдёт.