Podlite v1.0 - легковесный блок-ориентированный язык разметки для организации знаний

Что такое Podlite?

Podlite — это легковесный блок-ориентированный язык разметки, ориентированный на гибкость и простоту использования.

Не привязанный к конкретной предметной области, языку программирования или концепции, Podlite является универсальным языком разметки.
Кроме того, поддержка разметки Markdown как стандартного блока добавляет удобство и позволяет использовать знакомый синтаксис для форматирования текста.
Он идеален для документации, учебных материалов, ведения блогов и многого другого для организации знаний.
Одной из ключевых особенностей Podlite является его расширяемость. Это позволяет определять уникальные блоки и расширять функциональность языка в соответствии с требованиями вашего проекта.
Спецификация Podlite опубликована под лицензией Artistic License 2.0.

Ключевые особенности Podlite

Структура на основе блоков: В основе Podlite лежит концепция "блоков", которые являются фундаментальными единицами любого документа. Эти блоки могут иметь атрибуты.
Богатые возможности определения связей: Podlite позволяет связывать блоки, термины, определения различными типами отношений, улучшая взаимосвязь и навигацию ваших документов.
Поддержка формул и Markdown: Независимо от того, нужно ли вам вставить сложные математические формулы или вы предпочитаете простоту Markdown, Podlite подходит для вас.
Расширяемость и настраиваемость: Расширьте Podlite с помощью пользовательских блоков и встроенных кодов, адаптируя язык к вашим конкретным потребностям.

Заметки о выпуске Podlite v1.0

В данном релизе Podlite представлен ряд новых функций, разработанных для повышения гибкости и удобства использования языка разметки:

Настройка и расширяемость

Рефакторинг пользовательских блоков: Переработаны определения пользовательских блоков.
Расширение встроенной разметки: M<> теперь расширяет возможности inline разметки.

Обработка и управление данными

Поддержка Markdown: Блок =markdown теперь является стандартным блоком. Всвязи с этим добавлен новый режим для парсера.
Спецификация MIME-типа: Добавлен атрибут :mime-type для блоков =include и =data, облегчающий обработку различных типов данных.
Дополнительные схемы: Реализована схема data: для использования в блоках =picture и =table, упрощая встраивание данных.
Встраивание бинарных данных: Поддержка прямого встраивания бинарных данных в документы с атрибутами :filename и :encoding в блоках =data.
Таблицы CSV: Возможность отображения таблиц непосредственно из файлов CSV с улучшенным блоком =table.

Структурирование содержимого и навигация

Селекторы: Введены селекторы для группировки содержимого документов.
Автоматическое оглавление: Улучшенный блок =toc для генерации оглавлений в документе.
Включение внешнего контента: Новый блок =include для включения внешних файлов и документов.
Продвинутое форматирование таблиц: Новые блоки =row и =cell с атрибутами :header, :rowspan и :colspan для сложных таблиц.
Дополнительные атрибуты для связывания: Добавление атрибутов :id, :caption и :lang для обогащения метаданных документов.
Контекстные обратные ссылки: W<> для создания контекстных обратных ссылок, улучшая навигацию по документам и расширяя возможности ссылок.
Сворачивание содержимого: Новый атрибут :folded для переключения видимости содержимого в блоках и :folded-levels для управления вложенной видимостью в блоках оглавления (TOC).

Улучшения представления документов

Блоки уведомлений: Введены блоки уведомлений с атрибутом :notify, повышающие интерактивность в документах.
Списки задач: Введение списков задач с блоком =item и атрибутом :checked для эффективного управления списками дел.
Выделение ошибок: Введено O<> для выделения и маркировки ошибок, что полезно в образовательных и рецензируемых настройках.
Позиционирование текста: Новые атрибуты J<> для выравнивания и H<> для горизонтального позиционирования текста.
Эмодзи: Добавлена поддержка эмодзи с E<>, обогащая выразительность документов.
Вставки изображений: Новые функции в блоке =picture и P<> для новых возможностей использования изображений.
Математические формулы: Усиленная поддержка сложных математических формул с =formula и F<>.

Устаревшие/удаленные функции

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

P<toc:> из-за блока =toc,
P<man:>, P<doc:> из-за блока =include,
Атрибут :margin, директива =encoding, тип блоков Декларативный были удалены из-за избыточности.
Контекстные псевдонимы, директива =finish и маркеры в комментариях, P<> - ссылки размещения, атрибут :formatted, атрибут :like были удалены из-за избыточности и улучшений в других областях.

Саммари релиза

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

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

Отзывы и вклад

Отзывы приветствуются и могут быть предоставлены через Обсуждения на Github. Этот вклад жизненно важен для продолжающегося развития и улучшения Podlite.

Спасибо!

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

Спецификация: https://github.com/podlite/podlite-specs, [в формате HTML]
Веб-сайт: https://podlite.org
Online версия: https://pod6.in
Github: https://github.com/podlite ⭐️

Оставайтесь на связи, чтобы быть в курсе новых обновлений и счастливого документирования!