Опубликовал движок публикации моей базы знаний на github: https://github.com/podlite/podlite-web.

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

В репозитории подготовил несколько примеров: каталог examples. Они демонстрируют создание страниц, связывание файлов, использование диаграмм, публикацию заметок.

В примере блога демонстрируется интеграция с React и кастомизация стилей.

Дописываю небольшую статью с разбором примеров. Думаю на этом вопрос с документацией движка закрыть.

Собираюсь попробовать этот движок для продуктовых сайтов. Пока этим движком собирается https://zag.ru.

Больше всего мне понравилось во всей этой истории тот факт, что движки меняются, а исходники статей и заметок - нет 😀.

Для представления о предмете описания обновил синопсис инфраструктуры базы знаний. На данный момент воображение рисует вот такую архитектуру проекта: Концепт базы знаний. Подробнее можно ознакомиться в документе Делаю свою базу знаний Движок, о котором пойдет далее речь, отмечен на диаграмме как "publisher on the web". Это headless система персонального издательства, созданная на современном архитектурном паттерне - Jamstack. Проще говоря - продвинутый генератор статических сайтов 😀. Для меня это очередное представление моей базы знаний в web. Далее опишу без каких-то технических подробностей основные возможности движка. Колонки текстаТекст можно разбить на несколько колонок. Так на титульной странице сайта разбит текст с описаниями проектов и инофрмацией. Количество колонок определяется количеством блоков разметки. Диаграммы То ради чего все это и затевалось. Пока диаграммы строятся средствами браузера. Векторные и пиксельные форматы представления диаграмм будут реализованы позднее. Подписи к диаграммам и изображениям Подписи можно делать с ссылками и различными формами выделения текста. Подписи используются для создания автоматического списка картинок, диаграмм. "Печатаемые" ссылки "Печатаемые" - это ссылки, которые можно отправлять в скриншотах, фотографиях и распечатывать на бумажном носителе, например на товарном чеке, инструкции прилагаемой к товару, на упаковке, в газетных объявлениях, книгах. Символы в ссылке легко идентифицировать и такую ссылку можно набрать вручную. Например: zag.ru/n5HQ1. Эти ссылки для каждой страницы были сделаны в ранних версиях этого сайта, но в процессе смены движков были утрачены ). Теперь вернулись вновь. Преобразование локальных ссылок Исходным материалом для сборки сайта являются файлы, расположенные у меня на диске. Чтобы сделать ссылку на другой документ, я ставлю ссылку на файл. Вот как выглядит ссылка на титульной странице сайта, ведущая на оглавление сайта: L<Оглавление|file:./Contents.pod6>. При публикации подобные ссылки преобразуются в ссылки на соответсвующие страницы сайта. Cодержание статьи К каждой статье можно добавить содержание (англ. Table of contents). Оно может генерироваться из заголовков любых уровней. Содержание может состоять не только из заголовков, но из подписей к таблицам, рисункам и диаграммам. С учетом того, что содержаний в документе может быть несколько - можно сделать обычное содержание и отдельно список таблиц, список изображений и диаграмм в одной статье. Пример с несколькими содержаниями выглядит так: Пример нескольких содержаний. Первое содержание состоит из заголовков, второе - из названий таблиц и диаграмм. Оглавление Выбросил пагинацию и сделал оглавление для сайта: вывел все статьи и заметки на одной странице. Материалы сгруппированы по годам и месяцам. Эта страница произвела на меня наибольшее впечатление. Оглавление сайта Так как собираюсь в ближайшее время сделать движок открытым, то еще один важный элемент, предметный указатель, пока отложил на потом. Не хочется делать его второпях.
←↑→
Создание сайта/блога с помощью Podlite для Web