From ebba7b336e1103d1302e63b6993c1c736c67ac1a Mon Sep 17 00:00:00 2001 From: Thomas Heartman Date: Fri, 1 Sep 2023 10:35:45 +0200 Subject: [PATCH 1/3] docs: fix an issue where it goes into an infinite loop when building This change sets `noRuntimeDownloads` to `true` for `plugin-remote-content'` to avoid the infinite loop issue mentioned in https://github.com/rdilweb/docusaurus-plugin-remote-content/issues/51, as described in https://github.com/rdilweb/docusaurus-plugin-remote-content#noruntimedownloads. I suspect that this will require you to generate the files before running the doc build, which may be an issue. However, this does stop the doc from building over and over. --- website/docusaurus.config.js | 2 ++ 1 file changed, 2 insertions(+) diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js index eb613be0639d..6ffe1cc93dc5 100644 --- a/website/docusaurus.config.js +++ b/website/docusaurus.config.js @@ -618,6 +618,7 @@ module.exports = { outDir: 'docs/generated', // the base directory to output to. documents: sdks.urls, // the file names to download modifyContent: sdks.modifyContent, + noRuntimeDownloads: true, }, ], [ @@ -629,6 +630,7 @@ module.exports = { outDir: 'docs/generated/', // the base directory to output to. documents: edgeAndProxy.urls, // the file names to download modifyContent: edgeAndProxy.modifyContent, + noRuntimeDownloads: true, }, ], ], From d0d9da888bdefb8d3706c5d4fc70a544919f36da Mon Sep 17 00:00:00 2001 From: Thomas Heartman Date: Fri, 13 Oct 2023 12:01:27 +0200 Subject: [PATCH 2/3] docs: add pre-fetch scripts to start and build --- website/package.json | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/website/package.json b/website/package.json index 2deaaa84fd17..1c8b69079749 100644 --- a/website/package.json +++ b/website/package.json @@ -7,9 +7,10 @@ }, "scripts": { "docusaurus": "docusaurus", - "start": "docusaurus start", - "build": "yarn generate && docusaurus build", + "start": "yarn fetch-remote-content && docusaurus start", + "build": "yarn generate && yarn fetch-remote-content && docusaurus build", "swizzle": "docusaurus swizzle", + "fetch-remote-content": "docusaurus download-remote-content-external && docusaurus download-remote-content-sdks", "generate": "docusaurus gen-api-docs all && node clean-generated-docs.js", "deploy": "yarn generate && docusaurus deploy", "clear": "docusaurus clear", From a7ebd95b6537d7d24f3aea5e9dc9d3ac3c346a77 Mon Sep 17 00:00:00 2001 From: Thomas Heartman Date: Thu, 2 Nov 2023 10:47:19 +0100 Subject: [PATCH 3/3] Update website/package.json --- website/package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/package.json b/website/package.json index 1c8b69079749..e53d87d7386a 100644 --- a/website/package.json +++ b/website/package.json @@ -12,7 +12,7 @@ "swizzle": "docusaurus swizzle", "fetch-remote-content": "docusaurus download-remote-content-external && docusaurus download-remote-content-sdks", "generate": "docusaurus gen-api-docs all && node clean-generated-docs.js", - "deploy": "yarn generate && docusaurus deploy", + "deploy": "yarn generate && yarn fetch-remote-content && docusaurus deploy", "clear": "docusaurus clear", "serve": "docusaurus serve", "write-translations": "docusaurus write-translations",