From 3653d1d29eb0357c9fc03bf5eabc9b1c0499b2ad Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 21 Apr 2026 13:49:49 +0200 Subject: [PATCH 1/3] no-emphasis-as-heading --- .markdownlint-cli2.yaml | 2 +- .../admin_panel/roles_admin_panel.md | 4 ++-- docs/api/rest_api/rest_api_authentication.md | 2 +- docs/content_management/images/images.md | 6 +++--- .../cache/persistence_cache.md | 2 +- .../elasticsearch/elasticsearch_overview.md | 2 +- .../migrating_from_ez_publish_platform.md | 16 ++++++++-------- 7 files changed, 17 insertions(+), 17 deletions(-) diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml index ac68536e4f..e63abef824 100644 --- a/.markdownlint-cli2.yaml +++ b/.markdownlint-cli2.yaml @@ -21,7 +21,7 @@ config: link-fragments: true no-alt-text: true single-trailing-newline: true -# no-emphasis-as-heading: true + no-emphasis-as-heading: true no-space-in-code: true no-space-in-links: true fenced-code-language: true diff --git a/docs/administration/admin_panel/roles_admin_panel.md b/docs/administration/admin_panel/roles_admin_panel.md index ba27d7ee2e..5950744000 100644 --- a/docs/administration/admin_panel/roles_admin_panel.md +++ b/docs/administration/admin_panel/roles_admin_panel.md @@ -10,7 +10,7 @@ To give users an access to your website you need to assign them roles in the **A Each role consists of: -**Policies** +## Policies ![Policies](admin_panel_policies.png "Policies") @@ -27,7 +27,7 @@ See [example use case](permission_use_cases.md#restrict-editing-to-part-of-the-t For more information, see [Limitation reference](limitation_reference.md). -**Assignments** +## Assignments ![Assignments](admin_panel_assignments.png "Assignments") diff --git a/docs/api/rest_api/rest_api_authentication.md b/docs/api/rest_api/rest_api_authentication.md index f7f77366f8..de97086451 100644 --- a/docs/api/rest_api/rest_api_authentication.md +++ b/docs/api/rest_api/rest_api_authentication.md @@ -353,7 +353,7 @@ For details, see [RFC 2617](https://datatracker.ietf.org/doc/html/rfc2617). Most HTTP client libraries and REST libraries support this method. [Creating content with binary attachments](rest_requests.md#creating-content-with-binary-attachments) is an example of using basic authentication with [cURL](https://www.php.net/manual/en/book.curl.php) and its `CURLOPT_USERPWD`. -**Raw HTTP request with basic authentication** +See the following raw HTTP request with basic authentication example: ```http GET / HTTP/1.1 diff --git a/docs/content_management/images/images.md b/docs/content_management/images/images.md index 4b55abb5d9..9195336f81 100644 --- a/docs/content_management/images/images.md +++ b/docs/content_management/images/images.md @@ -168,19 +168,19 @@ If there is no configuration assigned to the `binary_handler`, the placeholder g #### Configuration examples -**Example 1 - placeholders with basic information about original image** +##### Example 1 - placeholders with basic information about original image ```yaml [[= include_file('code_samples/back_office/images/config/packages/images_basic.yaml') =]] ``` -**Example 2 - placeholders from remote source** +##### Example 2 - placeholders from remote source ```yaml [[= include_file('code_samples/back_office/images/config/packages/images_remote.yaml') =]] ``` -**Example 3 - placeholders from live version of a site** +##### Example 3 - placeholders from live version of a site ```yaml [[= include_file('code_samples/back_office/images/config/packages/images_live.yaml') =]] diff --git a/docs/infrastructure_and_maintenance/cache/persistence_cache.md b/docs/infrastructure_and_maintenance/cache/persistence_cache.md index 299f3d19d4..f0932756aa 100644 --- a/docs/infrastructure_and_maintenance/cache/persistence_cache.md +++ b/docs/infrastructure_and_maintenance/cache/persistence_cache.md @@ -54,7 +54,7 @@ Use of Redis as shared cache back end is a requirement for use in clustering set For an overview of this feature, see [Clustering](clustering.md). Filesystem adapters, for example, are **not** intended to be used over a shared filesystem. -**Cache service** +### Cache service The underlying cache system is exposed as an `ibexa.cache_pool` service, and can be reused by any other service as described in the [Using Cache service](#using-cache-service) section. diff --git a/docs/search/search_engines/elasticsearch/elasticsearch_overview.md b/docs/search/search_engines/elasticsearch/elasticsearch_overview.md index 8902ba97f0..3951aad368 100644 --- a/docs/search/search_engines/elasticsearch/elasticsearch_overview.md +++ b/docs/search/search_engines/elasticsearch/elasticsearch_overview.md @@ -17,7 +17,7 @@ Thanks to this mechanism, it's able to achieve fast response. For a detailed description of advanced settings that you might require in a specific production environment, see the documentation provided by Elastic. Start with the [Set up Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/setup.html) section. -**Prerequisite** +## Prerequisite To proceed you need to be familiar with how indexing, filtering and queries work. diff --git a/docs/update_and_migration/migrate_to_ibexa_dxp/migrating_from_ez_publish_platform.md b/docs/update_and_migration/migrate_to_ibexa_dxp/migrating_from_ez_publish_platform.md index e2cac3b51e..08faf936e7 100644 --- a/docs/update_and_migration/migrate_to_ibexa_dxp/migrating_from_ez_publish_platform.md +++ b/docs/update_and_migration/migrate_to_ibexa_dxp/migrating_from_ez_publish_platform.md @@ -410,9 +410,11 @@ Once you have fixed all the dump files in `ezxmltext-export/`, you may skip the `php -d memory_limit=1536M bin/console ezxmltext:import-xml --export-dir=ezxmltext-export -v` +##### Typical problems + Typical problems that needs manual fixing: -**Duplicate XHTML IDs** +###### Duplicate XHTML ID XHTML IDs needs to be unique. The following `ezxmltext` results in a warning: @@ -428,7 +430,7 @@ XHTML IDs needs to be unique. The following `ezxmltext` results in a warning: The conversion tool replaces the duplicate id (`inv5`) with a random value. If you need the ID value to match your CSS, you need to change it manually. The conversion tool also complains about IDs which contain invalid characters. -**Links with non-existing `object_remote_id` or `node_remote_id`.** +###### Links with non-existing `object_remote_id` or `node_remote_id` In `ezxmltext` you may have links which refer to other objects by their remote ID. This isn't supported in `richtext`, so the conversion tool must look up such remote IDs and replace them with the `object_id` or `node_id`. If the conversion tool cannot find the object by its remote id, it issues a warning about it. @@ -440,7 +442,7 @@ In older eZ Publish databases you may also have invalid links due to lack of ref When the conversion tool detects links with no reference it issues a warning and rewrite the URL to point to current page (`href="#"`). -**``** +###### `` The `` tag isn't yet supported in eZ Platform. @@ -448,7 +450,7 @@ When you're ready to migrate your eZ Publish XmlText content to the eZ Platform `php -d memory_limit=1536M bin/console ezxmltext:convert-to-richtext --export-dir=ezxmltext-export --export-dir-filter=notice,warning,error --concurrency 4 -v` -**Custom tags and attributes** +###### Custom tags and attributes eZ Platform now supports custom tags, including inline custom tags, and limited use of custom tag attributes. After migrating to RichText, you need to adapt your custom tag config for eZ Platform and rewrite the custom tags in Twig. @@ -574,18 +576,16 @@ new EzSystems\EzFlowMigrationToolkitBundle\EzSystemsEzFlowMigrationToolkitBundle bin/console cache:clear ``` -**4.** Run the script with the following parameters: +**4.** Run the script below with the following parameters: - absolute path of your legacy application - list of .ini files which define your legacy blocks -**Script command** - ``` bash bin/console ezflow:migrate —ini= [—ini= ...] ``` -**Example of the migration script command** +Example usage: ``` bash bin/console ezflow:migrate /var/www/legacy.application.com/ —ini=extension/myapplication/settings/block.ini.append.php From 9f79f0b93a94b772d7c46c5688a74c9b474598f6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 21 Apr 2026 14:56:21 +0200 Subject: [PATCH 2/3] table-column-count --- .markdownlint-cli2.yaml | 5 +- .../back_office_elements/add_dropdowns.md | 4 +- .../reusable_components.md | 2 +- docs/api/event_reference/content_events.md | 22 +-- .../event_reference/content_type_events.md | 10 +- docs/api/event_reference/language_events.md | 8 +- docs/api/event_reference/location_events.md | 10 +- .../event_reference/object_state_events.md | 8 +- docs/api/event_reference/other_events.md | 6 +- docs/api/event_reference/page_events.md | 8 +- docs/api/event_reference/role_events.md | 14 +- docs/api/event_reference/section_events.md | 4 +- docs/api/event_reference/site_events.md | 2 +- docs/api/event_reference/trash_events.md | 10 +- docs/api/event_reference/url_events.md | 10 +- docs/api/event_reference/user_events.md | 16 +- .../transactional_emails_parameters.md | 84 ++++----- .../field_type_reference/dateandtimefield.md | 10 +- .../field_type_reference/keywordfield.md | 6 +- .../field_type_reference/maplocationfield.md | 18 +- .../field_type_reference/relationfield.md | 6 +- .../field_type_reference/relationlistfield.md | 4 +- .../taxonomyentryfield.md | 2 +- .../field_type_reference/timefield.md | 6 +- .../field_type_reference/userfield.md | 2 +- docs/permissions/policies.md | 172 +++++++++--------- .../search_criteria_reference.md | 2 +- .../urls_and_routes/custom_breadcrumbs.md | 2 +- 28 files changed, 227 insertions(+), 226 deletions(-) diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml index e63abef824..a5d506c10b 100644 --- a/.markdownlint-cli2.yaml +++ b/.markdownlint-cli2.yaml @@ -14,10 +14,11 @@ config: table-pipe-style: style: leading_and_trailing -# table-column-count: true + table-column-count: true blanks-around-tables: true descriptive-link-text: true -# table-column-style: aligned + # table-column-style: + # style:aligned link-fragments: true no-alt-text: true single-trailing-newline: true diff --git a/docs/administration/back_office/back_office_elements/add_dropdowns.md b/docs/administration/back_office/back_office_elements/add_dropdowns.md index 811f3fd3b7..c3ba474859 100644 --- a/docs/administration/back_office/back_office_elements/add_dropdowns.md +++ b/docs/administration/back_office/back_office_elements/add_dropdowns.md @@ -108,13 +108,13 @@ The following attributes are available: |---|------|----------| |`source`| - |What is currently defined in the `