colibri/docs/guide/sl/localization/index.md

title	description
Lokalizacija dokumentacije	Lokalizirana dokumentacija Clawdie po načelu Astro/Starlight, s prevodi v gitu.

Lokalizacija dokumentacije

Clawdie lokalizira dokumentacijo izvorno v Astro/Starlight: vsak jezik je navaden markdown, voden v git repozitoriju, vgrajeno usmerjanje i18n v Starlight pa iz tega zgradi eno statično stran s podstranmi za posamezne jezike. V živi poti ni zunanje prevajalske storitve.

Vir resnice

Vsa dokumentacija — izvirnik in prevodi — živi pod docs/guide/:

• angleščina je privzeti jezik in je v korenu drevesa, npr. docs/guide/operate/terminal-capture.md
• vsak drugi jezik zrcali to strukturo pod imenikom z oznako BCP-47, npr. docs/guide/sl/operate/terminal-capture.md (slovenščina)

Repozitorij je uredniški vir resnice za vse jezike.

docs/guide/
├── operate/terminal-capture.md         # en (privzeto)
├── architecture/control-plane-bridge.md
└── sl/                                 # slovensko zrcalo
    ├── operate/terminal-capture.md
    └── architecture/control-plane-bridge.md

Gradnja in objava

Deljeni dokumentacijski projekt Astro/Starlight bere docs/guide/, uporabi usmerjanje jezikov v Starlight in zgradi statični izhod za vsak jezik. Objava poteka prek ječe cms:

• vir v repozitoriju: bootstrap/cms/clawdie-docs/
• pot izvajanja v ječi cms: /usr/home/<tenant>/<tenant>-docs/

cd /usr/home/<tenant>/<tenant>-docs
npm run deploy

Ta ena sama pot objave zažene sinhronizacijo vsebine in gradnjo Astro za vse jezike — lokalizacija nima ločene poti objave, ampak teče po običajni gradnji dokumentacije. Za celoten operaterski potek glejte Objava dokumentacije in najemniških strani.

Dodajanje ali posodabljanje prevoda

1. Angleško stran kopirajte v jezikovno zrcalo (enaka relativna pot pod docs/guide/<lang>/).
2. Prevedite besedilo ter polji title / description v glavi.
3. Potrdite spremembo v repozitorij.
4. Objavite prek ječe cms (npm run deploy).

Glejte Kako poteka cevovod in Navodila za nastavitev za podrobnosti.

Prihodnji načrt: Crowdin

Ročno urejanje jezikovnih datotek je v redu, dokler je prevedena površina majhna. Ko obseg prevajanja to preraste, je mogoče znova vpeljati Crowdin za upravljanje prevajalskih nizov — ta bi pošiljal angleški izvirnik in vračal dokončane prevode v isto razporeditev docs/guide/<lang>/, brez sprememb v tem, kako Astro gradi in objavlja. Crowdin danes ni vključen; je možnost za prihodnjo rast, ne trenutna odvisnost.

Strani v tem razdelku

• Kako poteka cevovod
• Navodila za nastavitev
• Odpravljanje težav