AI-tõlked
Laske AI-l tõlkida iga leht teistesse keeltesse ja hoida iga tõlge ajakohasena, kui teie dokumentatsioon muutub. Saadaval Pro- ja Enterprise-paketis.
Uuendatud 19. nov 20264 min lugemist
Lülitage keele jaoks sisse AI-tõlge ja Typemark tõlgib iga lehe sellesse keelde ning tõlgib lehe uuesti alati, kui see muutub. Tõlked on tavalised MDX-failid teie repositooriumis: saate neid lugeda, muuta või käsitsi ümber kirjutada, ja Typemark ei kirjuta kunagi üle tõlget, mida keegi on muutnud. AI-tõlked on saadaval Pro- ja Enterprise-paketis ning järgivad projekti omaniku paketti.
Lülitage sisse
Lisage keel
Valige Settings > Languages, klõpsake Add a language, sisestage keele kood, valige jaotises Translated by valik AI ja klõpsake Save languages. Ülejäänud seadistuse kohta vt Languages.
Või lisage failis
typemark.jsonlanguageshulka keel koos väärtusega"translate": "ai":"languages": [ { "code": "en", "name": "English" }, { "code": "fr", "name": "Français", "translate": "ai" }, { "code": "de", "name": "Deutsch", "translate": "ai" } ]Avaldage muudatus
Seaded avaldatakse salvestamisel. Kui muutsite faili
typemark.json, lükake see oma juurutusharusse või käsugatypemark push. Pärast avaldamist alustab Typemark tõlkimist ühe lehe kaupa ja salvestab iga tõlke valmimisel.Lugege tõlkeid
Redaktoris avage leht ja valige ülariba keelevahetajast keel. Iga keel näitab tõlke olekut.
Võite segada: osa keeli võib tõlkida AI-ga ja osa käsitsi, mis on vaikeseade ("translate": "manual").
Hoidke terminid muutumatutena
Loetlege tootenimed, funktsioonide nimed ja muud terminid, mida ei tohi kunagi tõlkida, valikus Settings > Languages > Terms AI keeps as written, üks rida kohta, või väärtuses translations.do_not_translate. Kuni 200 terminit, igaüks kuni 100 märki:
"translations": {
"do_not_translate": ["Acme Pay", "Workspace", "acme.config.json"]
}
AI kirjutab need täpselt antud kujul nii tekstis kui komponentide propsides. Typemark kontrollib enne tõlke salvestamist, et iga termin on säilinud.
Määrake toon
AI-tõlked järgivad samu juhiseid, mis AI-kirjutamine: mida kirjutate jaotisse Settings > AI writing, salvestatakse väärtusena ai.instructions. Määrake, kui formaalne olla, kas pöörduda lugejate poole sinavormis või teie-vormis ning millist õigekirja kasutada.
Mis tõlgitakse
| Tõlgitakse | Jäetakse täpselt nii, nagu kirjutatud |
|---|---|
| Tekst, mida lugejad loevad: pealkirjad, lõigud, loendid, tabelid ja lingi tekst | Koodiplokid ja inline code |
Frontmatteri title, description ja sidebarTitle | Kõik muud frontmatteri võtmed ja väärtused |
| Komponentide tekst: kaardi-, vahelehe-, sammu-, akordioni- ja hoiatuskastide pealkirjad, kirjeldused, sildid, pildi alternatiivtekst, pealdised, kohatäited, vihjed ja näpunäited | Komponentide nimed, propsi nimed ja propsid, mis pole tekst, nagu href, src, icon ja url |
| Lingi- ja pildisihtkohad | |
Propsid kirjutatud kujul {expressions}, sh tekstipropsid | |
Terminid loendis do_not_translate |
Typemark kontrollib iga tõlget enne salvestamist. Kui AI muutis koodi, linki, komponenti, frontmatteri võtit või terminit, mida oleks pidanud säilitama, visatakse tõlge minema ja leht jääb vana tõlke juurde või näitab vaikekeele lehte, kui tõlget polnud. Typemark proovib hiljem uuesti.
Üle 40 000 märgi pikkusi lehti ei tõlgita, samuti mitte API-viite lehti, mis on genereeritud OpenAPI spetsifikatsioonist.
Vahelehtede, gruppide ja linkide nimed
AI tõlgib ka saidi nimed failist typemark.json: vahelehed, grupid, ülaosa navigatsioonilingid ja jaluse lingid. Ta kirjutab need keele jaoks väärtusesse translations.labels (Languages) kommitina nimega Typemark AI, säilitades terminid loendist do_not_translate.
Ta täidab ainult nimed, millel pole veel tõlget. Nime, mille kirjutasite või muutsite, ei muudeta kunagi. Et hoida nimi keeles muutumatuna, andke sellele tühi tõlge ("Changelog": ""), ja AI jätab selle rahule. Kui nimetate grupi ümber, tõlgib AI uue nime ja eemaldab oma vana nime tõlke.
Kuhu tõlked salvestatakse
Tõlge läheb sinna, kuhu käsitsi kirjutatud tõlge läheks: quickstart.mdx tõlge on fr/quickstart.mdx, kui teil on docs_root, siis selle sees. Iga tõlge on eraldi kommit nimega nagu "Translate quickstart into Français", autoriks Typemark AI. Ühendatud repositooriumis lükatakse see GitHubi nagu redaktoris tehtud salvestus.
Typemark peab arvestust selle üle, mida AI kirjutas, lehed ja nimed, failis .typemark/translations.json. Jätke see oma repositooriumisse: nii eristab Typemark AI teksti teie muudatustest.
Staatused redaktoris
Redaktori keelevahetaja näitab iga AI-keele staatust praegusel lehel:
| Staatus | Mida see tähendab | Mida AI teeb |
|---|---|---|
| Source | Vaikekeel, millest tõlked tehakse | |
| Not translated yet | Tõlget veel pole | Tõlgib lehe |
| Translating… | Tõlge on teel | |
| Up to date | AI tõlge lehe praegusest versioonist | Ei midagi |
| Updating soon | AI tõlge lehe vanemast versioonist | Tõlgib uuesti |
| Edited by hand | Keegi muutis tõlget ja lehte pole sellest ajast muudetud | Ei midagi |
| Out of date | Keegi muutis tõlget ja lehte on sellest ajast muudetud | Ei midagi. Uuendage käsitsi või tõlkige uuesti. |
Muutke tõlget
Avage tõlge keelevahetajast, muutke seda ja salvestage. See on nüüd Edited by hand ja AI jätab selle edaspidi rahule, isegi kui leht muutub. Kui leht muutub, näitab see Out of date, et teate uuendada.
Tõlget, mille lisate ise AI-keeles, käsitletakse samamoodi: AI ei asenda seda kunagi.
Tõlgi uuesti
Et alustada uuesti AI versioonist, avage tõlge ja valige Re-translate into, millele järgneb keel keelevahetajast. See asendab tõlke, sh teie muudatused, ja loetakse kuu limiidi hulka. Redaktorid ja projekti omanik saavad uuesti tõlkida.
Ülevaatus enne, kui lugejad näevad
Käsitsi juurutamise režiimis ootavad uued ja uuendatud AI-tõlked, nagu teie enda muudatused, kuni keegi klõpsab Publish. Lugege need enne redaktoris läbi, ja Publish saab teie ülevaatusetapiks. Automaatse juurutamise režiimis läheb iga tõlge kohe pärast ehitamist avalikuks.
Millal tõlked käivituvad
AI tõlgib seda, mis on teie juurutusharus: pärast salvestamist redaktoris, juurutusharusse lükkamist või käsku typemark push.
Ta ei tõlgi kunagi eelvaate juurutusi ega harusid redaktoris. Haru säilitab oma tõlked ja selle lehed tõlgitakse üks kord, kui see on ühendatud. Re-translate ei ole saadaval, kui redaktor on harus.
Limiidid
AI tõlgib kuni 2000 lehte kuus kõigi omaniku saitide ja keelte peale kokku. Lehte, mis on tõlgitud kolme keelde, loetakse kolm korda ja nii loetakse ka iga uuendus. Vahelehtede, gruppide ja linkide nimede tõlkimine loetakse üheks lehekülje tõlkeks. Kui limiit saavutatakse, lõpetab AI tõlkimise kuni järgmise kuu 1. kuupäevani. Juba avaldatud tõlked jäävad alles ja lehed ilma tõlketa näitavad sel ajal vaikekeelt.
Kui omaniku pakett muutub
AI-tõlked järgivad projekti omaniku paketti. Kui omanik läheb üle Free-paketile, jäävad juba avaldatud tõlked saidile alles, kuid AI lõpetab uute ja muudetud lehtede tõlkimise ning Re-translate ei ole saadaval. Tõlkeid saab endiselt käsitsi muuta. Kui uuendate paketti uuesti, jätkab AI sealt, kus pooleli jäi.
Teie sisu
Typemark saadab lehe ja ülal toodud juhised oma AI-pakkujale samamoodi nagu AI-kirjutamise puhul. Ta palub pakkujal suunata päringud ainult mudelipakkujatele, kes ei salvesta ega treeni oma mudeleid teie andmetega.