Как перенести документ из LaTeX или Word

Статью или конспект, которые уже есть в LaTeX или Word, не нужно перепечатывать. Импорт преобразует их в LibreTimes Markdown вместе с формулами, теоремами, рисунками и библиографией и открывает результат как черновик для проверки. Это руководство импортирует документ, объясняет, что преобразование делает с каждой его частью, и перечисляет, что проверить перед публикацией. Последний раздел — о готовых файлах Markdown, которые публикуются через lt.

Импортировать файл

Откройте /new (туда ведёт Новая публикация на главной) и выберите Импорт.
Перетащите файл или нажмите, чтобы выбрать его:
- документ Word, .docx;
- отдельный файл LaTeX, .tex;
- проект LaTeX в виде .zip с рисунками и файлом .bib — лучший выбор, если в статье есть что-то из этого;
- PDF, .pdf, который публикуется как сам PDF, без преобразования, потому что в PDF нет структуры, которую можно было бы преобразовать.
Размер файла — до 50 МБ.
Если язык или тип не удалось определить по файлу, выберите их, когда спросят.
Прочитайте список предупреждений, который показывается вместе с черновиком, если он есть: в нём названо, что именно не удалось преобразовать точно и сколько раз.

Черновик откроется с заполненными названием, аннотацией, текстом и источниками. Он приватен, пока вы его не опубликуете.

Что делает преобразование

Зная, что случилось с каждой частью документа, вы знаете, куда смотреть.

В исходнике	В черновике
Название — из метаданных документа или из заголовка верхнего уровня в начале	Название работы, а не заголовок в тексте
Аннотация	Аннотация работы
Разделы	Заголовки от `##` и ниже; если уровней больше четырёх, самые глубокие сливаются, с предупреждением
$…$ , `\[…\]`, `equation`, `align`	Формулы, без изменений
`theorem`, `lemma`, `definition`, `proof` и другие окружения утверждений; стили абзацев Word с такими же названиями	Утверждения, например `:::theorem`
Стили Word с названиями Note, Tip, Important, Warning или Caution	Выноски
Рисунки с подписями	Блоки `::::figure` с подписями и якорем; изображения загружаются вместе с работой
`\cite` с файлом `.bib` в проекте; ссылки из Zotero или Mendeley в Word	Нумерованные метки вроде `[1]` в тексте и библиография как список источников работы
Таблицы	Таблицы; объединённые ячейки и ячейки из нескольких абзацев упрощаются, с предупреждением
Сырой LaTeX или HTML без аналога в Markdown	Удаляется, с предупреждением

Собственные команды LaTeX вне формул, такие как \emph, \section или \begin{theorem}, в текст не попадают: преобразование один раз переписывает их на диалект, и странице никогда не приходится читать LaTeX. Поэтому же их нельзя сохранить: диалект не принимает LaTeX вне формул.

Проверить черновик

Преобразование хорошее, но не идеальное. Пройдите черновик в редакторе с открытым Просмотром и по очереди проверьте:

Формулы. Ищите всё, что выделено красным. Обычная причина — команда из пакета, которого нет в KaTeX, или ваш собственный \newcommand; напишите её полностью. Смотрите Как писать формулы.
Утверждения. Каждая теорема, лемма или доказательство должны быть блоком со своей жирной меткой. Если метка видна дважды — один раз от блока и один раз текстом, скопированным из исходника, — удалите текст. Добавьте number= каждому утверждению, на номер которого ссылается текст; смотрите Как написать теорему и её доказательство.
Перекрёстные ссылки. У \ref, \eqref и \autoref нет аналога ни в формуле, ни в тексте. Дайте цели якорь и сошлитесь на него, как в разделе Ссылка на часть своего текста.
Ссылки на источники. Ссылка без записи в библиографии остаётся простым текстом и учитывается в предупреждениях. Добавьте недостающую запись на вкладке Ссылки или укажите источник в сноске.
Рисунки. Проверьте, что пришли все изображения. Изображение в устаревшем формате, которое не удалось преобразовать для веба, удаляется с предупреждением; переведите его в PNG или SVG сами и добавьте заново. Рисунок TikZ можно оставить в TikZ: смотрите Как нарисовать диаграмму в TikZ.
Таблицы. Пересоберите каждую таблицу, которая по предупреждениям была упрощена. Таблицу с объединёнными ячейками можно написать на сыром HTML.

Когда предпросмотр читается так же, как оригинал, все формулы набраны и ни одна строка ::: или {…} не показана текстом, черновик готов к публикации.

Публикация файлов Markdown через `lt`

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

Установите lt и войдите командой lt auth login.
Дайте каждому файлу блок frontmatter как минимум с title, type и language, а также с import_key, который называет его раз и навсегда:
```
---
title: Теорема о среднем
type: lecture
language: ru
import_key: analysis-course/03-mean-value
is_draft: true
---
```
Посмотрите, что будет создано или обновлено, ничего не записывая:
```
lt work publish notes/*.md --dry-run
```
Опубликуйте:
```
lt work publish notes/*.md --yes
```

Каждый файл становится работой, а is_draft: true оставляет её приватным черновиком, пока вы не опубликуете её на сайте. Текст должен быть уже на LibreTimes Markdown: lt публикует то, что написано в файле, и ничего не преобразует, так что LaTeX вне формул в файле будет показан как набран. Те же проверки, что выше, применяются в предпросмотре каждого черновика.

Целая книга публикуется так же — из папки с файлами глав и одним манифестом: смотрите Как написать книгу.