lgrind - Интернет в облаке

ПРОГРАММА:

ИМЯ

lgrind - обрабатывать красивые списки программ с помощью LaTeX

ЗАМЕТКА

Эта страница руководства еще не сильно устарела, но может скоро появиться, если только кто-нибудь не попросит меня поработать
в теме. Считайте документы LaTeX настоящими документами.

СИНТАКСИС

лгринд [ -e ] [ -i ] [ - ] [ -n ] [ -c ] [ -t ] [ -h ] [ -d <описание
файл> ] [ -l ] [ -s ] ...

ОПИСАНИЕ

LGrind красиво форматирует исходники программы, используя Латекс(1). Комментарии помещаются в
римским шрифтом, ключевые слова выделены жирным шрифтом, переменные - курсивом, а строки - машинным шрифтом. Источник
Номера строк файлов отображаются в правом поле (каждые 10 строк).

LGrind обрабатывает свой входной файл (ы) и записывает результат в стандартный вывод. Этот вывод
можно сохранить для последующего редактирования, включения в большой документ и т. д.

Возможные варианты:

-e обработать файл LaTeX для встроенного кода.

-i файл исходного кода процесса для включения в документ LaTeX.

- принимать входные данные со стандартного ввода.

-n не выделяйте ключевые слова жирным шрифтом.

-c не относитесь к @ и т. д. специально в комментариях.

-t изменить ширину табуляции (по умолчанию 8).

-h указывает текст, который нужно вставить в заголовок.

-d указывает файл определений языков (по умолчанию
/ usr / lib / texmf / текс / латекс / lgrind / lgrindef).

-д! То же, что и выше, но напишите исправленный исполняемый файл.

-l указывает используемый язык.

-s показывает список известных в настоящее время языков.

Если LGrind вызывается без параметров, будет показан экран справки. Если ни то, ни другое -e ни -i
указаны, создается полный файл LaTeX. Если язык не указан, LGrind
сам пытается определить используемый язык; C используется, когда это не удается.

ИСПОЛЬЗОВАНИЕ

Например, чтобы включить файл C с именем foo.c в ваш документ LaTeX, сначала дайте
команда:

lgrind -i -lc foo.c> foo.tex

Это сгенерирует foo.tex, который будет иметь довольно печатную версию foo.c с большим количеством
команд LaTeX.

Затем включите lgrind.sty, как и любой другой стиль, а именно
Строка \ usepackage {lgrind} в начале вашего документа LaTeX. Сделав это, внутри
документ, который вы можете включить foo.tex, используя одну из следующих команд:

\ lgrindfile {foo.tex}
который просто включит файл в эту точку текста и отобразит горизонтальный
строки до и после листинга.

\ lagrind [htbp] {foo.tex} {caption} {label}
который поместит листинг также в среду рисунка, используя float
параметры, заголовок и метка, которые вы дали.

Чтобы создать автономный файл LaTeX, скажем, из файла Yacc:

lgrind -ly bary.y> bary.tex
Он использует fancyhdr.sty Пита ван Оострума для создания верхних и нижних колонтитулов.

Для более подробного объяснения этих команд см.
/usr/TeX/texmf/doc/latex/lgrind.dvi.

EMBEDDED ПРОГРАММЫ В ПРЕДЕЛАХ A Латекс ФАЙЛОВ

(Из заметок Джерри Лейхтера.)

В тексте вашего файла LaTeX вы помечаете группы строк как текстовые или как отображаемые.
программный код стиля:

Стиль текста:

Выражение
%(
+ 3
%)
производит 10.
выводит что-то вроде: "Выражение a + 3 дает 10. "(с" a + 3 ", установленным как
программа.)

Тот же эффект может быть достигнут с помощью встроенных @.

Выражение @a + 3 @ дает 10.

Стиль отображения:

Заявление
%[
а + = 3;
%]
является примером оператора увеличения.
печатает что-то вроде:

Заявление
а + = 3;
является примером оператора увеличения.

Важные правила:

% и следующий символ должны быть первыми двумя символами в строке, чтобы быть
распознан.

Ставить ничего в строке после% и ключевого символа. Если вы это сделаете, LGrind
предоставит среду по умолчанию, которая создаст \ hbox для% ()%, а
\ vbox для% [-%]. Если вы поставите что-то на кон, LGrind предполагает, что вы хотите
полностью контролировать формат. Это требует понимания точно, что за
код, который производит LGrind, делает. (Иногда я не уверен, что знаю!)

%) и%], если я правильно помню, просто игнорируются вне группы кода, но любые
extra% (или% [выдает предупреждение, поэтому отсутствует%) или%] обычно перехватывается.

Вы можете вставить свой собственный код, используя строку, начинающуюся с% = в тексте программы.
Все, что вы вводите после этого, остается на выходе в точности так, как вы это вводили. Это будет
выполняется в странной среде, поэтому делать что-нибудь необычное очень сложно. Макрос,
\ Line предназначен, чтобы помочь вам делать простые вещи. Например,

%[
% = \ Line {________ \ vdots}

а = 1;
%]
производит:

.
.
.
а = 1;

(В тексте программы _ активен и расширяется до пространства фиксированной ширины. Целая группа
макросов также определены. Если вы понимаете, как LGrind настраивает линии, вы можете заменить
8 _ с вызовом \ Tab - но я позволю вам повеситься на этом.)

Вывод LGrind всегда содержит ровно одну строку вывода для каждой строки ввода. Следовательно,
вы можете искать номера строк в сообщениях об ошибках TeX в исходном файле, а не в
файл lgrind'ed (lground?). (Конечно, если проблема в выводе LGrind ....)

Многие вещи можно контролировать, переопределив различные макросы. Вы можете изменить какие шрифты
LGrind будет использовать для разных вещей, насколько он отступает на выходе,
добавляет номера строк, и если да, то с каким интервалом он их печатает и наклеивает ли их
влево или вправо и так далее. Все это описано в lgrind.dvi, хотя, вероятно,
не очень хорошо. Настройки по умолчанию дают результат, который мне кажется разумным, хотя я
не могу сказать, что я в восторге от этого. Делая на самом деле хорошая работа потребует определения некоторых
специальные шрифты.

Используйте lgrind онлайн с помощью сервисов onworks.net