diff --git a/docs/userGuide/plugins/filterTags.mbdf b/docs/userGuide/plugins/tags.mbdf similarity index 97% rename from docs/userGuide/plugins/filterTags.mbdf rename to docs/userGuide/plugins/tags.mbdf index cd1e6335c2..15e057d445 100644 --- a/docs/userGuide/plugins/filterTags.mbdf +++ b/docs/userGuide/plugins/tags.mbdf @@ -1,7 +1,9 @@ -#### `filterTags`: Toggling alternative contents in a page +## Tags You can use tags to selectively filter HTML elements when building a site. +### Toggling alternative contents in a page + Tags are specified by the `tags` attribute, **and can be attached to any HTML element**. During rendering, only elements that match tags specified in the `site.json` files will be rendered.
@@ -81,7 +83,7 @@ Alternatively, you can specify tags to render for a page in the front matter. Tags in `site.json` will be merged with the ones in the front matter, and are processed after front matter tags. See [Hiding Tags](../tweakingThePageStructure.html#hiding-tags) for more information. -#### Advanced Tagging Tips +### Advanced Tagging Tips You can use a `*` in a tag name to match elements more generally. A `*` in a tag will match any number of characters at its position. @@ -103,7 +105,7 @@ All 3 `

`s will be shown.

-#### Hiding Tags +### Hiding Tags Using `-` at the start of a tag hides all tags matching the expression. This is helpful for disabling a group of tags and enabling a particular tag. diff --git a/docs/userGuide/tweakingThePageStructure.md b/docs/userGuide/tweakingThePageStructure.md index 22b4b3a479..ddc5970bf2 100644 --- a/docs/userGuide/tweakingThePageStructure.md +++ b/docs/userGuide/tweakingThePageStructure.md @@ -4,7 +4,7 @@ title: "User Guide: {{ title }}" layout: userGuide - pageNav: 3 + pageNav: 2 @@ -43,7 +43,7 @@
- + {% from "njk/common.njk" import previous_next %} {{ previous_next('usingPlugins', 'reusingContents') }} diff --git a/docs/userGuide/usingPlugins.md b/docs/userGuide/usingPlugins.md index 9bcec0418d..e154828d93 100644 --- a/docs/userGuide/usingPlugins.md +++ b/docs/userGuide/usingPlugins.md @@ -228,7 +228,7 @@ MarkBind has a set of built-in plugins that can be used immediately without inst - + {% from "njk/common.njk" import previous_next %}