File tree 4 files changed +38
-5
lines changed
4 files changed +38
-5
lines changed Original file line number Diff line number Diff line change 1
- /// warning | Beta Release
2
- Blocks is currently only available in the Pymdown Extensions beta release. It is a work in progress and API and
3
- syntax are subject to change.
1
+ /// new | 9.10 New Experimental Feature
2
+ Blocks is currently a new, experimental extension type available in Pymdown Extensions that allows for writing a new
3
+ kind of block extension in Python Markdown. With this new addition, we've added a number of new extensions utilizing
4
+ this new extension type. While its intention is to hopefully replace extensions like Details and Tabbed, there are
5
+ currently no immediate plans to deprecate those plugins.
4
6
5
- Any and all feedback regarding these experimental blocks is appreciated. Let us know what you think so we can improve
6
- and make these a stable feature. Please provide feedback here: https://github.com/facelessuser/pymdown-extensions/discussions/1961 .
7
+ Any and all feedback regarding these new, experimental blocks is appreciated. Please provide feedback here:
8
+ https://github.com/facelessuser/pymdown-extensions/discussions/1973 .
7
9
///
Original file line number Diff line number Diff line change @@ -102,6 +102,29 @@ Some content
102
102
///
103
103
```
104
104
105
+ ## Tab IDs
106
+
107
+ By default, tabs generate IDs for each tab using the following template ` __tabbed_<tab_set_number>_<tab_number> ` . If it
108
+ is desired to implement jumping to a specific tab with more intuitive IDs, it may be preferable to generate IDs from
109
+ slugs. To do so, two [ options] ( #global-options ) are provided: ` slugify ` and ` separator ` .
110
+
111
+ /// tip
112
+ Jumping to tabs via IDs may require additional JavaScript to select the targeted tabs.
113
+ ///
114
+
115
+ If ` slugify ` is given a slug function (you can use any that [ ship with Pymdownx Extensions] ( ../../../extras/slugs.md ) ),
116
+ the Tabbed extension will generate IDs from the tab titles just like headers. ` separator ` allows for the specifying of
117
+ the word separator (` - ` is the default).
118
+
119
+ ## Additional Topics
120
+
121
+ As Tab shares the same output and functionality as the [ Tabbed extension] ( ../../tabbed.md ) , you can check out the
122
+ documentation there to learn the following:
123
+
124
+ - [ How to style the tabs?] ( ../../tabbed.md#styling-with-css )
125
+ - [ How to link tab selection on an entire page?] ( ../../tabbed.md#linked-tabs )
126
+ - [ What is the alternate style and how do I style them?] ( ../../tabbed.md#alternate-style )
127
+
105
128
## Global Options
106
129
107
130
Options | Type | Descriptions
Original file line number Diff line number Diff line change 2
2
3
3
# Details
4
4
5
+ /// tip | 9.10 New Approach to Details
6
+ 9.10 has added a new approach to creating details. Checkout the new [ Details extension here] ( ./blocks/plugins/details.md ) !
7
+ ///
8
+
5
9
## Overview
6
10
7
11
Details is an extension that creates collapsible elements that hide their content. It uses the HTML5
Original file line number Diff line number Diff line change 2
2
3
3
# Tabbed
4
4
5
+ /// tip | 9.10 New Approach to Tabs
6
+ 9.10 has added a new approach to creating tabs. Checkout the new [ Tab extension here] ( ./blocks/plugins/tab.md ) !
7
+ ///
8
+
5
9
## Overview
6
10
7
11
/// new | New 7.0
You can’t perform that action at this time.
0 commit comments