[FEATURE] Configure inventories via guides.xml

Author: linawolf

packages/guides/src/DependencyInjection/GuidesExtension.php

@@ -39,6 +39,18 @@ public function getConfigTreeBuilder(): TreeBuilder
                         ->scalarNode('version')->end()
                     ->end()
                 ->end()
+                ->arrayNode('inventories')
+                    ->children()
+                        ->arrayNode('inventory')
+                            ->arrayPrototype()
+                                ->children()
+                                    ->scalarNode('id')->end()
+                                    ->scalarNode('url')->end()
+                                ->end()
+                            ->end()
+                        ->end()
+                    ->end()
+                ->end()
                 ->scalarNode('html_theme')->end()
                 ->arrayNode('base_template_paths')
                     ->defaultValue([])
@@ -79,13 +91,22 @@ public function load(array $configs, ContainerBuilder $container): void
         $loader->load('command_bus.php');
         $loader->load('guides.php');
 
+        $projectSettings = [];
         if (isset($config['project'])) {
             if (isset($config['project']['version'])) {
                 $config['project']['version'] = (string) $config['project']['version'];
             }
 
+            $projectSettings = $config['project'];
+        }
+
+        if (isset($config['inventories'])) {
+            $projectSettings['inventories'] = $config['inventories']['inventory'];
+        }
+
+        if ($projectSettings) {
             $container->getDefinition(SettingsManager::class)
-                ->addMethodCall('setProjectSettings', [new ProjectSettings($config['project'])]);
+                ->addMethodCall('setProjectSettings', [new ProjectSettings($projectSettings)]);
         }
 
         if (isset($config['html_theme'])) {

packages/guides/src/Intersphinx/InventoryRepository.php

@@ -18,12 +18,12 @@ public function __construct(private readonly InventoryLoader $inventoryLoader)
     {
     }
 
-    /** @param array<string, string> $inventoryConfigs */
+    /** @param array<int, array<string, string>> $inventoryConfigs */
     public function initialize(array $inventoryConfigs): void
     {
         $this->inventories = [];
-        foreach ($inventoryConfigs as $key => $url) {
-            $this->inventories[$key] = new Inventory($url);
+        foreach ($inventoryConfigs as $inventory) {
+            $this->inventories[$inventory['id']] = new Inventory($inventory['url']);
         }
     }
 

tests/Integration/tests/intersphinx-link/input/guides.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<guides>
+    <project title="My Project" version="main (development)" />
+    <inventories>
+        <inventory id="t3coreapi" url="https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/" />
+        <inventory id="someapi" url="https://docs.typo3.org/m/typo3/reference-someapi/main/en-us/" />
+    </inventories>
+</guides>

tests/Integration/tests/intersphinx-link/input/settings.php

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<guides>
+    <project title="My Project" version="main (development)" />
+    <inventories>
+        <inventory id="t3coreapi" url="https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/" />
+        <inventory id="t3home" url="https://docs.typo3.org/" />
+    </inventories>
+</guides>

tests/Integration/tests/intersphinx-numeric/input/guides.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<guides>
+    <project title="My Project" version="3.1.4" />
+    <inventories>
+        <inventory id="t3coreapi" url="https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/" />
+        <inventory id="t3home" url="https://docs.typo3.org/" />
+    </inventories>
+</guides>