Добавить версию в PDF

[bkoshelev]

140

Описание

PR добавляет логику создания PDF на основе уже имеющихся данных из *.mdx файлов.

Данные конвертируются следующим образом: mdx -> md -> pdf

Основная идея была в том, чтобы не менять mdx файлы.

Фичи

• [x] Добавлено оглавление
• [x] Внутренние ссылки 1-го уровня глубины заменены на якоря
• [x] Тесты с вопросами удалены из текста
• [x] Аннотации перенесены в конец книги в раздел "Словарь"
• [x] В футер сайта добавлена кнопка для скачивания книги в PDF

Что не получилось сделать:

• [ ] Приложения для просмотра pdf не видят содержание (во многих приложениях есть боковая панель в которой можно выводить Table Of Contents
• [ ] Внутренние ссылки второго уровня глубины сломаны (например, /lsp/in-real-life) Нужно описать объект вида [ссылка]: [якорь, ведущий к нужному подразделу книги] и добавить якоря в нужные места
• [ ] Не работает разрыв страницы

Особенности

Из-за того что remark-плагины отдают только esm-модули, а в next.js падает сборка при установке type: module в -package.json, решено пока что собирать скрипт отдельно с помощью esbuild. (В дальнейшем можно перейти на ts-node, так как он уже поддерживает esm-модули)

Пример получившегося файла:

solid_book.pdf

Скриншоты

Верстка

Структура классов

[vercel[bot]]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated
ota-solid	✅ Ready (Inspect)	Visit Preview	Jun 5, 2022 at 4:21PM (UTC)

[bespoyasov]

Я там, кстати, ещё зависимости обновляю, и это может затронуть глоссарий :–(

[bkoshelev]

Я там, кстати, ещё зависимости обновляю, и это может затронуть глоссарий :–(

Судя по коммитам, глоссарий теперь больше не нужен. И контент, на основе которого он собирался будет удален. Хорошо, тогда уберу логику сборки глоссария из PR.

[bespoyasov]

Мёржу! 🎉

[bkoshelev]

Ура!

[bespoyasov]

Спасибо за помощь и участие ^_^