✨ support manually pass sidebar version

Author: StarHeartHunt

packages/theme-nonepress/src/theme/MDXPage/index.tsx

@@ -29,9 +29,11 @@ export default function MDXPage(props: Props): JSX.Element {
   } = frontMatter;
 
   const sidebarCustomProps = frontMatter.sidebar_custom_props as {
-    sidebar_id: string;
+    sidebar_id?: string;
+    sidebar_version?: string;
   };
   const sidebarId = sidebarCustomProps?.sidebar_id;
+  const sidebarVersion = sidebarCustomProps?.sidebar_version;
 
   return (
     <HtmlClassNameProvider
@@ -56,6 +58,7 @@ export default function MDXPage(props: Props): JSX.Element {
           minHeadingLevel={tocMinHeadingLevel!}
           maxHeadingLevel={tocMaxHeadingLevel!}
           sidebarId={sidebarId}
+          sidebarVersion={sidebarVersion}
           toc={toc}
         >
           <article className="prose max-w-full">

packages/theme-nonepress/src/theme/Page/Sidebar/index.tsx

@@ -18,7 +18,8 @@ import "./styles.css";
 
 export default function Sidebar({
   className,
-  sidebarId = "",
+  sidebarId,
+  sidebarVersion,
 }: Props): JSX.Element | null {
   const { pathname } = useLocation();
   const windowSize = useWindowSize();
@@ -30,8 +31,8 @@ export default function Sidebar({
 
   const docsVersionCandidate = useDocsVersionCandidates();
   const sidebarContent = useVersionedSidebar(
-    docsVersionCandidate[0].name,
-    sidebarId,
+    sidebarVersion || docsVersionCandidate[0].name,
+    sidebarId || "",
   );
 
   if (isMobile || !sidebarContent || sidebarContent.length === 0) {

packages/theme-nonepress/src/theme/Page/index.tsx

@@ -14,6 +14,7 @@ export default function Page({
   hideTableOfContents = false,
   reduceContentWidth = true,
   sidebarId,
+  sidebarVersion,
   toc,
   minHeadingLevel,
   maxHeadingLevel,
@@ -24,7 +25,7 @@ export default function Page({
     <div className="page">
       {/* sidebar */}
       {!hideSidebar && (
-        <Sidebar sidebarId={sidebarId} className="page-sidebar" />
+        <Sidebar sidebarId={sidebarId} sidebarVersion={sidebarVersion} className="page-sidebar" />
       )}
       {/* main */}
       <main className="page-main">

packages/theme-nonepress/src/types.d.ts

@@ -1519,6 +1519,7 @@ declare module "@theme/Page" {
     readonly hideTableOfContents?: boolean;
     readonly reduceContentWidth?: boolean;
     readonly sidebarId?: string;
+    readonly sidebarVersion?: string;
     readonly toc?: readonly TOCItem[];
     readonly minHeadingLevel?: number;
     readonly maxHeadingLevel?: number;
@@ -1618,6 +1619,7 @@ declare module "@theme/Page/Sidebar" {
   export interface Props {
     readonly className?: string;
     readonly sidebarId?: string;
+    readonly sidebarVersion?: string;
   }
 
   export default function Sidebar(props: Props): JSX.Element | null;

website/docusaurus.config.ts

@@ -78,7 +78,8 @@ export default async function createConfigAsync() {
           changelogHeader: `description: Changelog
 toc_max_heading_level: 2
 sidebar_custom_props:
-  sidebar_id: changelog`,
+  sidebar_id: changelog
+  sidebar_version: current`,
         } satisfies ChangelogOptions,
       ],
     ],