diff --git a/docs/en/reference/default-theme-layout.md b/docs/en/reference/default-theme-layout.md index 246e20fa..c348dd56 100644 --- a/docs/en/reference/default-theme-layout.md +++ b/docs/en/reference/default-theme-layout.md @@ -1,6 +1,6 @@ # Layout -You may choose the page layout by setting `layout` option to the page [frontmatter](./frontmatter-config). There are 3 layout options, `doc`, `page`, and `home`. If nothing is specified, then the page is treated as `doc` page. +You may choose the page layout by setting the `layout` option to the page [frontmatter](./frontmatter-config). There are 3 layout options, `doc`, `page`, and `home`. If nothing is specified, then the page is treated as `doc` page. ```yaml --- @@ -10,11 +10,11 @@ layout: doc ## Doc Layout -Option `doc` is the default layout and it styles the whole Markdown content into "documentation" look. It works by wrapping whole content within `vp-doc` css class, and applying styles to elements underneath it. +Option `doc` is the default layout and it styles the whole Markdown content into a "documentation" look. It works by wrapping whole content within `vp-doc` css class, and applying styles to elements underneath it. Almost all generic elements such as `p`, or `h2` get special styling. Therefore, keep in mind that if you add any custom HTML inside a Markdown content, those will get affected by those styles as well. -It also provides documentation specific features listed below. These features are only enabled in this layout. +It also provides some documentation-specific features, which are listed below. These features are only enabled in this layout: - Edit Link - Prev Next Link @@ -23,19 +23,19 @@ It also provides documentation specific features listed below. These features ar ## Page Layout -Option `page` is treated as "blank page". The Markdown will still be parsed, and all of the [Markdown Extensions](../guide/markdown) work as same as `doc` layout, but it wouldn't get any default stylings. +Option `page` is treated as a "blank page". The Markdown will still be parsed, and all of the [Markdown Extensions](../guide/markdown) work as same as with the `doc` layout, but it wouldn't get any default stylings. -The page layout will let you style everything by you without VitePress theme affecting the markup. This is useful when you want to create your own custom page. +The page layout will let you style everything yourself without the VitePress theme affecting the markup. This is useful when you want to create your own custom page. -Note that even in this layout, sidebar will still show up if the page has a matching sidebar config. +Note that even in this layout, the sidebar will still show up if the page has a matching sidebar config. ## Home Layout -Option `home` will generate templated "Homepage". In this layout, you can set extra options such as `hero` and `features` to customize the content further. Please visit [Default Theme: Home Page](./default-theme-home-page) for more details. +Option `home` will generate a "Homepage" template. In this layout, you can set extra options such as `hero` and `features` to customize the content further. Please visit the [Default Theme: Home Page](./default-theme-home-page) page for more details. ## No Layout -If you don't want any layout, you can pass `layout: false` through frontmatter. This option is helpful if you want a fully-customizable landing page (without any sidebar, navbar, or footer by default). +If you don't want any layout, you can pass `layout: false` through frontmatter. This option is helpful if you want a fully customizable landing page (without any sidebar, navbar, or footer by default). ## Custom Layout