modify script plugin so that snippets update on build permanently

Author: Blargian

docusaurus.config.en.js

@@ -5,7 +5,7 @@ import chHeader from "./plugins/header.js";
 import fixLinks from "./src/hooks/fixLinks.js";
 const path = require('path');
 const remarkCustomBlocks = require('./plugins/remark-custom-blocks');
-const remarkCodeImport = require('./plugins/remark-code-import');
+const codeImportPlugin = require('./plugins/code-import-plugin');
 
 // Import custom plugins
 const { customParseFrontMatter } = require('./plugins/frontmatter-validation/customParseFrontMatter');
@@ -153,7 +153,7 @@ const config = {
           showLastUpdateTime: false,
           sidebarCollapsed: true,
           routeBasePath: "/",
-          remarkPlugins: [math, remarkCustomBlocks, glossaryTransformer, [remarkCodeImport, { baseDir: __dirname }]],
+          remarkPlugins: [math, remarkCustomBlocks, glossaryTransformer],
           beforeDefaultRemarkPlugins: [fixLinks],
           rehypePlugins: [katex],
         },
@@ -356,6 +356,10 @@ const config = {
     [
         './plugins/tailwind-config.js',
         {}
+    ],
+    [
+        codeImportPlugin,
+        {}
     ]
   ],
   customFields: {

package.json

@@ -63,7 +63,6 @@
     "node-fetch": "^3.3.2",
     "numeral": "^2.0.6",
     "prism-react-renderer": "^2.4.1",
-    "raw-loader": "^4.0.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "react-medium-image-zoom": "^5.2.14",

plugins/code-import-plugin.js

@@ -0,0 +1,75 @@
+const fs = require('fs');
+const path = require('path');
+const glob = require('glob');
+
+function codeImportPlugin(context, options) {
+  return {
+    name: 'code-import-plugin',
+    async loadContent() {
+      // Find all markdown files in docs directory that might contain code imports
+      const docsPath = path.join(context.siteDir, 'docs');
+      
+      const markdownFiles = [
+        ...glob.sync('**/*.md', { cwd: docsPath, absolute: true }),
+        ...glob.sync('**/*.mdx', { cwd: docsPath, absolute: true }),
+      ];
+
+      // Process each markdown file for code imports
+      const processedFiles = [];
+      
+      for (const filePath of markdownFiles) {
+        try {
+          let content = fs.readFileSync(filePath, 'utf8');
+          let modified = false;
+          
+          // Process code blocks with file= syntax
+          content = content.replace(/```(\w+)?\s*(file=[^\s\n]+)([^\n]*)\n([^`]*?)```/g, (match, lang, fileParam, additionalMeta, existingContent) => {
+            try {
+              const importPath = fileParam.replace('file=', '');
+              const absoluteImportPath = path.resolve(context.siteDir, importPath);
+              const importedContent = fs.readFileSync(absoluteImportPath, 'utf8');
+              modified = true;
+              
+              // Preserve the complete metadata including file= and any additional parameters
+              const fullMeta = `${fileParam}${additionalMeta}`;
+              const metaStr = fullMeta ? ` ${fullMeta}` : '';
+              
+              return `\`\`\`${lang || ''}${metaStr}\n${importedContent}\`\`\``;
+            } catch (error) {
+              console.warn(`Could not import file ${importPath} in ${filePath}: ${error.message}`);
+              return match; // Return original if import fails
+            }
+          });
+          
+          if (modified) {
+            processedFiles.push({
+              path: filePath,
+              content: content,
+              originalPath: filePath
+            });
+          }
+        } catch (error) {
+          console.warn(`Error processing file ${filePath}: ${error.message}`);
+        }
+      }
+      
+      return { processedFiles };
+    },
+    
+    async contentLoaded({ content, actions }) {
+      const { processedFiles } = content;
+      
+      // Write processed files back to disk during build
+      for (const file of processedFiles) {
+        try {
+          fs.writeFileSync(file.path, file.content, 'utf8');
+          console.log(`Processed code imports in: ${path.relative(context.siteDir, file.path)}`);
+        } catch (error) {
+          console.error(`Error writing processed file ${file.path}: ${error.message}`);
+        }
+      }
+    }
+  };
+}
+
+module.exports = codeImportPlugin;

plugins/remark-code-import.js

@@ -11754,14 +11754,6 @@ raw-body@2.5.2:
     iconv-lite "0.4.24"
     unpipe "1.0.0"
 
-raw-loader@^4.0.2:
-  version "4.0.2"
-  resolved "https://registry.yarnpkg.com/raw-loader/-/raw-loader-4.0.2.tgz#1aac6b7d1ad1501e66efdac1522c73e59a584eb6"
-  integrity sha512-ZnScIV3ag9A4wPX/ZayxL/jZH+euYb6FcUinPcgiQW0+UBtEv0O6Q3lGd3cqJ+GHH+rksEv3Pj99oxJ3u3VIKA==
-  dependencies:
-    loader-utils "^2.0.0"
-    schema-utils "^3.0.0"
-
 rc@1.2.8, rc@^1.2.7:
   version "1.2.8"
   resolved "https://registry.yarnpkg.com/rc/-/rc-1.2.8.tgz#cd924bf5200a075b83c188cd6b9e211b7fc0d3ed"