प्रति-स्थानिक फ़ोल्डर (URL पुनर्लेखन)

docsOutput.style = "flat" के साथ README/USER-GUIDE के लिए, और डॉक-सिस्टम साइटों (docsOutput.style = "doc-system" या उपनाम "docusaurus" / "astro-starlight") के लिए और "vitepress" / अन्य डॉक-सिस्टम प्रीसेट के लिए उपयोग करें जो एक साझा स्थिर URL ट्री से स्क्रीनशॉट प्रदान करते हैं। VitePress के लिए लिंक-पुनर्लेखन विवरण: लिंक पुनर्लेखन — VitePress।

निर्देशिका लेआउट

प्रति-स्थानिक स्क्रीनशॉट निर्देशिका ट्री का उदाहरण

images/screenshots/
├── en-GB/
│   ├── translate.png
│   └── settings.png
├── de/
│   ├── translate.png
│   └── settings.png
└── fr/
    ├── translate.png
    └── settings.png

स्रोत मार्कडाउन स्रोत स्थानीय निर्देशिका को संदर्भित करता है:

![Translate tab](images/screenshots/en-GB/translate.png)

स्क्रीनशॉट स्क्रिप्ट अनुबंध

take-screenshots स्क्रिप्ट को हर स्थानीय के लिए फ़ाइलें लिखनी चाहिए - न कि केवल स्रोत स्थानीय के लिए। translate-docs कमांड पथों को फिर से लिखता है लेकिन फ़ाइलें नहीं बनाता है। एक विशिष्ट सहायक:

function getScreenshotDir(locale) {
  return `images/screenshots/${locale}`;
}

examples/nextjs-app में स्क्रीनशॉट स्क्रिप्ट में एक साधारण bash उदाहरण देखें, या duplistatus प्रोजेक्ट से take-screenshots.ts में एक अधिक जटिल उदाहरण देखें (जो Transrewrt द्वारा उत्पादन में भी उपयोग किया जाता है)।

नोट: नीचे दिए गए चार उप-अनुभाग एक ही regexAdjustments स्थानीय-खंड स्वैप (screenshots/[^/]+/ → screenshots/${translatedLocale}/) साझा करते हैं। केवल आउटपुट लेआउट और क्या फ्लैट लिंक रीराइटर पहले चलता है, इसमें अंतर होता है — उस उप-अनुभाग पर जाएं जो आपके docsOutput.style से मेल खाता है।

नोट: regexAdjustments पूर्ण अनुवादित मार्कडाउन बॉडी पर चलता है, जिसमें फेंस्ड कोड ब्लॉक भी शामिल हैं। यदि एक डॉक पेज में एक कॉन्फ़िग उदाहरण एम्बेड किया गया है जिसमें एक मिलान पथ (जैसे screenshots/en-GB/) शामिल है, तो वह स्निपेट भी अनुवादित आउटपुट में फिर से लिखा जाएगा। पुन: प्रयोज्य उदाहरणों में सामान्य screenshots/[^/]+/ फ़ॉर्म को प्राथमिकता दें।

कॉन्फ़िग - docsOutput.style = "flat"

फ्लैट लिंक रीराइटर पहले चलता है जब docsOutput.style = "flat" और गैर-मार्कडाउन URL में एक गहराई उपसर्ग जोड़ता है। outputDir: "translated-docs/" के साथ रेपो रूट पर README.md के लिए, यह ../ जोड़ता है:

images/screenshots/en-GB/translate.png  →  ../images/screenshots/en-GB/translate.png

फिर regexAdjustments नियम उस पहले से उपसर्गित URL के भीतर स्थानीय खंड को बदल देता है:

फ्लैट लेआउट के लिए regexAdjustments का उदाहरण

"docsOutput": {
  "style": "flat",
  "postProcessing": {
    "regexAdjustments": [
      {
        "description": "Per-locale screenshot folders",
        "search": "images/screenshots/[^/]+/",
        "replace": "images/screenshots/${translatedLocale}/"
      }
    ]
  }
}

परिणाम: ../images/screenshots/de/translate.png — translated-docs/README.de.md से रेपो रूट तक सही सापेक्ष पथ।

postProcessing चरण फ्लैट लिंक रीराइटर के बाद चलता है। search रेगुलर एक्सप्रेशन लिखें जो पहले से उपसर्गित URL के भीतर कहीं भी स्थानीय खंड से मेल खाते हों — रेगुलर एक्सप्रेशन में ../ उपसर्ग को शामिल करने की आवश्यकता नहीं है।

कार्यान्वयन उदाहरण (उत्पादन): Transrewrt — README.md (images/screenshots/en-GB/…) में स्क्रीनशॉट URL, ai-i18n-tools.config.json में स्थानीय पुनर्लेखन, duplistatus से take-screenshots.ts पर आधारित कैप्चर स्क्रिप्ट (ऊपर स्क्रीनशॉट स्क्रिप्ट अनुबंध देखें)।

कार्यान्वयन उदाहरण (डेमो कॉन्फ़िग): examples/nextjs-app — ai-i18n-tools.config.json (images/screenshots/[^/]+/ → ${translatedLocale}) में दूसरा docs[] ब्लॉक; सहायक स्क्रिप्ट screenshot-locales.sh।

कॉन्फ़िग - docsOutput.style = "doc-system"

किसी भी डॉक-सिस्टम साइट के लिए समान प्रति-स्थानिक फ़ोल्डर दृष्टिकोण जो एक साझा स्थिर URL उपसर्ग के माध्यम से स्क्रीनशॉट को संदर्भित करता है। फ्लैट लिंक रीराइटर नहीं चलता है; postProcessing मूल मार्कडाउन URL में स्थानीय खंड को फिर से लिखता है।

डॉक-सिस्टम लेआउट के लिए regexAdjustments का उदाहरण

"docsOutput": {
  "style": "doc-system",
  "docsRoot": "docs",
  "localeSubpath": "your-generator/locale/content/path",
  "postProcessing": {
    "regexAdjustments": [
      {
        "description": "Per-locale screenshot folders in static assets",
        "search": "screenshots/[^/]+/",
        "replace": "screenshots/${translatedLocale}/"
      }
    ]
  }
}

अपने जनरेटर के लेआउट को {locale}/ और अनुवादित फ़ाइल के बीच मिलान करने के लिए localeSubpath सेट करें, या जब डिफ़ॉल्ट फिट हों तो "doc-system" के बजाय एक प्रीसेट उपनाम ("docusaurus", "astro-starlight") का उपयोग करें। स्रोत मार्कडाउन आमतौर पर URL में स्रोत स्थानीय को एम्बेड करता है:

![Screenshot](/img/screenshots/en-GB/screenshot.png)

हर लक्ष्य स्थानीय के लिए उसी पथ पर मिलान करने वाली PNG फ़ाइलें भेजें (जैसे static/img/screenshots/de/screenshot.png)। screenshots/en-GB/ को हार्डकोडिंग करने के बजाय screenshots/[^/]+/ को प्राथमिकता दें ताकि नियम sourceLocale परिवर्तन से बच सके।

प्रीसेट - docsOutput.style = "docusaurus"

डिफ़ॉल्ट localeSubpath = "docusaurus-plugin-content-docs/current" के साथ "doc-system" के समान। फ़्लैट लिंक रीराइटर नहीं चलता है। postProcessing मूल मार्कडाउन URL देखता है। अंग्रेज़ी पृष्ठ आमतौर पर स्रोत लोकेल के साथ एक पूर्ण पथ का उपयोग करते हैं:

![Screenshot](/img/screenshots/en-GB/screenshot.png)

Docusaurus प्रीसेट के लिए regexAdjustments का उदाहरण

"docsOutput": {
  "style": "docusaurus",
  "postProcessing": {
    "regexAdjustments": [
      {
        "description": "Per-locale screenshot folders in docs-site static assets",
        "search": "screenshots/[^/]+/",
        "replace": "screenshots/${translatedLocale}/"
      }
    ]
  }
}

docs-site/static/img/screenshots/<locale>/screenshot.png पर PNG फ़ाइलें शिप करें। स्रोत-लोकेल-अज्ञेय कॉन्फ़िग के लिए, screenshots/en-GB/ के बजाय screenshots/[^/]+/ को प्राथमिकता दें।

कार्यान्वयन उदाहरण: examples/docusaurus-docs/docs/feature-showcase.md (/img/screenshots/en-GB/screenshot.png) ai-i18n-tools.config.json के साथ।

प्रीसेट - docsOutput.style = "astro-starlight"

localeSubpath: "" के साथ "doc-system" के समान — अनुवादित पृष्ठ सीधे {outputDir}/{locale}/ के अंतर्गत आते हैं। ऊपर दिए गए सामान्य डॉक-सिस्टम कॉन्फ़िग के समान प्रति-लोकेल फ़ोल्डर दृष्टिकोण। स्रोत मार्कडाउन /img/screenshots/en-GB/screenshot.png का उपयोग करता है:

Astro Starlight प्रीसेट के लिए regexAdjustments का उदाहरण

"docsOutput": {
  "style": "astro-starlight",
  "postProcessing": {
    "regexAdjustments": [
      {
        "description": "Per-locale screenshot folders in public assets",
        "search": "screenshots/[^/]+/",
        "replace": "screenshots/${translatedLocale}/"
      }
    ]
  }
}

public/img/screenshots/<locale>/screenshot.png पर PNG शिप करें। ${translatedLocale} प्लेसहोल्डर आपकी कॉन्फ़िग लोकेल स्ट्रिंग का उपयोग करता है (जैसे pt-BR)। astro-starlight प्रीसेट डिफ़ॉल्ट रूप से लोकेल आउटपुट पथों को लोअरकेस करता है (pt-br/), लेकिन public/img/screenshots/ के अंतर्गत स्थिर एसेट फ़ोल्डर मार्कडाउन URL में लिखी गई लोकेल सेगमेंट से मेल खाना चाहिए — स्क्रीनशॉट निर्देशिकाओं को ${translatedLocale} के साथ संरेखित रखें, न कि आवश्यक रूप से एस्ट्रो रूट केसिंग के साथ।

कार्यान्वयन उदाहरण: examples/astro-docs — feature-showcase.mdx और ai-i18n-tools.config.json (screenshots/[^/]+/)।