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.

Спасибо!

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

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