Плагин Gutenberg WordPress для представления Contents Block

То, что когда-то считалось территорией плагинов, теперь стало реальностью в рамках проекта Gutenberg. Вчера команда объединила пулреквест для блока Table of Contents (TOC) с кодовой базой плагина. Это был вклад разработчика Zebulan Stanphill, начатый почти год назад.

Блок TOC может показаться немного нишевым. Однако, очевидно, в этом есть необходимость. Есть по крайней мере два автономных плагина для работы с этой функцией, и несколько плагинов библиотеки блоков охватывают ее. На прошлой неделе один читатель спросил о таком решении . Вскоре плагин Gutenberg и, в конечном итоге, WordPress будут покрыты его и другими.

Блок в настоящее время недоступен в плагине на WordPress.org. Официально он еще не отправлен. Чтобы протестировать его, пользователям нужно будет либо клонировать репозиторий Gutenberg GitHub, либо получить ZIP-файл ночной бета-версии . Он должен приземлиться в Gutenberg 10.1 в ближайшие недели для тех, кто хочет подождать.

Включение этих более нишевых блоков – хорошее направление для проекта – также возможен блок сносок . Хотя может показаться, что разработчикам плагинов наступать на пятки, WordPress нужно расширяться. Сторонним разработчикам достаточно места для создания других блоков. Опыт ухудшается, когда пользователям приходится перебирать множество плагинов, чтобы найти что-то важное для своего процесса написания. Существуют ограничения на то, какие блоки в конечном итоге должны быть включены в платформу. Однако WordPress публикует программное обеспечение. Расширенные функции письма, такие как оглавление и сноски, прочно входят в настройку по умолчанию.

Блок оглавления

Этот блок немного отличается от других блоков, к которым привыкли пользователи. TOC – это список всех заголовков в документе. В случае WordPress и веб-страниц в целом оглавление ссылается на эти заголовки. Это позволяет пользователям перемещаться по странице. Блок зависит от других блоков в контенте, это немного новая концепция для редактора блоков.

При первом добавлении блока на пустую страницу будет отображаться вспомогательное сообщение.

Пользователи должны начать добавлять блоки заголовков в свои сообщения, чтобы использовать блок оглавления. После добавления каждый заголовок отображается как элемент списка. Блок также правильно размещает элементы списка для подзаголовков – например, H3 входит в подсписок под H2.

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

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

Чтобы добавить привязку, пользователи должны щелкнуть каждый заголовок и перейти к панели параметров блока. На вкладке «Дополнительно» введите уникальный идентификатор. Проще всего назвать это по самому тексту. Блок заголовка с «Новым миром» получает привязку a-new-world. Это также помогает, когда другие делают глубокие ссылки на сообщения, создавая более красивые URL-адреса, например yoursite.com/blog/post-name/#a-new-world.

Блок оглавления не имеет никаких настроек дизайна. Если пользователям нужно изменить цвета или другие элементы, связанные с дизайном, лучше всего обернуть это в другой блок, например Group или Cover.

Если добавить заголовок для блока Group или перед блоком TOC, он будет добавлен в список. Лучше всего использовать блок абзаца как искусственный заголовок и изменить размер шрифта.

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