Added version 2.2.x

Author: BenjaminHoegh

package-lock.json

@@ -0,0 +1,77 @@
+---
+title: Abbreviations
+---
+
+# Abbreviations
+
+## Description
+
+The Abbreviations feature provides automatic detection and formatting of abbreviations within your Markdown content. By wrapping abbreviations in `<abbr>` tags, it enhances text comprehension and accessibility, allowing users to see the full meaning of abbreviations on hover.
+
+## Configuration Syntax
+
+To configure the Abbreviations feature, use the `config()->set()` and `config()->get()` methods:
+
+### Getting the Current Configuration
+
+To retrieve the current configuration for the Abbreviations feature:
+
+```php
+$configValue = config()->get('abbreviations');
+```
+
+### Setting the Configuration
+
+To adjust the Abbreviations feature, use:
+
+```php
+config()->set('abbreviations', (bool|array) $value);
+```
+
+- `$value` can be a boolean to enable or disable the feature globally, or an array for more detailed configuration options.
+
+## Configuration Options
+
+The Abbreviations feature supports the following settings:
+
+- **allow_custom** (bool): Allows the definition of custom abbreviations directly within your Markdown content. This option is enabled by default.
+- **predefined** (array): Provides a list of predefined abbreviations and their full meanings to ensure consistency across your documents.
+
+## Examples
+
+### Disable Abbreviations
+
+To completely disable the processing of abbreviations:
+
+```php
+$ParsedownExtended->config()->set('abbreviations', false);
+```
+
+### Predefine Abbreviations
+
+To set up a predefined list of abbreviations:
+
+```php
+$ParsedownExtended->config()->set('abbreviations', [
+    'predefined' => [
+        'CSS' => 'Cascading Style Sheets',
+        'HTML' => 'HyperText Markup Language',
+        'JS' => 'JavaScript',
+    ],
+]);
+```
+
+### Use Predefined Abbreviations Only
+
+To restrict usage to only predefined abbreviations and disable custom abbreviations:
+
+```php
+$ParsedownExtended->config()->set('abbreviations', [
+    'allow_custom' => false,
+    'predefined' => [
+        'CSS' => 'Cascading Style Sheets',
+        'HTML' => 'HyperText Markup Language',
+        'JS' => 'JavaScript',
+    ],
+]);
+```

versioned_docs/version-2.2.x/Configuration/Abbreviations.md

@@ -0,0 +1,85 @@
+---
+title: Alerts
+---
+
+# Alerts
+
+## Description
+
+ParsedownExtended supports GitHub Flavored Markdown (GFM) alert syntax. Alerts are block-quote-style callouts that are styled with a distinctive type label, making it easy to draw attention to notes, tips, warnings, and other important information.
+
+```markdown
+> [!NOTE]
+> Highlights information that users should take into account.
+> [!TIP]
+> Optional information to help a user be more successful.
+> [!IMPORTANT]
+> Crucial information necessary for users to succeed.
+> [!WARNING]
+> Critical content demanding immediate user attention due to potential risks.
+> [!CAUTION]
+> Negative potential consequences of an action.
+```
+
+Each alert type is wrapped in a `<div>` with a CSS class composed of the base class and the lowercase alert type, e.g., `markdown-alert markdown-alert-note`.
+
+## Configuration Syntax
+
+To configure Alerts in ParsedownExtended, use the `config()->set()` method:
+
+```php
+$ParsedownExtended->config()->set('alerts', (bool|array) $value);
+```
+
+## Parameters
+
+- **types** (array): The list of recognised alert type labels (case-insensitive). Defaults to `['note', 'tip', 'important', 'warning', 'caution']`.
+- **class** (string): The base CSS class applied to the outer `<div>` wrapper of every alert. Defaults to `'markdown-alert'`.
+
+## Examples
+
+### Disable Alerts
+
+To disable alert block processing entirely:
+
+```php
+$ParsedownExtended->config()->set('alerts', false);
+```
+
+### Custom Alert Types
+
+To support only a subset of alert types, or to add your own:
+
+```php
+$ParsedownExtended->config()->set('alerts.types', ['note', 'warning', 'danger']);
+```
+
+### Custom CSS Class
+
+To use a different base CSS class for styling:
+
+```php
+$ParsedownExtended->config()->set('alerts.class', 'callout');
+```
+
+With this setting a `> [!NOTE]` block would render as:
+```html
+<div class="callout callout-note">
+  <p>...</p>
+</div>
+```
+
+### Localised Alert Labels
+
+You can replace the default English type labels with your own language or branding:
+
+```php
+$ParsedownExtended->config()->set('alerts.types', ['hinweis', 'tipp', 'warnung']);
+```
+
+Then use the matching labels in your Markdown:
+
+```markdown
+> [!HINWEIS]
+> This is a note in German.
+```

versioned_docs/version-2.2.x/Configuration/Alerts.md

@@ -0,0 +1,57 @@
+---
+title: Code
+---
+
+# Code
+
+## Description
+
+Code snippets within Markdown documents can be presented in two distinct styles: inline and block. Inline code is used for highlighting code or commands within a sentence, whereas block code is suited for larger code excerpts or examples that should stand apart from the main text. ParsedownExtended enhances the management of both inline and block code snippets, offering configurable settings to fine-tune their processing and presentation.
+
+## Configuration Syntax
+
+To configure the code processing settings, use the `config()->set()` and `config()->get()` methods:
+
+### Getting the Current Configuration
+
+To retrieve the current configuration for code processing:
+
+```php
+$configValue = $ParsedownExtended->config()->get('code');
+```
+
+### Setting the Configuration
+
+To adjust the code processing settings:
+
+```php
+$ParsedownExtended->config()->set('code', (bool|array) $value);
+```
+
+- `$value` is a boolean indicating whether inline code processing is enabled (`true`) or disabled (`false`). Alternatively, you can use an array for more detailed configuration options. By default, inline code formatting is usually enabled.
+
+## Examples
+
+### Disabling All Code Processing
+
+To disable the processing of all code, including both inline and block code:
+
+```php
+$ParsedownExtended->config()->set('code', false);
+```
+
+### Disabling Inline Code
+
+To disable the formatting of inline code, preventing text surrounded by backticks from being rendered distinctly:
+
+```php
+$ParsedownExtended->config()->set('code.inline', false);
+```
+
+### Disabling Block Code
+
+To disable the processing of block code, which is usually delimited by triple backticks or indentation:
+
+```php
+$ParsedownExtended->config()->set('code.block', false);
+```

versioned_docs/version-2.2.x/Configuration/Code.md

@@ -0,0 +1,50 @@
+---
+title: Comments
+---
+
+# Comments
+
+## Description
+
+The Comments feature in Markdown allows you to include notes or annotations within your content that won't be rendered in the final output. This is useful for adding explanations or reminders that are visible in the source but invisible to the end user. ParsedownExtended provides options to enable or disable the processing of comments within your Markdown files.
+
+## Configuration Syntax
+
+To configure the Comments feature, use the `config()->set()` and `config()->get()` methods:
+
+### Getting the Current Configuration
+
+To retrieve the current configuration for comment processing:
+
+```php
+$configValue = $ParsedownExtended->config()->get('comments');
+```
+
+### Setting the Configuration
+
+To adjust the Comments feature:
+
+```php
+$ParsedownExtended->config()->set('comments', (bool) $value);
+```
+
+- `$value` is a boolean indicating whether comment processing is enabled (`true`) or disabled (`false`). By default, comment processing may be enabled or disabled based on your system's settings.
+
+## Examples
+
+### Disabling Comments
+
+To disable the processing of comments in Markdown, preventing any comments from being included in the source:
+
+```php
+$ParsedownExtended->config()->set('comments', false);
+```
+
+### Enabling Comments
+
+To enable the processing of comments, allowing annotations to be included in your Markdown files but not rendered in the final output:
+
+```php
+$ParsedownExtended->config()->set('comments', true);
+```
+

versioned_docs/version-2.2.x/Configuration/Comments.md

@@ -0,0 +1,42 @@
+---
+title: Definition Lists
+---
+
+# Definition Lists
+
+## Description
+
+Definition lists allow for the organization of terms and their corresponding definitions in a structured format. This functionality enables authors to create glossaries or specify key concepts with descriptions directly within their Markdown content. While the capability to interpret definition list syntax comes from Parsedown, ParsedownExtended provides enhanced support by allowing users to easily enable or disable this feature through its configuration settings.
+
+## Configuration Syntax
+
+To configure the processing of definition lists in your Markdown, use the `config()->set()` and `config()->get()` methods:
+
+### Getting the Current Configuration
+
+To retrieve the current configuration for definition list processing:
+
+```php
+$configValue = $ParsedownExtended->config()->get('definition_lists');
+```
+
+### Setting the Configuration
+
+To adjust the processing of definition lists:
+
+```php
+$ParsedownExtended->config()->set('definition_lists', (bool) $value);
+```
+
+- `$value` is a boolean indicating whether definition lists should be processed (`true`) or ignored (`false`).
+
+## Examples
+
+### Disable Definition Lists
+
+To prevent the automatic processing of definition lists, thereby disabling the feature:
+
+```php
+$ParsedownExtended->config()->set('definition_lists', false);
+```
+

versioned_docs/version-2.2.x/Configuration/Definition Lists.md

@@ -0,0 +1,67 @@
+---
+title: Diagrams
+---
+
+# Diagrams
+
+## Description
+
+ParsedownExtended introduces support for incorporating diagrams directly into Markdown documents, enhancing visual representation and understanding. This feature recognizes syntax intended for diagram rendering, specifically designed to work with [ChartJS](https://www.chartjs.org) and [Mermaid](https://mermaid-js.github.io/mermaid/). ParsedownExtended ensures that diagram code is preserved and remains unaltered for client-side rendering, requiring the inclusion of ChartJS and Mermaid JavaScript libraries in your project.
+
+```mermaid
+graph TD;
+    A-->B;
+    A-->C;
+    B-->D;
+    C-->D;
+```
+
+## Configuration Syntax
+
+To enable the diagrams feature in ParsedownExtended, use the `config()->set()` and `config()->get()` methods:
+
+### Getting the Current Configuration
+
+To retrieve the current configuration for diagram support:
+
+```php
+$configValue = $ParsedownExtended->config()->get('diagrams');
+```
+
+### Setting the Configuration
+
+To adjust the diagram processing settings:
+
+```php
+$ParsedownExtended->config()->set('diagrams', (bool|array) $value);
+```
+
+- `$value` can be a boolean to enable or disable diagram support globally, or an array for more specific configuration options.
+
+## Configuration Options
+
+This feature allows the following settings:
+
+- **chartjs**: Enable or disable support for ChartJS diagrams.
+- **mermaid**: Enable or disable support for Mermaid diagrams.
+
+## Examples
+
+### Enable Diagrams
+
+To activate diagram support, ensuring that Markdown containing ChartJS or Mermaid syntax is properly recognized and left intact for client-side rendering:
+
+```php
+$ParsedownExtended->config()->set('diagrams', true);
+```
+
+### Disable a Specific Diagram Type
+
+To disable support for a specific diagram type, such as ChartJS:
+
+```php
+$ParsedownExtended->config()->set('diagrams', [
+    'chartjs' => false
+]);
+```
+