Сделал поддержку формул как для основной разметки Podlite, так и внутри блоков markdown. 🧮✨


Формулы можно вводить с помощью кода C<F<>> и блока C<=formula>. Внутри C<=markdown> с помощью C<$...$> и C<$$...$$>. 


picture

L<Пример на pod6.in|https://pod6.in/#p=%3Dfor+formula+%3Acaption%28%27The+Cauchy-Schwarz+Inequality%27%29%0A+++%5Cleft%28+%5Csum_%7Bk%3D1%7D%5En+a_k+b_k+%5Cright%29%5E2+%5Cleq+%5Cleft%28+%5Csum_%7Bk%3D1%7D%5En+a_k%5E2+%5Cright%29+%5Cleft%28+%5Csum_%7Bk%3D1%7D%5En+b_k%5E2+%5Cright%29%0A%0A%0A%0AThis+is+an+inline++example%3A+F%3C+y+%3D+%5Csqrt%7B3x-1%7D%2B%281%2Bx%29%5E2+%3E%0A%0A%3Dbegin+markdown%0A%0A++*+this+is+a+example+of+%60formula%60+inside+markdown%3A+%24y+%3D+%5Csqrt%7B3x-1%7D%2B%281%2Bx%29%5E2%24%0A++%0A++and+block%3A+%0A++%0A++%24%24%0A++%5Cleft%28+%5Csum_%7Bk%3D1%7D%5En+a_k+b_k+%5Cright%29%5E2+%5Cleq+%5Cleft%28+%5Csum_%7Bk%3D1%7D%5En+a_k%5E2+%5Cright%29+%5Cleft%28+%5Csum_%7Bk%3D1%7D%5En+b_k%5E2+%5Cright%29%0A++%24%24%0A++%0A++%0A%0A%3Dend+markdown%0A%0A>


Узнать больше о формулах можно здесь: L<LaTeX/Mathematics|https://en.wikibooks.org/wiki/LaTeX/Mathematics>.


К сожалению, кроме написания диплома, я больше вроде нигде формулы не использовал.


para

root

По движку публикации базы знаний в Web L<podlite-web| https://github.com/podlite/podlite-web> из набора файлов есть хороший прогресс в развитии.  Он заключается в том, что сейчас можно не только публиковать свою базу знаний из набора статических файлов используя единый шаблон, но и расширять функционал создаваемых web сайтов с помощью плагинов и подключаемых внешних javascript библиотек.


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


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


Например давно хотелось  сделать предметный указатель по базе знаний (он же, если я не ошибаюсь - C<Index of Terms>). Я понимал, что это не тоже самое что предметный указатель для книги, где есть нумерация страниц, и возможно будет несколько попыток, пока не получиться удовлетворительный результат.


Хотелось сделать поиск. Также есть в планах добавить визуализацию связей, что тоже потребует экспериментов. 


Таким образом список требований к результату был более менее конкретизирован.


В качестве практической задачи я взял идею построения базы знаний для L<Raku|https://raku.org> комьюнити на основе проектов, разбросанных по разным репозиториям - официальной документации, проекту примеров кода, а также всех пользовательских библиотек/модулей.


Заодно это был хороший повод реализовать предметный указатель, попробовать сделать поиск и протестировать парсер Podlite на предмет обработки как файлов, содержащих только разметку, так и извлечения разметки из файлов с программным кодом. 


Поскольку Podlite поддерживает markdown, то в базу знаний попали также все дополнительные файлы, сопровождающие программный код. Например, множество C<README.md> из GitHub-репозиториев пользовательских модулей, в которых тоже содержится документация.


Получившийся в итоге результат базы знаний можно посмотреть здесь: L<The Raku Knowledge Base|https://raku-knowledge-base.podlite.org/>. 
Исходники: L<
https://github.com/zag/raku-knowledge-base>


L<Предметный указатель|https://raku-knowledge-base.podlite.org/indexterms> ( Index of Terms) получился вот таким:


Вместо номеров страниц используется символ C<#>, а если для указанного Term есть несколько ссылок, то порядковые номера ссылок. При наведении курсора на ссылку отображается название документа, чтобы понять контекст, где этот термин используется.


Также поддерживается "See Also" - это когда для термина существует синоним, т.е. эта же сущность имеет другое название.


Реализована группировка терминов:


Поиск вызывается сочетанием клавиш (ctrl-K ) на любой странице: 


По поводу поиска, могу только сказать, что это очень начальная версия, где используется только простой поиск текста в документах, без какой либо градации по типу найденного результата. Тут еще предстоит достаточно поработать, хотя документы вполне себе ищутся )


В результате в проекте публикации базы знаний из набора файлов L<podlite-web| https://github.com/podlite/podlite-web> добавились плагины для дополнительной обработки документов и возможность подключения внешних библиотек.


Также оставлю ссылку на пост из блога Podlite с подробностями: L<podlite.org/a5ZK1|https://podlite.org/a5ZK1>


Первые результаты анонса L<Podlite|https://github.com/podlite> показали, что к новому языку разметки определенно есть интерес:


Уже появились первые issues, что очень мотивирует развивать его дальше. 😀
