group sidebar based on tag groups

Author: B4nan

apify-docs-theme/src/theme/custom.css

@@ -990,14 +990,19 @@ html[data-theme='dark'] .actionLink:hover::after {
     }
 }
 
-aside li.section-header > div > .menu__link {
+aside li.section-header > div > .menu__link,
+aside li.section-header > ul > li > div > .menu__link {
     text-transform: uppercase;
     opacity: 0.8;
     font-size: 16px;
     font-weight: 700;
     margin: 0;
 }
 
+aside li.section-header > div > .menu__link {
+    font-size: 20px;
+}
+
 aside li.section-header.menu__list-item {
     margin-top: 15px;
     margin-bottom: 5px;
@@ -1011,6 +1016,11 @@ aside li.section-header > .menu__list {
     padding-left: 0;
 }
 
+.theme-doc-sidebar-menu li.section-header > ul > li .menu__list-item-collapsible:hover,
+.theme-doc-sidebar-menu li.section-header > ul > li .menu__list-item-collapsible--active {
+    background: inherit !important;
+}
+
 .beta-chip {
     display: inline-block;
     border: 1px solid #ccc;

patches/docusaurus-plugin-openapi-docs+0.0.0-961.patch

@@ -0,0 +1,37 @@
+diff --git a/node_modules/docusaurus-plugin-openapi-docs/lib/sidebars/index.js b/node_modules/docusaurus-plugin-openapi-docs/lib/sidebars/index.js
+index 5802904..17409d5 100644
+--- a/node_modules/docusaurus-plugin-openapi-docs/lib/sidebars/index.js
++++ b/node_modules/docusaurus-plugin-openapi-docs/lib/sidebars/index.js
+@@ -139,9 +139,18 @@ function groupByTags(items, sidebarOptions, options, tags, docPath) {
+         }
+         const taggedApiItems = apiItems.filter((item) => { var _a; return !!((_a = item.api.tags) === null || _a === void 0 ? void 0 : _a.includes(tag)); });
+         const taggedSchemaItems = schemaItems.filter((item) => { var _a; return !!((_a = item.schema["x-tags"]) === null || _a === void 0 ? void 0 : _a.includes(tag)); });
++        const altids = [];
++
++        if (tagObject?.['x-legacy-doc-urls']) {
++            console.log(tagObject);
++            altids.push(...tagObject['x-legacy-doc-urls']);
++        }
++
+         return {
+             type: "category",
+             label: (_a = tagObject === null || tagObject === void 0 ? void 0 : tagObject["x-displayName"]) !== null && _a !== void 0 ? _a : tag,
++            customProps: { altids },
+             link: linkConfig,
+             collapsible: sidebarCollapsible,
+             collapsed: sidebarCollapsed,
+@@ -201,11 +210,12 @@ function generateSidebarSlice(sidebarOptions, options, api, tags, docPath, tagGr
+                     filteredTags.push(tag);
+                 }
+             });
++            const { sidebarCollapsed, sidebarCollapsible } = sidebarOptions;
+             const groupCategory = {
+                 type: "category",
+                 label: tagGroup.name,
+-                collapsible: true,
+-                collapsed: true,
++                collapsible: sidebarCollapsible,
++                collapsed: sidebarCollapsed,
+                 items: groupByTags(api, sidebarOptions, options, [filteredTags], docPath),
+             };
+             if (options.showSchemas) {

sources/api/sidebars.js

@@ -1,12 +1,22 @@
+// eslint-disable-next-line global-require
+const items = require('./sidebar.ts');
+
+for (const item of items) {
+    // this is wrongly rendered in each category (openapi group tag)
+    if (item.items[0].id === 'apify-api') {
+        item.items.shift();
+    }
+}
+
 module.exports = {
     api: [
         {
             type: 'category',
             label: 'Apify API',
             collapsible: false,
             className: 'section-header',
-            // eslint-disable-next-line global-require
-            items: require('./sidebar.ts'),
+            link: { type: 'doc', id: 'apify-api' },
+            items,
         },
     ],
 };