| @@ -1,76 +1,48 @@ | ||
| 1 | 1 | === Gutenberg === |
| 2 | 2 | Contributors: matveb, joen, karmatosed |
| 3 | -Tested up to: 7.0 | |
| 4 | -Stable tag: 23.5.1 | |
| 3 | +Requires at least: 5.5.0 | |
| 4 | +Tested up to: 5.6 | |
| 5 | +Requires PHP: 5.6 | |
| 6 | +Stable tag: 9.7.1 | |
| 5 | 7 | License: GPLv2 or later |
| 6 | 8 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 7 | 9 | |
| 8 | -The Gutenberg plugin adds editing, customization, and site building to WordPress. Use it to test beta features before their official release. | |
| 10 | +The Gutenberg plugin provides editing, customization, and site building features to WordPress. This beta plugin allows you to test bleeding-edge features before they land in future WordPress releases. | |
| 9 | 11 | |
| 10 | 12 | == Description == |
| 11 | 13 | |
| 12 | -“Gutenberg” is a codename for a whole new paradigm for creating with WordPress, that aims to revolutionize the entire publishing experience as much as <a href="https://en.wikipedia.org/wiki/Johannes_Gutenberg">Johannes Gutenberg</a> did the printed word. The project is <a href="https://wordpress.org/about/roadmap/">following a four-phase process</a> that will touch major pieces of WordPress — Editing, Customization, Collaboration, and Multilingual. | |
| 14 | +"Gutenberg" is a codename for a whole new paradigm in WordPress site building and publishing, that aims to revolutionize the entire publishing experience as much as Gutenberg did the printed word. Right now, the project is in the first phase of a four-phase process that will touch every piece of WordPress -- Editing, Customization, Collaboration, and Multilingual -- and is focused on a new editing experience, the block editor. | |
| 13 | 15 | |
| 14 | -Following the introduction of post block editing in December 2018, Gutenberg later introduced full site editing (FSE) in 2021, <a href="https://wordpress.org/news/2022/01/josephine/">which shipped with WordPress 5.9 in early 2022</a>. | |
| 16 | +The block editor introduces a modular approach to pages and posts: each piece of content in the editor, from a paragraph to an image gallery to a headline, is its own block. And just like physical blocks, WordPress blocks can added, arranged, and rearranged, allowing WordPress users to create media-rich pages in a visually intuitive way -- and without work-arounds like shortcodes or custom HTML. | |
| 15 | 17 | |
| 16 | -### What Does Gutenberg Do? | |
| 18 | +The block editor first became available in December 2018, and we're still hard at work refining the experience, creating more and better blocks, and laying the groundwork for the next three phases of work. The Gutenberg plugin gives you the latest version of the block editor so you can join us in testing bleeding-edge features, start playing with blocks, and maybe get inspired to build your own. | |
| 17 | 19 | |
| 18 | -Gutenberg is WordPress's “block editor”, and introduces a modular approach to modifying your entire site. Edit individual content blocks on posts or pages. Add and adjust widgets. Even design your site headers, footers, and navigation with full site editing support. | |
| 19 | - | |
| 20 | -Each piece of content in the editor, from a paragraph to an image gallery to a headline, is its own block. And just like physical blocks, WordPress blocks can be added, arranged, and rearranged, allowing users to create media-rich content and site layouts in a visually intuitive way — and without workarounds like shortcodes or custom HTML and PHP. | |
| 21 | - | |
| 22 | -We’re always hard at work refining the experience, creating more and better blocks, and laying the groundwork for future phases of work. Each WordPress release includes stable features from the Gutenberg plugin, so you don’t need to install the plugin to benefit from the work being done here. | |
| 23 | - | |
| 24 | -### Early Access | |
| 25 | - | |
| 26 | -Are you a tech-savvy early adopter who likes testing bleeding-edge and experimental features, and isn’t afraid to tinker with features that are still in active development? If so, this beta plugin gives you access to the latest Gutenberg features for block and full site editing, as well as a peek into what’s to come. | |
| 27 | - | |
| 28 | -### Contributors Wanted | |
| 29 | - | |
| 30 | -For the adventurous and tech-savvy, the Gutenberg plugin gives you the latest and greatest feature set, so you can join us in testing and developing bleeding-edge features, playing around with blocks, and maybe <a href="https://developer.wordpress.org/block-editor/contributors/">get inspired to contribute</a> or <a href="https://developer.wordpress.org/block-editor/how-to-guides/block-tutorial/">build your own blocks</a>. | |
| 31 | - | |
| 32 | 20 | ### Discover More |
| 33 | 21 | |
| 34 | -- **User Documentation:** Review the <a href="https://wordpress.org/documentation/article/wordpress-block-editor/">WordPress Editor documentation</a> for detailed instructions on using the editor as an author to create posts, pages, and more. | |
| 22 | +- **User Documentation:** See the <a href="https://wordpress.org/support/article/wordpress-editor/">WordPress Editor documentation</a> for detailed docs on using the editor as an author creating posts and pages. | |
| 35 | 23 | |
| 36 | -- **Developer Documentation:** Explore the <a href="https://developer.wordpress.org/block-editor/">Developer Documentation</a> for extensive tutorials, documentation, and API references on how to extend the editor. | |
| 24 | +- **Developer Documentation:** Extending and customizing is at the heart of the WordPress platform, see the <a href="https://developer.wordpress.org/block-editor/developers/">Developer Documentation</a> for extensive tutorials, documentation, and API reference on how to extend the editor. | |
| 37 | 25 | |
| 38 | 26 | - **Contributors:** Gutenberg is an open-source project and welcomes all contributors from code to design, from documentation to triage. See the <a href="https://developer.wordpress.org/block-editor/contributors/">Contributor's Handbook</a> for all the details on how you can help. |
| 39 | 27 | |
| 40 | -The development hub for the Gutenberg project can be found at <a href="https://github.com/wordpress/gutenberg">https://github.com/wordpress/gutenberg</a>. Discussions for the project are on the <a href="https://make.wordpress.org/core/">Make Core Blog</a> and in the #core-editor channel in Slack, <a href="https://make.wordpress.org/core/tag/core-editor-agenda/">including weekly meetings</a>. If you don’t have a Slack account, you can <a href="https://make.wordpress.org/chat/">sign up here</a>. | |
| 28 | +The development hub for the Gutenberg project is on Github at: <a href="https://github.com/wordpress/gutenberg/"> https://github.com/wordpress/gutenberg</a> | |
| 41 | 29 | |
| 30 | +Discussion for the project is on <a href="https://make.wordpress.org/core/">Make Blog</a> and the `#core-editor` channel in Slack, <a href="https://make.wordpress.org/chat/">signup information</a>. | |
| 31 | + | |
| 42 | 32 | == Frequently Asked Questions == |
| 43 | 33 | |
| 44 | 34 | = How can I send feedback or get help with a bug? = |
| 45 | 35 | |
| 46 | -The best place to report bugs, feature suggestions, or any other feedback is at <a href="https://github.com/WordPress/gutenberg/issues">the Gutenberg GitHub issues page</a>. Before submitting a new issue, please search the existing issues to check if someone else has reported the same feedback. | |
| 36 | +We'd love to hear your bug reports, feature suggestions and any other feedback! Please head over to <a href="https://github.com/WordPress/gutenberg/issues">the GitHub issues page</a> to search for existing issues or open a new one. While we'll try to triage issues reported here on the plugin forum, you'll get a faster response (and reduce duplication of effort) by keeping everything centralized in the GitHub repository. | |
| 47 | 37 | |
| 48 | -While we try to triage issues reported here on the plugin forum, you’ll get a faster response (and reduce duplication of effort) by keeping feedback centralized in GitHub. | |
| 38 | += What's Next for the Project? = | |
| 49 | 39 | |
| 50 | -= Where can I report security bugs? = | |
| 40 | +The four phases of the project are Editing, Customization, Collaboration, and Multilingual. You can hear more about the project and phases from Matt in his State of the Word talks for <a href="https://ma.tt/2019/11/state-of-the-word-2019/">2019</a> and <a href="https://ma.tt/2018/12/state-of-the-word-2018/">2018</a>. Additionally you can follow updates in the <a href="https://make.wordpress.org/core/?s=gutenberg">Make WordPress Core blog</a>. | |
| 51 | 41 | |
| 52 | -The Gutenberg team and WordPress community take security bugs seriously. We appreciate your efforts to responsibly disclose your findings, and will make every effort to acknowledge your contributions. | |
| 53 | 42 | |
| 54 | -To report a security issue, please visit the [WordPress HackerOne](https://hackerone.com/wordpress) program. | |
| 43 | += Where Can I Read More About Gutenberg? = | |
| 55 | 44 | |
| 56 | -= Do I have to use the Gutenberg plugin to get access to these features? = | |
| 57 | - | |
| 58 | -Not necessarily. Each version of WordPress after 5.0 has included features from the Gutenberg plugin, which are known collectively as the <a href="https://wordpress.org/documentation/article/wordpress-block-editor/">WordPress Editor</a>. You are likely already benefiting from stable features! | |
| 59 | - | |
| 60 | -But if you want cutting edge beta features, including more experimental items, you will need to use the plugin. You can <a href="https://wordpress.org/news/2021/04/become-an-early-adopter-with-the-gutenberg-plugin/">read more here</a> to help decide whether the plugin is right for you. | |
| 61 | - | |
| 62 | -= Where can I see which Gutenberg plugin versions are included in each WordPress release? = | |
| 63 | - | |
| 64 | -View the <a href="https://developer.wordpress.org/block-editor/principles/versions-in-wordpress/">Versions in WordPress</a> document to get a table showing which Gutenberg plugin version is included in each WordPress release. | |
| 65 | - | |
| 66 | -= What’s next for the project? = | |
| 67 | - | |
| 68 | -The four phases of the project are Editing, Customization, Collaboration, and Multilingual. You can hear more about the project and phases from Matt in his State of the Word talks for <a href="https://ma.tt/2021/12/state-of-the-word-in-person/">2021</a>, <a href="https://ma.tt/2020/12/sotw-2020/">2020</a>, <a href="https://ma.tt/2019/11/state-of-the-word-2019/">2019</a>, and <a href="https://ma.tt/2018/12/state-of-the-word-2018/">2018</a>. Additionally, you can follow the <a href="https://make.wordpress.org/core/tag/gutenberg-new/">biweekly release notes</a> and <a href="https://make.wordpress.org/core/tag/gutenberg-next/">monthly project plan updates</a> on the <a href="https://make.wordpress.org/core/?s=gutenberg">Make WordPress Core blog</a> for more up to date information about what’s happening now. | |
| 69 | - | |
| 70 | - | |
| 71 | -= Where can I read more about Gutenberg? = | |
| 72 | - | |
| 73 | 45 | - <a href="http://matiasventura.com/post/gutenberg-or-the-ship-of-theseus/">Gutenberg, or the Ship of Theseus</a>, with examples of what Gutenberg might do in the future |
| 74 | 46 | - <a href="https://make.wordpress.org/core/2017/01/17/editor-technical-overview/">Editor Technical Overview</a> |
| 75 | 47 | - <a href="https://wordpress.org/gutenberg/handbook/reference/design-principles/">Design Principles and block design best practices</a> |
| 76 | 48 | - <a href="https://github.com/Automattic/wp-post-grammar">WP Post Grammar Parser</a> |
| @@ -77,7 +49,12 @@ | ||
| 77 | 49 | - <a href="https://make.wordpress.org/core/tag/gutenberg/">Development updates on make.wordpress.org</a> |
| 78 | 50 | - <a href="https://wordpress.org/gutenberg/handbook/">Documentation: Creating Blocks, Reference, and Guidelines</a> |
| 79 | 51 | - <a href="https://wordpress.org/gutenberg/handbook/reference/faq/">Additional frequently asked questions</a> |
| 80 | 52 | |
| 53 | += Where can I see which Gutenberg plugin versions are included in each WordPress release? = | |
| 54 | + | |
| 55 | +View <a href="https://developer.wordpress.org/block-editor/principles/versions-in-wordpress/">the Versions in WordPress</a> document to get a table showing which Gutenberg plugin version is included in each WordPress release. | |
| 56 | + | |
| 57 | + | |
| 81 | 58 | == Changelog == |
| 82 | 59 | |
| 83 | -To read the changelog for the latest Gutenberg release, please navigate to the <a href="https://github.com/WordPress/gutenberg/releases/latest">release page</a>. | |
| 60 | +To read the changelog for Gutenberg 9.7.2, please navigate to the <a href="https://github.com/WordPress/gutenberg/releases/tag/v9.7.2">release page</a>. | |
