Введение

Общие настройки

• chemmacros дает возможность выводить длинные названия веществ с адекватными переносами, и форматировать всяческие экспериментальные данные (спектры, температуры плавления)
• mhchem форматирует простые (строчные) формулы и реакции
• chemscheme добавляет плавающее окружение для схем реакций со своим названием и нумерацией
• chemnum нумерация соединений

\usepackage{chemmacros}\usepackage[version=4]{mhchem}\mhchemoptions{layout=stacked}\chemsetup{formula = mhchem}\chemsetup{modules=all}\usepackage{chemscheme}\renewcommand{\schemename}{Схема}\usepackage{chemnum}\setchemnum{format=\bfseries}

• placeins вместе с модификатором h! из пакета float не позволяет плавающим рисункам уплывать куда-нибудь не туда
• todonotes позволяет оставлять заметки на полях и в тексте
• threeparttable добавляет возможность делать сноски к таблицам
• makecell переносы в таблицах (очень удивился, когда узнал, что для этого требуется отдельный пакет)

Организация файлов

. appendix  img include sections     conclusion      img     experimental      img     introduction      img     literature      ChemDraw      img     results         ChemDraw         img

\documentclass[12pt, a4paper, final]{extarticle}\input{include/preamble.tex}\input{include/siunitx.tex}\input{include/acronyms.tex}\begin{document}\includepdf{include/titul_bac.pdf}\include{include/toc}\include{include/loa}\include{sections/introduction/introduction}\include{sections/literature/literature}\include{sections/results/results}\include{sections/experimental/experimental}\include{sections/conclusion/conclusion}\include{include/bibliography}\include{appendix/appendix}\end{document}

Картинки

\renewcommand{\thesubfigure}{\asbuk{subfigure})}

\begin{figure}    \centering    \subfigure[Подпись к рисунку 1]    {    \includegraphics[width = 0.45\textwidth]{рисунок1}    }    \subfigure[Подпись к рисунку 2]    {    \includegraphics[width = 0.45\textwidth]{рисунок2}    }    \caption{Подпись ко всему рисунку}\end{figure}

Таблицы

Цитаты

Jakob F., Herdtweck E., Bach T. Synthesis and Properties of Chiral Pyrazolidines Derived from (+)Pulegone // Chemistry A European Journal. 2010. Июль. Т. 16, No 25. С. 75377546.

Jakob F., Herdtweck E., Bach T. Synthesis and Properties of Chiral Pyrazolidines Derived from (+)Pulegone // Chemistry A European Journal. 2010. Т. 16, No 25. С. 7537 7546.

\AtEveryBibitem{\clearfield{month}}\AtEveryCitekey{\clearfield{month}}

\DefineBibliographyExtras{russian}{\renewcommand{\bibrangedash}{\,--\,}}\DefineBibliographyExtras{english}{\renewcommand{\bibrangedash}{\,--\,}}\DefineBibliographyStrings{english}{number = {}, jourvol = {V. }}

\renewcommand{\multicitedelim}{, }

Непосредственно химия

Формулы

Простые формулы

(\ce{Mg(ClO4)2}, \ce{Mg(NTf2)2}, \ce{TiCl4}, \ce{SnCl4}, \ce{Yb(OTf)3})

превращется в

Нумерация соединений

Например (doi:10.1021/cm052861i)

2-(1-(3,5-bis((perfluorophenyl)methoxy)benzoyl)-3-cyano-4-((E)-2-(5-((E)-4-(dibutylamino)styryl)thiophen-2-yl)vinyl)-5-oxo-1,5-dihydro-2H-pyrrol-2-ylidene)malononitrile

Как это выглядит

В документе:

И в коде:

\begin{overpic}{sections/literature/img/azomethine_generation.eps}        \put(6, 44){\textbf{\cmpd{hydrazone}}}        \put(56, 44){\textbf{\cmpd{enhydrazine}}}        \put(6, 29){\textbf{\cmpd{carbene}}}        \put(62, 29){\textbf{\cmpd{silyl}}}        \put(6, 15){\textbf{\cmpd{oxidation}}}        \put(49, 16){\textbf{\cmpd{diazo}}}        \put(65, 16){\textbf{\cmpd{azo}}}        \put(22, 0){\textbf{\cmpd{metathezis}}}    \end{overpic}

Экспериментальные данные

Например

\data*{Т\textsubscript*{пл.}} 147--\SI{150}{\celsius}.

будет выведено как:

Приложения

    \pagenumbering{gobble}    \titleformat*{\section}{\raggedleft\large\bfseries}

    \addtocontents{toc}{\protect\setcounter{tocdepth}{0}}

    \makeatletter    \renewcommand{\thesection}{\@arabic\c@section}    \makeatother

    \begin{figure}[h!]        \rotatebox{90}{            \begin{minipage}{0.82\textheight}                \includegraphics[width=\linewidth]{appendix/img/1.pdf}                \caption{Спектр 1}            \end{minipage}        }    \end{figure}

Список сокращений

Пример

\DeclareAcronym{bz}{    short={Bz},    long={Бензоил},    first-style=short}

при упоминании в тексте как

\ac{bz}

будет выведено в виде Bz а в списке сокращений будет приведено с расшифровкой.

Часть списка сокращений выглядит так:

Презентация

Вместо заключения

1. Серия статей Каталог классов и стилей LaTeX за авторством Евгения Балдина, в особенности, пятая часть
2. Раздел chemistry на CTAN
3. Документация упомянутых в статье пакетов

Некоторое время назад у меня возникла потребность писать несложные тексты, которые включали в себя математические рассуждения, формулы и вычисления. С помощью примеров и гайдов из интернета я смог освоить самые основы TeX и выполнять поставленные задачи. Но меня не покидала мысль о том, что я стреляю из пушки по воробьям, поэтому я очень обрадовался, когда один знакомый показал мне редактор Mathcha, который включал в себя возможности Word и TeX одновременно. Я считаю, что этот сервис слишком недооценён, и многим он понравится, поэтому я делаю обзор на него.

Дисклеймер: данный обзор основан на опыте работы автора с инструментом и не является рекламой сервиса Mathcha.io

С чем же мы имеем дело

Mathcha.io онлайн WYSIWYG (What You See Is What You Get) редактор текста, который имеет поддержку встроенных в текст формул, блоков формул, картинок, кода с подсветкой, а также некоторых других фич, про которые речь в этой статье не пойдёт (checkbox, вставка видео с Youtube, создание диаграмм и рисунков).

Работа с программой

Текст

Интерфейс программы напоминает Word, что помогает быстро сориентироваться. Сверху есть разные инструменты форматирования: центровка текста, жирный/подчёркнутый/курсив, ссылки, копирование стиля, списки, шрифт (всего 5 штук), размер и цвет текста. Всё это помогает работать с обычным текстом в один клик (в том числе благодаря общепринятым ctrl+b и подобным).

Математика

Вот ради чего это всё затевалось. Есть 2 способа подключения формул: inline-math и math-container (первый можно встраивать в строки текста, а второй только как отдельный блок, что является логичным для математических выкладок).

Лайфхак: можно создать inline-math на текущей позиции курсора, напечатав $. Я не нашёл в настройках способа отключить это (возможно он есть). Но по умолчанию вместо обычного значка доллара приходится писать \$ + Enter, что очень неудобно в финансовых документах. В обычном TeX такая проблема тоже есть, так как $ обозначает начало формулы.

Синтаксис из TeX символы

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

Большинство символов можно найти в выпадающем списке по названию:

Также очень удобная фича, когда не можешь описать символ словами поиск по рисунку:

А также есть автозамена "программистских" значков на математические, например, <= (меньше или равно) заменяется на цельный символ.

Математические конструкции

Другая важная часть математических формул конструкции: дроби, корни, кванторы. Всё это есть в Mathcha, в том же списке по обратному слешу. По первым символам названия можно посмотреть варианты конструкций и места, где могут находиться параметры конструкции.

Поиск по рисунку также работает

Так ли это удобно?

Но именно тут возникает главное упущение разработчиков mathcha, которое сильно затрудняет работу: после каждого специального символа необходимо нажимать Enter. Даже если вы полностью напечатали название. Да, предпросмотр дроби хорошо выглядит, а также он очень полезен, когда числитель и знаменатель сложные, но, например, напечатать \frac{3}{5} часто быстрее, чем \frac <Enter> 3 <стрелочка вниз> 5 <стрелочка вправо>.

В любом месте документа (в том числе в математических блоках) можно сделать импорт из TeX, но для этого необходимо напечатать \from-latex <Enter>, потом написать формулу как в TeX (в этом окне также есть предпросмотр), а потом мышкой нажать на OK. Это может занять ещё больше времени, чем первый вариант.

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

Вставка картинок

Вставить картинку в документ можно из буфера обмена, с устройства или по url. Также 50 мегабайт ваших картинок хранятся в привязке к аккаунту. Можно делать подпись к картинкам или открывать их на полный экран.

Код

Присутствует поддержка блоков кода с подсветкой и другим оформлением.

Связь с внешним миром

Экспорт в PDF

Единственный способ экспортировать документ в PDF нажать кнопку "Печать" (ctrl+P) и далее выбрать "Печать в PDF" (в зависимости от ОС). Можно выбрать поля и формат страницы, а также колонтитулы.

Экспорт в TeX

Есть возможность экспорта выделенной области как тело документа TeX, но полная совместимость не гарантируется.

Поделиться документом

Можно поделиться документом по прямой ссылке на сайт mathcha.io в формате read-only. Также недавно появилась возможность добавить коллабораторов в документ, но я не пробовал, насколько хорошо работает синхронизация при такой совместной работе.

Десктопная версия

Существует платная (3$ в месяц) офлайн версия, которая имеет некоторые преимущества по сравнению с онлайн версией. Она имеет поддержку экспорта в формат .mathcha, а также снимаются некоторые лимиты. Без лицензии программа находится в режиме read-only, то есть вы всё ещё можете экспортировать файл из онлайн редактора в .mathcha, а после открыть его на чтение в десктопной версии (онлайн версия открывать .mathcha файлы не умеет). Также плюсом офлайн формата является приватность, то есть ваши документы не хранятся где-то в интернете

Выводы

Mathcha самостоятельный инструмент, который использует TeX, а также другие виды контента. Я бы не рекомендовал использовать её людям, которые имеют обширный опыт при работе с обычными TeX документами (так как при большой скорости печати подсказки начинают мешать). Также не стоит рассматривать Mathcha как полную замену TeX-у, так как её возможности сильно ограничены (например, отсутствием внешних пакетов). При работе в ней вы будете "заперты", то есть вынести текущие наработки за пределы редактора не всегда просто. У меня никогда не пропадали документы из хранилища mathcha, но я не могу быть полностью уверен в его надёжности.

Я рекомендую использовать Mathcha как альтернативу редакторам TeX для создания несложных документов. Я пользовался им во многих ситуациях, и ни разу не испытывал больших сложностей.

Облачные серверы от Маклауд быстрые и безопасные.

Зарегистрируйтесь по ссылке выше или кликнув на баннер и получите 10% скидку на первый месяц аренды сервера любой конфигурации!

О Jupyter

О dotnet/interactive

Об AngouriMath

Встраиваем латех

let magic() =    let register (value : ILatexiseable) = $@"            <script src='https://polyfill.io/v3/polyfill.min.js?features=es6'></script>            <script id='MathJax-script' async src='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js'></script>            \[{value.Latexise()}\]            "    Formatter.Register<ILatexiseable>(register, "text/html")

Дальнейшие планы

Ссылки

Глава 1. Введение

\clubpenalty=400   % Эти числа -- разрешение на запрет висячих строчек. Подразумеваемость = 300, абсолютный запрет = 10000.\widowpenalty=400  %% Увеличиваем эти числа до тех пор, пока не начнет увеличиваться количество страниц.\righthyphenmin=2 % сколько букв можно переносить. Если используется Babel, то команда немного другая.\tolerance=500   %max=10000, default=200 (выбор между разрежением и переполнением).% лучше разрядить, чем переполнить!\looseness=-1 % иногда можно удлинять страницу на одну строку.\hfuzz=2.5pt % иногда можно вылезти за край строки на 2.5 pt.

Глава 2. Свои стандарты

\special{papersize=170mm,240mm}\textheight 187mm % 200-(12+25)*0.35146 = 186.99598\textwidth 130mm\headheight13.6pt % = 0.48 mm\oddsidemargin -5.4mm\evensidemargin -5.4mm\topmargin -5.4mm\usepackage{setspace}\singlespacing

\singlespacing

\topmargin -5.4mm

\voffset=0 \headheight12pt \headsep25pt % 1 pt = 0.3528 мм

\headheight13.6pt

\documentclass[aip,cp,amsmath,amssymb,reprint]{revtex4-2}

Глава 3. Свои обозначения

\begin{split}--\end{split}, \begin{align}--\end{align}

\newcommand*{\BE}{\begin{equation}} %\newcommand*{\EN}{\end{equation}} %\newcommand*{\BEA}{\begin{subequations} \begin{eqnarray}} %\newcommand*{\ENA}{\end{eqnarray} \end{subequations}} 

\begin{equation}

\newcommand*{\hs}{\hspace*{\parindent}}

\newcommand*{\nn}{\nonumber}

\newcommand*{\ea}{{\it et al\/}\xspace}

\newcommand*{\1}{$_1$}\newcommand*{\2}{$_2$}\newcommand*{\3}{$_3$}\newcommand*{\4}{$_4$}\newcommand*{\5}{$_5$}\newcommand*{\6}{$_6$}\newcommand*{\7}{$_7$}\newcommand*{\8}{$_8$}\newcommand*{\9}{$_9$}

\newcommand*{\T}[1]{\text{#1}}

\newcommand*{\ic}{cm $^{-1}$\xspace}

\newcommand*{\po}[1]{$\times \! $10$^{#1}$} % *10(-n)\newcommand*{\vp}[2]{#1$ \times \! $10$^{#2}$\xspace} % v*10(n)\newcommand*{\ve}[2]{#1$\pm$#2\xspace} % v+-e\newcommand*{\vep}[3]{$(#1 \pm #2)\times \! 10^{#3}$\xspace} % (v+-e)*10^n

\newcommand*{\EpsWrapD}[7]{%\begin{wrapfigure}[#5]{#3}{#2 \textwidth} % #3=l,r,L,R\begin{center} \sffamily\includegraphics*[width= #2 \textwidth ]{#1} % 1-имя файла и метка заодно,% 2-ширина рисунка (доля от ширины страницы)\vspace{-#7mm} % #7: сократить расстояние между подписью снизу и рисунком\caption{\label{fig:#1}#4} % #4 - подпись под рисунком\vspace{-#6pt}\end{center}% #6: сократить расстояние между подписью снизу и текстом после таблицы \end{wrapfigure}}

\newcommand*{\TableBE}[5]{\begin{table}[#1] %\captionabove\vspace*{-#5mm}\centering \sffamily \caption{\label{tab:#2}#3} \begin{tabular}{#4} \toprule }\newcommand*{\TableEN}[3]{\bottomrule \end{tabular}\vspace{-#2mm} \small \begin{flushleft} #1 \end{flushleft}\vspace{-#3mm}\end{table}}

\TableBE{H}{RS_Ham_2pi}{\TableBE{H}{RS_Ham_2pi}{Гамильтониан линейной молекулы в состоянии $^2\Pi $}{G LL}{2} $^2\Pi $ }{G LL}{2}\CR & |^2\Pi_{1/2} JM_J \pm \rangle & |^2\Pi_{3/2} JM_J \pm \rangle \\\midrule|^2\Pi_{1/2} JM_J \pm \rangle & B[J_{\perp}^2+1] -A/2 & -B J_{\perp} \\|^2\Pi_{3/2} JM_J \pm \rangle & -B J_{\perp} & B[J_{\perp}^2-1] +A/2 \\\TableEN{}{0}{0}

\newcommand*{\RisEpsLarge}[7]{\begin{figure}[#5] \begin{center}\includegraphics*[width= #2 \textwidth,#6]{#1} %#6: scale=2, bb=10 20 100 200\vspace{-#3mm}\sansmath\caption{ \label{fig:#1}#4}\vspace{-#7mm}\end{center} \end{figure}}

\newcommand*{\RisEpsPos}[5]{\RisEpsLarge{#1}{#2}{#3}{#5}{#4}{angle=0}{0}}\newcommand*{\RisEps}[4]{\RisEpsLarge{#1}{#2}{#3}{#4}{!tbhp}{angle=0}{0}}\newcommand*{\RisEpsTop}[4]{\RisEpsLarge{#1}{#2}{#3}{#4}{!t}{angle=0}{0}}\newcommand*{\RisEpsBot}[4]{\RisEpsLarge{#1}{#2}{#3}{#4}{!b}{angle=0}{0}}\newcommand*{\RisEpsPlace}[5]{\RisEpsLarge{#1}{#2}{#3}{#5}{#4}{angle=0}{0}}\newcommand*{\RisEpsRot}[4]{\RisEpsLarge{#1}{#2}{#3}{#4}{tbhp}{angle=90}{0}}\newcommand*{\RisEpsRotTop}[4]{\RisEpsLarge{#1}{#2}{#3}{#4}{!t}{angle=90}{0}}\newcommand*{\RisEpsRotBot}[4]{\RisEpsLarge{#1}{#2}{#3}{#4}{!b}{angle=90}{0}}\newcommand*{\RisEpsRotBotPlace}[5]{\RisEpsLarge{#1}{#2}{#3}{#5}{#4}{angle=90}{0}}\newcommand*{\RisEpsRotClock}[4]{\RisEpsLarge{#1}{#2}{#3}{#4}{tbhp}{angle=-90}{0}}\newcommand*{\RisEpsRotClockTop}[4]{\RisEpsLarge{#1}{#2}{#3}{#4}{!t}{angle=-90}{0}}\newcommand*{\RisEpsRotClockBot}[4]{\RisEpsLarge{#1}{#2}{#3}{#4}{!b}{angle=-90}{0}}\newcommand*{\RisEpsRotClockBotPlace}[5]{\RisEpsLarge{#1}{#2}{#3}{#5}{#4}{angle=-90}{0}}

\WrapTableBE<\source>:<source lang="tex">\newcommand*{\WrapTableBE}[6]{\renewcommand{\baselinestretch}{0.75}\small\normalsize\begin{wraptable}{#1}{#5\textwidth} \sffamily\begin{center} \vspace*{-#6mm}\caption{\label{tab:#2}#3} \begin{tabular}{#4} \toprule }% #1 : l, r #2 : label #3 : caption #4 : cc|cc|rr|ll #5 : 4 #6: 5% вставить в текст таблицу, окончание\newcommand*{\WrapTableEN}[2]{\bottomrule \end{tabular} \end{center} \vspace{-#2pt} \small #1 \end{wraptable}\renewcommand{\baselinestretch}{1}\small\normalsize}

Глава 4. Экспорт текста в разные части книги или в другие книги

\usepackage{newfile} % загрузить пакет newfile\newoutputstream{ZO} % создать поток по имени ZO\openoutputfile{Zadachi.tex}{ZO} % направить поток в файл по имени Zadachi.tex\newcommand*{\PutNumberZO}{\addtostream{ZO}{$\{$\thechapter.\theenumi$\}$}} % в файл Zadachi.tex % добавить номер главы и номер задачи.

\chapter{Задачи и решения}\Epigraf{0.68}{Отплякиваясь от сурых пляк, каждый хамсик шмыряет на глын по 5 гнусиков. Сколько гнусиков шмырнут на глын 12 гнусиков, отплякивающихся от сурых пляк?}{"Задачи по математике"\ , Г.Остер}\bigskip\input{Zadachi}\endinput   После компиляции всех глав идёт команда закрыть поток и начать компилировать  файл \closeoutputstream{ZO}  % закрыть поток ZO\include{Zadachi_Head} % компилировать файл Zadachi_Head.tex 

\newclipboard{myclipboard}

\openclipboard{myclipboard}

\Copy{item_name}

\Paste{item_name}

Глава 5. Работа со ссылками

\bibliography{Bib_File1,Bib_File2,...Bib_FileN}

@article{Levchenko01_7485,year=2001, title={Electronic structure of halogen-substituted methyl radicals: excited states of {CH$_2$Cl and CH$_2$F}}, author={S{ergey} V. Levchenko and A{nna} I. Krylov}, journal=JCP,volume=115,pages=7485,numpages=10, abstract={Electronically excited states in CH2Cl and CH2F radicals are...}}

\bibliographystyle{gost2008}

\bibitem{Levchenko01_7485}\selectlanguageifdefined{english}\BibEmph{Levchenko~S.~V., Krylov~A.~I.} Electronic structure of halogen-substituted methyl radicals: excited states of {CH$_2$Cl and CH$_2$F}~// \BibEmph{J. Chem. Phys.} \BibDash\newblock 2001. \BibDash\newblock Vol. 115. \BibDash\newblock P.~7485.

Глава 6. Минимальный работающий пример

% Файл P_main.tex  % главный в проекте\documentclass[10pt,twoside,openany]{book}\usepackage{etoolbox}   % this package introduces operations: \newbool,...\newbool{For_Internet}\booltrue{For_Internet}    % % Цветная книга для Интерента%\boolfalse{For_Internet}  % или черно-белая для бумаги\newbool{FR} %FR= First Run%\booltrue{FR}  %  --  make  FR = true\boolfalse{FR}  %  --  make  FR = false\input{P_Preamble}       % загрузить преамбулу\includeonly{             % какие главы включаем в книгуP_Ch1,        %%%P_Ch2,        %%%Zadachi_Head  %%%}\begin{document}         % начало документа\tableofcontents         % Оглавление\ifbool{FR}{\newclipboard{myclipboard}}{}                          % какие главы компилируем\include{P_Ch1}          %%%\include{P_Ch2}          %%%\closeoutputstream{ZO}  % закрыть поток в файл Zadachi.tex\ifbool{FR}{}{\openclipboard{myclipboard}}\include{Zadachi_Head} % загрузить Файл с задачами с решениями%\bibliography{P_Bibs}  % создать список литературы, убираем простоты ради\end{document}         % конец документа\endinput              % конец текста, дальше только комментарии%+++++++++++++++++% Файл P_preamble.tex  % преамбула\usepackage[warn]{mathtext} %(до задания inputenc, fontenc, babel)% русские буквы в формулах, с предупреждением%---- основной язык -- русский\usepackage[T2A]{fontenc}\usepackage[cp1251]{inputenc}\usepackage[english,russian]{babel}   % load Babel setup for English                                      % and Russian languages;                                      % the latter is the default.% Поскольку опция russian стоит последней, основным языком документа будет russian.%-- форматирование страницы\textheight 187mm\textwidth 130mm\headheight13.6pt\special{papersize=170mm,240mm}\oddsidemargin -5.4mm\evensidemargin -5.4mm\topmargin -5.4mm%--- стиль заполнения таблицы\clubpenalty=400\widowpenalty=400\tolerance=500  %max=10000, default=200 (выбор между разрежением и переполнением).\looseness=-1 %(можно удлинять страницу на одну строку)\hfuzz=2.5pt % можно вылезти за край строки на 2.5%--- полезные пакеты\usepackage{amssymb,amsmath} % почти стандарт Латеха\usepackage{xspace}\usepackage{enumerate} % списки\usepackage{booktabs}\usepackage[dotinlabels]{titletoc}%-- включение рисунков\usepackage{graphicx}  % Пакет для включения рисунков%\usepackage[dvips]{color} % есть цветные фотографии!\graphicspath{{figs/}} % В этой директории хранятся все рисунки *.eps,\usepackage[usenames,dvipsnames]{xcolor,colortbl}%--- мой цвет для таблиц, и для ссылок на рисунки и формулы\definecolor{lightcyan}{rgb}{0.88,1,1} % обычно: ( 0.88, 1, 1)\ifbool{For_Internet}{\newcolumntype{g}{>{\columncolor{lightcyan}}c}}%{\newcolumntype{g}{>{\columncolor{light-gray}}c}}\newcommand*{\red}[1]{\textcolor[rgb]{1.00,0.00,0.00}{#1}}\newcommand*{\blue}[1]{\textcolor[rgb]{0.00,0.00,1.00}{#1}}\ifbool{For_Internet}%{\renewcommand{\thetable}{\red{{\it\arabic{chapter}.\arabic{table}\,}\normalfont}}}%{\renewcommand{\thetable}{{\it\arabic{chapter}.\arabic{table}\,}\normalfont}}\ifbool{For_Internet}%{\renewcommand{\thefigure}{{\blue{\bfseries{\arabic{chapter}.\arabic{figure}}\normalfont}}}}%{\renewcommand{\thefigure}{{\bfseries{\arabic{chapter}.\arabic{figure}}\normalfont}}}% Чтобы окрасить названия глав в оглавлении \ifbool{For_Internet}{ \titlecontents{chapter}[1.8em] % distance to page margin   {\vspace{3mm} \bfseries\color{blue}} % \sffamily   {\contentslabel[\thecontentslabel. ]{1.5em}} % distance between 1. and Title of chapter   {\hspace*{-2.3em}}{\color{blue}   {\titlerule*[1pc]{}\contentspage}\color{blue}}[\vspace{0.5mm}] }{}\definecolor{light-gray}{gray}{0.95}\ifbool{For_Internet}{\newcommand*{\CR}{\rowcolor{lightcyan}}}%{\newcommand*{\CR}{\rowcolor{light-gray}}}%---- оформление ссылок в виде \label{fig:name} \fref{fig:name}\usepackage[vario]{fancyref} % plain is also possible\renewcommand*{\fancyrefdefaultspacing}{\fancyreftightspacing}\frefformat{vario}{\fancyreffiglabelprefix}{\bfseries{#1}\normalfont }\frefformat{vario}{\fancyreftablabelprefix}{\textit{#1}\normalfont}\frefformat{vario}{\fancyrefenumlabelprefix}{\textrm{#1}\normalfont}% Если это убрать, то пакет fancyref начинает вставлять много отсебятины.%--- мои макросы\newcommand*{\mb}[1]{\mbox{\boldmath$#1$}}  % жирный мат. курсив\newcommand*{\BE}{\begin{equation}}        %\newcommand*{\EN}{\end{equation}}          %\newcommand*{\BEA}{\begin{subequations} \begin{eqnarray}} %\newcommand*{\ENA}{\end{eqnarray} \end{subequations}}   %\newcommand*{\hs}{\hspace*{\parindent}}    %\newcommand*{\nn}{\nonumber}        %\newcommand*{\1}{$_1$}\newcommand*{\2}{$_2$}\newcommand*{\3}{$_3$}\newcommand*{\4}{$_4$}\newcommand*{\5}{$_5$}\newcommand*{\6}{$_6$}\newcommand*{\7}{$_7$}\newcommand*{\8}{$_8$}\newcommand*{\9}{$_9$}%\newcommand*{\T}[1]{\text{#1}}%\newcommand*{\vep}[3]{$(#1 \pm #2) \times \! 10 ^{#3} $\xspace} % (v+-e)*10^n%\newcommand*{\ic}{см$^{-1}$\xspace}                 % inverse centimeters%----  Переопределение математических символов в русских традициях\renewcommand{\le}{\leqslant}\renewcommand{\leq}{\leqslant}\renewcommand{\ge}{\geqslant}\renewcommand{\geq}{\geqslant}%---- вставить простую таблицу\newcommand*{\TableBE}[5]{\begin{table}[#1] %\captionabove\vspace*{-#5mm}\centering \sffamily \caption{\label{tab:#2}#3} \begin{tabular}{#4} \toprule }\newcommand*{\TableEN}[3]{\bottomrule \end{tabular}\vspace{-#2mm}  \small \begin{flushleft}  #1 \end{flushleft}\vspace{-#3mm}\end{table}}%---- вставить в текст таблицу%  начало\newcommand*{\WrapTableBE}[6]{\renewcommand{\baselinestretch}{0.75}\small\normalsize\begin{wraptable}{#1}{#5\textwidth} \sffamily\begin{center} \vspace*{-#6mm}\caption{\label{tab:#2}#3} \begin{tabular}{#4} \toprule }% #1 : l, r   #2 : label   #3 : caption  #4 : cc|cc|rr|ll  #5 : 40mm% вставить в текст таблицу, окончание\newcommand*{\WrapTableEN}[2]{\bottomrule \end{tabular} \end{center} \vspace{-#2pt} \small #1  \end{wraptable}\renewcommand{\baselinestretch}{1}\small\normalsize}%---- вставить рисунок внутрь текста\usepackage{wrapfig} % нужен для RisEpsRight\newcommand*{\EpsWrapD}[7]{%\begin{wrapfigure}[#5]{#3}{#2 \textwidth} %\begin{center} \sffamily\includegraphics*[width= #2 \textwidth ]{#1}\vspace{-#7mm}\caption{\label{fig:#1}#4}\vspace{-#6pt}\end{center}\end{wrapfigure}}%---- потоки в другие файлы\usepackage{clipboard} % It is used to |copy and \HL\Paste the texts with tasks\usepackage{newfile}\newoutputstream{ZO}\openoutputfile{Zadachi.tex}{ZO}\newcommand*{\itemZO}[2]{\item  \label{enum:#1}%\Copy{#1}{\emph{\ifbool{For_Internet}{\blue{ #2 }}{#2}}}%\addtostream{ZO}{$\{$\thechapter.\theenumi $\}$}}\endinput%+++++++++++++++++% Файл \Ch1.tex  % глава 1\chapter{\label{ch:Chast1}Про сжатие текста}\section{Маленькие рисунки}\hs   Латех охотно отдаёт под плавающий объект (рисунок, таблицу) целые строчки, но очень не любитобтекание плавающих объектов текстом.   Печальный факт состоитьв том, что вписать в текст рисунок с подписьюснизу или сверху в Латехе до сих пор проблема.   Это делают пакеты wrapfig и floatflt, но оба капризны.   Так что выбор есть, но он плохой.   Если вы видите маленький красивый векторный рисунок иподпись к нему расположена слева или справа,так что рисунок и подпись занимают всю ширину страницы,то знайте -- это фирменный стиль пакета TikZ.%   Люблю его, как тёщу.  То есть совсем не очень.   Одна из его поганых особенностей состоит в том, что получение pdf-файлапо схеме tex$\to$dvi$\to$ps$\to$pdf очень сильно отличаетсяот результатов, полученных по схеме tex$\to$dvi$\to$pdf.\section{Как форматировать текст}\hs   Представим себе, что вам нужно ужать текст.   Например, чтобы убрать висящую в начале страницы строку, после которой начинается новая глава.   Пример внизу показывает один из полезных трюков -- разное размещение индексов в знаке суммы.   Заодно показано введение текста в формулу в математической и в текстовой моде.\BEA   \sum_{\varkappa=0,...}(1/2)^{\varkappa} \leq {\mb 2}, & \T{скобка справа от text, $e^x$, \vep{2}{1}{3}   },\\   \sum\nolimits_{\phi=0,...}(1/2)^{\phi} \le {\mb 2},   & {\text скобка слева от text, \tg(x) }.\ENA\section{Задачи к главе \thechapter}\begin{enumerate}[$\{$\thechapter.1$\}$]\begin{writeverbatim}{ZO}\section{Задачи и решения к главе~\ref{ch:Chast1}}\end{writeverbatim}%---------------------\itemZO{Zadacha11}{Докажите, как физик физику, что $f= \int_0^{\infty} \cos(x/a) \; dx =0$.}\begin{writeverbatim}{ZO}\Paste{Zadacha11}\smallskip\\\hs   Доказательство.   Пусть математики думают, что $f = \lim_{R \to \infty} \sin(R/a) = ??$, это их дело.   А мы добавим какую-нибудь физическую причину, меняющую определение:\BE \nnf = \int_0^{\infty} e^{-bx}\; \cos(x/a) \; dx = \frac{b}{b^2+1/a^2}.\EN   Теперь надо перейти к частным случаям.   Например, пренебречь физической причиной, положив  $b=0$.   Получим $f = 0$, что и требовалось доказать.\end{writeverbatim}\end{enumerate}%+++++++++++++++++% Файл \Ch2.tex  % глава 2\chapter{\label{ch:Chast2}Про букву ё и кавычки}\section{Передохнём или передохнем?}\hs   Для тех, кто протестует против ничем не заслуженной дискриминации буквы \emph{ё},есть специальная программа Yo.   Скачайте её и вы сможете ёфицировать свой текст!   Долой дискриминацию буквы \emph{ё}!\section{Русские кавычки}\hs   В английском языке приняты одинарные и двойные кавычки в виде ... и ....   В России приняты французские (...) и немецкие (...) кавычки, они называются ёлочки и лапки соответственно.\WrapTableBE{r}{C2_parties}{Ответы политпартий на вопросы}{g llll}{0.3}{8}\CR   & I  & II  & III  & IV   \\\midruleЕдРо  & 0 & 0 & 1 & 1  \\ЛДПР  & 1 & 1 & 0 & 1  \\КПРФ  & 0 & 1 & 1 & 0  \\\WrapTableEN{I, II, III, IV -- номера вопросов, 0 и 1 -- ответы (да, нет)}{5} %%   Лапки используются внутри ёлочек (Что тебе снится, крейсер Аврора).   Для набора лапок можно использовать команды \verb|\glqq|  и \verb|\grqq|,а для ёлочек -- \verb|\flqq|  и \verb|\frqq|.   Они определены в пакете babel.   Но это не обязательно.   Например, лапок на клавиатуре нет, а скопировать их откуда-нибудь можно и компилятор их понимает.\section{Задачи к главе \thechapter}\begin{enumerate}[$\{$\thechapter.1$\}$]\begin{writeverbatim}{ZO}\section{Задачи и решения к главе~\ref{ch:Chast2}}\end{writeverbatim}%---------------------\itemZO{Zadacha21}{В табл.~\fref{tab:C2_parties} показаны ответы на важные вопросы трёх политических партий.   По этим ответам можно вычислить коэффициенты антикорреляции (КА) между любыми двумя партиями, $0 \le$КА$\le 1$.   Всегда ли можно нанести эти партии на плоскость в виде трёх точек, чтобы расстояние между любыми двумя партиями было пропорционально КА между ними? }\begin{writeverbatim}{ZO}\Paste{Zadacha21}\hs\EpsWrapD{P_ABC}{0.28}{r}{Три партии}{8}{0}{6}   Ответ.   Для построения треугольника нужно, чтобы выполнялось неравенство треугольника $a+b \ge c$, где($a,b,c$) -- любая выборка из трёх длин, см. рис. \fref{fig:P_ABC}.   Представим себе крайний случай -- у одной партии все нули, а у другой все единицы.   Расстояние между ними равно 1.   Тогда у третьей партии сумма коэффициентов будет тоже равна 1, то есть она располагаетсяна отрезке, соединяющем первые две партии.   Все остальные ситуации проще.\end{writeverbatim}\end{enumerate}\endinput% Программа (TikZ) для этого рисунка:\tikzsetnextfilename{P_ABC}\begin{tikzpicture}\coordinate(a) at (1,0);\coordinate(b) at (-1.3,0);\coordinate(c) at (0,1);\draw[very thick] (a) --node[below]{$a$} (b)--node[above left]{$b$} (c)--node[above right]{$c$} (a);\shade[ball color=blue] (a) circle(0.3) node[below=3mm]{ЛДПР};\shade[ball color=red]  (b) circle(0.4) node[below=4mm]{КПРФ};\shade[ball color=green](c) circle(0.5) node[above=5mm]{ЕдРо};\end{tikzpicture}%+++++++++++++++++% Файл Figs\P_ABC.eps  % рисунок, поставьте какой-нибудь свой%+++++++++++++++++% Файл Zadachi.tex до начала работы пустой%+++++++++++++++++% Файл Zadachi_Head.tex % Заголовок части с задачами и решениями\chapter{\label{ZiR_Open} Решения задач}\input{Zadachi}\endinput

Вступление

1. Минимальными усилиями поднять сайт с релизами;
2. Сделать обновления контента на сайте автоматическим.

1. Push коммита на GitHub;
2. Сборка .tex-файлов в CI/CD;
3. Отправка собранных pdf в GitHub releases;
4. Обновление pdf-файлов на сайте-визитке.

• Аккаунт на GitHub;
• Инструменты для компиляции LaTeX;
• Любой текстовой редактор (я использую VIM, настроенный на latex);

Подключаем GitHub Actions

1. Имени (секция name: );
2. Условия запуска (секция on: );
3. Списка задач на выполнение (секция jobs: )

name: Build and deploy latex sources to GitHub Pageson: pushjobs:build:# Базовая ОС, на которой будут исполняться команды. Оставим ubunturuns-on: ubuntu-lateststeps:# Необходимо использовать этот action, чтобы получить содержимое репо- uses: actions/checkout@v2# Компилируем документ- name: Build documentuses: xu-cheng/latex-action@v2with:# Переименуйте, если у вас другой файлroot_file: main.tex# Больше параметров в офф. документацииworking_directory: latex_sources/# Аргументы, к которыми запускать компилятор (latexmk)# -jobname=<name> дает возможность поменять имя выходного файлаargs: -jobname=my_doc -pdf -file-line-error -halt-on-error -interaction=nonstopmodecompiler: latexmk# Загружаем собранные pdf-файлы- name: Upload pdf documentuses: actions/upload-artifact@v2with:# Это значение используется как ключ в хранилищеname: my_doc# Путь до собранного pdf. Может содержать *, **# Здесь это <working_directory>/<jobname>.pdfpath: latex_sources/my_doc.pdf

Настраиваем автоматические релизы

1. Ставить тэги вручную на те коммиты, по которым мы хотим собирать и релизить pdf-файлы;
2. Ставить теги в автоматическом режиме на все коммиты и релизить их.

deploy:runs-on: ubuntu-latest# Деплой будет только на ветке master. Закомментируйте, если не надоif: github.ref == 'refs/heads/master'# Можно зависеть от любого другого job. Порядок выполнения будет подстраиваться.needs: [build]steps:# Это хак, чтобы дергать bash-команды и запоминанать их результат- name: Variables# id используется внутренне: по нему можно ссылаться на результаты из другого stepid: vars# echo в таком форматировании позволит впоследствии ссылаться на результаты через ${{ steps.<step_id>.outputs.<variable_name> }}# Вертикальная черта |  это специальный символ yaml. Означает, что дальше идет массив команд и их все надо выполнитьrun: |echo ::set-output name=date::$(date +'%Y-%m-%d')echo ::set-output name=sha8::$(echo ${GITHUB_SHA} | cut -c1-8)- name: Download artifactsuses: actions/download-artifact@v2with:# Тот самый ключ, который мы указывали в upload-artifactname: my_doc- name: Create Releaseuses: actions/create-release@v1id: create_releaseenv:# По офф.документации, надо указать GITHUB_TOKENGITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # This token is provided by Actionswith:# Берем результат из step с id=vars (см. выше).# Получим теги вида my_doc-<дата билда>-<первые 8 символов из sha коммита>tag_name: my_doc-${{ steps.vars.outputs.date }}-${{ steps.vars.outputs.sha8 }}# Имя, которое будет высвечиваться в релизеrelease_name: My Actions document (version ${{ steps.vars.outputs.date }})# Наш релиз не набросок и не пререлиз, так что оба в falsedraft: falseprerelease: false# Прикладываемые файлы надо заливать отдельным step- name: Upload pdf assetuses: actions/upload-release-asset@v1env:# Тоже требуется токенGITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}with:# Из предыдущего step с id=create_release генерится upload_url  по нему и надо заливатьupload_url: ${{ steps.create_release.outputs.upload_url }}# Не переходим в папку latex_sources, поскольку download-artifacts грузит в текущую директориюasset_path: ./my_doc.pdf# Имя, которое будет высвечиваться в релизеasset_name: my_asset_name.pdfasset_content_type: application/pdf

Поднимаем GitHub Pages

Где моя страница?

Загружаем свежайший релиз

Итоги

Поводом к появлению этой заметки послужила вполне реальная история. Всё началось с того, что мой хороший знакомый, химик по образованию, роду деятельности и складу ума, обратился ко мне за помощью. Помощь заключалась в подготовке публикации на некую околохимическую тему, с формулами, таблицам, диаграммами и прочими атрибутами Серьёзного Научного Труда (СНТ), причём химия подразумевалась органической, и, следовательно, формулы структурными и раскидистыми, а таблицы километровыми. Публикация была нужна, как водится, вчера, свёрстанная и оформленная по жёстким требованиям неведомой мне организации, с аннотацией, списком литературы о множестве наименований, со ссылками, сносками, цитатами, эпиграфами...

Уяснив стартовые данные, я впал в лёгкое уныние. Больше всего в тот момент мне хотелось сослаться на обстоятельства непреодолимой силы, перегруженность, невменяемость, сезонное обострение ящура короче говоря, найти любой повод и на волю, в пампасы! Но сакраментальное ты ж программист! и осторожное буду должен уже прозвучали, вздохи химика становились все тяжелее, размеренно падая на и без того узкую тропку к отступлению, химиковы глаза за толстыми стёклами очков давали изрядную фору фирменному взгляду Кота-в-сапогах из Шрека...

Пути назад не было. Квест начался.

Химик пришел не с пустыми руками. Он принёс множество листиков с зачем-то уже напечатанным текстом и формулами, тщательно нарисованными шариковой ручкой в специально сделанных пропусках между абзацами. Впрочем, тут же выяснилось, что большая часть СНТ всё ещё пребывает в недрах могучего химикова ума, а листочки это так, наброски, черновики и вообще проба пера.

Ситуация вырисовывалась невесёлая. Химик весьма уверенно набирал текст в notepadе и даже, кажется, знал, как выделить строчку в Wordе курсивом. Я совершенно точно помнил формулы воды, этилового спирта и был убеждён, что лить воду в серную кислоту ни в коем случае нельзя. Или наоборот? Неважно, главное на этом пересечение наших познаний исчерпывалось. Вопрос вырисовывался один, но глобальный: как? Как организовать работу так, чтобы химик мог излить ещё не рождённый СНТ на бумагу то есть, в какой-то текстовый формат, а я мог бы разобраться в структуре документа и сверстать его надлежащим образом, вставив в нужные места все упомянутые выше красоты?

Word отпал, когда к концу следующего дня химик прислал первые наброски нашего с ним великого творения, в порядке здоровой инициативы набранные с помощью именно это редактора. По привычке он набирал в нём текст как в блокноте: абзацные отступы, состряпанные из ядрёной смеси пробелов и табуляций, ряды пустых абзацев, долженствующие перенести текст на следующую страницу, нумерованные вручную списки, колонки текста, выровненные все теми же многострадальными пробелами и переносами строк в самых неожиданных местах Химик блистал! К сожалению, он совсем забыл про поля, и когда я выставил их ширину в требуемые значения, всё это великолепие рассыпалось в совершенно невзрачные и не поддающиеся восстановлению ошмётки. What you see оказалось не совсем what you get, а говоря по правде совсем не.

Править все присылаемые химиком черновики и наброски присваивать нужные стили абзацам и заголовкам, делать списки списками, разрывы страниц разрывами, вычищать ненужные пробелы и т.д. и т.п. мне совершенно не улыбалось. Кроме того, я абсолютно не представлял (что уж там, я и сейчас пребываю в счастливом неведении) как изобразить в этом самом Wordе хотя бы структурную формулу какого-нибудь бензола, не говоря уже о чём-то посложнее не рисовать же, в самом деле, картинки?

Решение пришло после короткого гугления: Markdown! Прикинув, что возможности этого простого, как табуретка, языка разметки перекрывают потребности химика по оформлению текстовой части его работы на 99%, я подыскал внятное руководство и переправил его химику с предложением обсудить этот вариант по скайпу. На удивление, химик воспринял идею без особого сопротивления: как потом выяснилось, вольная борьба с Wordом изрядно поднадоела ему самому.

По обсуждении, план совместной работы над документом сводился к следующему:

• Химик, используя подходящий Markdown-редактор, готовит текстовую часть документа, соблюдая его структуру, вводя разделы, подразделы и т.п.
• Простые формулы вписываются непосредственно в Markdown-разметку, сложные и структурные рисуются от руки, сканы пересылаются мне; место в тексте для них маркируется.
• Данные для таблиц, диаграмм и графиков присылаются мне в сыром виде (как оказалось, это были в основном CSV-файлы); место в тексте для них также маркируется.
• Я подготавливаю сложную вёрстку (титульник, формулы, таблицы, диаграммы и графики, библиографию и т.д.) как компоненты составного документа LaTeX.
• После подготовки и вычитки всех материалов я верстаю их в единый документ LaTeX, добавляю содержание, приложения и т.п.
• Профит!

И работа пошла, пусть поначалу со скрипом и неровно, но пошла! После нескольких дней ошибок, химик на удивление неплохо приноровился к незатейливому синтаксису Markdown, благо, редактор не слишком отличался от его излюбленного блокнота. Для удобства, текст публикации был разбит на несколько md-файлов, по числу основных разделов. Во избежание случайной утраты данных проект был помещён под контроль VCS; правда, мне приходилось рулить проектом сразу на двух машинах: на своём и, в ипостаси альтер-эго химика посредством TeamViewer на его компьютере.

Предлагая к использованию Markdown, я планировал воспользоваться всеми любимым pandocом и просто-напросто преобразовать md-файлы в исходники LaTeX, но время поджимало, и компоновку итогового документа пришлось начать, не дожидаясь полного завершения работ химиком. И вот тут-то Оказалось, я здорово недооценил перфекционизм и энтузиазм моего соавтора: просматривая очередной коммит проекта, я заметил массовые и довольно объёмные изменения в md-файлах, которые были давно вычитаны, исправлены, преобразованы в LaTeX и щедро нафаршированы формулами, таблицами и прочими кулинарными ингредиентами. Как выяснилось, в порыве творческого экстаза химик в очередной раз перечитал уже набранные разделы, остался не весьма ими доволен и, ничтоже сумняшеся, тут же устранил недочёты. Всю ночь возился! горделиво заявил он по скайпу в ответ на мои робкие попытки узнать, что же произошло.

Признаюсь, я начал закипать. Вариантов оставалось два: отследить изменения в новообретенных текстах и вручную перенести их в исходники LaTeX или опять расчехлить pandoc, преобразовать оные тексты в LaTeX и, засучив рукава, снова нашпиговать их утраченными красивостями, практически вернувшись к той самой печке, от которой удалось отплясать уже довольно далеко.

Из этих двух вариантов всё более хотелось выбрать третий: пампасы! Тем более, что химик явно недоумевал, почему я не разделяю восторгов по поводу улучшений и украшений, несомненно нашёптанных ему его органико-химической музой в, разумеется, лучшие творческие минуты его жизни, что не оставляло сомнений в том, что муза посетит его ещё не раз и процесс внесения правок и изменений приобретает мрачноватую перспективу стать перманентным и всеобъемлющим.

И вдруг! Покопавшись в пакетах LaTeX, я с удивлением обнаружил среди прочих пакет с многообещающим названием markdown. Ещё не веря в удачу, я начал читать описание Да! Этот пакет позволял включать Markdown-файлы в документ LaTeX as is, без сторонних утилит, без дополнительных правок или излишних телодвижений, при этом позволяя использовать в Markdown-разметке конструкции LaTeX!

Теперь мне оставалось только прописать в md-текстах химика включение иллюстраций по месту (в виде tex-разметки), залить эти изменения на его компьютер и строго-настрого запретить ему править или выкидывать вот эти вот непонятные закорючечки. Остальной химиков текст ему позволялось изменять как угодно, в любое время дня и ночи, на пару с музой или без содействия оной. Простая пересборка LaTeXом подтягивала в итоговый документ все изменения, никак не отражающиеся на уже проделанной работе. Система контроля версий довершала глубоко эшелонированную линию обороны от возможных деструктивных поползновений.

Публикация была готова не совсем в срок, но до дедлайна уложиться удалось.

Ф-ф-у-у-у-ух.

Повторюсь, это вполне реальная история. Да, есть ещё люди, которые используют Word (или LibreOffice Writer, или AbiWord, или ) как пишущую машинку, не заморачиваясь стилями, параметрами абзацев и тому подобными, совершенно бессмысленными с их точки зрения, штуками. А почему нет? Это же вовсеушипрожужжанный WYSIWYG, они же видят перед собой что-то, вполне себе читаемое. Да, при этом они могут быть вполне успешными профессионалами в своей области. Да, им непросто объяснить суть проблемы, а научить правильной вёрстке непросто вдвойне. И да, порой им приходится готовить публикации...

Надеюсь, мой опыт работы в тандеме подобного толка пригодится ещё кому-то в сходной ситуации, или натолкнёт на нужное решение в какой-то иной. Более подробно ознакомиться с возможностями пакета markdown можно в обзорной статье.

Удачи!