Merge pull request #3224 from Blargian/improve_site_vitals

Improve site performance metrics

Author: Blargian

docusaurus.config.js

@@ -1,5 +1,5 @@
 {
-  "name": "new-nav-docusaurus-2-2",
+  "name": "clickhouse-docs",
   "version": "0.0.0",
   "private": true,
   "config": {
@@ -8,7 +8,7 @@
     "autogen_needed_files": "src/Core/FormatFactorySettings.h src/Core/Settings.cpp CHANGELOG.md"
   },
   "scripts": {
-    "build": "yarn copy-clickhouse-repo-docs && yarn generate-changelog && yarn autogenerate-settings && yarn build-api-doc && yarn build-swagger && docusaurus build",
+    "build": "yarn copy-clickhouse-repo-docs && yarn generate-changelog && yarn autogenerate-settings && yarn build-api-doc && yarn build-swagger && GENERATE_SOURCEMAP=false docusaurus build",
     "clear": "docusaurus clear && bash ./placeholderReset.sh",
     "deploy": "docusaurus deploy",
     "docusaurus": "docusaurus",
@@ -19,15 +19,15 @@
     "prep-from-local": "bash ./scripts/copy-clickhouse-repo-docs.sh -l $1",
     "autogenerate-settings": "bash ./scripts/settings/autogenerate-settings.sh",
     "generate-changelog": "bash ./scripts/generate-changelog.sh",
-    "new-build": "yarn copy-clickhouse-repo-docs && yarn generate-changelog && yarn autogenerate-settings && yarn build-api-doc && yarn build-swagger && docusaurus build",
+    "new-build": "yarn copy-clickhouse-repo-docs && yarn generate-changelog && yarn autogenerate-settings && yarn build-api-doc && yarn build-swagger && GENERATE_SOURCEMAP=false docusaurus build",
     "start": "docusaurus start",
     "swizzle": "docusaurus swizzle",
     "write-heading-ids": "docusaurus write-heading-ids",
     "run-indexer": "bash ./scripts/search/run_indexer.sh"
   },
   "dependencies": {
     "@docusaurus/core": "3.7.0",
-    "@docusaurus/plugin-client-redirects": "3.7.0",
+    "@docusaurus/faster": "^3.7.0",
     "@docusaurus/preset-classic": "3.7.0",
     "@docusaurus/theme-mermaid": "3.7.0",
     "@docusaurus/theme-search-algolia": "^3.7.0",
@@ -40,9 +40,7 @@
     "esbuild-loader": "^4.0.3",
     "flexsearch": "^0.7.43",
     "gray-matter": "^4.0.3",
-    "hast-util-is-element": "1.1.0",
     "http-proxy-middleware": "3.0.3",
-    "katex": "^0.16.21",
     "node-fetch": "^3.3.2",
     "prism-react-renderer": "^2.4.1",
     "react": "^18.2.0",
@@ -60,7 +58,6 @@
     "@docusaurus/module-type-aliases": "3.7.0",
     "@playwright/test": "^1.49.1",
     "@types/react": "^19.0.4",
-    "cheerio": "^1.0.0",
     "rsync": "^0.6.1",
     "typescript": "^5.7.3"
   },

package.json

@@ -114,7 +114,7 @@
   --click-color-button-text-disabled: var(--palette_neutral_500);
 
   --click-color-table-header-background: var(--palette_slate_50);
-  --click-color-table-header-text: var(var(--palette_slate_900));
+  --click-color-table-header-text: var(--palette_slate_900);
   --click-color-table-row-background: var(--palette_neutral_0);
   --click-color-table-row-text: var(--palette_slate_900);
   --click-color-table-cell-stroke: var(--palette_slate_100);

src/css/colors.scss

@@ -2,6 +2,11 @@
 @use "default";
 @use "home";
 
+/* KaTeX renders the input twice by default, once in HTML and one in MathML */
+.katex-html {
+  display: none;
+}
+
 html[data-theme="dark"] {
   background: var(--click-color-background);
   background-attachment: fixed;

src/css/custom.scss

@@ -157,3 +157,4 @@
   --ifm-menu-link-sublist-icon: url("data:image/svg+xml,%3Csvg width='24' height='24' viewBox='0 0 24 24' fill='none' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M11.9988 9.21211L16.2363 13.4684L15.4488 14.2559L11.9988 10.8059L8.54883 14.2559L7.76133 13.4684L11.9988 9.21211Z' fill='%23E2E3E7' /%3E%3Cpath d='M11.9988 9.21211L16.2363 13.4684L15.4488 14.2559L11.9988 10.8059L8.54883 14.2559L7.76133 13.4684L11.9988 9.21211Z' fill='black' fill-opacity='0.2'/%3E%3C/svg%3E");
 
 }
+

src/css/default.scss

@@ -1,30 +1,30 @@
 /* Hide breadcrumbs for home page */
 .docs-doc-id-home-page .breadcrumbs {
-    display: none;
+  display: none;
 }
-  
+
 .docs-doc-id-home-page .docItemCol_src-theme-DocItem-Layout-styles-module {
-    max-width: 100vw;
-    overflow-x: hidden;
+  max-width: 100vw;
+  overflow-x: hidden;
 
-    @media (min-width: 768px) {
-      max-width: 100% !important;
-    }
+  @media (min-width: 768px) {
+    max-width: 100% !important;
+  }
 }
 
 .docs-doc-id-home-page .container {
-    margin-left: 0;
-    margin-right: 0;
-    max-width: 100%;
-    padding-bottom: 0;
+  margin-left: 0;
+  margin-right: 0;
+  max-width: 100%;
+  padding-bottom: 0;
 
-    @media (min-width: 768px) {
-      overflow-x: auto;
-    }
+  @media (min-width: 768px) {
+    overflow-x: auto;
+  }
 }
 
 .docs-doc-id-home-page .main-content-wrapper {
-    margin-top: 0;
+  margin-top: 0;
 }
 
 .docs-doc-id-home-page .docItemCol_src-theme-DocItem-Layout-styles-module {
@@ -41,18 +41,18 @@
   padding-left: 1rem;
   padding-right: 1rem;
 }
-  
+
 .home-page-hero {
-    border-bottom: 1px solid var(--click-color-stroke);
-    display: flex;
-    flex-direction: column;
-    padding-bottom: 2rem;
+  border-bottom: 1px solid var(--click-color-stroke);
+  display: flex;
+  flex-direction: column;
+  padding-bottom: 2rem;
 
-    @media (min-width: 768px) {
-      flex-direction: row;
-      padding-top: 4rem;
-      padding-bottom: 4rem;
-    }
+  @media (min-width: 768px) {
+    flex-direction: row;
+    padding-top: 4rem;
+    padding-bottom: 4rem;
+  }
 }
 
 .home-page-hero-left {
@@ -88,7 +88,7 @@
   margin-bottom: 1rem;
   width: 100%;
 
-  @media (min-width: 768px) {    
+  @media (min-width: 768px) {
     margin-right: 24px;
     margin-bottom: 0;
     width: 200px;
@@ -241,3 +241,4 @@ img.home-svg svg path {
     padding-left: 4rem !important;
   }
 }
+

src/css/home.scss

@@ -1,5 +1,3 @@
-import useDebounce from './useDebounce'
-import useThrottle from './useThrottle'
 import useClickOutside from './useClickOutside'
 
-export { useDebounce, useThrottle, useClickOutside }
+export { useClickOutside }

src/hooks/index.js

@@ -8,3 +8,4 @@
   --ifm-pre-color: var(--prism-color);
   overflow-x: scroll;
 }
+