Merge pull request #3812 from Blargian/vertical_stepper_support_all

support hN level headers for vertical stepper

Author: Blargian

docs/best-practices/partionning_keys.md renamed to docs/best-practices/partitioning_keys.mdx

@@ -5,6 +5,6 @@ title: 'Choose a Low Cardinality Partitioning Key'
 description: 'Use a low cardinality partitioning key or avoid using any partitioning key for your table.'
 ---
 
-import Content from '@site/docs/best-practices/partionning_keys.md';
+import Content from '@site/docs/best-practices/partitioning_keys.mdx';
 
 <Content />

docs/guides/best-practices/partitioningkey.md

@@ -60,10 +60,10 @@ const config = {
   // url: process.env.VERCEL_URL ? `https://${process.env.VERCEL_URL}` : 'https://bookish-disco-5997zvo.pages.github.io',
   baseUrl: "/docs/",
   baseUrlIssueBanner: true,
-  onBrokenLinks: "warn",
+  onBrokenLinks: "throw",
   onBrokenMarkdownLinks: "warn",
   onDuplicateRoutes: "throw",
-  onBrokenAnchors: "warn",
+  onBrokenAnchors: "throw",
   favicon: "img/docs_favicon.ico",
   organizationName: "ClickHouse",
   trailingSlash: false,

docusaurus.config.en.js

@@ -37,8 +37,15 @@ const plugin = (options) => {
                             if (attr.name === 'type' && typeof attr.value === 'string') {
                                 type = attr.value;
                             } else if (attr.name === 'headerLevel' && typeof attr.value === 'string') {
-                                if (attr.value === "h3")
-                                    headerLevel = 3
+                                let set_level = attr.value
+                                const regex = /h([2-5])/;
+                                const match = set_level.match(regex);
+                                // If there's a match, convert the captured group to a number
+                                if (match) {
+                                    headerLevel = Number(match[1]);
+                                } else {
+                                    throw new Error("VerticalStepper supported only for h2-5");
+                                }
                             }
                         }
                     });

plugins/remark-custom-blocks.js

@@ -89,7 +89,7 @@ const sidebars = {
         "best-practices/select_data_type",
         "best-practices/use_materialized_views",
         "best-practices/minimize_optimize_joins",
-        "best-practices/partionning_keys",
+        "best-practices/partitioning_keys",
         "best-practices/selecting_an_insert_strategy",
         "best-practices/using_data_skipping_indices",
         "best-practices/avoid_mutations",

sidebars.js

@@ -89,8 +89,8 @@ const VStepper = ({
     const isExpandedMode = expanded === 'true';
 
     let hType = 'h2';
-    if (headerLevel == 3) {
-        hType = 'h3'
+    if (headerLevel > 2) {
+        hType = `h${headerLevel}`
     }
 
     // Get children and filter out non-elements