Some stuff (Записи о LaTeX)

LaTeX: параметры ключ=значение

None — Tue, 21 Oct 2025 22:42:06 GMT

Определение команды:

\ExplSyntaxOn

\keys_define:nn { mymodule }
  {
    color .tl_set:N = \l_mymodule_color_tl ,
    color .initial:n = { black } ,
    text .tl_set:N = \l_mymodule_text_tl ,
    text .initial:n = { Default~Text } ,
    size .dim_set:N = \l_mymodule_size_dim ,
    size .initial:n = { 12pt } ,
  }

\NewDocumentCommand { \mycommand } { O{} }
  {
    \keys_set:nn { mymodule } { #1 }
    \group_begin:
      \color{\l_mymodule_color_tl}
      \fontsize{\l_mymodule_size_dim}{\dim_eval:n{\l_mymodule_size_dim * 1.2}}\selectfont
      \l_mymodule_text_tl
    \group_end:
  }

\ExplSyntaxOff

Использование:

\begin{document}

\mycommand % Uses default values
\par
\mycommand[color=blue, text=Hello~World, size=18pt]
\par
\mycommand[size=24pt, color=red]

Свойства ключей в `keys_define`

Каждый ключ в keys_define может иметь набор свойств:

.code:n = code to execute: задает код для выполнения, когда ключ задан, при этом в коде может использоваться #1 и туда будет подставлено значение ключа.
.initial:n = initial value: Задает начальное значение. Оно будет использоваться, если ключ вообще не задан.
.default:n = default value: Задает значение по умолчанию. Оно будет использоваться если ключ задан без значения (например, key=).
.choices:nn = { список выбора }: Задает список допустимых значений для ключа. Для каждого возможного значения задается код, который должен выполниться в соответствующем случае.
.bool_set:N, .bool_set_true:N, .bool_set_false:N: Задает что делать для boolean-ключей, установить значение, true или false.
.int_set:N, .dim_set:N, .tl_set:N: Задает присвоение переменным для числа, размера или строки.

Пример:

\ExplSyntaxOn
\keys_define:nn { mymodule }
  {
    color .code:n = \tl_set:Nn \l_mymodule_color_tl { #1 },
    color .initial:n = black,
    shape .choices:nn =
      {
        circle .code:n = \tl_set:Nn \l_mymodule_shape_tl { circle },
        square .code:n = \tl_set:Nn \l_mymodule_shape_tl { square }
      },
    shape .initial:n = circle,
    linewidth .int_set:N = \l_mymodule_linewidth_int,
    linewidth .initial:n = 1
  }
\ExplSyntaxOff

В этом примере определены ключи color, shape и linewidth для модуля mymodule.

color принимает значение, shape значение из списка, a linewidth задает числовую переменную.

LaTeX mbox на список

None — Sun, 19 Oct 2025 20:47:17 GMT

Есть: строка, разделенная запятыми.

Надо: завернуть каждый элемент отдельно в функцию (например, в \mbox) и собрать строку обратно, возможно с другими разделителями.

\ExplSyntaxOn

\NewDocumentCommand{\MBoxingList}{O{,\ }m}
{
  \seq_clear_new:N \l__in_seq
  \seq_set_from_clist:Nn \l__in_seq {#2}
  \seq_set_map:NNn \l__in_seq \l__in_seq {\mbox{##1}}
  \seq_use:Nn \l__in_seq {#1}
%  \quad\seq_count:N \l__in_seq
}

\ExplSyntaxOff

Использовать так: `\expanded{\MBoxingList[, ]{123, 123, 5234, 6543}}

Как вариант определить через \NewExpandableDocumentCommand, но тогда вызывать без \expanded и могут быть сюрпризы если исходная строка передается не явно, а определена командой.

P.S. Вроде и работает, но с этим expansion что-нибудь да не нравится. В общем, глаз да глаз.

P.P.S. Можно попробовать через пакет listofitems.

P.P.P.S Есть какое-то решение на классическом синтаксисе:

\makeatletter

% Functional foreach construct
% #1 - Function to call on each comma-separated item in #3
% #2 - Parameter to pass to function in #1 as first parameter
% #3 - Comma-separated list of items to pass as second parameter to function #1
\def\foreach#1#2#3{%
  \@test@foreach{#1}{#2}#3,\@end@token%
}

% Internal helper function - Eats one input
\def\@swallow#1{}

% Internal helper function - Checks the next character after #1 and #2 and
% continues loop iteration if \@end@token is not found
\def\@test@foreach#1#2{%
  \@ifnextchar\@end@token%
    {\@swallow}%
    {\@foreach{#1}{#2}}%
}

% Internal helper function - Calls #1{#2}{#3} and recurses
% The magic of splitting the third parameter occurs in the pattern matching of the \def
\def\@foreach#1#2#3,#4\@end@token{%
  #1{#2}{#3}%
  \@test@foreach{#1}{#2}#4\@end@token%
}

\makeatother

%% Функция для использования
\def\makembox#1#2{\mbox{#2}, }

Вызов сторонних скриптов из LaTeX

None — Thu, 09 Oct 2025 11:45:10 GMT

Latex при сборке документа может вызывать сторонние программы. Иногда это удобно.

По умолчанию такое поведение запрещено, но опцией командной строки --shell-escape это разрешается.

Настройка latexmk

Если сборка производится через latexmk, то в файл конфигурации latexmkrc надо добавить строчки:

push @extra_pdflatex_options, '-shell-escape';
push @extra_xelatex_options, '-shell-escape';
push @extra_lualatex_options, '-shell-escape';

Альтернативный вариант для того же latexmkrc переопределить переменные для запуска, по сути:

$latex = 'latex  %O  --shell-escape %S';
$pdflatex = 'pdflatex  %O  --shell-escape %S';

В документе

В самом документе можно вызывать внешние программы с параметрами и сразу же вставлять на это место документа их выхлоп. Например:

\makeatletter
\@@input|"python3 ff.py"
\makeatother

LaTeX переменное количество строк и их вывод

None — Fri, 31 Mar 2023 16:40:55 GMT

Иногда бывает нужно добавлять переменное количество строк, к примеру, в преамбуле. А потом, где-то в недрах документа (или стилей) это все как-то вывести.

Такой пример:

% счетчик количества элементов в массиве
\newcount\My@arrname@cnt
\My@arrname@cnt = 0

% временные счетчики (используются для вывода)
% Могут быть одни на много массивов - уникальность не нужна
\newcount\My@tmpcnta
\newcount\My@tmpcntb

% команда добавить в массив
\newcommand{\MyArrayAddRaw}[1]{%
  \advance \My@arrname@cnt 1
  \@namedef{My@arrname@txt@\number\My@arrname@cnt}{#1}}

% команда на вывод
\newcommand{\OutputArray}{

  % вывод массива
  \My@tmpcnta = 1                   % a = 1
  \My@tmpcntb = \My@arrname@cnt     % b = number of elements
  \advance \My@tmpcntb 1            % b++
  \loop
  \ifnum \My@tmpcnta < \My@tmpcntb  % while (a < b)
    \@nameuse{My@arrname@txt@\number\My@tmpcnta}\par % use Array[a]
    \advance \My@tmpcnta 1          % a++;
  \repeat%

}

Текст в две колонки в LaTeX

None — Wed, 28 Sep 2022 13:58:06 GMT

Если надо сделать текст в две колонки, но не на весь документ, а на какую-то его часть (например, чтоб сделать синхронно "было-стало"), то можно использовать пакет paracol.

Для этого в преамбуле документа надо добавить:

\usepackage{paracol}
\setlength{\columnseprule}{0.5pt} % толщина разделительной линии (закомментировать если линия не нужна)
\colseprulecolor{black}  % цвет разделительной линии

В теле документа использовать, например, так:

\begin{paracol}{2}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\textbf{\emph{Имеется:}}

\switchcolumn % переключение на правый столбец

\textbf{\emph{Должно быть:}}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\switchcolumn % переключение на левый столбец

% пусто в этом столбце

\switchcolumn % переключение на правый столбец
\textcolor[rgb]{0,0.4,0}{Сделать дело}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\switchcolumn* % переключение на левый столбец (с выравниванием по высоте = *)
\textcolor{red}{Гулять смело}

\switchcolumn % переключение на правый столбец
\textcolor[rgb]{0,0.4,0}{Отдыхать смело}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Выравнивание по высоте (команду со *) следует использовать только если разная высота абзацев получается, а надо чтоб абзацы шли синхронно слева и справа.

Поворот страницы в LaTeX

None — Tue, 27 Sep 2022 14:43:00 GMT

Если надо сделать посреди нормального портретного документа страницу landscape, но так, чтобы колонтитулы оставались вертикальными, а в итоговом pdf-документе страница отображалась повернутой на 90 градусов, то надо в преамбуле документа добавить:

\usepackage{pdflscape}

А там где должно быть повернуто писать как обычно, но все это обернуть в

\begin{landscape}
...
\end{landscape}

В этом случае страницы станут повернутыми уже в pdf-файле, то есть, при просмотре файла не надо будет крутить головой, а для печати ничего отдельно делать не надо.

LaTeX центрировать текст в ячейке таблицы

None — Fri, 22 Apr 2022 21:42:04 GMT

При центрировании текста внутри ячеек при помощи \centering в последнем столбце ряда возникает сложность из-за проблем с \\, которые означает разное в таблицах и в абзацах.

Для того, чтобы это решить следует использовать:

\centering\arraybackslash

ну или использовать в таблице \tabularnewline вместо \\ (что может далеко не всегда работать).

Источник: https://texfaq.org/FAQ-tabcellalign

Конфигурационный файл latexmkrc

None — Tue, 19 Oct 2021 12:08:14 GMT

latexmk ищет настройки, помимо параметров командной строки, в файле конфигурации latexmkrc.

Типовой шаблон

Вот его типовое содержимое:

# Jobname: as with current tex, etc indicates basename of generated files.
$jobname = 'trd'; 

$out_dir = '__output';  # Directory for output files.

# Array of LaTeX files to process when no files are specified on the command line.
# Wildcards allowed
@default_files = ('main.tex');

$diagnostics = 0;

$pdf_mode = 1;  # No pdf file requested to be made by pdflatex
                # Possible values: 
                #     0 = don't create pdf file
                #     1 = pdflatex to create pdf file by pdflatex
                #     2 = pdf from ps by ps2pdf
                #     3 = pdf from dvi by dvipdf
                #     4 = lualatex    
                #     5 = xelatex     

$do_cd = 0;     # Do not do cd to directory of source file.


$force_mode = 0;        # =1 to force processing past errors

$recorder = 1;          # Whether to use recorder option on latex/pdflatex
$silent = 0;            # Silence latex's messages?


push @extra_pdflatex_options, '-file-line-error';
push @extra_xelatex_options, '-file-line-error';

#push @extra_pdflatex_options, '-halt-on-error';
#push @extra_pdflatex_options, '-interaction=batchmode';
#push @extra_pdflatex_options, '-synctex=1';

$dependents_list = 0;   # Whether to display list(s) of dependencies
$dependents_phony = 0;
$rules_list = 0;        # Whether to display list(s) of dependencies
$deps_file = $out_dir . '/' . $jobname . '.dep';       # File for dependency list output.  Default stdout.

$clean_ext = "dep gz";  # space separated extensions of files that are
                        # to be deleted when doing cleanup, beyond
                        # standard set

$show_time = 1;

if ( ! exists $ENV{TEXINPUTS} ) {
  $ENV{TEXINPUTS} = '';
}
$ENV{TEXINPUTS} = '../sty'.$search_path_separator.$ENV{TEXINPUTS};

Опции для разных вариантов latex одновременно

Если надо добавлять опции одновременно для pdflatex, xelatex и lualatex, то можно сделать функцию (это ж просто perl-скрипт!) и использовать её:

sub add_option1 {
  push @extra_pdflatex_options, $_[0];
  push @extra_xelatex_options,  $_[0];
  push @extra_lualatex_options, $_[0];
}

add_option1 ('-file-line-error');
add_option1 ('-halt-on-error');
add_option1 ('-interaction=batchmode');    
#add_option1 ('-interaction=errorstopmode');

add_option1 ('-synctex=1');

add_option1 ('-shell-escape');

Показ меток в LaTeX

None — Fri, 10 Sep 2021 11:15:19 GMT

Для показа меток используется пакет showlabels. Пример использования:

\usepackage[inline,inner]{showlabels}

LaTeX прикрепить файл к pdf если файл существует

None — Fri, 10 Sep 2021 11:13:20 GMT

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

%%% Включить в pdf файл исходного кода если существует файл ./src/src.zip
\RequirePackage{embedfile}

\IfFileExists{./src/src.zip}{
  \embedfile[filespec=src.zip,mimetype=application/zip,desc=Source code]{./src/src.zip}
}{}