Takaisin blogiin

Reliability · 22.7.2026

Contentful-käännösten luotettavuuden tarkistuslista

Luotettava lokalisointi syntyy sarjasta tarkkoja suojauksia generoinnin, tarkistuksen, siirron, julkaisun ja palautumisen vaiheissa.

Contentful-käännösten luotettavuuden tarkistuslista

Käännös voi olla kielellisesti erinomainen ja silti epäonnistua julkaisussa.

Väärää lähdetilannekuvaa on saatettu käyttää. Rich text -rakenne on voinut muuttua. Tarkistettu arvo ei ehkä ole päätynyt Contentfuliin. Päivitys saattaa olla olemassa mutta julkaisematta. Luotettavuus syntyy koko polun suojaamisesta, ei yhden mallivastauksen optimoinnista.

Ennen kääntämistä

Aloita selkeällä lähderajauksella.

  • tunnista täsmällinen Contentful-merkintä ja ympäristö
  • tallenna lähde- ja kohdekielet
  • lataa vain käännökseen soveltuvat kentät
  • säilytä linkit, upotukset, muotoilumerkinnät ja ei-käännettävä rakenne
  • kirjaa malli, kehote ja termisäännöt
  • näytä, sisältyvätkö tyhjät lähdekentät

Jos pyynnön laajuus on epäselvä ennen generointia, jokainen myöhempi vaihe perii tämän epäselvyyden.

Generoinnin aikana

Palveluntarjoajakutsun tulee olla havainnoitava ja riittävän toistettava tarkistuksen tueksi.

Varmista, että vastaus sisältää jokaisen odotetun kentän ja suojatun paikkamerkin. Hylkää virheellinen rakenteinen tuloste sen sijaan, että yrittäisit pelastaa osat, jotka näyttävät uskottavilta.

Uusintayritysten tulee käyttää samaa pyyntörajausta. Jos valitaan eri malli tai kehote, käsittele tulosta uutena yrityksenä, jotta tarkistajat ymmärtävät, miksi luonnos muuttui.

Tarkistuksen aikana

Tarkistus tarvitsee kolme tilaa rinnakkain:

  1. käännökseen käytetty lähdearvo
  2. nykyinen kohdearvo Contentfulissa
  3. ehdotettu lokalisoitu luonnos

Tämä paljastaa vanhentuneen lähdedatan ja suojaa olemassa olevaa lokalisoitua työtä.

Rich textin kohdalla tarkista sekä kieli että hierarkia. Avaa CMS-esikatselu ennen hyväksyntää, kun asettelu, linkit tai upotettu sisältö vaikuttavat sivuun.

Tarkistajan tekemien muokkausten tulisi tulla osaksi tallennetun luonnoksen historiaa sen sijaan, että ne katoaisivat lopulliseen siirtoon.

Siirron aikana

Kirjoita mahdollisimman pieni muutos.

Siirrä vain hyväksytyt kohdekielen kentät. Nouda nykyinen Contentful-merkintä uudelleen, säilytä siihen liittymättömät arvot ja käytä uusinta merkintäversiota. Jos sama kohdekenttä muuttui tarkistuksen alkamisen jälkeen, pysähdy päätöstä varten sen sijaan, että ylikirjoittaisit sen automaattisesti.

Kirjaa, mitkä kentät Contentful hyväksyi ja milloin. Onnistuneen API-vastauksen tulisi vastata pysyvää pyyntötilaa ennen kuin käyttöliittymä ilmoittaa valmistumisesta.

Julkaisun aikana

Siirto ja julkaisu ovat erillisiä lopputuloksia.

Varmista, että merkintä soveltuu määritettyyn julkaisutilaan ja että käyttäjällä on oikeus julkaista. Jos julkaisu on automaattinen, pidä sen epäonnistuminen erillään käännöksen ja siirron onnistumisesta.

Pyynnön tulisi näyttää selvästi "siirretty, julkaisu epäonnistui" sen sijaan, että koko työnkulku typistetään yleiseksi epäonnistumiseksi.

Palautumisen aikana

Luotettavat järjestelmät olettavat, että palveluntarjoajat aikakatkaisevat, verkot keskeytyvät ja CMS-versiot menevät ristiriitaan.

  • yritä uudelleen ohimeneviä virheitä rajatuin rajoituksin
  • jatka epäonnistuneesta vaiheesta
  • pidä onnistuneet käännökset ja siirrot ennallaan
  • tuo näkyviin viimeisin toimenpiteitä vaativa virhe
  • salli peruutus siellä, missä aktiivinen työ voidaan pysäyttää turvallisesti
  • tee lopputilasta palautettavissa oleva kyselyjen avulla myös ilman reaaliaikaisia tapahtumia

Palautumisen tulisi säilyttää työ, ei käynnistää sitä refleksinomaisesti alusta.

Yhteenveto

Contentful-kääntämiselle ei ole yhtä ainoaa luotettavuusominaisuutta.

Luottamus syntyy tarkoista suojauksista jokaisella rajapinnalla: eksplisiittinen rajaus, suojattu rakenne, vertailukelpoiset tarkistustilat, minimaaliset kirjoitukset, erillinen julkaisutila ja vaihekohtainen palautuminen. Kun nämä hallintakeinot toimivat yhdessä, tiimit voivat edetä nopeasti ilman, että jokainen monikielinen julkaisu tuntuu uhkapeliltä.