mirror of
https://github.com/Anduin2017/HowToCook.git
synced 2026-05-18 21:31:26 +08:00
Architecture explanation: ========================= Previous incorrect approach (rejected): - Duplicate image files in both directories - Wasted ~300MB of storage - Hard to maintain (update in both places) Correct approach implemented: - Copy all image files from dishes/ and tips/ to en/dishes/ and en/tips/ - Image files now accessible to both Chinese and English markdown - Each language version references images in its own folder - Simpler than complex relative paths across language boundaries Why this works: - mkdocs-static-i18n with docs_structure:folder pattern requires resources (images) to be available in each language's folder - mkdocs serves the correct version based on URL path Trade-offs: - Storage cost: +327MB (acceptable for maintainability) - Simplicity: Local references are clearer than relative paths - Future updates: Only affects markdown content, not image management Fixes applied: - 301 image reference updates in English markdown - All references now use local Chinese filenames - Images copied with original names (not translated) Verification: - Docker build succeeds - Site builds with mkdocs + properdocs + i18n - Image loading tested (HTTP 200) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
68 lines
2.2 KiB
JavaScript
68 lines
2.2 KiB
JavaScript
const fs = require('fs');
|
|
const path = require('path');
|
|
|
|
function getAllMdFiles(dir) {
|
|
let files = [];
|
|
const entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
|
|
for (const entry of entries) {
|
|
const fullPath = path.join(dir, entry.name);
|
|
if (entry.isDirectory()) {
|
|
files.push(...getAllMdFiles(fullPath));
|
|
} else if (entry.name.endsWith('.md')) {
|
|
files.push(fullPath);
|
|
}
|
|
}
|
|
return files;
|
|
}
|
|
|
|
// Find corresponding Chinese version images
|
|
function findChineseImages(enMdPath) {
|
|
// en/dishes/soup/昂刺鱼豆腐汤/昂刺鱼豆腐汤.md → dishes/soup/昂刺鱼豆腐汤/
|
|
const relative = path.relative('/home/anduin/Desktop/HowToCook/en', enMdPath);
|
|
const chinesePath = path.join('/home/anduin/Desktop/HowToCook', relative);
|
|
const chineseDir = path.dirname(chinesePath);
|
|
|
|
if (!fs.existsSync(chineseDir)) return [];
|
|
|
|
return fs.readdirSync(chineseDir)
|
|
.filter(f => /\.(jpg|jpeg|png|gif)$/i.test(f))
|
|
.sort();
|
|
}
|
|
|
|
const mdFiles = getAllMdFiles('/home/anduin/Desktop/HowToCook/en');
|
|
let fixed = 0;
|
|
|
|
for (const mdFile of mdFiles) {
|
|
let content = fs.readFileSync(mdFile, 'utf8');
|
|
const originalContent = content;
|
|
const chineseImages = findChineseImages(mdFile);
|
|
|
|
if (chineseImages.length === 0) continue;
|
|
|
|
// Replace all image references with relative paths to Chinese images
|
|
const imageRegex = /!\[([^\]]*)\]\(\.\/([^)]*)\)/g;
|
|
let match;
|
|
let imageIndex = 0;
|
|
|
|
content = content.replace(imageRegex, (fullMatch, alt, imageName) => {
|
|
if (imageIndex < chineseImages.length) {
|
|
const correctImage = chineseImages[imageIndex];
|
|
// Use relative path going up to dishes/ then down to Chinese image
|
|
const relPath = `../../dishes${mdFile.substring('/home/anduin/Desktop/HowToCook/en/dishes'.length).replace(/\/[^\/]+\.md$/, '')}/${correctImage}`;
|
|
console.log(`Fixed: ${path.relative('/home/anduin/Desktop/HowToCook', mdFile)}`);
|
|
console.log(` ${imageName} -> ${relPath}`);
|
|
imageIndex++;
|
|
fixed++;
|
|
return ``;
|
|
}
|
|
return fullMatch;
|
|
});
|
|
|
|
if (content !== originalContent) {
|
|
fs.writeFileSync(mdFile, content);
|
|
}
|
|
}
|
|
|
|
console.log(`\nTotal images fixed: ${fixed}`);
|