vstupná premenná
Šablóna promptu používaná na zistenie názvu cieľového jazyka zo všetkých vstupných premenných.
Prehľad pracovného postupu: Preklady pre HUGO projekty
Tento pracovný postup je navrhnutý na automatizáciu prekladu markdown súborov používaných v HUGO projektoch, so zvláštnym dôrazom na zachovanie štruktúry a formátovania súboru. Pracovný postup zabezpečuje, že sa prekladá iba relevantný textový obsah, zatiaľ čo technické prvky, ako je predná časť, štruktúra markdownu a riadiace znaky, zostávajú nedotknuté. Je to obzvlášť užitočné pre tímy spravujúce viacjazyčné statické stránky postavené na HUGO a hľadajúce spôsob, ako škálovať lokalizáciu obsahu pri zachovaní vysokej kvality a konzistentnosti.
Účel a využitie
- Automatizovaný preklad: Pracovný postup využíva najmodernejšie jazykové modely (varianty OpenAI GPT-4) na poskytovanie kvalitných prekladov markdown súborov.
- Zachovanie štruktúry: Dôsledne zachováva štruktúru HUGO markdown súborov, vrátane prednej časti v TOML formáte, markdown nadpisov a špeciálneho formátovania.
- Selektívny preklad: Pracovný postup je navrhnutý tak, aby neprekladal názvy polí v prednej časti alebo text v rámci HTML tagov, ale zameriaval sa len na hodnoty polí a obsah v markdown.
- Škálovateľná lokalizácia: Automatizáciou prekladu tento pracovný postup umožňuje rýchle rozšírenie do viacerých jazykov s minimálnou manuálnou námahou.
Kľúčové kroky v pracovnom postupe
Pracovný postup pozostáva z niekoľkých vzájomne prepojených komponentov. Tu je krok za krokom prehľad:
| Krok | Komponent | Funkcia |
|---|---|---|
| 1 | Chat Input | Prijíma markdown súbor na preklad a potrebné premenné (napr. cieľový jazyk). |
| 2 | Prompt Template (vstupná premenná) | Zistí názov cieľového jazyka zo vstupných premenných na ďalšie použitie. |
| 3 | LLM OpenAI (nano) | Používa ľahký GPT-4 model na spracovanie promptov. |
| 4 | Generator (získaj názov jazyka) | Generuje názov cieľového jazyka zo zadaných premenných. |
| 5 | Document Retriever (GetBestTranslation) | Vyhľadáva existujúce najlepšie preklady alebo kontext z interných/dokumentových zdrojov. |
| 6 | Prompt Template (Prompt) | Vytvára detailný prompt s inštrukciami pre LLM, ako prekladať so všetkými obmedzeniami a príkladmi. |
| 7 | LLM OpenAI (full) | Používa plný GPT-4 model (s veľkým kontextom) na vykonanie prekladu. |
| 8 | Generator | Vykoná preklad pomocou vyššie uvedeného promptu a modelu. |
| 9 | Chat Output | Zobrazí preložený markdown súbor vo výstupnom rozhraní. |
Detailná logika pracovného postupu
- Spracovanie vstupu: Používateľ odošle markdown súbor a určí cieľový jazyk. Pracovný postup extrahuje relevantné premenné na použitie v promptoch.
- Zistenie jazyka: Prvá časť pracovného postupu určí názov cieľového jazyka zo vstupu pomocou ľahkého LLM a vlastnej šablóny promptu.
- Získanie kontextu: Voliteľne vyhľadá existujúce preklady alebo príslušnú dokumentáciu na poskytnutie ďalšieho kontextu a zabezpečenie konzistentnosti prekladu.
- Vytvorenie prekladového promptu: Je zostavený komplexný prompt, ktorý obsahuje pravidlá formátovania, obmedzenia prekladu a očakávanú štruktúru súboru. Modelu je poskytnutá ukážka štruktúry súboru so striktnými pokynmi, čo prekladať a čo zachovať.
- Generovanie prekladu: Hlavný preklad sa vykonáva výkonným LLM modelom, ktorý zabezpečuje vysokú kvalitu výstupu pri prísnom dodržaní požiadaviek na formátovanie a štruktúru.
- Výstup: Preložený markdown súbor je pripravený na kontrolu používateľom alebo ďalšie automatizované spracovanie.
Prečo je tento pracovný postup užitočný
- Konzistentnosť: Zabezpečuje, že všetky preložené súbory dodržiavajú prísne smernice týkajúce sa formátovania a štruktúry požadované HUGO projektmi.
- Efektivita: Výrazne znižuje manuálnu námahu spojenú s prekladom a formátovaním markdown súborov pre statické generátory stránok.
- Škálovateľnosť: Umožňuje jednoduché rozšírenie do viacerých jazykov a spracovanie veľkého objemu obsahu.
- Kontrola kvality: Použitím kontextovo orientovaného vyhľadávania a explicitných prekladateľských pokynov minimalizuje chyby typické pre naivné strojové preklady.
Špeciálne poznámky
- Pravidlá pre jednotlivé polia: Pracovný postup starostlivo prekladá len hodnoty polí v prednej časti, nie názvy polí ani štruktúrne prvky.
- Integrita formátovania: Riadiace znaky ako
+ + +a prvky markdown/HTML sú zachované podľa požiadaviek HUGO a TOML špecifikácií. - Rozšíriteľnosť: Modulárny prístup (s vyhľadávačmi, šablónami promptov a generátormi) umožňuje jednoduché prispôsobenie podľa vývoja požiadaviek.
Zhrnutie: Tento pracovný postup poskytuje kompletné, spoľahlivé a škálovateľné riešenie pre preklad HUGO markdown súborov, vďaka čomu je mimoriadne užitočný pre organizácie spravujúce viacjazyčné statické stránky alebo dokumentačné projekty.
