use fumadocs

Author: undefined-moe

.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": ["next/core-web-vitals", "next/typescript"]
+}

.gitignore

@@ -3,3 +3,31 @@ node_modules
 .vuepress/dist
 .cache/
 .temp/
+# deps
+/node_modules
+
+# generated content
+.contentlayer
+.content-collections
+.source
+
+# test & build
+/coverage
+/.next/
+/out/
+/build
+*.tsbuildinfo
+
+# misc
+.DS_Store
+*.pem
+/.pnp
+.pnp.js
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# others
+.env*.local
+.vercel
+next-env.d.ts

api/README.md

@@ -0,0 +1,7 @@
+import type { ReactNode } from 'react';
+import { HomeLayout } from 'fumadocs-ui/layouts/home';
+import { baseOptions } from '@/app/layout.config';
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return <HomeLayout {...baseOptions}>{children}dsa</HomeLayout>;
+}

app/(home)/layout.tsx

@@ -0,0 +1,19 @@
+import Link from 'next/link';
+
+export default function HomePage() {
+  return (
+    <main className="flex flex-1 flex-col justify-center text-center">
+      <h1 className="mb-4 text-2xl font-bold">Hello World</h1>
+      <p className="text-fd-muted-foreground">
+        You can open{' '}
+        <Link
+          href="/docs"
+          className="text-fd-foreground font-semibold underline"
+        >
+          /docs
+        </Link>{' '}
+        and see the documentation.
+      </p>
+    </main>
+  );
+}

app/(home)/page.tsx

@@ -0,0 +1,29 @@
+import { source } from '@/lib/source';
+import { createFromSource } from 'fumadocs-core/search/server';
+import { createTokenizer } from '@orama/tokenizers/mandarin';
+import { stopwords as mandarinStopwords } from "@orama/stopwords/mandarin";
+
+export const revalidate = false;
+
+const tokenizer = createTokenizer({
+    stopWords: mandarinStopwords,
+});
+const search = {
+    tokenizer,
+    language: 'mandarin',
+    components: {
+        tokenizer,
+    },
+    search: {
+        threshold: 0,
+        tolerance: 0,
+    },
+}
+export const { staticGET: GET } = createFromSource(source, undefined, {
+    localeMap: {
+        cn: search,
+        en: search,
+        mandarin: search,
+        english: search,
+    }
+});

app/api/search/route.ts

@@ -0,0 +1,54 @@
+import { source } from '@/lib/source';
+import { Popup, PopupContent, PopupTrigger } from 'fumadocs-twoslash/ui';
+import { Callout } from 'fumadocs-ui/components/callout';
+import {
+  DocsPage,
+  DocsBody,
+  DocsDescription,
+  DocsTitle,
+} from 'fumadocs-ui/page';
+import { notFound } from 'next/navigation';
+import defaultMdxComponents from 'fumadocs-ui/mdx';
+
+export default async function Page(props: {
+  params: Promise<{ slug?: string[] }>;
+}) {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+
+  const MDX = page.data.body;
+
+  return (
+    <DocsPage toc={page.data.toc} full={page.data.full}>
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription>{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX components={{ 
+          ...defaultMdxComponents,
+          Popup,
+          PopupContent,
+          PopupTrigger,
+          Callout,
+        }} />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+export async function generateStaticParams() {
+  return source.generateParams();
+}
+
+export async function generateMetadata(props: {
+  params: Promise<{ slug?: string[] }>;
+}) {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+
+  return {
+    title: page.data.title,
+    description: page.data.description,
+  };
+}

app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,35 @@
+import { DocsLayout } from 'fumadocs-ui/layouts/docs';
+import { RootToggle } from 'fumadocs-ui/components/layout/root-toggle';
+import type { ReactNode } from 'react';
+import { baseOptions } from '@/app/layout.config';
+import { source } from '@/lib/source';
+
+export default function Layout({ children }: { children: ReactNode }) {
+  return (
+    <DocsLayout
+      tree={source.pageTree}
+      {...baseOptions}
+      sidebar={{
+        tabs: false,
+        banner: (
+          <RootToggle
+            options={[
+              {
+                title: 'Hydro',
+                description: 'The Online Judge System',
+                url: '/docs/Hydro',
+              },
+              {
+                title: 'XCPC-Tools',
+                description: 'Tools for on-site contests',
+                url: '/docs/Tools',
+              },
+            ]}
+          />
+        ),
+      }}
+    >
+      {children}
+    </DocsLayout>
+  );
+}

app/docs/layout.tsx

@@ -0,0 +1,5 @@
+@import 'tailwindcss';
+@import 'fumadocs-ui/css/neutral.css';
+@import 'fumadocs-ui/css/preset.css';
+
+@source '../node_modules/fumadocs-ui/dist/**/*.js';

app/global.css

@@ -0,0 +1,27 @@
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+import Image from 'next/image';
+
+/**
+ * Shared layout configurations
+ *
+ * you can customise layouts individually from:
+ * Home Layout: app/(home)/layout.tsx
+ * Docs Layout: app/docs/layout.tsx
+ */
+export const baseOptions: BaseLayoutProps = {
+  nav: {
+    title: (
+      <>
+        <Image
+          width="24"
+          height="24"
+          src="https://hydro.ac/favicon.svg"
+          alt="Logo"
+        />
+        Hydro
+      </>
+    ),
+  },
+  links: [
+  ],
+};