Så fungerar Sleekdocs Translate

Kom igång

1. Logga in

   Med Google, Microsoft eller en engångskod via e-post. Första gången skapas ett konto åt dig.

2. Gå med i eller skapa ett team

   Har du blivit inbjuden accepterar du inbjudan, så är du med. Annars skapar du ett team: du blir dess administratör, och det börjar med 14 dagar av Pro.

3. Skapa ett projekt och importera era filer

   Välj primärspråk, lägg till språken ni översätter till och importera de JSON-filer ni redan har.

4. Översätt, publicera och driftsätt

   Översätt bredvid texten i primärspråket, publicera en revision och driftsätt den i utveckling, test eller produktion. Appen hämtar den från Sleekdocs CDN.

Guider

Läs in översättningarna som Sleekdocs driftsätter direkt i appen. Guiderna är på engelska.

Begrepp

Team

Användare tillhör ett eller flera team. Ett team håller projekten som medlemmarna arbetar med, och det är teamet som har en plan.

Projekt

En applikation som översätts, med ett primärspråk och ett eller flera språk att översätta till.

Revision

När ett språk publiceras sparas texterna som nästa numrerade revision. Fram till dess är texterna du redigerar arbetskopian.

Miljö

Utveckling, test och produktion. En driftsättning lägger en revisions fil på CDN:et för en miljö, så att testappen och liveappen kan köra olika revisioner.

Team och roller

Varje teammedlem har en roll, med samma behörigheter i alla teamets projekt.

Att driftsätta kräver en egen behörighet för varje miljö (utveckling, test och produktion), som en administratör ger i medlemmens inställningar. Att publicera kräver minst en av dem. På så sätt kan en översättare publicera och driftsätta i test medan bara vissa driftsätter i produktion.

Projekt och språk

Ett projekt motsvarar oftast en applikation. Dess Översikt visar språken, antalet nycklar och projektets inställningar.

Översätta

Öppna ett språk för att se varje nyckel med primärspråkets text bredvid översättningen, och hur långt språket har kommit: "120 av 140 översatta · 86 %".

Import och export

Ta in de översättningsfiler appen redan har, och ta ut texterna igen när som helst.

Publicera och driftsätta

Inget når appen förrän ni publicerar och driftsätter, så översättarna kan arbeta med nästa release medan den nuvarande ligger kvar.

1. Publicera

   Sparar ett språks arbetskopia som nästa revision. Innan du publicerar visar Visa ändringar vad som har lagts till, ändrats och tagits bort.

2. Driftsätt

   Lägger en revision på CDN:et för en miljö, på https://cdn.sleekdocs.com/<projekt>/<miljö>/<språk>.json, och rensar CDN:ets cachade kopia så att appen får den direkt.

API-nycklar och API:t

Läs och ändra översättningar, publicera och driftsätt från skript och byggpipelines. Alla anrop beskrivs i API-referensen (på engelska), och sökvägarna är stabila: fält kan läggas till, men inget tas bort eller byter namn.

Exempel

Skicka nyckeln som en bearer-token. Med de här satta:

API=https://translate.sleekdocs.com/api/v1/api/translate
PROJECT=<ert projekt-ID>
SLEEKDOCS_KEY=sdt_…

hämtar du den senast publicerade svenska filen, platt:

curl -H "Authorization: Bearer $SLEEKDOCS_KEY" \
  "$API/projects/$PROJECT/languages/sv/file?revision=latest&format=flat"

Lägg till eller uppdatera nycklar från koden, först som en provkörning som bara visar vad som skulle ändras:

curl -X PATCH -H "Authorization: Bearer $SLEEKDOCS_KEY" -H "Content-Type: application/json" \
  "$API/projects/$PROJECT/keys" \
  -d '{"mode": "upsert", "dryRun": true,
       "items": [{"key": "checkout.title", "values": {"en": "Checkout", "sv": "Kassa"}}]}'

Publicera de ändrade språken och driftsätt sedan den senaste revisionen av alla språk i test:

curl -X POST -H "Authorization: Bearer $SLEEKDOCS_KEY" -H "Content-Type: application/json" \
  "$API/projects/$PROJECT/publish" \
  -d '{"languages": "changed"}'

curl -X POST -H "Authorization: Bearer $SLEEKDOCS_KEY" -H "Content-Type: application/json" \
  "$API/projects/$PROJECT/deploy" \
  -d '{"env": "test", "languages": "all", "revision": "latest"}'

API:t kan också lista nycklar som inte är översatta eller har ändrats sedan senaste publiceringen, importera hela filer, jämföra revisioner och döpa om och ta bort nycklar. API-referensen visar alla anrop.

Webhooks

Sleekdocs kan meddela en annan tjänst när ett språk publiceras eller driftsätts, till exempel en Slack- eller Teams-kanal eller er byggserver. En webhook gäller ett helt team eller ett projekt, och skickar en HTTP POST med en JSON-kropp som ni kan forma med språk, revision, miljö och användare. En mottagare som fallerar stoppar aldrig publiceringen eller driftsättningen.

Teamets administratörer lägger till webhooks på teamsidan, under Webhooks, och kan skicka ett testmeddelande för att kontrollera mottagaren. Adressen måste vara https, och meddelandet kan använda ${language.code}, ${language.name}, ${revision}, ${env}, ${user.name} och ${user.email}.

Säkerhet och personuppgifter

Inloggningen sker via Clerk, med Google, Microsoft eller en engångskod via e-post, så Sleekdocs Translate hanterar eller lagrar aldrig lösenord. Om dig sparar vi namn och e-postadress. Varje anrop kontrolleras mot din roll i teamet som äger projektet. Integritetspolicyn (på engelska) har detaljerna.