From 1d62f72e87d014c0e37815050be51d469f62badf Mon Sep 17 00:00:00 2001
From: port <108868128+portdeveloper@users.noreply.github.com>
Date: Sat, 16 May 2026 13:12:47 +0000
Subject: [PATCH 1/5] add docusaurus-plugin-copy-page-button
---
website/docusaurus.config.ts | 1 +
website/package.json | 1 +
2 files changed, 2 insertions(+)
diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts
index 52512b4cdfc..c4dd2e99419 100644
--- a/website/docusaurus.config.ts
+++ b/website/docusaurus.config.ts
@@ -221,6 +221,7 @@ const config: Config = {
],
plugins: [
'docusaurus-plugin-sass',
+ 'docusaurus-plugin-copy-page-button',
function disableExpensiveBundlerOptimizationPlugin() {
return {
name: 'disable-expensive-bundler-optimizations',
diff --git a/website/package.json b/website/package.json
index 8fa6cc9b9b6..7c09d8defdf 100644
--- a/website/package.json
+++ b/website/package.json
@@ -56,6 +56,7 @@
"@docusaurus/plugin-pwa": "3.10.1",
"@docusaurus/preset-classic": "3.10.1",
"@docusaurus/theme-mermaid": "3.10.1",
+ "docusaurus-plugin-copy-page-button": "^0.5.1",
"docusaurus-plugin-sass": "^0.2.6",
"react": "^19.2.6",
"react-dom": "^19.2.6",
From 7b5dfd10f0a9fb47ea839966596ad1d4c68868f4 Mon Sep 17 00:00:00 2001
From: port <108868128+portdeveloper@users.noreply.github.com>
Date: Sat, 16 May 2026 14:37:35 +0000
Subject: [PATCH 2/5] bump docusaurus-plugin-copy-page-button to 0.5.2
includes fixes for @Simek's feedback (no-ToC fallback, layout shift, font, first-render race)
---
website/package.json | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/website/package.json b/website/package.json
index 7c09d8defdf..2cdafba9559 100644
--- a/website/package.json
+++ b/website/package.json
@@ -56,7 +56,7 @@
"@docusaurus/plugin-pwa": "3.10.1",
"@docusaurus/preset-classic": "3.10.1",
"@docusaurus/theme-mermaid": "3.10.1",
- "docusaurus-plugin-copy-page-button": "^0.5.1",
+ "docusaurus-plugin-copy-page-button": "^0.5.2",
"docusaurus-plugin-sass": "^0.2.6",
"react": "^19.2.6",
"react-dom": "^19.2.6",
From 5c51def1667a1fea0a7c9e52cf269d841c05827e Mon Sep 17 00:00:00 2001
From: port <108868128+portdeveloper@users.noreply.github.com>
Date: Thu, 21 May 2026 09:52:58 +0000
Subject: [PATCH 3/5] Fix copy page button rendering
---
website/docusaurus.config.ts | 1 -
website/src/theme/DocItem/Layout/index.tsx | 101 ++++++++++++++++++
.../theme/DocItem/Layout/styles.module.css | 54 ++++++++++
.../docusaurus-plugin-copy-page-button.d.ts | 31 ++++++
4 files changed, 186 insertions(+), 1 deletion(-)
create mode 100644 website/src/theme/DocItem/Layout/index.tsx
create mode 100644 website/src/theme/DocItem/Layout/styles.module.css
create mode 100644 website/src/types/docusaurus-plugin-copy-page-button.d.ts
diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts
index c4dd2e99419..52512b4cdfc 100644
--- a/website/docusaurus.config.ts
+++ b/website/docusaurus.config.ts
@@ -221,7 +221,6 @@ const config: Config = {
],
plugins: [
'docusaurus-plugin-sass',
- 'docusaurus-plugin-copy-page-button',
function disableExpensiveBundlerOptimizationPlugin() {
return {
name: 'disable-expensive-bundler-optimizations',
diff --git a/website/src/theme/DocItem/Layout/index.tsx b/website/src/theme/DocItem/Layout/index.tsx
new file mode 100644
index 00000000000..3287c634f50
--- /dev/null
+++ b/website/src/theme/DocItem/Layout/index.tsx
@@ -0,0 +1,101 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import React, {type ReactNode} from 'react';
+import clsx from 'clsx';
+import {useWindowSize} from '@docusaurus/theme-common';
+import {useDoc} from '@docusaurus/plugin-content-docs/client';
+import CopyPageButton from 'docusaurus-plugin-copy-page-button/src/CopyPageButton';
+import DocItemPaginator from '@theme/DocItem/Paginator';
+import DocVersionBanner from '@theme/DocVersionBanner';
+import DocVersionBadge from '@theme/DocVersionBadge';
+import DocItemFooter from '@theme/DocItem/Footer';
+import DocItemTOCMobile from '@theme/DocItem/TOC/Mobile';
+import DocItemTOCDesktop from '@theme/DocItem/TOC/Desktop';
+import DocItemContent from '@theme/DocItem/Content';
+import DocBreadcrumbs from '@theme/DocBreadcrumbs';
+import ContentVisibility from '@theme/ContentVisibility';
+import type {Props} from '@theme/DocItem/Layout';
+
+import styles from './styles.module.css';
+
+function DocItemCopyPageButton({className}: {className?: string}) {
+ return (
+
+
+
+ );
+}
+
+/**
+ * Decide if the toc should be rendered, on mobile or desktop viewports
+ */
+function useDocTOC() {
+ const {frontMatter, toc} = useDoc();
+ const windowSize = useWindowSize();
+
+ const hidden = frontMatter.hide_table_of_contents;
+ const canRender = !hidden && toc.length > 0;
+
+ const mobile = canRender ? : undefined;
+
+ const desktop =
+ canRender && (windowSize === 'desktop' || windowSize === 'ssr') ? (
+
+ ) : undefined;
+
+ return {
+ canRender,
+ hidden,
+ mobile,
+ desktop,
+ };
+}
+
+export default function DocItemLayout({children}: Props): ReactNode {
+ const docTOC = useDocTOC();
+ const {metadata} = useDoc();
+ return (
+
+
+
+
+
+
+
+
+ {docTOC.mobile}
+
+ {children}
+
+
+
+
+
+ {docTOC.desktop && (
+
+
+ {docTOC.desktop}
+
+ )}
+