feat: add metadata

Author: zhangqifan

metadata.js

@@ -0,0 +1,73 @@
+const fs = require('fs');
+const path = require('path');
+
+// 假设 JSON 数据已经保存在一个文件中
+const jsonData = require('./swift_docs_structure.json');
+
+// 根目录路径
+const rootDir = './swift-6-beta.docc';
+
+// GitHub 仓库的基础 URL
+const githubBaseUrl = 'https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc';
+
+// 递归遍历目录
+function traverseDirectory(dir) {
+    const files = fs.readdirSync(dir);
+
+    files.forEach(file => {
+        const fullPath = path.join(dir, file);
+        const stat = fs.statSync(fullPath);
+
+        if (stat.isDirectory()) {
+            traverseDirectory(fullPath);
+        } else if (path.extname(file) === '.md') {
+            processMarkdownFile(fullPath);
+        }
+    });
+}
+
+// 处理 Markdown 文件
+function processMarkdownFile(filePath) {
+    const relativePath = path.relative(rootDir, filePath);
+    const fileName = path.basename(filePath, '.md');
+
+    // 查找匹配的 URL
+    let matchingUrl = null;
+    for (const section in jsonData) {
+        const match = jsonData[section].find(item => {
+            const urlParts = item.url.split('/');
+            const lastPart = urlParts[urlParts.length - 1].toLowerCase();
+            return lastPart === fileName.toLowerCase() ||
+                lastPart === fileName.toLowerCase().replace(/[^a-z0-9]/g, '');
+        });
+        if (match) {
+            matchingUrl = match.url;
+            break;
+        }
+    }
+
+    if (matchingUrl) {
+        const content = fs.readFileSync(filePath, 'utf8');
+
+        // 检查文件是否已经包含了注释
+        if (content.includes('要翻译的文件：') && content.includes('Swift 文档源文件地址：')) {
+            console.log(`Already updated: ${filePath}`);
+            return;
+        }
+
+        const newContent = `<!--
+要翻译的文件：${githubBaseUrl}/${relativePath.replace(/\\/g, '/')}
+Swift 文档源文件地址：${matchingUrl}
+-->
+
+${content}`;
+
+        fs.writeFileSync(filePath, newContent);
+        console.log(`Updated: ${filePath}`);
+    } else {
+        console.log(`No matching URL found for: ${filePath}`);
+    }
+}
+
+// 开始处理
+traverseDirectory(rootDir);

swift-6-beta.docc/GuidedTour/AboutSwift.md

@@ -1,3 +1,8 @@
+<!--
+要翻译的文件：https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc/GuidedTour/AboutSwift.md
+Swift 文档源文件地址：https://docs.swift.org/swift-book/documentation/the-swift-programming-language/aboutswift
+-->
+
 # About Swift
 
 Understand the high-level goals of the language.

swift-6-beta.docc/GuidedTour/Compatibility.md

@@ -1,3 +1,8 @@
+<!--
+要翻译的文件：https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc/GuidedTour/Compatibility.md
+Swift 文档源文件地址：https://docs.swift.org/swift-book/documentation/the-swift-programming-language/compatibility
+-->
+
 # Version Compatibility
 
 Learn what functionality is available in older language modes.

swift-6-beta.docc/GuidedTour/GuidedTour.md

@@ -1,3 +1,8 @@
+<!--
+要翻译的文件：https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc/GuidedTour/GuidedTour.md
+Swift 文档源文件地址：https://docs.swift.org/swift-book/documentation/the-swift-programming-language/guidedtour
+-->
+
 # A Swift Tour
 
 Explore the features and syntax of Swift.

swift-6-beta.docc/LanguageGuide/AccessControl.md

@@ -1,3 +1,8 @@
+<!--
+要翻译的文件：https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc/LanguageGuide/AccessControl.md
+Swift 文档源文件地址：https://docs.swift.org/swift-book/documentation/the-swift-programming-language/accesscontrol
+-->
+
 # Access Control
 
 Manage the visibility of code by declaration, file, and module.

swift-6-beta.docc/LanguageGuide/AdvancedOperators.md

@@ -1,3 +1,8 @@
+<!--
+要翻译的文件：https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc/LanguageGuide/AdvancedOperators.md
+Swift 文档源文件地址：https://docs.swift.org/swift-book/documentation/the-swift-programming-language/advancedoperators
+-->
+
 # Advanced Operators
 
 Define custom operators, perform bitwise operations, and use builder syntax.

swift-6-beta.docc/LanguageGuide/AutomaticReferenceCounting.md

@@ -1,3 +1,8 @@
+<!--
+要翻译的文件：https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc/LanguageGuide/AutomaticReferenceCounting.md
+Swift 文档源文件地址：https://docs.swift.org/swift-book/documentation/the-swift-programming-language/automaticreferencecounting
+-->
+
 # Automatic Reference Counting
 
 Model the lifetime of objects and their relationships.

swift-6-beta.docc/LanguageGuide/BasicOperators.md

@@ -1,3 +1,8 @@
+<!--
+要翻译的文件：https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc/LanguageGuide/BasicOperators.md
+Swift 文档源文件地址：https://docs.swift.org/swift-book/documentation/the-swift-programming-language/basicoperators
+-->
+
 # Basic Operators
 
 Perform operations like assignment, arithmetic, and comparison.

swift-6-beta.docc/LanguageGuide/ClassesAndStructures.md

@@ -1,3 +1,8 @@
+<!--
+要翻译的文件：https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc/LanguageGuide/ClassesAndStructures.md
+Swift 文档源文件地址：https://docs.swift.org/swift-book/documentation/the-swift-programming-language/classesandstructures
+-->
+
 # Structures and Classes
 
 Model custom types that encapsulate data.

swift-6-beta.docc/LanguageGuide/Closures.md

@@ -1,3 +1,8 @@
+<!--
+要翻译的文件：https://github.com/SwiftGGTeam/the-swift-programming-language-in-chinese/blob/swift-6-beta-translation/swift-6-beta.docc/LanguageGuide/Closures.md
+Swift 文档源文件地址：https://docs.swift.org/swift-book/documentation/the-swift-programming-language/closures
+-->
+
 # Closures
 
 Group code that executes together, without creating a named function.