Что такое 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 ⭐️

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