New document (#5299)

* add new doc (#5175) Co-authored-by: dreamer6680 <146868355@qq.com> * Test docs (#5235) * fix: change the page of doc * chore: add new dependencies, update global styles/layout, optimize docs, add Feishu & GitHub icons, update API examples * fix: docs/index 404 not found * Update environment variable names, optimize styles, add new API routes, fix component styles, adjust documentation, and update GitHub and Feishu icons * update readme * feat: add a linkfastgpt compontent * feat: update new doc * fix:remove unuse page and redirect homepage to docs (#5288) * fix：remove some unuse doc * fix: redirect homepage to doc * git ignore * fix:navbar to index (#5295) * sidbar * fix: navtab unlight (#5298) * doc --------- Co-authored-by: dreamer6680 <1468683855@qq.com> Co-authored-by: dreamer6680 <146868355@qq.com>
2025-10-18 09:24:03 +00:00 · 2025-07-23 21:35:03 +08:00
parent ce9ec1bf57
commit fe7abf22a9
895 changed files with 36297 additions and 56 deletions
--- a/document/components/sideBar.tsx
+++ b/document/components/sideBar.tsx
@@ -0,0 +1,81 @@
+'use client';
+
+import { usePathname } from 'next/navigation';
+import { useEffect, type FC, type ReactNode } from 'react';
+import {
+  SidebarItem,
+  SidebarFolder,
+  SidebarFolderTrigger,
+  SidebarFolderContent
+} from 'fumadocs-ui/components/layout/sidebar';
+import { type SidebarComponents } from 'fumadocs-ui/components/layout/sidebar';
+import { type PageTree } from 'fumadocs-core/server';
+
+const isInFolder = (folder: PageTree.Folder, pathname: string): boolean => {
+  const check = (item: PageTree.Item | PageTree.Folder): boolean => {
+    if ('children' in item) {
+      return item.children
+        .filter(
+          (child): child is PageTree.Item | PageTree.Folder => 'url' in child || 'children' in child
+        )
+        .some(check);
+    }
+    return 'url' in item && item.url === pathname;
+  };
+  return check(folder);
+};
+
+const CustomItem: FC<{ item: PageTree.Item }> = ({ item }) => {
+  const pathname = usePathname();
+  const isActive = pathname === item.url;
+
+  useEffect(() => {
+    if (isActive) {
+      const anchor = document.querySelector(`a[href='${item.url}']`);
+      if (anchor) {
+        setTimeout(() => {
+          anchor.scrollIntoView({ behavior: 'smooth', block: 'center' });
+        }, 100);
+      }
+    }
+  }, [isActive, item.url]);
+
+  return (
+    <SidebarItem
+      href={item.url}
+      className={`rounded-lg hover:cursor-pointer ${isActive && 'bg-blue-50 font-bold text-[#3370FF] dark:bg-[rgba(104,143,232,0.1)] dark:text-blue-400'} 
+      `}
+    >
+      {item.icon}
+      {item.name}
+    </SidebarItem>
+  );
+};
+
+const CustomFolder: FC<{ item: PageTree.Folder; level: number; children: ReactNode }> = ({
+  item,
+  level,
+  children
+}) => {
+  const pathname = usePathname();
+  const shouldExpand = isInFolder(item, pathname);
+
+  return (
+    <SidebarFolder defaultOpen={shouldExpand} className="bg-blue hover:cursor-pointer">
+      <SidebarFolderTrigger className="hover:cursor-pointer">{item.name}</SidebarFolderTrigger>
+      <SidebarFolderContent className="bg-blue hover:cursor-pointer">
+        {children}
+      </SidebarFolderContent>
+    </SidebarFolder>
+  );
+};
+
+const CustomSeparator: FC<{ item: PageTree.Separator }> = ({ item }) => (
+  <div className="text-sm font-semibold px-2 py-2 mt-4 mb-2">{item.name}</div>
+);
+
+export const CustomSidebarComponents: SidebarComponents = {
+  Item: CustomItem,
+  Folder: CustomFolder,
+  Separator: CustomSeparator
+};