常見錯誤與疑難排解

螢幕截圖路徑中沒有地區設定目錄images/screenshots/screenshot.png — 無法區分地區設定變體，也無法重寫。在使用每個地區設定資料夾重寫之前，請重組為images/screenshots/<locale>/screenshot.png。

正規表達式中硬式編碼來源地區設定"search": "screenshots/en-GB/" — 如果 sourceLocale 變更，將會無聲無息地中斷。請改用 "search": "screenshots/[^/]+/"。

SVG 來源與輸出在同一個目錄 如果 svg.sourcePath 與 svg.outputDir 重疊，產生的檔案將會與手動編輯的來源混雜。請將它們放在不同的目錄中。

Docusaurus 中 SVG 的絕對靜態 URL/img/diagram.svg（來自 static/img/）需要 regexAdjustments 規則才能在翻譯後的輸出中重寫為 ../assets/。請將來源 SVG 放在 static/assets/，並從一開始就使用相對的 ../assets/diagram.svg，以完全避免此問題。

Docusaurus 中缺少 docs/assets 符號連結 沒有符號連結，docs/user-guide/ 中的來源文件無法透過相對路徑參考 static/assets/ 中的 PNG 或 SVG。請在專案建立時設定符號連結：ln -s ../static/assets documentation/docs/assets。

take-screenshots指令碼僅擷取來源地區設定 每個地區設定的資料夾佈局需要每個地區設定的PNG檔案。如果指令碼僅擷取en-GB，則翻譯的文件將具有指向遺失檔案的重寫路徑。

regexAdjustments 在圍欄式設定範例內的重寫postProcessing 會在完整的翻譯後 markdown 主體上執行，包括圍欄式程式碼區塊。如果文件頁面內嵌了包含相符路徑的設定片段（例如 screenshots/en-GB/），該片段在翻譯後的輸出中也會被重寫。在可重複使用的範例中，請優先使用通用的 screenshots/[^/]+/ 形式，或者接受翻譯後的文件會在圖解中顯示特定地區的路徑。