Latex

• 1: Библиотека цветных блоков и рамок tcolorbox для Latex
• 1.1: Ключи к командам tcolorbox
• 1.2: Команды для Title
• 1.3: Команды для SubTitle
• 1.4: Команды для Part
• 1.5: Команды для Lower Part
• 1.6: Команды для Color и Font
• 1.7: Команды для выравнивания текста
• 1.8: Команды для управления размерами и отступами в боксах
• 1.9: Команды для управления параметрами углов в боксах
• 1.10: Команды для управления прозрачностью в боксах
• 1.11: Команды для управления высотой боксов
• 1.12: Команды для добавления различного контента в боксы
• 1.13: Команды для упрвления слоями в боксах
• 1.14: Команды для управления плавающими объектами боксов
• 1.15: Команды для встраивания объектов и боксов в боксы (embedding)
• 1.16: Управление ограничивающей рамкой (Bounding Box) в tcolorbox
• 1.17: Управление уровнями/слоями в пакете tcolorbox
• 1.18: Управление Capture mode в пакете tcolorbox
• 1.19: Управление характеристиками текста в пакете tcolorbox
• 1.20: Files - Работа с временными файлами в tcolorbox
• 1.21: cbox Specials - Специальные настройки для cbox и cboxmath
• 1.22: Counters, Labels, and References - Счётчики, метки и ссылки в tcolorbox
• 1.23: Even and Odd Pages - Разное оформление для чётных и нечётных страниц
• 1.24: Externalization - Интеграция с внешними файлами TikZ
• 1.25: Miscellaneous - Разные дополнительные возможности
• 2: Справочник основных пакетов LaTeX
• 3: Latex для авторов
• 3.1: Памятка по командам Latex 3
• 4: Пакеты для работы с таблицами в LaTeX
• 5: Описание пакетов fancyhdr и fancybox
• 6: TEX издательская система
• 6.1: TEX команды
• 6.2: TEX for the Impatient
• 6.3: TEX
• 6.4:
• 7: Графический пакет TIKZ для Latex
• 7.1: Дисплей для руководства пользователя
• 7.2: Foreach for Tex
• 7.3: Key Management
• 7.4: Примеры PIC в библиотеке TIKZ
• 7.5: Matrix в модуле TIKZ
• 7.6: PIC маленький рисунок
• 7.7: Node TIKZ
• 7.8: Path и его особенности
• 7.9: Вводные понятия в TIKZ
• 7.10: Диаграммы в Latex библиотека TIKZ
• 7.11: Примеры по Эвклиду
• 7.12: Сети PETRI
• 7.13: Графики в TIKZ для Latex
• 8: Пакет Xcolor и colortbl
• 9: Пакет longtable
• 10: Newfont
• 11: Pdfpages
• 12: Titleps
• 13: Titlesec
• 14: Пакет fontenc - Управление кодировками шрифтов в LaTeX
• 15: Пакет fontspec - Управление кодировками шрифтов в XeLaTeX

1 - Библиотека цветных блоков и рамок tcolorbox для Latex

Официальное описание пакета по адресу: https://ctan.org/pkg/tcolorbox

tcolorbox – Цветные рамки для примеров и теорем в LaTeX и т. д.

Этот пакет предоставляет среду для цветных текстовых рамок с заголовком. По желанию, такая рамка может быть разделена на верхнюю и нижнюю части; таким образом, пакет может быть использован для настройки примеров LaTeX, где одна часть рамки отображает исходный код, а другая часть показывает результат. Другой распространенный случай использования – настройка теорем. Пакет поддерживает сохранение и повторное использование исходного кода и частей текста.

Пакет зависит от пакетов pgf, verbatim, environ и etoolbox.

\documentclass[a4paper]{article}
\usepackage{tikz}
\usepackage[all]{tcolorbox}
\usepackage{incgraph}
\usepackage{lipsum}
\usepackage{accsupp} 
\begin{document}
\begin{inctext}
  \begin{tikzpicture}
    \definecolorseries{boxcol}{rgb}{last}{blue}{red}
    \resetcolorseries[28]{boxcol}
    \coordinate (A) at (0,0); \coordinate (B) at (21,29.7);
    \path[use as bounding box] (A) rectangle coordinate (C) (B);
    \node[transform shape,xslant=0.7,rotate=-10,xshift=0cm] at (C) {%
      \BeginAccSupp{method=plain,ActualText={}}%
      \begin{tcbraster}[raster columns=4,title=tcolorbox,
        fonttitle=\small\bfseries,raster width=50cm]
        \foreach \b in {1,...,28} {\begin{tcolorbox}[enhanced,
            watermark text=\thetcbrasternum,
            colframe=boxcol!30!white,
            colback=boxcol!25!white!30!white,
            colbacktitle=boxcol!!+!50!black!30!white,
            colupper=black!30!white]\lipsum[2]\end{tcolorbox}}
      \end{tcbraster}%
      \EndAccSupp{}%
    };
    \node at (C) {%
      \begin{tcbitemize}[title=tcolorbox ,fonttitle=\small\bfseries,
        enhanced jigsaw,opacityback=0.5,opacitybacktitle=0.75,
        halign=center,valign=center,arc=5mm,
        raster width=16cm,raster column skip=8mm,raster halign=center,
        raster force size=false,
        raster row 1/.style={height=6cm},
        raster row 2/.style={width=6cm,height=4cm},
        raster column 1/.style={flushright title,
          frame style={left color=yellow!50!black,right color=green!50!black},
          title style={left color=yellow!50!blue,right color=blue!50!green!50!black},
          interior style={left color=yellow!70,right color=green!70},
          underlay={\draw[line width=6mm,line cap=round,black!60]
            ([shift={(0.4,-0.15)}]frame.north east)
            --([shift={(0.4,0.15)}]frame.south east); }},
        raster column 2/.style={
          frame style={left color=green!50!black,right color=yellow!50!black},
          title style={left color=blue!50!green!50!black,right color=yellow!50!blue},
          interior style={left color=green!70,right color=yellow!70}}]
        \tcbitem[fontupper=\Huge\bfseries,sharp corners=east,
        underlay={\draw[line width=6mm,line cap=round,black!60]
          ([shift={(0.4,0.30)}]frame.north east)-- coordinate(A) +(0,0.2);
          \draw[line width=1mm,line cap=round,black!60](A) -- +(30:1.5cm);
          \draw[line width=1mm,line cap=round,black!60](A) -- +(150:1.5cm);}]
        tcolorbox
        \tcbitem[fontupper=\large\bfseries,sharp corners=west]
        Manual for
        \tcbitem[sharp corners=northeast]
        \tcbitem[sharp corners=northwest] Thomas F.~Sturm
      \end{tcbitemize}%
    };
  \end{tikzpicture}
\end{inctext}
\end{document}

Установка пакета

\usepackage{tcolorbox}

Пакет принимает ключи опций в синтаксисе “ключ-значение”. В качестве альтернативы вы можете использовать эти ключи позже в преамбуле с помощью команды \tcbuselibrary.

\tcbuselibrary{⟨key list⟩}

Вот перевод на русский язык с примерами, обернутыми в latex:

Следующие ключи используются внутри \tcbuselibrary соответственно \usepackage без ключа:

• tree path /tcb/library/.

• /tcb/library/skins (LIB skins)
  Загружает пакет tikzfill.image → CTAN и предоставляет дополнительные стили (skins) для внешнего вида цветных коробок;

  \tcbuselibrary{skins}
  

• /tcb/library/vignette (LIB vignette)
  Предоставляет код для более орнаментального оформления;

  \tcbuselibrary{vignette}
  

• /tcb/library/raster (LIB raster)
  Предоставляет дополнительные макросы и опции для наборки нескольких коробок, расположенных в виде растровой сетки;

  \tcbuselibrary{raster}
  

• /tcb/library/listings (LIB listings)
  Загружает пакет listings → CTAN и предоставляет дополнительные макросы для наборки листингов

  \tcbuselibrary{listings}
  

• /tcb/library/listingsutf8 (LIB listingsutf8)
  Загружает пакеты listings → CTAN и listingsutf8 для поддержки UTF-8.

  \tcbuselibrary{listingsutf8}
  

• /tcb/library/minted (LIB minted)
  Загружает пакет minted → CTAN для наборки листингов с помощью инструмента Pygments;

  \tcbuselibrary{minted}
  

• /tcb/library/theorems (LIB theorems)
  Предоставляет дополнительные макросы для наборки теорем

  \tcbuselibrary{theorems}
  

• /tcb/library/breakable (LIB breakable)
  Предоставляет поддержку автоматического разбиения коробок с одной страницы на другую;

  \tcbuselibrary{breakable}
  

• /tcb/library/magazine (LIB magazine)
  Предоставляет поддержку для хранения частей разбитых коробок для последующего использования или в измененном порядке;

  \tcbuselibrary{magazine}
  

• /tcb/library/poster (LIB poster)
  Предоставляет поддержку для создания постеров;

  \tcbuselibrary{poster}
  

• /tcb/library/fitting (LIB fitting)
  Предоставляет поддержку адаптации размера шрифта содержимого коробки к размерам коробки;

  \tcbuselibrary{fitting}
  

• /tcb/library/hooks (LIB hooks)
  Расширяет несколько опций до “hookable” ключей;

  \tcbuselibrary{hooks}
  

• /tcb/library/xparse (LIB xparse)
  Загружает пакет xparse → CTAN и считается устаревшей библиотекой, сохраненной для совместимости;

  \tcbuselibrary{xparse}
  

• /tcb/library/external (LIB external)
  Предоставляет поддержку экстернализации для фрагментов документов, которые могут быть самостоятельными;

  \tcbuselibrary{external}
  

• /tcb/library/documentation (LIB documentation)
  Предоставляет дополнительные макросы для наборки документации LATEX

Основные параметры рамок tcolorbox

Создание рамок

Команды tcolorbox и \tcbox

\begin{tcolorbox}
This is a \textbf{tcolorbox}.
\end{tcolorbox}

\begin{tcolorbox}[colback=red!5!white,colframe=red!75!black,title=My nice heading]
This is another \textbf{tcolorbox}.
\tcblower %разделитель бокса
Here, you see the lower part of the box.
\end{tcolorbox}

\tcblower

Используется внутри tcolorbox для разделения верхней части коробки от необязательной нижней части коробки. Верхняя и нижняя части рассматриваются как отдельные функциональные единицы. Если вы хотите просто провести линию, используйте \tcbline.

Пример использования:

\begin{tcolorbox}
    Верхняя часть коробки.
    \tcblower
    Нижняя часть коробки.
\end{tcolorbox}

\tcbset{⟨options⟩}

Устанавливает параметры для всех последующих tcolorbox внутри текущей группы TEX. По умолчанию это не применяется к вложенным коробкам.

Например, цвета коробок могут быть определены для всего документа следующим образом:

\tcbset{colback=red!5!white, colframe=red!75!black}

После этого все последующие tcolorbox будут использовать указанные цвета фона и рамки.

\tcbsetforeverylayer{⟨options⟩}

Устанавливает параметры для всех последующих tcolorbox внутри текущей группы TEX. В отличие от \tcbset, это также применяется к вложенным коробкам. Технически, параметры ⟨options⟩ добавляются к значениям по умолчанию для каждой tcolorbox, которые применяются с помощью /tcb/reset

Не следует использовать этот макрос, если вы не уверены, что хотите применять ⟨options⟩ также для коробок в коробках (в коробках в коробках и т.д.).

Пример использования:

\tcbset{colback=green!10!white}
\tcbsetforeverylayer{colframe=red!75!black}

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

\tcbox[⟨options⟩]{⟨box content⟩}

Создает цветную коробку, которая подгоняется по ширине к заданному содержимому ⟨box content⟩. В принципе, большинство ⟨options⟩ для tcolorbox могут быть использованы для \tcbox с некоторыми ограничениями. \tcbox не может иметь нижнюю часть и не может быть разбита.

Пример использования:

\tcbox[colback=blue!10!white, colframe=blue!75!black]{Это содержимое цветной коробки.}

В этом примере создается цветная коробка с заданным фоном и рамкой, подгоняющаяся по ширине к тексту внутри.

\tcboxverb[⟨options⟩]{⟨verbatim box content⟩}

Создает цветную коробку на основе \tcbox, которая подгоняется по ширине к заданному содержимому ⟨verbatim box content⟩. Основная \tcbox стилизована с помощью /tcb/verbatim плюс заданные ⟨options⟩. Разница с \tcbox заключается в том, что ⟨verbatim box content⟩ интерпретируется как текст без форматирования. Поэтому \tcboxverb действует аналогично \verb.

Пример использования:

\tcboxverb[colback=yellow!10!white, colframe=yellow!75!black]{\texttt{Это содержимое в verbatim-формате.}}

В этом примере создается цветная коробка с заданным фоном и рамкой, подгоняющаяся по ширине к тексту, который интерпретируется без форматирования.

Создание окружений и команд tcolorbox

\newtcolorbox[⟨init options⟩]{⟨name⟩}[⟨number⟩][⟨default⟩]{⟨options⟩}

Создает новое окружение ⟨name⟩ на основе tcolorbox. В принципе, \newtcolorbox работает как \newenvironment. Это означает, что новое окружение ⟨name⟩ может принимать ⟨number⟩ аргументов, где ⟨default⟩ — это значение по умолчанию для необязательного первого аргумента. Параметры ⟨options⟩ передаются основной tcolorbox. Обратите внимание, что /tcb/savedelimiter автоматически устанавливается на заданное ⟨name⟩. Параметры ⟨init options⟩ позволяют настроить автоматическую нумерацию.

Пример использования:

\newtcolorbox[auto numbered]{mybox}[2][default value]{colback=blue!5!white, colframe=blue!75!black, title=Заголовок}

В этом примере создается новое окружение mybox, которое может принимать два аргумента, где первый аргумент имеет значение по умолчанию “default value”. Параметры для tcolorbox задают цвет фона, цвет рамки и заголовок.

\newtcolorbox{mybox}{colback=red!5!white,
colframe=red!75!black}
\begin{mybox}
This is my own box.
\end{mybox}

\newtcolorbox{mybox}[1]{colback=red!5!white,
colframe=red!75!black,fonttitle=\bfseries,
title={#1}}
\begin{mybox}{Hello there}
This is my own box with a mandatory title.
\end{mybox}

\newtcolorbox{mybox}[2][]{colback=red!5!white,
colframe=red!75!black,fonttitle=\bfseries,
colbacktitle=red!85!black,enhanced,
attach boxed title to top center={yshift=-2mm},
title={#2},#1}
\begin{mybox}[colback=yellow]{Hello there}
This is my own box with a mandatory title
and options.
\end{mybox}

\newtcolorbox[auto counter,number within=section]{pabox}[2][]{%
colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
title=Examp.~\thetcbcounter: #2,#1}

\begin{pabox}[colback=yellow]{Hello there}
This is my own box with a mandatory
numbered title and options.
\end{pabox}

\renewtcolorbox[⟨init options⟩]{⟨name⟩}[⟨number⟩][⟨default⟩]{⟨options⟩}

Работает аналогично \newtcolorbox, но основан на \renewenvironment вместо \newenvironment. Существующее окружение переопределяется.

Пример использования:

\renewtcolorbox[auto numbered]{mybox}[2][default value]{colback=green!5!white, colframe=green!75!black, title=Обновленный заголовок}

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

\NewTColorBox[⟨init options⟩]{⟨name⟩}{⟨specification⟩}{⟨options⟩}

Создает новое окружение ⟨name⟩ на основе tcolorbox. В принципе, \NewTColorBox работает как \NewDocumentEnvironment. Это означает, что новое окружение ⟨name⟩ создается с заданным аргументом LATEX3 ⟨specification⟩. Если окружение с именем ⟨name⟩ уже было определено, будет выдана ошибка. Параметры ⟨options⟩ передаются основной tcolorbox. Обратите внимание, что /tcb/savedelimiter автоматически устанавливается на заданное ⟨name⟩. Параметры ⟨init options⟩ позволяют настроить автоматическую нумерацию.

Пример использования:

% counter из предыдущего примера pabox продолжается в этом стиле
\NewTColorBox[use counter from=pabox]{mybox}{ O{red} m d"" !O{} }
{enhanced,colframe=#1!75!black,colback=#1!5!white,
fonttitle=\bfseries,title={\thetcbcounter~#2},
IfValueT={#3}{watermark text={#3}},#4}

\begin{mybox}{My title}
This is a tcolorbox.
\end{mybox}

\begin{mybox}[blue]{My title}
This is a tcolorbox.
\end{mybox}

\begin{mybox}[green]{My title}"My Watermark"
This is a tcolorbox.
\end{mybox}

\begin{mybox}[yellow]{My title}[colbacktitle=yellow!50!white,coltitle=black]
This is a tcolorbox.
\end{mybox}

\begin{mybox}[purple]{My title}"All together"[coltitle=yellow]
This is a tcolorbox.
\end{mybox}

В этом примере создается новое окружение mynewbox с заданной спецификацией и параметрами, включая цвет фона, цвет рамки и заголовок. Если окружение с именем mynewbox уже существует, будет выдана ошибка.

\RenewTColorBox[⟨init options⟩]{⟨name⟩}{⟨specification⟩}{⟨options⟩}

Работает аналогично \NewTColorBox , но основан на \RenewDocumentEnvironment вместо \NewDocumentEnvironment. Существующее окружение переопределяется.

Пример использования:

\RenewTColorBox[auto numbered]{mybox}{m}{colback=red!10!white, colframe=red!75!black, title=Обновленный заголовок}

В этом примере существующее окружение mybox переопределяется с новыми параметрами.

\ProvideTColorBox[⟨init options⟩]{⟨name⟩}{⟨specification⟩}{⟨options⟩}

Работает аналогично \NewTColorBox, но основан на \ProvideDocumentEnvironment вместо \NewDocumentEnvironment. Окружение ⟨name⟩ создается только в том случае, если оно еще не определено.

Пример использования:

\ProvideTColorBox[auto numbered]{mybox}{m}{colback=green!10!white, colframe=green!75!black, title=Предоставленный заголовок}

В этом примере окружение mybox будет создано только если оно еще не существует.

\DeclareTColorBox[⟨init options⟩]{⟨name⟩}{⟨specification⟩}{⟨options⟩}

Работает аналогично \NewTColorBox, но основан на \DeclareDocumentEnvironment вместо \NewDocumentEnvironment. Новое окружение всегда создается, независимо от того, существует ли уже окружение с тем же именем.

Пример использования:

\DeclareTColorBox[auto numbered]{mybox}{m}{colback=blue!10!white, colframe=blue!75!black, title=Объявленный заголовок}

В этом примере окружение mybox будет создано, даже если оно уже существует, что может привести к ошибке.

\NewTotalTColorBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}{⟨content⟩}

Создает новую команду \⟨name⟩ на основе tcolorbox. В отличие от \NewTColorBox, также указывается ⟨content⟩ для tcolorbox. В принципе, \NewTotalTColorBox работает как \NewDocumentCommand. Это означает, что новая команда \⟨name⟩ создается с заданным аргументом LATEX3 ⟨specification⟩. Если \⟨name⟩ уже было определено, будет выдана ошибка. Параметры ⟨options⟩ передаются основной tcolorbox, которая заполняется указанным ⟨content⟩. Обратите внимание, что /tcb/savedelimiter автоматически устанавливается на заданное \⟨name⟩. Также обратите внимание, что /tcb/saveto, /tcb/savelowerto и /tcb/redirectlowerto не могут использоваться с \NewTotalTColorBox и аналогичными командами. Параметры ⟨init options⟩ позволяют настроить автоматическую нумерацию.

Пример использования:

\NewTotalTColorBox{\diabox}{ O{} v m }
{ bicolor,nobeforeafter,equal height group=diabox,width=5.7cm,
fonttitle=\bfseries\ttfamily,adjusted title={#2},center title,
colframe=blue!20!black,leftupper=0mm,rightupper=0mm,colback=black!75!white,#1}
{ \tikz\path[fill zoom image={#2}] (0,0) rectangle (\linewidth,4cm);%
\tcblower#3}

\diabox{blueshade.png}{Created with |GIMP|.\\\url{http://www.gimp.org}}
\diabox{goldshade.png}{Created with |GIMP|.\\\url{http://www.gimp.org}}

В этом примере создается новая команда mytotalbox, которая принимает содержимое и параметры, включая цвет фона и цвет рамки. Если команда с именем mytotalbox уже существует, будет выдана ошибка.

\RenewTotalTColorBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}{⟨content⟩}

Работает аналогично \NewTotalTColorBox, но основан на \RenewDocumentCommand вместо \NewDocumentCommand. Существующая команда переопределяется.

Пример использования:

\RenewTotalTColorBox[auto numbered]{mytotalbox}{m}{colback=purple!10!white, colframe=purple!75!black}{Обновленное содержимое команды.}

В этом примере существующая команда mytotalbox переопределяется с новыми параметрами и содержимым.

\ProvideTotalTColorBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}{⟨content⟩}

Работает аналогично \NewTotalTColorBox, но основан на \ProvideDocumentCommand вместо \NewDocumentCommand. Команда \⟨name⟩ создается только в том случае, если она еще не определена.

Пример использования:

\ProvideTotalTColorBox[auto numbered]{mytotalbox}{m}{colback=teal!10!white, colframe=teal!75!black}{Предоставленное содержимое команды.}

В этом примере команда mytotalbox будет создана только если она еще не существует.

\DeclareTotalTColorBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}{⟨content⟩}

Работает аналогично \NewTotalTColorBox, но основан на \DeclareDocumentCommand вместо \NewDocumentCommand. Новая команда всегда создается, независимо от того, существует ли уже команда с тем же именем.

Пример использования:

\DeclareTotalTColorBox[auto numbered]{mytotalbox}{m}{colback=cyan!10!white, colframe=cyan!75!black}{Объявленное содержимое команды.}

В этом примере команда mytotalbox будет создана, даже если она уже существует, что может привести к ошибке.

Создание команд на основе \tcbox

\newtcbox[⟨init options⟩]{\⟨name⟩}[⟨number⟩][⟨default⟩]{⟨options⟩}

Создает новый макрос \⟨name⟩ на основе \tcbox. В принципе, \newtcbox работает как \newcommand. Новый макрос \⟨name⟩ может принимать ⟨number⟩+1 аргументов (до 10), где ⟨default⟩ — это значение по умолчанию для необязательного первого аргумента. В дополнение к аргументам ⟨number⟩ есть автоматический последний (обязательный) аргумент \⟨name⟩, который принимает содержимое коробки. Параметры ⟨options⟩ передаются основной tcbox. Параметры ⟨init options⟩ позволяют настроить автоматическую нумерацию.

Пример использования:

\newtcbox{\mybox}[1][red]{on line,
arc=0pt,outer arc=0pt,colback=#1!10!white,colframe=#1!50!black,
boxsep=0pt,left=1pt,right=1pt,top=2pt,bottom=2pt,
boxrule=0pt,bottomrule=1pt,toprule=1pt}

\newtcbox{\xmybox}[1][red]{on line,
arc=7pt,colback=#1!10!white,colframe=#1!50!black,
before upper={\rule[-3pt]{0pt}{10pt}},boxrule=1pt,
boxsep=0pt,left=6pt,right=6pt,top=2pt,bottom=2pt}

The \mybox[green]{quick} brown \mybox{fox} \mybox[blue]{jumps} over the \mybox[green]{lazy} \mybox{dog}.\par
The \xmybox[green]{quick} brown \xmybox{fox} \xmybox[blue]{jumps} over the \xmybox[green]{lazy} \xmybox{dog}.

В этом примере создается новый макрос mytcbox, который может принимать два аргумента, где первый аргумент имеет значение по умолчанию “default value”. Параметры для tcbox задают цвет фона и цвет рамки.

\renewtcbox[⟨init options⟩]{\⟨name⟩}[⟨number⟩][⟨default⟩]{⟨options⟩}

Работает аналогично \newtcbox, но основан на \renewcommand вместо \newcommand. Существующий макрос переопределяется.

Пример использования:

\renewtcbox[auto numbered]{mytcbox}[2][default value]{colback=blue!10!white, colframe=blue!75!black}

В этом примере существующий макрос mytcbox переопределяется с новыми параметрами и значением по умолчанию для первого аргумента.

\NewTCBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}

Создает новую команду \⟨name⟩ на основе \tcbox. В принципе, \NewTCBox работает как \NewDocumentCommand. Это означает, что новая команда \⟨name⟩ создается с заданным аргументом LATEX3 ⟨specification⟩. В дополнение к аргументу ⟨specification⟩ есть автоматический последний (обязательный) аргумент \⟨name⟩, который принимает содержимое коробки. Таким образом, \⟨name⟩ может иметь до 10 аргументов в сумме. Если \⟨name⟩ уже было определено, будет выдана ошибка. Параметры ⟨options⟩ передаются основной \tcbox. Обратите внимание, что /tcb/savedelimiter автоматически устанавливается на заданное \⟨name⟩. Параметры ⟨init options⟩ позволяют настроить автоматическую нумерацию.

Пример использования:

\NewTCBox[auto numbered]{mynewtcbox}{m}{colback=green!10!white, colframe=green!75!black}

В этом примере создается новая команда mynewtcbox, которая принимает спецификацию и параметры, включая цвет фона и цвет рамки. Если команда с именем mynewtcbox уже существует, будет выдана ошибка.

\RenewTCBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}

Работает аналогично \NewTCBox, но основан на \RenewDocumentCommand вместо \NewDocumentCommand. Существующая команда переопределяется.

Пример использования:

\RenewTCBox[auto numbered]{mytcbox}{m}{colback=red!10!white, colframe=red!75!black}

В этом примере существующая команда mytcbox переопределяется с новыми параметрами.

\ProvideTCBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}

Работает аналогично \NewTCBox, но основан на \ProvideDocumentCommand вместо \NewDocumentCommand. Команда \⟨name⟩ создается только в том случае, если она еще не определена.

Пример использования:

\ProvideTCBox[auto numbered]{mytcbox}{m}{colback=green!10!white, colframe=green!75!black}

В этом примере команда mytcbox будет создана только если она еще не существует.

\DeclareTCBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}

Работает аналогично \NewTCBox, но основан на \DeclareDocumentCommand вместо \NewDocumentCommand. Новая команда всегда создается, независимо от того, существует ли уже команда с тем же именем.

Пример использования:

\DeclareTCBox[auto numbered]{mytcbox}{m}{colback=blue!10!white, colframe=blue!75!black}

В этом примере команда mytcbox будет создана, даже если она уже существует, что может привести к ошибке.

\NewTotalTCBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}{⟨content⟩}

Создает новую команду \⟨name⟩ на основе \tcbox. В отличие от \NewTCBox, также указывается ⟨content⟩ для tcbox. В принципе, \NewTotalTCBox работает как \NewDocumentCommand. Это означает, что новая команда \⟨name⟩ создается с заданным аргументом LATEX3 ⟨specification⟩. Если \⟨name⟩ уже было определено, будет выдана ошибка. Параметры ⟨options⟩ передаются основной \tcbox, которая заполняется указанным ⟨content⟩. Обратите внимание, что /tcb/savedelimiter автоматически устанавливается на заданное \⟨name⟩. Параметры ⟨init options⟩ позволяют настроить автоматическую нумерацию.

Пример использования:

\NewTotalTCBox[auto numbered]{mytotaltcbox}{m}{colback=yellow!10!white, colframe=yellow!75!black}{Это содержимое новой команды.}

В этом примере создается новая команда mytotaltcbox, которая принимает спецификацию и параметры, включая цвет фона и цвет рамки, а также содержимое коробки. Если команда с именем mytotaltcbox уже существует, будет выдана ошибка.

\NewTotalTCBox{\myverb}{ O{red} v !O{} }
{ fontupper=\ttfamily,nobeforeafter,tcbox raise base,arc=0pt,outer arc=0pt,
top=0pt,bottom=0pt,left=0mm,right=0mm,
leftrule=0pt,rightrule=0pt,toprule=0.3mm,bottomrule=0.3mm,boxsep=0.5mm,
colback=#1!10!white,colframe=#1!50!black,#3}{#2}

To set a word \textbf{bold} in \myverb{\LaTeX}, use
\myverb[green]{\textbf{bold}}. Alternatively, write
\myverb[yellow]{{\bfseries bold}}.
In \myverb[blue]{\LaTeX}[enhanced,fuzzy halo], other font settings are
done in the same way, e.\,g. \myverb{\textit}, \myverb{\itshape}\\
or \myverb[brown]{\texttt}, \myverb[brown]{\ttfamily}.

% \usepackage{listings} or \tcbuselibrary{listings}
\NewTotalTCBox{\commandbox}{ s v }
{verbatim,colupper=white,colback=black!75!white,colframe=black}
{\IfBooleanT{#1}{\textcolor{red}{\ttfamily\bfseries > }}%
\lstinline[language=command.com,keywordstyle=\color{blue!35!white}\bfseries]^#2^}

\commandbox*{cd "My Documents"} changes to directory \commandbox{My Documents}.

\commandbox*{dir /A} lists the directory content.

\commandbox*{copy example.txt d:\target} copies \commandbox{example.txt} to 
   \commandbox{d:\target}.

\RenewTotalTCBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}{⟨content⟩}

Работает аналогично \NewTotalTCBox, но основан на \RenewDocumentCommand вместо \NewDocumentCommand. Существующая команда переопределяется.

Пример использования:

\RenewTotalTCBox[auto numbered]{mytotaltcbox}{m}{colback=purple!10!white, colframe=purple!75!black}{Обновленное содержимое команды.}

В этом примере существующая команда mytotaltcbox переопределяется с новыми параметрами и содержимым.

\ProvideTotalTCBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}{⟨content⟩}
Работает аналогично \NewTotalTCBox, но основан на \ProvideDocumentCommand вместо \NewDocumentCommand. Команда \⟨name⟩ создается только в том случае, если она еще не определена.

Пример использования:

\ProvideTotalTCBox[auto numbered]{mytotaltcbox}{m}{colback=teal!10!white, colframe=teal!75!black}{Предоставленное содержимое команды.}

В этом примере команда mytotaltcbox будет создана только если она еще не существует.

\DeclareTotalTCBox[⟨init options⟩]{\⟨name⟩}{⟨specification⟩}{⟨options⟩}{⟨content⟩}
Работает аналогично \NewTotalTCBox, но основан на \DeclareDocumentCommand вместо \NewDocumentCommand. Новая команда всегда создается, независимо от того, существует ли уже команда с тем же именем.

Пример использования:

\DeclareTotalTCBox[auto numbered]{mytotaltcbox}{m}{colback=cyan!10!white, colframe=cyan!75!black}{Объявленное содержимое команды.}

В этом примере команда mytotaltcbox будет создана, даже если она уже существует, что может привести к ошибке.

Переопределение других сред (обертывание с помощью tcolorbox)

\tcolorboxenvironment{⟨name⟩}{⟨options⟩}

Существующая среда ⟨name⟩ переопределяется, чтобы быть обернутой внутри tcolorbox с заданными ⟨options⟩.

% tcbuselibrary{skins}
\newenvironment{myitemize}{%
\begin{itemize}}{\end{itemize}}
\tcolorboxenvironment{myitemize}{blanker,
before skip=6pt,after skip=6pt,
borderline west={3mm}{0pt}{red}}

Some text.
\begin{myitemize}
\item Alpha
\item Beta
\item Gamma
\end{myitemize}
More text.

1.1 - Ключи к командам tcolorbox

Ключи для TCB

Основные ключи оформления заголовка (/tcb/boxtitle/)

Ключи документации (/tcb/doclang/)

Ключи внешнего контента (/tcb/external/)

Библиотеки (/tcb/library/)

Ключи постеров (/tcb/poster/)

Ключи виньетирования (/tcb/vig/)

Интеграция с TikZ (/tikz/)

Особенности:

1. Группы ключей организованы по функциональности (заголовки, документация, внешний контент и т.д.)
2. Виньетки (/tcb/vig/) предоставляют сложные эффекты затемнения/осветления углов
3. Постеры (/tcb/poster/) позволяют создавать сложные сеточные компоновки
4. Интеграция с TikZ дает полный контроль над графическими элементами

Каждая группа ключей решает специфические задачи, от базового позиционирования до сложных эффектов оформления.

1.2 - Команды для Title

\tcbset{colback=White,arc=0mm,width=(\linewidth-4pt)/4,
equal height group=AT,before=,after=\hfill,fonttitle=\bfseries}
The following titles are not adjusted:\\
\foreach \n in {xxx,ggg,AAA,\"Agypten}
{\begin{tcolorbox}[title=\n,colframe=red!75!black]

Some content.\end{tcolorbox}}
Now, we try again with adjusted titles:\\
\foreach \n in {xxx,ggg,AAA,\"Agypten}
{\begin{tcolorbox}[adjusted title=\n,colframe=blue!75!black]
Some content.\end{tcolorbox}}

1.3 - Команды для SubTitle

Таблица команд для управления Subtitle в пакете tcolorbox

Примеры использования

1. Базовый подзаголовок

\begin{tcolorbox}[title=Основной заголовок, colback=blue!5!white, colframe=blue!75!black]
   Основное содержимое.
   \tcbsubtitle{Первый подзаголовок}
   Текст под первым подзаголовком.
   \tcbsubtitle{Второй подзаголовок}
   Текст под вторым подзаголовком.
\end{tcolorbox}

2. Настройка стиля подзаголовков

\begin{tcolorbox}[
   title=Пример с subtitle style,
   colback=green!5!white,
   colframe=green!75!black,
   subtitle style={
      colback=yellow!20!white,
      colframe=red!50!black,
      fontupper=\bfseries,
      boxrule=1pt
   }
]
   Основной текст.
   \tcbsubtitle{Настроенный подзаголовок}
   Текст с кастомным оформлением.
\end{tcolorbox}

3. Локальная переопределение через ⟨options⟩

\begin{tcolorbox}[title=Локальные настройки, colback=purple!5!white]
   \tcbsubtitle[colback=orange!30!white, before skip=10pt]{Особый подзаголовок}
   Текст с увеличенным отступом сверху и оранжевым фоном.
\end{tcolorbox}

1.4 - Команды для Part

Таблица команд для управления частями (Upper/Lower Part) в пакете tcolorbox

Примеры использования

1. Управление видимостью частей

\begin{tcolorbox}[upperbox=invisible, colback=white]
  Этот текст не виден (верхняя часть скрыта).
\end{tcolorbox}

\begin{tcolorbox}[lowerbox=invisible, colback=white]
  Виден только верх.
  \tcblower
  Нижняя часть скрыта.
\end{tcolorbox}

Результат:

• Первый бокс: пустое пространство (верх скрыт).
• Второй бокс: отображается только текст до \tcblower.

2. Сокращенные команды visible/invisible

\begin{tcolorbox}[invisible, title=Скрытый бокс]
  Весь контент (включая заголовок) не виден.
  \tcblower
  Нижняя часть тоже скрыта.
\end{tcolorbox}

Результат: Пустое место (все части скрыты).

3. Сохранение контента в файл

\begin{tcolorbox}[saveto=mybox.tex, title=Сохраненный бокс]
  Верхняя часть.
  \tcblower
  Нижняя часть.
\end{tcolorbox}

Загружаем сохраненное: 
\input{mybox.tex}

Результат:

• В документе отображается оригинальный бокс.
• Содержимое сохранено в mybox.tex и может быть повторно загружено через \input.

4. Работа с нижней частью

\begin{tcolorbox}[savelowerto=lower.tex]
  Верхняя часть (отображается).
  \tcblower
  Нижняя часть (сохраняется в файл).
\end{tcolorbox}

Результат:

• В документе видна только верхняя часть.
• Нижняя часть сохранена в lower.tex.

Важные нюансы:

1. Разделение частей:

   • Верхняя часть обязательна, нижняя — опциональна (активируется \tcblower).
   • Без \tcblower весь контент считается верхней частью.

2. Совместимость:

   • saveto нельзя использовать с savelowerto или redirectlowerto.

3. Применение:

   • invisible полезен для скрытия контента (например, при сохранении в файл без отображения).
   • savelowerto удобен для извлечения доп. материалов (решений задач, примечаний).

1.5 - Команды для Lower Part

Таблица команд для управления нижней частью (Lower Part) в пакете tcolorbox

Примеры использования

1. Управление видимостью нижней части

\begin{tcolorbox}[lowerbox=invisible, colback=white]
  Верхняя часть (видна).
  \tcblower
  Нижняя часть (скрыта, но место остаётся).
\end{tcolorbox}

\begin{tcolorbox}[lowerbox=ignored, colback=white]
  Верхняя часть (видна).
  \tcblower
  Нижняя часть (полностью игнорируется).
\end{tcolorbox}

Результат:

• Первый бокс: нижняя часть скрыта, но занимает место.
• Второй бокс: нижняя часть отсутствует.

2. Сохранение нижней части в файл

\begin{tcolorbox}[savelowerto=lower_content.tex, lowerbox=invisible]
  Верхняя часть.
  \tcblower
  Нижняя часть (сохранена в файл).
\end{tcolorbox}

Загружаем сохранённое: 
\input{lower_content.tex}

Результат:

• В документе отображается только верхняя часть.
• Нижняя часть сохранена в lower_content.tex и может быть загружена через \input.

3. Перенаправление нижней части без отображения

\setcounter{enumi}{1}
Значение счётчика: \theenumi

\begin{tcolorbox}[redirectlowerto=counter_example.tex]
  Верхняя часть.
  \tcblower
  Нижняя часть. \stepcounter{enumi} Новое значение: \theenumi.
\end{tcolorbox}

Загружаем: 
\input{counter_example.tex}

Результат:

• В документе: отображается только верхняя часть, счётчик не изменён.
• В файле counter_example.tex: сохранён текст нижней части с обновлённым счётчиком.

4. Визуальное разделение частей

\begin{tcolorbox}[title=Разделённые части, lower separated=true]
  Верхняя часть.
  \tcblower
  Нижняя часть (визуально отделена).
\end{tcolorbox}

\begin{tcolorbox}[title=Неразделённые части, lower separated=false]
  Верхняя часть.
  \tcblower
  Нижняя часть (без разделения).
\end{tcolorbox}

Результат:

• Первый бокс: части разделены линией (зависит от стиля).
• Второй бокс: части сливаются.

5. Создание пользовательского окружения с сохранением

\newtcolorbox{mybox}[1]{%
  savelowerto=#1, lowerbox=ignored,
  colback=blue!5!white, colframe=blue!75!black,
  title=Мой бокс
}

\begin{mybox}{saved_part.tex}
  Верхняя часть.
  \tcblower
  Сохранённая нижняя часть.
\end{mybox}

Используем сохранённое: 
\input{saved_part.tex}

Результат:

• В документе: только верхняя часть с заголовком “Мой бокс”.
• В файле saved_part.tex: сохранена нижняя часть.

Ключевые особенности:

1. Гибкость:

   • lowerbox=ignored полностью исключает нижнюю часть из обработки, что полезно для оптимизации.
   • redirectlowerto позволяет сохранять контент без побочных эффектов (например, изменения счётчиков).

2. Совместимость:

   • savelowerto и redirectlowerto нельзя использовать вместе с saveto.

3. Дизайн:

   • Разделение частей (lower separated) можно настроить для разных стилей (например, beamer или raster).

1.6 - Команды для Color и Font

Таблица управления цветами и шрифтами в tcolorbox

Основные параметры цвета

Управление отображением заголовка

Параметры шрифтов

Примеры использования

1. Настройка цветов

\begin{tcolorbox}[colframe=red, colback=yellow!10, colbacktitle=blue!20, coltitle=white, title=Цветной бокс]
  Это пример цветного tcolorbox.
  \tcblower
  Нижняя часть с другим цветом текста.
\end{tcolorbox}

2. Управление шрифтами

\begin{tcolorbox}[fonttitle=\sffamily\bfseries\large, fontupper=\itshape, fontlower=\bfseries, title=Шрифты]
  Верхняя часть курсивом.
  \tcblower
  Нижняя часть жирным.
\end{tcolorbox}

3. Комбинированный пример

\begin{tcolorbox}[
  colframe=green!50!black,
  colback=green!10,
  colbacktitle=green!40,
  coltitle=white,
  fonttitle=\bfseries,
  title filled=true,
  title=Комбинированный пример,
  fontupper=\small,
  collower=red
]
  Верхняя часть мелким шрифтом.
  \tcblower
  Нижняя часть красным цветом.
\end{tcolorbox}

Особенности:

1. Все цветовые параметры поддерживают стандартные цветовые модели LaTeX (например, red!50!white).
2. Для шрифтов можно использовать любые стандартные команды изменения шрифта (\bfseries, \itshape и т.д.).
3. Параметр title filled автоматически активируется при установке colbacktitle или других связанных с заголовком параметров.
4. coltext удобен для установки единого цвета текста во всем боксе, тогда как colupper и collower позволяют дифференцировать части.

1.7 - Команды для выравнивания текста

Таблица управления выравниванием текста в tcolorbox

Горизонтальное выравнивание

Вертикальное выравнивание

Сокращённые команды

Примеры использования

1. Горизонтальное выравнивание

\begin{tcolorbox}[halign=flush left, title=Пример выравнивания]
  Текст, выровненный по левому краю.
  \tcblower
  Нижняя часть с выравниванием по правому краю.
\end{tcolorbox}

2. Вертикальное выравнивание

\begin{tcolorbox}[valign=center, height=4cm]
  Текст, выровненный по центру по вертикали.
\end{tcolorbox}

3. Выравнивание заголовка

\begin{tcolorbox}[halign title=center, title=Центрированный заголовок]
  Содержимое бокса.
\end{tcolorbox}

Особенности:

1. Разница между flush и не-flush версиями:

   • flush версии используют стандартные LaTeX-команды (\raggedright, \centering, \raggedleft)
   • Не-flush версии реализованы через TikZ и могут давать более сбалансированное расположение с переносами

2. Вертикальное выравнивание имеет смысл только при явно заданной высоте бокса

3. Параметры scale и scale* масштабируют текст по вертикали, что может быть полезно для точного заполнения пространства

1.8 - Команды для управления размерами и отступами в боксах

Управление геометрией в tcolorbox

4.7.1 Ширина (Width)

4.7.2 Границы (Rules)

4.7.3 Скругления (Arcs)

4.7.4 Отступы (Spacing)

4.7.5 Размеры (Size Shortcuts)

4.7.6 Переключение сторон (Toggle Left and Right)

Примеры использования

Настройка ширины

\begin{tcolorbox}[width=0.5\linewidth, text width=4cm]
  Бокс с ограниченной шириной текста
\end{tcolorbox}

Границы и скругления

\begin{tcolorbox}[
  boxrule=2mm,
  arc=5mm,
  arc is angular,
  toprule=3mm,
  bottomrule=1mm
]
  Бокс с нестандартными границами
\end{tcolorbox}

Отступы

\begin{tcolorbox}[
  boxsep=2mm,
  left=1cm,
  right*=0mm,
  toptitle=5mm
]
  Бокс с кастомными отступами
\end{tcolorbox}

Размеры

\begin{tcolorbox}[size=small, oversize]
  Компактный бокс, расширенный за поля
\end{tcolorbox}

Переключение сторон

\begin{tcolorbox}[
  toggle left and right=evenpage,
  leftrule=1cm,
  rightrule=1mm
]
  Бокс с переключением границ на четных страницах
\end{tcolorbox}

1.9 - Команды для управления параметрами углов в боксах

Управление углами (Corners) в tcolorbox

Основные команды для работы с углами

Особенности работы с углами:

1. По умолчанию все углы скруглены (rounded corners=all)
2. sharpish corners - это компромиссный вариант, когда углы выглядят острыми, но технически остаются скругленными (влияет на тени и границы)
3. Можно комбинировать разные типы углов в одном боксе

Примеры использования

1. Острые углы

\begin{tcolorbox}[
  colback=white,
  colframe=blue,
  sharp corners=northwest,  % только северо-западный угол острый
  title=Бокс с острым углом
]
Содержимое бокса
\end{tcolorbox}

2. Полностью острый бокс

\begin{tcolorbox}[
  colback=white,
  colframe=red,
  sharp corners,  % все углы острые
  title=Полностью острый бокс
]
Содержимое бокса
\end{tcolorbox}

3. Комбинирование углов

\begin{tcolorbox}[
  colback=white,
  colframe=green,
  sharp corners=north,  % верхние углы острые
  rounded corners=south,  % нижние углы скругленные
  title=Комбинированный бокс
]
Содержимое бокса
\end{tcolorbox}

4. Sharpish corners

\begin{tcolorbox}[
  colback=white,
  colframe=purple,
  sharpish corners,  # углы выглядят острыми
  title=Бокс с sharpish corners
]
Содержимое бокса
\end{tcolorbox}

Визуальные различия:

1. Обычные скругленные углы (rounded corners):

   • Плавные изгибы
   • Тени и границы полностью повторяют форму

2. Sharpish corners:

   • Углы выглядят почти острыми
   • Тени и границы слегка скруглены

3. Полностью острые углы (sharp corners):

   • Четкие прямые углы
   • Тени и границы имеют острые края

Советы по использованию:

1. Для большинства случаев достаточно sharp corners или rounded corners
2. Используйте sharpish corners, если нужен компромисс между внешним видом и поведением теней
3. Можно точечно менять отдельные углы для создания уникальных дизайнов
4. Настройки углов влияют на:
   • Основную рамку бокса
   • Границы (borderline)
   • Тени (shadow)

1.10 - Команды для управления прозрачностью в боксах

Таблица управления прозрачностью в tcolorbox

Основные параметры прозрачности

Примеры использования

1. Полупрозрачная рамка и фон

\begin{tcolorbox}[
  colframe=blue,
  colback=white,
  opacityframe=0.3,
  opacityback=0.7,
  title=Пример прозрачности
]
Этот бокс имеет полупрозрачную рамку и фон
\end{tcolorbox}

2. Прозрачный заголовок

\begin{tcolorbox}[
  colframe=red,
  colbacktitle=yellow,
  opacitybacktitle=0.5,
  opacitytitle=0.8,
  title=Прозрачный заголовок
]
Текст содержимого
\end{tcolorbox}