Typemark Documentation

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

  1. 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.json languages hulka keel koos väärtusega "translate": "ai":

    "languages": [
      { "code": "en", "name": "English" },
      { "code": "fr", "name": "Français", "translate": "ai" },
      { "code": "de", "name": "Deutsch", "translate": "ai" }
    ]
  2. Avaldage muudatus

    Seaded avaldatakse salvestamisel. Kui muutsite faili typemark.json, lükake see oma juurutusharusse või käsuga typemark push. Pärast avaldamist alustab Typemark tõlkimist ühe lehe kaupa ja salvestab iga tõlke valmimisel.

  3. 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õlgitakseJäetakse täpselt nii, nagu kirjutatud
Tekst, mida lugejad loevad: pealkirjad, lõigud, loendid, tabelid ja lingi tekstKoodiplokid ja inline code
Frontmatteri title, description ja sidebarTitleKõ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äitedKomponentide 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:

StaatusMida see tähendabMida AI teeb
SourceVaikekeel, millest tõlked tehakse
Not translated yetTõlget veel poleTõlgib lehe
Translating…Tõlge on teel
Up to dateAI tõlge lehe praegusest versioonistEi midagi
Updating soonAI tõlge lehe vanemast versioonistTõlgib uuesti
Edited by handKeegi muutis tõlget ja lehte pole sellest ajast muudetudEi midagi
Out of dateKeegi muutis tõlget ja lehte on sellest ajast muudetudEi 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.