From 9c810d08a458e045939d5a9308158ed9a7b3d3e7 Mon Sep 17 00:00:00 2001 From: "lina.wolf" Date: Mon, 6 May 2024 17:32:54 +0200 Subject: [PATCH 1/2] [TASK] Link to site sets explainaition and improve texts Releases: main --- Documentation/UsingSetting/PageTSconfig.rst | 23 ++++++++++++--------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/Documentation/UsingSetting/PageTSconfig.rst b/Documentation/UsingSetting/PageTSconfig.rst index d5411fd..98228ad 100644 --- a/Documentation/UsingSetting/PageTSconfig.rst +++ b/Documentation/UsingSetting/PageTSconfig.rst @@ -17,7 +17,8 @@ The options described below are available for setting page TSconfig in non-sitepackage extensions. Page TSconfig can be defined globally as -:ref:`Default page TSconfig ` or for a +:ref:`Default page TSconfig `, on site level via +:ref:`Page TSconfig via site or set ` or for a :ref:`page tree `, a page and all its subpages. It is also possible to set @@ -75,7 +76,6 @@ TYPO3 v11 and v12 by importing the content of this file with the API function :language: php :caption: EXT:my_sitepackage/ext_localconf.php - .. _include-static-page-tsconfig-per-site: Page TSconfig on site level @@ -84,17 +84,20 @@ Page TSconfig on site level .. versionadded:: 13.1 Page TSconfig can be included on a per site level. -Site Page TSconfig is loaded from :file:`page.tsconfig` if placed next to -site configuration file :file:`config.yaml` and is scoped to pages within that -site. +Page TSconfig can be defined on a site level by placing a file called +:file:`page.tsconfig` in the storage directory of the site +(:ref:`config/sites// `). + +Extensions and site packages can provide page TSconfig in +:ref:`site sets ` by placing a a file called :file:`page.tsconfig` +into the folder of that set. This way sites and sets can ship page TSconfig without the need for database entries or by polluting global scope. Dependencies can be expressed via site sets, allowing for automatic ordering and deduplication. -See also :ref:`Feature: #103437 - Introduce site sets ` - -.. todo: Link site sets once they are documented +See also +:ref:`site sets as page TSconfig provider `. .. _include-static-page-tsconfig-per-site-example: @@ -156,8 +159,8 @@ Static page TSconfig that has been :ref:`registered ` by your sitepackage or a third party extension can be included in the page properties. -#. Go to the page properties of the page where you want to include the page TSconfig. -#. Go to the tab :guilabel:`Resources`, then to +#. Go to the page properties of the page where you want to include the page TSconfig. +#. Go to the tab :guilabel:`Resources`, then to :guilabel:`page TSconfig > Include static page TSconfig (from extensions)` and select the desired configurations from the :guilabel:`Available Items`. From 2f3525f338b7b083a190be245e08c0254a3a8560 Mon Sep 17 00:00:00 2001 From: "lina.wolf" Date: Mon, 6 May 2024 17:46:28 +0200 Subject: [PATCH 2/2] [TASK] Link to site sets explainaition and improve texts Releases: main --- Documentation/UsingSetting/PageTSconfig.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/UsingSetting/PageTSconfig.rst b/Documentation/UsingSetting/PageTSconfig.rst index 98228ad..16cd469 100644 --- a/Documentation/UsingSetting/PageTSconfig.rst +++ b/Documentation/UsingSetting/PageTSconfig.rst @@ -86,7 +86,7 @@ Page TSconfig on site level Page TSconfig can be defined on a site level by placing a file called :file:`page.tsconfig` in the storage directory of the site -(:ref:`config/sites// `). +(:ref:`config/sites// `). Extensions and site packages can provide page TSconfig in :ref:`site sets ` by placing a a file called :file:`page.tsconfig`