Как в LaTeX сделать описание функции языка программирования?

[alien308]

Как в LaTeX сделать описание функции языка программирования, конкретно сейчас Python, с нужными отступами и соответствующими секциями (описание, аргументы, возвращаемые значения)? Вот как здесь https://docs.scipy.org/doc/scipy/reference/generated/scipy.signal.spectrogram.html.

[zykov]

По разному.
Например:

Используется синтаксис LaTeX

\begin{verbatim}
\end{verbatim}

[alien308]

Так не пойдёт. Надо правильно расставить отступы, где надо моноширинный шрифт и так далее. Думаю существует достойный канонический способ или пакет. Хотелось бы сразу делать достойно, а не сотворять недостойные костыли.

[zykov]

Проще всего картинкой вставить.
Сделать хорошо с подсветкой синтаксиса, в картику преобразовать и её вставить.
Быстрый и лёгкий способ.

-- 10.09.2022, 20:19 --

Вот ещё есть пакет LaTeX/Source Code Listings.

[alien308]

Source Code Listing он для исходного кода, а не для документации. Картинку вставлять уж очень костыльно, редактировать потом сложно.
Пока отступы и переносы строк ручками подгоняю, что категорически не рекомендуется :)

[Pphantom]

Каких-то специализированных именно для этой задачи средств, кажется, нет, но внешне желаемое очень сильно напоминает вложенные ненумерованные списки (itemize), возможно, с некоторой дополнительной настройкой отступов.

[vpb]

alien308 в сообщении #1564524 писал(а):

Так не пойдёт

Бог весть, почему вам так не пойдет. Я намедни решил аналогичный вопрос с помощью begin/end verbatim.

("Аналогичный вопрос" означает вот что. Доказательство некоего утверждения опиралось на большие компьютерные вычисления. Дабы избавить читателя от возможных сомнений, типа "а может vpb это неправильно запрограммировал ?", я в качестве последнего параграфа в препринте поместил распечатку программы, чтобы сомневающийся читатель мог ее прогнать самостоятельно. Просто брал из исходного файла на сях функции, и вставлял их между begin{verbatim} и end{verbatim}. И вполне красиво и читабельно получилось. )

На всякий случай, в книжке Львовского про латех есть параграф про буквальное воспроизведение.

[ИСН]

Вербатим был хорош 20 лет назад. За это время люди обленились, разучились обдирать медведя на обед, привыкли к тёплой ванне и подсветке кода. Поэтому minted. Да, он требует дополнительных приседаний с питоном.