filecontents

Синопсис:

\begin{filecontents}[option]{filename}
  text
\end{filecontents}

или

\begin{filecontents*}[option]{filename}
  text
\end{filecontents*}

Создаёт файл с именем filename в текущем каталоге (или каталоге вывода, если указан; см. каталог вывода) и записывает в него text. По умолчанию, существующий файл не перезаписывается.

Непомеченная версия среды filecontents добавляет в начало создаваемого файла заголовок с комментариями TeX; см. пример ниже. Помеченная версия filecontents* не включает заголовок.

Возможные опции:

force ¶

overwrite

Перезаписать существующий файл.

noheader ¶

Опустить заголовок. Эквивалентно использованию filecontents*.

nosearch ¶

Проверять существование файла только в текущем каталоге (и каталоге вывода, если указан), а не во всей цепочке поиска.

Эти опции были добавлены в релизе LaTeX 2019 года.

Эта среда может быть использована в любом месте преамбулы, хотя часто её размещают перед командой \documentclass. Она обычно используется для создания файла данных, такого как .bib, или других файлов из исходного файла документа, чтобы сделать исходный файл самодостаточным. Аналогично, она может быть использована для создания пользовательского файла стиля или класса, опять же, делая исходный файл самодостаточным.

Например, этот документ:

\documentclass{article}
\begin{filecontents}{JH.sty}
\newcommand{\myname}{Jim Hef{}feron}
\end{filecontents}
\usepackage{JH}
\begin{document}
Article by \myname.
\end{document}

производит этот файл JH.sty:

%% LaTeX2e file `JH.sty'
%% generated by the `filecontents' environment
%% from source `test' on 2015/10/12.
%%
\newcommand{\myname}{Jim Hef{}feron}