Update docs

Author: estruyf

.frontmatter/database/mediaDb.json

@@ -8,10 +8,16 @@
 
 ### 🎨 Enhancements
 
+- [#441](https://github.com/estruyf/vscode-front-matter/issues/441): Show input descriptions for snippet and data forms
+- [#442](https://github.com/estruyf/vscode-front-matter/issues/442): Hide sidebar on data view when data file is selected + show dropdown of data files
+- [#788](https://github.com/estruyf/vscode-front-matter/issues/788): Show a warning on setting update when it exists in an extended configuration
 - [#798](https://github.com/estruyf/vscode-front-matter/issues/798): Changed dialog to slide-over for the snippet forms
-- [#799](https://github.com/estruyf/vscode-front-matter/issues/799): Added `frontMatter.logging` setting to define the logging output. Options are `info`, `warn`, `error`, and `verbose`. Default is `info`.
+- [#799](https://github.com/estruyf/vscode-front-matter/issues/799): Added `frontMatter.logging` setting to define the logging output. Options are `info`, `warn`, `error`, and `verbose`. The default is `info`.
 - [#800](https://github.com/estruyf/vscode-front-matter/issues/800): Add colors for the Front Matter CMS output
+- [#808](https://github.com/estruyf/vscode-front-matter/issues/808): Add support to generate field groups and `block` fields in content type generation
 - [#810](https://github.com/estruyf/vscode-front-matter/issues/810): Update the tab title based on the view
+- [#811](https://github.com/estruyf/vscode-front-matter/issues/811): Added `panel.gitActions` view mode option to hide the Git actions in the panel
+- [#812](https://github.com/estruyf/vscode-front-matter/issues/812): Added the `{{locale}}` placeholder, which can be used in the `previewPath` property
 
 ### ⚡️ Optimizations
 

content/changelog/CHANGELOG.md

@@ -3,7 +3,7 @@ title: Placeholders
 slug: content-creation/placeholders
 description: Learn how to use placeholders in Front Matter CMS
 date: 2022-03-14T08:42:21.626Z
-lastmod: 2024-02-24T13:18:09.798Z
+lastmod: 2024-06-10T09:46:20.253Z
 weight: 200.51
 ---
 
@@ -29,12 +29,14 @@ automatically fill in values when creating a new content.
 
 ## Special placeholders
 
-| Placeholder             | Description                                                                                                        | Works for                                             |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------- |
-| `{{seoTitle}}`          | This creates a SEO friendly slug from the title. More info can be found in the [slug][02] section.                 | `slugTemplate` properties.                            |
-| `{{fm.<field name>}}`   | The value of the field in the front matter                                                                         | `slugTemplate` and `previewPath` properties.          |
-| `{{pathToken.<index>}}` | The value of the path token at the index                                                                           | `previewPath` on the page folder or the content-type. |
-| `{{pathToken.relPath}}` | The relative value path staring from the page folder' path                                                         | `previewPath` on the page folder or the content-type. |
+| Placeholder | Description | Works for |
+| --- | --- | --- |
+| `{{seoTitle}}`          | This creates a SEO friendly slug from the title. More info can be found in the [slug][02] section. | `slugTemplate` properties |
+| `{{date\|<format>}}`    | Use the publishing date of your article in the preview URL. Example: `/blog/{{date\|yyyy-MM}}` | `previewPath` property |
+| `{{locale}}`            | The locale of the page. | `previewPath` property |
+| `{{fm.<field name>}}`   | The value of the field in the front matter | `slugTemplate` and `previewPath` properties |
+| `{{pathToken.<index>}}` | The value of the path token at the index | `previewPath` on the page folder or the content-type |
+| `{{pathToken.relPath}}` | The relative value path staring from the page folder' path | `previewPath` on the page folder or the content-type |
 
 ### Example 1
 
@@ -90,6 +92,59 @@ The above configuration results in the following path: `/blog/25/02/23/`.
 
 ![Placeholder field formatting](/releases/v9.0.0/placeholder-formatting.png)
 
+### Example 4: using the `{{date|<format>}}` placeholder
+
+The `{{date|<format>}}` placeholder can be used in the `previewPath` property and uses the field
+with the name `date` or a date field where the `isPublishDate` property is set to `true`.
+
+```json {{ "title": "Using the date placeholder", "description": "" }}
+"frontMatter.content.pageFolders": [
+  {
+    "title": "blog",
+    "filePrefix": null,
+    "previewPath": "/{{fm.type}}/{{date|yyyy}}",
+    "path": "[[workspace]]/content"
+  }
+]
+```
+
+The above configuration results in the following path: `/blog/2024/`.
+
+### Example 5: using the `{{locale}}` placeholder
+
+The `{{locale}}` placeholder will return the locale of the page when you have
+a [multi-language setup](/docs/content-creation/multilingual).
+
+```json {{ "title": "Using the locale placeholder", "description": "" }}
+"frontMatter.content.pageFolders": [
+  {
+    "title": "blog",
+    "filePrefix": null,
+    "previewPath": "/{{locale}}",
+    "path": "[[workspace]]/content"
+  }
+]
+```
+
+The above configuration results in the following path for English content: `/en/<slug>/`.
+
+You can also ignore a specific locale by using the `ignore:<locale>` option.
+
+```json {{ "title": "Ignoring a specific locale", "description": "" }}
+"frontMatter.content.pageFolders": [
+  {
+    "title": "blog",
+    "filePrefix": null,
+    "previewPath": "/{{locale|ignore:en}}",
+    "path": "[[workspace]]/content"
+  }
+]
+```
+
+The above configuration results in the following path for English content: `/<slug>/`.
+For other locales, the preview path will generate the following path:
+`/<locale>/<slug>/` (e.g. `/nl/<slug>/`).
+
 ## Custom placeholders
 
 You can define you own placeholders within the `frontMatter.content.placeholders` setting. There are

content/docs/content-creation/placeholders.md

@@ -3,7 +3,7 @@ title: Editor panel
 slug: panel
 description: null
 date: 2021-08-30T16:13:00.546Z
-lastmod: 2023-10-06T13:47:51.482Z
+lastmod: 2024-06-10T08:24:04.381Z
 weight: 400
 ---
 
@@ -200,6 +200,7 @@ You define a mode with an `id` and a set of features. The allowed features are t
 ### Panel
 
 - `panel.globalSettings`: Show the global settings section.
+- `panel.gitActions`: Show the git actions section.
 - `panel.seo`: Show the SEO status section.
 - `panel.actions`: Show the actions section.
 - `panel.metadata`: Show the metadata section.

content/docs/panel.md

@@ -3,7 +3,7 @@ title: Settings overview
 slug: settings/overview
 description: null
 date: 2023-02-13T16:44:09.618Z
-lastmod: 2024-02-26T17:54:04.814Z
+lastmod: 2024-06-10T09:13:40.409Z
 weight: 1000.2
 ---
 
@@ -13,6 +13,23 @@ Here you can find an overview of all available settings.
 
 ## Available settings
 
+### frontMatter.logging
+
+Specify the logging level you want to use for the extension.
+
+- Type: `string`
+- Default: `info`
+
+Options:
+
+- `verbose`
+- `info`
+- `warning`
+- `error`
+
+> **Info**: More information on how to use it can be found in the
+> [troubleshooting - logging](/docs/troubleshooting#logging) section.
+
 ### frontMatter.config.dynamicFilePath
 
 Allows you to specify a dynamic config file path which will be used during the initialization of
@@ -509,6 +526,13 @@ field value.
 > characters you enter. In case you want to skip some characters or all of them, you need to wrap
 > that part between two single quotes. Example: `"'blog/'yyyy/MM"` will result in: `blog/2021/08`.
 
+### frontMatter.preview.trailingSlash
+
+Specify if you want to add a trailing slash to the preview URL.
+
+- Type: `boolean`
+- Default: `false`
+
 ### frontMatter.projects
 
 Allows you to specify a list of projects you want to manage with Front Matter CMS. Each project