Не каждый документ начинается в Word. На Typst сегодня быстро пишут статьи, письма, резюме и конспекты лекций, не воюя с LaTeX, а многие команды ведут руководства, спецификации и регламенты на AsciiDoc. И вот кто-то просит подписанную отсканированную копию, а на компьютере перед вами есть только исходный файл.

Look Scanned теперь открывает оба формата. Для файлов .typ используйте Typst (.typ) в отсканированный PDF, для файлов .adoc и .asciidoc — AsciiDoc (.adoc) в отсканированный PDF. Документ превращается в страницы прямо в вашем браузере. Вы проверяете их в предпросмотре, добавляете эффект сканирования и скачиваете PDF, который выглядит так, будто прошёл через настоящий сканер. Не нужно устанавливать Typst CLI, Ruby или Asciidoctor PDF и не нужно входить ни в какую учётную запись.

Typst: настоящий компилятор в вашем браузере

Look Scanned запускает официальный компилятор Typst (Typst 0.14) в версии для браузера. Это тот же компилятор, что стоит за typst compile, поэтому страницы, переносы строк, формулы и таблицы получаются такими же, как на вашем компьютере, включая размер страницы и поля, заданные в документе.

  • В первый раз придётся немного подождать. Компилятор и шрифты Typst, вместе около 20 МБ, загружаются с Look Scanned при первом использовании. Потом они берутся из кеша браузера, и файлы Typst открываются даже без интернета.
  • Один файл, без пакетов. Компилируются только самодостаточные документы. Строка #import "@preview/…" вызывает ошибку, потому что нет реестра пакетов, откуда их можно было бы скачать. То же касается всего, что читает другой файл: изображения, вставленного через #image, главы, подключённой через #include, или данных из файла CSV или JSON.
  • Только стандартные шрифты Typst. Текст набирается шрифтами, которые идут вместе с Typst: Libertinus Serif, New Computer Modern с математическим шрифтом и DejaVu Sans Mono для кода. Шрифты, установленные на компьютере, недоступны, поэтому другой шрифт, указанный в документе, заменяется одним из этих. Они покрывают латиницу (включая вьетнамские буквы), греческий алфавит, кириллицу и еврейское письмо. Для китайского, японского и корейского текста запасного шрифта нет вообще, а такие письменности, как арабская, тайская или деванагари, тоже не поддерживаются как следует, поэтому, если они есть в документе, проверьте предпросмотр.
  • Исходник должен компилироваться. Если Typst сообщает об ошибке, вместо страниц вы увидите сообщение об ошибке.

Поскольку Typst создаёт настоящий PDF ещё до того, как накладывается эффект сканирования, его текст можно сохранить. При сохранении в PDF включите «Сохранить исходный текст (аналогично OCR)» в настройках вывода, и текст в отсканированном PDF останется доступным для поиска и копирования.

AsciiDoc: Asciidoctor без Ruby

Файлы AsciiDoc преобразует Asciidoctor, эталонный обработчик AsciiDoc, в версии на JavaScript, которая работает в браузере. Результат раскладывается на страницы A4 с полями в один дюйм, и вот что переносится:

  • Заголовок документа: название, автор и строка с редакцией, а также оглавление, если в документе задан :toc:.
  • Разделы, списки, таблицы, сноски, цитаты и выноски в коде (callouts). Блоки-предупреждения (admonitions) показывают свою метку, например Note или Warning, текстом, а не значком.
  • Формулы STEM, набранные настоящим математическим шрифтом, если в документе задан :stem:. Работают и нотация AsciiMath, и нотация LaTeX, как в тексте, так и отдельными блоками.
  • Листинги кода с подсветкой синтаксиса, если в документе задан :source-highlighter:, какой бы подсветчик там ни был указан. Без этого атрибута листинги остаются без цвета, как и в любом другом месте.
  • Длинные таблицы и листинги продолжаются на следующей странице, а строка таблицы никогда не разрезается пополам.

Кое-что не переносится:

  • include:: не выполняется. Каждая директива include показывается как ссылка на свой путь вместо подключаемого содержимого. Сначала соберите части в один файл.
  • Изображениям нужен полный адрес. Изображение, указанное относительным путём вроде images/diagram.png, не найдётся, потому что файл открывается сам по себе, без своей папки. Изображение с полным адресом https:// загружается с сайта, где оно лежит, и для этого нужно подключение к интернету.
  • Диаграммы остаются исходным кодом. Asciidoctor Diagram недоступен, поэтому блок PlantUML или Mermaid отображается в виде набранного вами текста.
  • Шрифты берутся с вашего устройства. Текст набирается шрифтами, установленными на вашем компьютере или телефоне, поэтому на другом устройстве тот же файл может разбиться на страницы иначе.
  • Очень длинным файлам может не хватить времени. Вёрстка должна завершиться примерно за 30 секунд, поэтому документ размером с книгу лучше разбить на файлы поменьше.
  • Файлы .asc не принимаются. Это расширение обычно используют ключи и подписи PGP. Переименуйте файл AsciiDoc в .adoc, прежде чем открывать его.

Как превратить файл .typ или .adoc в отсканированный PDF

  1. Откройте Typst (.typ) в отсканированный PDF или AsciiDoc (.adoc) в отсканированный PDF и выберите файл.
  2. Подождите немного, пока готовятся страницы, а затем пролистайте предпросмотр страницу за страницей. Проверьте заголовки, формулы, таблицы и код.
  3. Настройте эффект сканирования. Если в документе мелкий шрифт или плотные формулы, держите размытие и шум на низком уровне.
  4. Нажмите «Создать отсканированный PDF», а затем «Скачать отсканированный PDF».

Если вам удобнее изображения, каждую страницу можно экспортировать в JPG или PNG. Когда какой формат лучше, рассказано в нашей статье о PDF, JPG и PNG. А в пакетном сканировании, функции Pro, можно обработать сразу несколько файлов .typ или .adoc.

Ваш файл остаётся на вашем устройстве

Оба формата преобразуются и сканируются в браузере, а исходный файл никогда не загружается на сервер. Для Typst скачиваются только компилятор и его шрифты, с собственного сайта Look Scanned; пакеты и другие файлы никогда не запрашиваются. Для AsciiDoc единственное исключение — изображение с полным адресом https://: оно загружается с сайта, где размещено, точно так же, как если бы вы открыли эту страницу в браузере.

Что полезно знать

  • Результат состоит из изображений. Как и в настоящем скане, текст в PDF нельзя выделить или найти поиском, если только вы не включили описанную выше опцию для файла Typst. Сохраните исходник .typ или .adoc для редактирования.
  • Эффект сканирования применяется всегда. Look Scanned нужен для того, чтобы документы выглядели отсканированными. Если вам нужен просто чистый PDF, экспортируйте его через Typst или Asciidoctor PDF.
  • Нужны пакеты, include или диаграммы? Создайте PDF на компьютере, где установлены Typst или Asciidoctor PDF, а затем добавьте к этому PDF эффект сканирования в Look Scanned. Так можно обработать любой документ, ведь самую сложную часть уже выполнил исходный инструмент.

Пишете в другом формате? Посмотрите, как Look Scanned работает с файлами LaTeX и с файлами Markdown, HTML и TXT.

Есть файл .typ или .adoc, который должен выглядеть как скан? Попробуйте с Typst или с AsciiDoc.