Skip to content

Fix pageNav in tweaking the page structure #1127

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
marvinchin merged 11 commits into from
Mar 24, 2020
Merged

Fix pageNav in tweaking the page structure #1127

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
538ff88
add _site to ignore list
Tejas2805 Feb 16, 2020
52e1afa
update highlighted text bg color
Tejas2805 Feb 17, 2020
f3d3f34
Merge branch 'master' of https://github.com/MarkBind/markbind
Tejas2805 Feb 27, 2020
31d0325
Merge branch 'master' of https://github.com/MarkBind/markbind
Tejas2805 Mar 9, 2020
d86bf69
Merge branch 'master' of https://github.com/MarkBind/markbind
Tejas2805 Mar 15, 2020
4830d54
Update headings
Tejas2805 Mar 15, 2020
6733f12
update pageNav
Tejas2805 Mar 15, 2020
c3526f1
Update filterTags.mbdf
Tejas2805 Mar 15, 2020
e985c04
Update filterTags.mbdf
Tejas2805 Mar 16, 2020
e2713ef
rename filterTags to tags
Tejas2805 Mar 23, 2020
2d9534a
Merge branch 'master' of https://github.com/MarkBind/markbind into fi…
Tejas2805 Mar 23, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions docs/userGuide/plugins/filterTags.mbdf → docs/userGuide/plugins/tags.mbdf
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
#### `filterTags`: Toggling alternative contents in a page
## Tags
Copy link
Contributor

@marvinchin marvinchin Mar 21, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we rename the file as well?

Copy link
Contributor Author

@Tejas2805 Tejas2805 Mar 23, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes! Will do.


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.

<div class="indented">
Expand Down Expand Up @@ -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.

Expand All @@ -103,7 +105,7 @@ All 3 `<p>`s will be shown.

</div>

#### 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.

Expand Down
4 changes: 2 additions & 2 deletions docs/userGuide/tweakingThePageStructure.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<frontmatter>
title: "User Guide: {{ title }}"
layout: userGuide
pageNav: 3
pageNav: 2
</frontmatter>

<span id="link" class="d-none">
Expand Down Expand Up @@ -43,7 +43,7 @@

<hr><!-- ======================================================================================================= -->

<include src="plugins/filterTags.mbdf" />
<include src="plugins/tags.mbdf" />

{% from "njk/common.njk" import previous_next %}
{{ previous_next('usingPlugins', 'reusingContents') }}
2 changes: 1 addition & 1 deletion docs/userGuide/usingPlugins.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -228,7 +228,7 @@ MarkBind has a set of built-in plugins that can be used immediately without inst

<include src="plugins/algolia.mbdf" />
<include src="plugins/codeBlockCopyButtons.mbdf" />
<include src="plugins/filterTags.mbdf" />
<include src="plugins/tags.mbdf" />
<include src="plugins/googleAnalytics.mbdf" />

{% from "njk/common.njk" import previous_next %}
Expand Down