Typemark Documentation

Keeli

Avaldage oma dokumendid mitmes keeles, igaüks omal aadressil, lugejatele keelevalijaga. Igas paketis.

Uuendatud 19. nov 20266 min lugemist

Avaldage oma sait mitmes keeles. Iga tõlge on MDX-fail selle lehe kõrval, mida ta tõlgib, lugejad vahetavad keelt saidi päises ning otsingumootorid leiavad iga versiooni. Keeled on saadaval igas paketis. Pro- ja Enterprise-paketis saab AI kirjutada tõlked ja hoida need ajakohasena.

Lisage oma keeled

Menüüs Settings > Languages määrab projekti omanik keele, milles teie lehed on kirjutatud, ning lisab seejärel teised keeled:

  1. Jaotises Default language märkige selle keele kood ja nimi, milles teie lehed on. Sait ilma keeleteta on inglise keeles.
  2. Klõpsake nuppu Add a language ja sisestage keele kood, näiteks fr. Typemark täidab nime selles keeles, seda saab muuta. Koodi, mis ei ole päris keelekood, ei aktsepteerita.
  3. Jaotises Translated by valige AI, et AI tõlgiks iga lehe (Pro ja Enterprise), või Your team, et kirjutaksite tõlked ise.
  4. Klõpsake nuppu Save languages. Typemark salvestab loendi faili typemark.json ja taastab teie saidi.

Salvestatud keele koodi ei saa muuta: eemaldage keel ja lisage see uuesti. Keele eemaldamine avaldamise tühistab selle tõlked, nende failid jäävad aga teie repositooriumisse.

Menüü Settings kirjutab languages loendi faili typemark.json, kuid seda saab muuta ka seal, esimesena keel, milles teie lehed on:

"languages": [
  { "code": "en", "name": "English" },
  { "code": "fr", "name": "Français" },
  { "code": "pt-BR", "name": "Português (Brasil)" }
]
VõtiMida see teeb
codeKeele kood, näiteks fr, pt-BR või zh-Hans. See on osa aadressist: /fr/quickstart.
nameMida lugejad näevad keelevalijas, kuni 50 tähemärki. Kirjutage see keeles endas, näiteks Français.
defaulttrue keele puhul, milles teie lehed on kirjutatud. Ilma selleta on esimene keel vaikekeel.
translate"ai", et AI tõlgiks iga lehe sellesse keelde (Pro ja Enterprise). "manual", vaikimisi, jätab tõlked teie hooleks. Vt AI-tõlked.

Võite lisada kuni 30 keelt. Kirje, mida Typemark ei saa kasutada, näiteks kood, mis esineb kaks korda, või keel ilma nimeta, jäetakse välja ning avaldamine loetleb selle hoiatusena projekti ülevaates.

Muutke typemark.json oma ühendatud repositooriumis või CLI-ga projekti puhul, mida Typemark majutab. Menüü Settings > Languages näitab kirjeid, mida ta ei saa kasutada, hoiatustena ning salvestamine need eemaldab.

Keelekoodid

Kood on päris keelekood: keel, siis vajadusel kirjutussüsteem ja piirkond, näiteks fr, pt-BR, zh-Hans, es-419 või sr-Latn-RS. Typemark kontrollib iga osa IANA keelealamsildiregistrit vastu.

  • Menüü Settings > Languages keeldub koodist, mis ei ole kehtiv, näiteks zz või kirjavea korral, ja ütleb seda välja all. Vana koodi puhul nimetab ta praeguse: iw on nüüd he.
  • Kood failis typemark.json, mida Typemark ei tunne, avaldatakse ikkagi, ja avaldamine loetleb hoiatuse projekti ülevaates. Menüü Settings säilitab selle samuti koos märkusega, kui salvestate muid muudatusi.
  • Koode võrreldakse täpselt nii, nagu need on kirjutatud, seega kasutage sama koodi failis typemark.json ja kaustade nimedes.
  • mcp ja ai-search ei saa olla koodid, sest iga sait kasutab juba neid aadresse.

Vaikekeel

Teie olemasolevad lehed on vaikekeeles. Need säilitavad oma aadressid, näiteks /quickstart, ja midagi nende juures ei muutu.

Sait ilma languages on inglise keeles. Sait, mis loetleb ühe keele, on täielikult selles keeles: lehe atribuut lang ja otsing kasutavad seda ning keelevalijat ei ole.

Kuhu tõlked lähevad

Tõlke tee on sama mis lehel, mida ta tõlgib, keele koodiga nimetatud kausta sees:

LehtPrantsuse tõlgeAadress
quickstart.mdxfr/quickstart.mdx/fr/quickstart
guides/authentication.mdxfr/guides/authentication.mdx/fr/guides/authentication

Kui kasutate docs_root, lähevad keelekaustad selle sisse: docs/fr/quickstart.mdx. Keele avaleht on /fr.

Tõlge on täielik leht oma frontmatteriga (tõlgitud title ja description) ning sisuga selles keeles. Tõlke alustamiseks käsitsi kopeerige lehe fail keelekausta ja tõlkige see, oma repositooriumis või CLI-ga. Redaktoris avab keelevahetaja lehe olemasolevad tõlked.

Mida lugejad näevad

  • Keelevalija saidi päises loetleb teie keeled ja avab lehe, millel nad asuvad, valitud keeles. Typemark ei vali kunagi keelt brauseri seadetest.
  • Sama navigatsioon igas keeles. Vahelehed, rühmad ja nende järjekord tulevad teie navigation-st, iga lehe pealkiri on lugeja keeles, kui sellel on tõlge, ning vahelehtede ja rühmade nimed on tõlgitud, kui annate neile tõlke.
  • Sait ise lugeja keeles. "On this page", otsing, lehe tegevuste menüü, Ask AI, "Was this page helpful?", eelmine ja järgmine, kuupäevad ning 404-leht on lugeja keeles. Vt Saidi enda sõnad.
  • Iga leht igas keeles. Leht ilma tõlketa näitab vaikekeele lehte keele aadressil, nii et /fr/billing töötab enne tõlkimist ja navigatsioonil ei ole kunagi auke.
  • Lingid lugeja keeles. Prantsuskeelsel lehel läheb link /quickstart aadressile /fr/quickstart, kui sellel lehel on avaldatud prantsuskeelne tõlge, ja aadressile /quickstart kuni selleni. Kirjutage lingid vaikeaadressidele tavapäraselt: Typemark kohandab need lehe serveerimisel, teie failid ei muutu. Ankrud, lingid teistele saitidele, failid nagu /llms.txt ning lingid, mis juba nimetavad keele (/de/setup), jäävad kirjutatud kujul.
  • Otsing lugeja keeles. Prantsuskeelsel lehel otsimine leiab prantsuskeelsed tõlked ja vaikekeele lehed, millel tõlget veel ei ole. Otsing kasutab iga keele sõnareegleid seal, kus Typemarkil need on, nii et sõna erinevad vormid sobivad, ja teistes keeltes sobitatakse sõnad kirjutatud kujul. Vt Mida iga keel saab.
  • Ümbersuunamised igas keeles. Ümbersuunamine /old lehelt /new lehele suunab ka /fr/old lehelt /fr/new lehele.

Mida iga keel saab

Iga keel saab omad aadressid, keelevalija, tõlgitud navigatsiooni ja hreflang-lingid. Mõned asjad sõltuvad keelest:

FunktsioonKeeled
Saidi enda sõnadInglise, saksa, prantsuse, hispaania, portugali, jaapani ja eesti keel. Teised keeled näitavad neid inglise keeles.
Otsing, mis sobitab sõna erinevaid vormeAraabia, taani, hollandi, inglise, soome, prantsuse, saksa, kreeka, ungari, indoneesia, iiri, itaalia, leedu, nepali, norra, portugali, rumeenia, vene, hispaania, rootsi, tamili ja türgi keel. Teised keeled, näiteks eesti, jaapani, hiina ja korea keel, sobitavad sõnu kirjutatud kujul.
AI-tõlkedIga keel, mida AI-mudel kirjutab. Pro ja Enterprise.

Paremalt vasakule kirjutatavaid keeli, näiteks araabia, heebrea, pärsia ja urdu keelt, ei toetata veel. Võite need avaldada, kuid paigutus jääb vasakult paremale.

Saidi enda sõnad

Kõik, mida teie sait ise ütleb, on tõlgitud lehel lugeja keeles: sisukord, otsing, lehe tegevuste menüü, kaart "Use these docs with AI", Ask AI paneel, tagasisidevidin, eelmine ja järgmine, "Updated" kuupäevad ja lugemisaeg, mobiilimenüü, "Powered by Typemark", 404-leht ning privaatse saidi sisselogimisvorm.

Typemarkil on need sõnad inglise, saksa, prantsuse, hispaania, portugali, jaapani ja eesti keeles. Piirkondlik kood kasutab oma keele sõnu, nii et pt-BR saab portugali ja es-419 hispaania keele sõnad. Teised keeled näitavad neid inglise keeles. Tootenimed, MCP, llms.txt ja Markdown jäävad samaks.

Vahelehtede, rühmade ja linkide nimede tõlkimine

Vahelehtede ja rühmade nimed, ülemise navigatsiooni lingid ja jaluse lingid tulevad teie typemark.json-st. Andke neile iga keele jaoks tõlge jaotises translations.labels, võtmeks nimi nii, nagu te selle kirjutasite:

"translations": {
  "labels": {
    "fr": { "Get started": "Premiers pas", "Guides": "Guides", "Status": "État du service" },
    "de": { "Get started": "Erste Schritte" }
  }
}

Nimi ilma tõlketa kuvatakse kirjutatud kujul ning vaikekeele lehed näitavad alati nimesid kirjutatud kujul. Kuna tõlked on seotud nimega, säilitab rühma teisaldamine ka tema tõlke; nime muutmine nõuab uut tõlget. Keele puhul, mida AI tõlgib, täidab AI nimed, mida te pole tõlkinud, ega muuda kunagi ühtegi, mille olete kirjutanud.

Otsingumootorid

  • Iga leht määrab oma keele elemendis <html lang>.
  • Iga leht loetleb oma versioonid teistes keeltes hreflang-linkidega, pluss x-default vaikekeele jaoks. Loetletakse ainult keeled, milles lehel on oma tõlge, ning peidetud lehed ei loetle ühtegi.
  • Saidikaart loetleb iga tõlke samade alternatiivide ja kõigega.
  • Leht, mis kuvatakse vaikekeeles tõlke aadressil, osutab otsingumootoritele vaikelehele kui kanoonilisele URL-ile, nii et sama tekst ei indekseerita kahel korral.

Mis jääb vaikekeelde

  • llms.txt, llms-full.txt, MCP-server ja Ask AI kasutavad vaikekeelt.
  • API viitelehed, mis on genereeritud OpenAPI spetsifikatsioonist, ei ole tõlgitud.

Redaktoris

Saidil, millel on rohkem kui üks keel, on redaktori ülaribal keelevahetaja Visual ja Source kõrval. See avab lehe, millel te parasjagu olete, teises keeles. Keeled, millel lehel ei ole veel tõlget, on hallid. Tõlge salvestatakse nagu iga teine leht.

Lehti vaikekeeles nimetage ümber, teisaldage ja kustutage. Tõlke ümbernimetamiseks või kustutamiseks muutke selle faili oma repositooriumis või CLI-ga.

Redaktor näitab linke nii, nagu te need kirjutasite. Preview avab lehe teie saidil, lingid lehe keeles.

Kontrollige enne avaldamist

typemark dev eelvaatab iga keelt teie arvutis: keelevalijat, tõlgitud lehti ja silte ning linke lugeja keeles.

typemark check loeb languages nii, nagu seda teeb avaldamine, ja käsitleb linki /fr/<page> lingina sellele lehele:

ReegelRaskusasteMida see tähendab
config-languagesVigaKeelekirje, mille Typemark välja jätab, näiteks kood, mis ei ole keelekoodi kujuga või esineb kaks korda
language-codeHoiatusKood, mis ei ole päris keelekood, näiteks zz või kirjaviga. See avaldatakse ikkagi.
config-translationsHoiatustranslate väärtus muu kui "ai" või "manual", translations.do_not_translate, mis ei ole loend, või translations.labels, mis ei ole keelte kaupa nimede objekt
languages-singleHoiatuslanguages loetleb ühe keele, seega on kogu sait selles ja keelevalijat ei ole. Loetlege esimesena vaikekeel, siis teised.
language-folderHoiatusNavigatsioonis olev leht asub keele kaustas, näiteks fr/intro. Lugejad ei pääse sellele ligi, sest /fr/intro on intro prantsuskeelne versioon. Viige see kaustast välja.
translation-unlistedHoiatusLehe tõlge, mida ei ole navigatsioonis, seega seda ei avaldata