extcode · extcode · Feb 21, 2025 · Feb 21, 2025
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
@@ -31,6 +31,18 @@ jobs:
       - name: PHP lint
         run: "find *.php Classes Configuration Tests -name '*.php' -print0 | xargs -0 -n 1 -P 4 php -l"
 
+  documentation-rendering:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Documentation without warnings
+        run: |
+          mkdir -p Documentation-GENERATED-temp \
+          && docker run --rm --pull always -v $(pwd):/project \
+             ghcr.io/typo3-documentation/render-guides:latest --config=Documentation --no-progress --fail-on-log
+
   coding-guideline:
     runs-on: ubuntu-latest
     needs:

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
@@ -196,17 +196,15 @@ test:codception:php83:typo3_12:
 documentation:
   stage: documentation
   image:
-    name: t3docs/render-documentation:v2.4.0
-    entrypoint: [""]
-  before_script:
-    - cp -a ${CI_PROJECT_DIR}/. /PROJECT
-    - mkdir -p ${CI_PROJECT_DIR}/Documentation-GENERATED-temp
+    name: ghcr.io/typo3-documentation/render-guides:latest
+    entrypoint: [ "" ]
   script:
-    - cd /ALL/venv
-    - /ALL/Menu/mainmenu.sh makehtml-no-cache -c resultdir ${CI_PROJECT_DIR}/Documentation-GENERATED-temp
+    - mkdir -p Documentation-GENERATED-temp
+    - /opt/guides/entrypoint.sh --config=Documentation --no-progress --fail-on-log
+  before_script: []
   artifacts:
     paths:
-      - ${CI_PROJECT_DIR}/Documentation-GENERATED-temp/Result/project/0.0.0
+      - Documentation-GENERATED-temp/
     expire_in: 1 day
     when: always
 

diff --git a/...ministratorManual/Configuration/Index.rst → ...ion/Administrator/Configuration/Index.rst b/...ministratorManual/Configuration/Index.rst → ...ion/Administrator/Configuration/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+=============
 Configuration
 =============
 

diff --git a/...tratorManual/Configuration/Main/Index.rst → ...dministrator/Configuration/Main/Index.rst b/...tratorManual/Configuration/Main/Index.rst → ...dministrator/Configuration/Main/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../../Includes.txt
+.. include:: ../../../Includes.rst.txt
 
+==================
 Main Configuration
 ==================
 

diff --git a/Documentation/Administrator/Index.rst b/Documentation/Administrator/Index.rst
@@ -0,0 +1,14 @@
+.. include:: ../Includes.rst.txt
+
+.. _administrator:
+
+==================
+For Administrators
+==================
+
+.. toctree::
+   :maxdepth: 5
+   :titlesonly:
+
+   Installation/Index
+   Configuration/Index
diff --git a/...dministratorManual/Installation/Index.rst → ...tion/Administrator/Installation/Index.rst b/...dministratorManual/Installation/Index.rst → ...tion/Administrator/Installation/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+============
 Installation
 ============
 

diff --git a/Documentation/AdministratorManual/Index.rst b/Documentation/AdministratorManual/Index.rst
diff --git a/Documentation/Changelog/1.0/Index.rst b/Documentation/Changelog/1.0/Index.rst
@@ -1,6 +1,7 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+===========
 1.0 Changes
 ===========
 
-The version 1.0.0 is a release for TYPO3 v8.7 only and skipped for TYPO3 v9. `2.0 Changes <../2.0/Index.html>`_.
+The version 1.0.0 is a release for TYPO3 v8.7 only and skipped for TYPO3 v9.5. This version is compatible to Cart v5.0+.
diff --git a/Documentation/Changelog/2.0/Index.rst b/Documentation/Changelog/2.0/Index.rst
@@ -1,9 +1,10 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+===========
 2.0 Changes
 ===========
 
-This is the initial release of cart_events for TYPO3 v9.5. It is part of the cart extension.
+The version 2.0.0 is a release for TYPO3 v9.5 only. This version is compatible to Cart v6.0+.
 
 .. IMPORTANT::
    **If upgrading from cart version 4.8.1 or earlier: Please read the documentation very carefully! Please make a backup of your filesystem and database!** If possible test the update in a test copy of your TYPO3 instance.
diff --git a/Documentation/Changelog/2.1/Feature-26-AddToCartFormFrameworkFinisher.rst b/Documentation/Changelog/2.1/Feature-26-AddToCartFormFrameworkFinisher.rst
@@ -1,4 +1,4 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
 ====================================================
 Feature: #26 - Add addToCart form framework finisher

diff --git a/Documentation/Changelog/2.1/Feature-33-AddKeSearchIndexer.rst b/Documentation/Changelog/2.1/Feature-33-AddKeSearchIndexer.rst
@@ -1,4 +1,4 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
 ====================================
 Feature: #33 - Add ke_search indexer

diff --git a/Documentation/Changelog/2.1/Important-38-RenderEventDateInShowTemplate.rst b/Documentation/Changelog/2.1/Important-38-RenderEventDateInShowTemplate.rst
@@ -1,4 +1,4 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
 ===================================================================
 Important: #38 - Render begin and end of eventDate in show template

diff --git a/Documentation/Changelog/2.1/Index.rst b/Documentation/Changelog/2.1/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+===========
 2.1 Changes
 ===========
 

diff --git a/Documentation/Changelog/2.3/Breaking-36-AddPriceCategories.rst b/Documentation/Changelog/2.3/Breaking-36-AddPriceCategories.rst
@@ -1,4 +1,4 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
 ====================================
 Breaking: #36 - Add price categories

diff --git a/Documentation/Changelog/2.3/Feature-36-AddPriceCategories.rst b/Documentation/Changelog/2.3/Feature-36-AddPriceCategories.rst
@@ -1,4 +1,4 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
 ===================================
 Feature: #36 - Add price categories

diff --git a/Documentation/Changelog/2.3/Index.rst b/Documentation/Changelog/2.3/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+===========
 2.3 Changes
 ===========
 

diff --git a/Documentation/Changelog/2.4/Feature-59-AddHookToAllowChangingTheProduct.rst b/Documentation/Changelog/2.4/Feature-59-AddHookToAllowChangingTheProduct.rst
@@ -1,4 +1,4 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
 =====================================================
 Feature: #59 - Add Hook to Allow Changing the Product

diff --git a/Documentation/Changelog/2.4/Index.rst b/Documentation/Changelog/2.4/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+===========
 2.4 Changes
 ===========
 

diff --git a/Documentation/Changelog/3.0/Index.rst b/Documentation/Changelog/3.0/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+===========
 3.0 Changes
 ===========
 

diff --git a/Documentation/Changelog/4.0/Breaking-64-MoveFluidPaginationToController.rst b/Documentation/Changelog/4.0/Breaking-64-MoveFluidPaginationToController.rst
@@ -1,4 +1,4 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
 ===================================================
 Breaking: #64 - Move Fluid Pagination to Controller

diff --git a/Documentation/Changelog/4.0/Feature-64-AddPaginationToController.rst b/Documentation/Changelog/4.0/Feature-64-AddPaginationToController.rst
@@ -1,4 +1,4 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
 ============================================
 Breaking: #64 - Add Pagination to Controller

diff --git a/Documentation/Changelog/4.0/Index.rst b/Documentation/Changelog/4.0/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+===========
 4.0 Changes
 ===========
 

diff --git a/Documentation/Changelog/5.0/Index.rst b/Documentation/Changelog/5.0/Index.rst
@@ -0,0 +1,11 @@
+.. include:: ../../Includes.rst.txt
+
+===========
+5.0 Changes
+===========
+
+**Table of contents**
+
+.. contents::
+   :local:
+   :depth: 1
diff --git a/Documentation/Changelog/Index.rst b/Documentation/Changelog/Index.rst
@@ -1,12 +1,14 @@
-.. include:: ../Includes.txt
+.. include:: ../Includes.rst.txt
 
+=========
 ChangeLog
 =========
 
 .. toctree::
    :maxdepth: 5
    :titlesonly:
 
+   5.0/Index
    4.0/Index
    3.0/Index
    2.4/Index

diff --git a/Documentation/Includes.txt → Documentation/Includes.rst.txt b/Documentation/Includes.txt → Documentation/Includes.rst.txt
diff --git a/Documentation/Index.rst b/Documentation/Index.rst
@@ -1,10 +1,10 @@
-.. include:: Includes.txt
+.. include:: Includes.rst.txt
 
 .. _start:
 
-===========================
+================
 EXT: Cart Events
-===========================
+================
 
 .. image:: Images/cart_events_logo.png
    :height: 200
@@ -52,5 +52,5 @@ EXT: Cart Events
    :titlesonly:
 
    Introduction/Index
-   AdministratorManual/Index
+   Administrator/Index
    Changelog/Index
diff --git a/Documentation/Introduction/Index.rst b/Documentation/Introduction/Index.rst
@@ -1,4 +1,4 @@
-.. include:: ../Includes.txt
+.. include:: ../Includes.rst.txt
 
 Introduction
 ------------
@@ -12,4 +12,3 @@ Cart Events provides an own data storage for events. Events can be offered via a
 
    Support/Index
    Sponsoring/Index
-   NoteOfThanks/Index
diff --git a/Documentation/Introduction/NoteOfThanks/Index.rst b/Documentation/Introduction/NoteOfThanks/Index.rst
diff --git a/Documentation/Introduction/Sponsoring/Index.rst b/Documentation/Introduction/Sponsoring/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+==========
 Sponsoring
 ==========
 
@@ -10,7 +11,4 @@ There is also the possibility to support the further development independently o
 *  Ask for an invoice.
 *  `GitHub Sponsors <https://github.com/sponsors/extcode>`_
 *  `PayPal.Me <https://paypal.me/extcart>`_
-*  `patreon.com <https://patreon.com/ext_cart>`_
 
-Sponsors
---------
diff --git a/Documentation/Introduction/Support/Index.rst b/Documentation/Introduction/Support/Index.rst
@@ -1,5 +1,6 @@
-.. include:: ../../Includes.txt
+.. include:: ../../Includes.rst.txt
 
+=======
 Support
 =======
 

diff --git a/Documentation/Settings.cfg b/Documentation/Settings.cfg
diff --git a/Documentation/guides.xml b/Documentation/guides.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<guides xmlns="https://www.phpdoc.org/guides" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="https://www.phpdoc.org/guides ../vendor/phpdocumentor/guides-cli/resources/schema/guides.xsd"
+        links-are-relative="true">
+    <extension class="\T3Docs\Typo3DocsTheme\DependencyInjection\Typo3DocsThemeExtension"
+               project-repository="https://github.com/extcode/cart_events"
+               project-issues="https://github.com/extcode/cart_events/issues"
+               edit-on-github-branch="main"
+               edit-on-github="extcode/cart_events"
+               typo3-core-preferred="stable"
+               interlink-shortcode="extcode/cart_events"
+    />
+    <project title="Cart Events"
+             release="5.0.0"
+             version="5.0"
+             copyright="2018 - 2025"
+    />
+    <inventory id="t3tsref" url="https://docs.typo3.org/typo3cms/TyposcriptReference/"/>
+</guides>