Не кожен документ народжується у 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.