Описание
Гутенберг — больше, чем редактор. Сейчас редактор находится в центре внимания, и в конечном итоге проект повлияет на весь опыт публикаций, включая настройку (кастомизации — следующий этап направления).
Сфокусируйся на редактировании
Редактор стремится дать новый опыт работы с страницами и записями для создания разнообразных публикаций, и имеющиеся «блоки» облегчат сегодня работу с шорткодами, произвольным HTML, или «таинственным фаршем» встраиваний (embed). — Мэтт Мулленвег
Одна вещь, которая отличает WordPress от других систем, заключается в том, что он позволяет создавать яркие макеты записей — какие вы можете себе представить, но только если вы знаете HTML и CSS и создаете свою собственную произвольную ВП тему. Подумайте о редакторе — как инструменте, позволяющем писать разнообразные записи и создавать красивые макеты; мы можем превратить WordPress во что-то, что пользователи любят, а не то, что они выбирают, потому что это то, что используют все остальные.
Гутенберг рассматривает редактор как нечто большее, чем поле с контентом, пересматривая макет, который был почти неизменен в течение почти десятилетия. Это позволяет нам целостно проектировать современный опыт редактирования и построить фундамент для грядущих событий.
Вот почему мы смотрим на весь экран редактирования, а не только на поле содержимого:
- Блок объединяет несколько интерфейсов. Если мы добавим, что-то поверх существующего интерфейса будет сложнее добавить, а не удалить его.
- Пересматривая интерфейс, мы можем модернизировать процесс написания, редактирования и публикации, с удобством использования и простотой, принося пользу как новым, так и постоянным пользователям.
- Когда одиночный блок занимает центральное место, он демонстрирует четкий путь для разработчиков, чтобы создавать премиальные блоки, превосходящие как шорткоды, так и виджеты.
- Обдумывание всего интерфейса закладывает прочную основу для следующего шага: полной настройки сайта.
- Взгляд на полноценный экран редактора также дает нам возможность кардинально модернизировать фундамент и предпринять шаги в направлении более гибкого и будущего использования JavaScript, который полностью использует API-интерфейс WordPress REST.
Блоки
Блоки — это объединяющая эволюция того, что сейчас повсеместно в движке: шорткоды, встраивания (embeds), виджеты, форматы записей, произвольные типы записей, настройки тем, мета-боксы и другие элементы форматирования. Они охватывают широту функциональности, на которую способен WordPress, с ясностью последовательного пользовательского опыта.
Представьте себе произвольный блок: “сотрудник“, который автор может перетащить на страницу «Обо мне», и автоматически отображать изображение, имя и биографию. Целая вселенная плагинов, которые расширяют WordPress таким же образом. Простые меню и виджеты. Пользователи, которые могут мгновенно понять и использовать WordPress — и 90% плагинов. Это позволит вам легко создавать красивые записи, такие как в этом примере.
Посмотрите FAQ — для поиска ответов на наиболее распространенные вопросы о проекте.
Совместимость
Записи обратно совместимы, и шорткоды будут работать. Мы постоянно изучаем, как могут быть адаптированы узкоспециализированные метабоксы, и рассматриваем решения, начиная от плагина отключения Gutenberg, чтобы автоматически определять, загружать ли Gutenberg или нет. Хотя мы хотим убедиться, что новый опыт редактирования от написания до публикации является удобным для пользователя, мы стремимся найти хорошее решение для узкоспециализированных существующих сайтов.
Этапы Гутенберга
Гутенберг имеет три запланированных этапа. Первый, нацеленный на включение в WordPress 5.0, фокусируется на опыте редактирования записей и реализации блоков. На этом начальном этапе основное внимание уделяется подходу, основанному на содержимом. Использование блоков, как описано выше, позволяет сосредоточиться на том, как будет выглядеть ваш контент без отвлечения на другие настройки конфигурации. Это в конечном итоге поможет всем пользователям представить свой контент привлекательным, непосредственным и визуальным.
Эти основополагающие элементы проложат путь для второго и третьего этапов, запланированных на следующий год, выйти за рамки записей в шаблоны страниц и, в конечном счете, полностью настроить сайт.
Gutenberg — это большие перемены, и будет существовать путь обеспечения того, чтобы существующие функциональные возможности (например, шорткоды и мета-боксы) продолжали работать, позволяя разработчикам эффективно использовать время и пути для перехода. В итоге, он откроет новые возможности для разработчиков плагинов и тем, чтобы лучше обслуживать пользователей с помощью более привлекательного и визуального опыта, который использует набор инструментов, поддерживаемый ядром.
Авторы
Гутенберг построен многими участниками и волонтерами. Пожалуйста, просмотрите полный список участников на CONTRIBUTORS.md.
Блоки
Этот плагин предоставляет 11 блоков.
- core/block
- core/calendar
- core/tag-cloud
- core/rss
- core/legacy-widget
- core/categories
- core/latest-comments
- core/archives
- core/shortcode
- core/latest-posts
- core/search
Часто задаваемые вопросы
- Как я могу отправить отзыв или получить помощь с ошибкой?
-
Мы будем рады услышать ваши отчеты об ошибках, предложения по функционалу и любые другие отзывы! Перейдите к странице вопросов GitHub, чтобы найти существующие вопросы или открыть новую тему. Хотя мы попытаемся сортировать проблемы, описанные здесь на форуме плагинов, вы получите более быстрый ответ (и уменьшите дублирование), оставив все в репозитории GitHub.
- Как я могу внести свой вклад?
-
Мы называем этот редактор проектом «Гутенберг», потому что это большое начинание.
Мы работаем над этим каждый день на GitHub, и мы будем рады если вы поможете нам в его создании.
Чтобы получить обратную связь — проще всего присоединиться к нам на нашем Slack канале,#core-editor.Смотри также CONTRIBUTING.md.
- Где я могу больше узнать о Гутенберге?
-
- Gutenberg, или корабль Тесея, с примерами того, что Гутенберг мог бы сделать в будущем
- Технический обзор редактора
- Принципы дизайна и лучшие практики проектирования блоков
- WP Post Grammar парсер
- Обновления развития на make.wordpress.org
- Документация: создание блоков, справка и руководства
- Другие часто задаваемые вопросы
Отзывы
Участники и разработчики
«Gutenberg» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники
«Gutenberg» переведён на 44 языка. Благодарим переводчиков за их работу.
Перевести «Gutenberg» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
Features
- A11y: Support Navigation and Edit modes to ease navigating between blocks.
- Support text alignments in Table block columns.
- Support changing the separator block color.
Enhancements
- Improvements to the BlockPreview component:
- Support previewing a multiple blocks (a template).
- Unify BlockPreview and BlockPreviewContent into a unique component.
- Hide block appenders.
- Expose the component in the block-editor module.
- Scale the preview content according to the width of the preview container.
- Improvements to the Modal component design:
- Increase the padding of the Modal component.
- Correct the position of the close button.
- Use classnames instead of inline styles for text alignments in:
- Add a purple color option to the default color palette.
- A11y: Visible focus and active styles for Windows high contrast mode.
- Improve the design of the inline image controls in the Gallery block.
- I18n: Align the Read more string with WordPress Core.
- Removes the word-break :break-all CSS rule from the table cells.
- Update the Notice dismiss button to match other Gutenberg UI (color and icon).
- Modifies the shortcut hierarchy in the keyboard shortcuts modal.
- Remove edit gallery toolbar button.
- Add the possibility to disable document settings panels registered by plugins.
- ESLint plugin: Enable
wpglobal by default in therecommendedconfig.
Experiments
- Add a settings page to the plugin to enable/disable experimental features.
- Add padding when interacting with nested blocks to ease parent block selections.
- Widgets Screen:
- Prevent the block toolbar from overlapping the widget area header.
- Add the BlockEditorKeyboardShortcuts component.
- Fixed block paddings.
New APIs
- Support Entities Local Edits in the Core Data Module.
- Support autosaving entities in the Core Data Module.
- Add support for disabled dropdown items in SelectControl.
- Add onFocusOutside prop as a replacement to Popover onClickOutside.
- Stop using unstable props on DropdownMenu.
Bug Fixes
- Prevent tooltips from appearing on mouse down.
- Avoid passing event object to save button onSave prop.
- Prevent image captions loss when editing a Gallery block.
- Rerender FormtTokenField component when the suggestions prop changes.
- Handle scalar return types values in useSelect.
- Fix php notice that can be triggered while using the Search block.
- Fix the Resolve Block Modal columns sizes.
- Fix duplicate content when pasting text into newly focused RichText.
- Fix Table block cell selection when clicking on the edge of the cells.
- Prevent the CSS reset from applying to the meta boxes.
- Fix misaligned Block toolbars on floated blocks.
- Fix the Notice component close button alignment and height.
- Link to the full size images in the Gallery block.
- Avoid leaking CSS transforms when disabling block animations.
- A11y: Avoid focusing the PostTitle component when switching between code and visual editor.
- A11y: Add a confirmation step to enable the Custom Fields option.
- Disable block insertion buttons and prevent moving blocks depending on the contextual restrictions (template locking and default block availability).
- Fix Block manager not honoring the allowed_block_types hook.
- Keep the Image block alt and caption attributes while uploading a new image.
- Don’t render drop zone below the default block appender.
- Prevent horizontal arrow navigation errors.
- Fix shifting menu items on DropdownMenu.
- Make API Fetch refresh nonces as soon as they expired.
Various
- Github actions:
- Automatically assign issues to PR authors.
- Automatically assign the First-time Contributor label.
- Avoid unguarded getRangeAt usage and add eslint rule.
- Make the e2e transforms tests more stable.
- ESLint no-unused-vars-before-return rule: Exempt destructuring only if to multiple properties.
- Output an informational message for deprecations when no version provided.
- Refactor registry selectors to allow calling them from other regular selectors.
- Bail early in the deactivatePlugin e2e test utility if plugin is already inactive.
- Fix the CheckboxControl styles in a WordPress agnostic context.
- Move the auto-draft status and default title handling to the server.
- Code quality tweaks to the Table block e2e tests.
- Fix JSDocs errors across the entire repository.
- Upgrade Lerna to the latest version (3.16.4).
- Upgrade Puppeteer to the latest version (1.19.0).
- Upgrade ESLint to the latest version (6.1.0).
- Run npm audit fix to fix dependency vulnerabilities.
- Audit and fix all missing or obsolete package dependencies.
- Fix issue with jest caching of block.json files.
- Add eslint-plugin-jsdoc lint rule for better JSDoc linting.
- Fix intermittent RichText e2e test failures.
- Replace the react-click-outside dependency usage with our own Higher-order component withFocusOutside.
- Improve the usage of eslint-disable directives.
- Migrate the Github Actions to the new YAML syntax.
Documentation
- Enhance the components Design Documentation and guidelines:
- DateTime component.
- Spinner component.
- ClipboardButton component.
- Add section about adding new dependencies to WordPress packages.
- Add Figma ressources to the Design documentation.
- Document URL inputs reusable components.
- Typos and tweaks: 1, 2, 3.
Mobile
- Refactor BlockToolbar out of BlockList.
- Fix toolbar bottom inset for iPhone X devices.