Вот как получилось запустить публикацию  локальной базы знаний в web, не тратя время на дополнительные компоненты:


Какой концепт задумывался и как это работает на данный момент


caption

Image

Этого минимума достаточно, чтобы публиковать заметки и статьи на домашнем сайте. И еще экспериментировать с сайтами проектов и лэндингами.


Об этом подробнее расскажу в ближайшее время...


para

root

Я хотел бы представить простой блок-ориентированный язык разметки L<Podlite|https://podlite.org/specification> 🚀.

Я посвятил работе над его спецификацией большую часть прошлого года. В нее вошли результаты предыдущих лет работы и использования Raku Pod (aka pod6).


Цель статьи - познакомить с возможностями Podlite накануне выпуска первой версии спецификации.


Основные функции языка разметки включают в себя:


Анонс: Podlite - простой блок-ориентированный язык разметки.


TITLE

DESCRIPTION

markdown

=begin markdown


Я хотел бы представить простой блок-ориентированный язык разметки [Podlite](https://podlite.org/specification) 🚀. Я посвятил работе над его спецификацией большую часть прошлого года. В нее вошли результаты предыдущих лет работы и использования Raku Pod (aka pod6).

Цель статьи - познакомить с возможностями Podlite накануне выпуска первой версии спецификации.

=end markdown


=begin markdown
Основные функции языка разметки включают в себя:

* Блок является базовой единицей документа
* Блоки могут иметь атрибуты
* Разметка поддерживает связывание блоков различными типами отношений
* Поддерживаются формулы
* Markdown является стандартным блоком. Это означает, что можно переключаться в режим markdown при необходимости в любой части документа.
* Поддерживаются таблицы, изображения, оглавление и различные типы списков
* Podlite расширяемый на уровне блоков и inline элементов
* Есть хранение в документе raw данных 
* Включение одного документа в другой

Podlite - блок-ориентированный язык разметки. Блоки могут быть представлены в трех эквивалентных формах блоков:
разграниченные (delimited), блоки-параграфы (paragraph) и сокращенные (abbreviated) блоки.

```

=begin table :caption<Summary>
 Constants 1
 Variables 10
=end table

=for table :caption<Summary>
 Constants 1
 Variables 10

=table
 Constants 1
 Variables 10

```

Podlite не содержит в себе какой-то концепции и не привязан к какому-то конкретному языку программирования. Это позволяет ему быть встроенным в любой язык программирования, который поддерживает блочные или многострочные комментарии.

Например, в javascript:

```
 /*
 =head1 Documentation
 
 This is a general overview:
 
 =begin Mermaid
 graph LR
 A-->B
 B-->C
 C-->A
 D-->C
 =end Mermaid
 =begin markdown
 
 # header
 
 * text
 * text
 
 =end markdown
 */
```

В Podlite имеются разные варианты связей между блоками, документами, терминами и определениями.
Это делает его отличным средством для построения баз знаний, а так же создания документации, блогов, учебных материалов и многого другого.


[Спецификация Podlite](https://github.com/podlite/podlite-specs) опубликована под открытой лицензией Artistic license 2.0. 

Планирую продолжать развивать этот язык. Он открыт новым идеям и надеюсь найдет интересные сферы применения. По крайней мере в ближайших моих планах продолжить его применять в построении баз знаний. 

Всвязи с предстоящим релизом буду рад отзывам и предложениям.

## Текущий статус Podlite

* на данный момент [спецификация Podlite](https://github.com/podlite/podlite-specs) находится в стадии **beta**, но в ближайшее время выйдет первая версия

* есть реализация на Typescript (https://github.com/podlite/podlite), с помощью которой построен [пакет web публикации](https://github.com/podlite/podlite-web) и [web редактор](https://pod6.in)

* есть бесплатный редактор для десктопа, доступный во всех сторах : https://github.com/podlite/podlite-desktop

* есть плагин для VS Code c функциями AI (сейчас на ранней стадии разработки)


## Полезные ссылки

* Specification : [https://github.com/podlite/podlite-specs](https://github.com/podlite/podlite-specs) ⭐️🙏 , [\[в формате html\]](https://podlite.org/specification)
* github: [https://github.com/podlite](https://github.com/podlite) 
* website: [https://podlite.org](https://podlite.org)
* web playground: [https://pod6.in](https://pod6.in)

=end markdown

L<Podlite|https://podlite.org/> родился как облегченная реализация Raku Pod (также известного как pod6), и со временем он превратился в самую полную реализацию этого языка разметки. Пришло время двигать ее дальше.

Podlite: Идеи для модернизации Raku Pod (ака pod6)


L<Podlite|https://podlite.org/> родился как облегченная реализация L<Raku Pod|https://github.com/Raku/old-design-docs/blob/master/S26-documentation.pod> (также известного как pod6), и со временем он превратился в самую полную реализацию этого языка разметки. Podlite включает в себя:

item

Более того, Podlite также поддерживает Диаграммы, автоматическое создание оглавления и L<встроенную поддержку Markdown|https://zahatski.com/2022/11/30/1/podlite-ver-0-4-0-markdown-support>.

Я веду ежедневные журналы в формате Raku Pod уже много лет и использую Podlite ведения блогов.


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


head

Селекторы Podlite в сущности довольно похожи на селекторы CSS. Они помогают идентифицировать и фильтровать конкретные блоки в документах. Каждый шаблон селектора может содержать необязательные источники блоков и имена блоков.


Общий синтаксис следующий:


code

=begin code :allow< R >
<EXTERNAL_SOURCE>
or
[ <EXTERNAL_SOURCE> | ] <BLOCKS_SELECTOR>
=end code

Селекторы можно использовать не только для описания блоков в текущем документе, но и во внешних документах:


Вот еще несколько примеров:


table_head

    _______________________________________         ___________________________________________________


table_row

table

=begin table :nested

 Selector Description
 _______________________________________ ___________________________________________________
 head1, head2, item1 Все блоки head1, head2 и item1 из текущего документа

 file:article.rakudoc | head1, head2 Все блоки C<head1> и C<head2> из файла C<article.rakudoc>.

 file:./includes/*.pod6 | head1, head2 Все блоки C<head1> и C<head2> из pod6 фалов, размещенных в каталоге includes

 doc:Data::Dumper | code Все блоки code из документации к модулю C<Data::Dumper>
 file:/docs/**/*.md | head1 Поиск всех заголовков первого уровня во всех Markdown файлах из каталога "docs" и его дочерних папок.
=end table

Селекторы являются важной частью, которая будет использоваться в других разделах.


=begin code :allow 

 Z<>=toc <SELECTOR>

=end code

Блок C<=toc> используется для создания автоматически созданного оглавления (TOC) в документе. TOC служит в качестве индекса заголовков разделов в документе, и его структура определяется организацией документа.

=begin code
 =toc head1, head2, head3, item1, item2, table
=end code


В этом блоке используется селектор для описания блоков, используемых для построения TOC.


Можно создавать списки таблиц или даже изображений:


=begin code :allow 

=for toc :title('Список таблиц')
table

=for toc :title('Список изображений')
Image, Diagram

=end code

=begin code :allow 

 =include <SELECTOR>

=end code

Блок C<=include> - мощный инструмент для повторного использования конкретных частей документов в исходных файлах проекта. Это особенно удобно при работе с сложными документами, которые требуют включения определенных разделов из разных файлов, сохраняя общий контекст и структуру.

Этот блок отлично подходит для создания книг. Совместно с I<Селекторами> он позволяет включать произвольные блоки из других документов и файлов.

Z<>=picture, C< P<> > - Вставка изображений

Для вставки изображений можно использовать блок C<=picture>:

=begin code :allow 

B<=picture> site-menu.png
This is the menu rendered by the React component

=end code

Может быть отрисовано так: 


Пример inline использования:


=begin code :allow 
 =para In the vast expanse of the cosmos, an intrepid B<P<astronaut|astronaut.png>>
 floats weightlessly above the Earth.

=end code

Чтобы вставить коды эмодзи, вы можете использовать код C<E<>> вместе с двоеточием и коротким именем эмодзи:

=begin code :allow 

 Podlite uses emoji codes to express emotions and actions,
 such as B<E<:thumbsup:>> for approval and B<E<:smile:>> for happiness.

=end code

это отрисовывается как:


formula

Для вставки математических формул используйте блок C<=formula> с inline кодом C<F<>>.