diff --git a/docs/configuration.md b/docs/configuration.md
index 239cde998551ec809869be71c175934a870e0939..5f799b856a3752a120762c24752772c12ead4492 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -69,6 +69,10 @@ search:
```
## Mermaid Diagrams
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
The minimum configuration requires the key for `version` ([from jsDelivr](https://cdn.jsdelivr.net/npm/mermaid/)) in `_config.yml`:
@@ -104,6 +108,10 @@ heading_anchors: true
```
## External navigation links
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
External links can be added to the navigation through the `nav_external_links` option.
See [Navigation Structure]({% link docs/navigation-structure.md %}#external-navigation-links) for more details.
@@ -165,6 +173,10 @@ jtd.addEvent(toggleDarkMode, 'click', function(){
See [Customization]({% link docs/customization.md %}) for more information.
## Callouts
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
To use this feature, you need to configure a `color` and (optionally) `title` for each kind of callout you want to use, e.g.:
@@ -231,6 +243,12 @@ ga_tracking: UA-2709176-10
ga_tracking_anonymize_ip: true # Use GDPR compliant Google Analytics settings (true/nil by default)
```
+### Multiple IDs
+{: .d-inline-block .no_toc }
+
+New (v0.4.0)
+{: .label .label-green }
+
This theme supports multiple comma-separated tracking IDs. This helps seamlessly transition UA properties to GA4 properties by tracking both for a while.
```yaml
@@ -267,7 +285,7 @@ just_the_docs:
# nav_exclude: true
# Fold the collection in the navigation
# Supports true or false (default)
- # nav_fold: true
+ # nav_fold: true # note: this option is new in v0.4
# Exclude the collection from the search
# Supports true or false (default)
# search_exclude: true
diff --git a/docs/customization.md b/docs/customization.md
index d1a37ed673ffba0545e1fef9ade17133fc195435..9d8ddfc0b295e0b5247f3344ad9ea409cb008274 100644
--- a/docs/customization.md
+++ b/docs/customization.md
@@ -16,10 +16,6 @@ nav_order: 6
---
## Color schemes
-{: .d-inline-block }
-
-New
-{: .label .label-green }
Just the Docs supports two color schemes: light (default), and dark.
@@ -166,6 +162,10 @@ To do this, create an `_includes` directory and make a copy of the specific file
Just the Docs provides the following custom includes files:
### Custom TOC Heading
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
`_includes/toc_heading_custom.html`
@@ -202,12 +202,20 @@ The `<head>` tag automatically includes a link to an existing favicon if you set
Content added to this file appears at the top of every page's main content between the site search and auxiliary links if they are enabled. If `search_enabled` were set to false and `aux_links` were removed, the content of `header_custom.html` would occupy the space at the top of every page.
### Custom Nav Footer
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
`_includes/nav_footer_custom.html`
Any content added to this file will appear at the bottom left of the page below the site's navigation. By default an attribution to Just the Docs is displayed which reads, `This site uses Just the Docs, a documentation theme for Jekyll.`.
### Custom Search Placeholder
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
`_includes/search_placeholder_custom.html`
diff --git a/docs/navigation-structure.md b/docs/navigation-structure.md
index f9d8ea38ce7629b259ffdeaeac14ed1262de1e38..dc19c792af4b76ba83d9f631c9573f3b81f30469 100644
--- a/docs/navigation-structure.md
+++ b/docs/navigation-structure.md
@@ -145,6 +145,10 @@ nav_order: 2
The Buttons page appears as a child of UI Components and appears second in the UI Components section.
### Ordering child pages
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
You can optionally add the following to the YAML front matter to reverse the default sort order of child pages:
diff --git a/docs/search.md b/docs/search.md
index 3ed6ebbfcefa875f8af61c4e2859b7ca5adc674b..78175f3ccab5dcf4c36b3c847d01d9b5f7ec268a 100644
--- a/docs/search.md
+++ b/docs/search.md
@@ -127,6 +127,13 @@ This command creates the `assets/js/zzzz-search-data.json` file that Jekyll uses
Alternatively, you can create the file manually with [this content]({{ site.github.repository_url }}/blob/main/assets/js/zzzz-search-data.json).
## Custom content for search index
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
+
+Advanced
+{: .label .label-yellow }
By default, the search feature indexes a page's `.content`, `.title`, and *some* headers within the `.content`. Other data (e.g. front matter, files in `_data` and `assets`) is not indexed. Users can customize what is indexed.
diff --git a/docs/ui-components/callouts.md b/docs/ui-components/callouts.md
index b53b8796ab1f98533e9569392efbb8b5ac783509..e0ea86f270b599e8c9c4ae6163499932933510c0 100644
--- a/docs/ui-components/callouts.md
+++ b/docs/ui-components/callouts.md
@@ -6,6 +6,10 @@ nav_order: 7
---
# Callouts
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
Markdown does not include support for callouts. However, you can style text as a callout using a Markdown extension supported by kramdown: [*block IALs*](https://kramdown.gettalong.org/quickref.html#block-attributes).
diff --git a/docs/ui-components/code.md b/docs/ui-components/code.md
index a4092f1ae44576759597a2d9d6faaa2fa3819141..44d3efebc8a3ec28f4f66f470021ec4a724bf46b 100644
--- a/docs/ui-components/code.md
+++ b/docs/ui-components/code.md
@@ -90,6 +90,10 @@ To demonstrate front end code, sometimes it's useful to show a rendered example
---
## Mermaid diagram code blocks
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
[Mermaid](https://mermaid-js.github.io/mermaid/) allows you to add diagrams and visualizations using Markdown code blocks. **It is disabled by default**. However, you can turn on support for mermaid by adding a `mermaid` key to your `_config.yml`.
@@ -145,6 +149,10 @@ graph TD;
*Note: for demonstration purposes, we've enabled mermaid on this site. It is still disabled by default, and users need to opt-in to use it.*
## Copy button
+{: .d-inline-block }
+
+New (v0.4.0)
+{: .label .label-green }
The copy button for code blocks can be enabled or disabled via the `enable_copy_code_button` key in `_config.yml`. By default, the value of this key is `false`; users need to opt-in.
@@ -153,4 +161,4 @@ The copy button for code blocks can be enabled or disabled via the `enable_copy_
enable_copy_code_button: true
```
-Note that this feature requires JavaScript; if JavaScript is disabled in the browser, this feature will not work.
\ No newline at end of file
+Note that this feature requires JavaScript; if JavaScript is disabled in the browser, this feature will not work.