WordPress / gutenberg-starter-theme

A simple theme for testing Gutenberg.
GNU General Public License v2.0
685 stars 164 forks source link

Add docs support to the theme #19

Closed pento closed 6 years ago

pento commented 6 years ago

This adds styling and functionality for the document to theme.

There are still things todo, including, but not limited to:

pento commented 6 years ago

The importer currently runs manually. You can do it on your w.org sandbox with this command:

wp eval 'Import_Gutendocs::action_wporg_gutenberg_markdown_import();' --url=https://wordpress.org/gutenberg/

pento commented 6 years ago

The Handbook plugin on w.org automatically adds a table of contents to each page. For example, the "Topics" heading and list following it on this page:

https://wordpress.org/gutenberg/handbook/blocks/applying-styles-with-stylesheets/

I'm not really fussed whether this is styled, or removed.

shaunandrews commented 6 years ago

https://wordpress.org/gutenberg/handbook/blocks/applying-styles-with-stylesheets/

It looks like the code blocks are causing the content area to flow under the sidebar at smaller window widths:

screen shot 2017-10-26 at 9 18 04 am

--

Not really related to the styling, but the sidebar menu is missing a link back to the introduction. And, the link at the bottom of the introduction is for "Blocks," which skips the "Block API" page:

screen shot 2017-10-26 at 9 18 48 am