Документация

Диаграммы TikZ

TikZ – язык рисования LaTeX, принятый в академической среде для точных диаграмм: геометрические построения, коммутативные диаграммы, графы, схемы, графики. Блок TikZ содержит исходник LaTeX; LibreTimes компилирует его в SVG при сохранении публикации и показывает читателям изображение.

:::tikz
\begin{tikzpicture}
  \draw[->] (-2,0) -- (2,0) node[right] {$x$};
  \draw[->] (0,-2) -- (0,2) node[above] {$y$};
  \draw (0,0) circle (1cm);
  \draw (0,0) -- (45:1cm) node[midway, above left] {$r$};
\end{tikzpicture}
:::

Как это работает

  • Тело – стандартный LaTeX tikzpicture. Математика в подписях узлов работает как обычно ({$x$}).
  • Компиляция происходит на сервере при сохранении, в песочнице. Читатели получают статический SVG – в браузере ничего не компилируется, и страница не зависит от внешних сервисов.
  • Пока диаграмма не отрендерена (или её компиляция не удалась), блок показывает заглушку "Diagram not rendered" вместо исходника. В предпросмотре редактора ошибки компиляции видно, и их можно чинить.
  • Неудавшаяся диаграмма никогда не блокирует публикацию текста вокруг неё.

Подписи и идентификаторы

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

::::figure{#unit-circle}
:::tikz
\begin{tikzpicture} \draw (0,0) circle (1cm); \end{tikzpicture}
:::
 
Единичная окружность.
::::

Границы

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