Dokumentasjon
Velkommen, og flott å se deg her! Hvis du har spørsmål, bare ta kontakt med oss på hi@localhero.ai.
Kom i gang
Registrer deg og følg disse trinnene for å integrere oversettelseshåndtering med Localhero.ai i prosjektet ditt.
1. Initialiser prosjektet ditt
Dette vil spørre om API-nøkkelen din og opprette enlocalhero.json
-fil i prosjektets rotmappe,og sette opp GitHub Action for å automatisk oversette i18n-filene dine. Du finner API-nøkkelen din på API-nøkler-siden.
$ npx @localheroai/cli init
2. Konfigurer prosjektet ditt
Sjekk den generertelocalhero.json
-filen og se om du trenger å gjøre noen justeringer.{:projectId=>"your-project-id", :sourceLocale=>"en", :targetLocales=>["es", "fr", "de"], :files=>["config/locales/*.yml", "app/javascript/locales/*.json"]}
3. Commit og push
Commit og push endringene dine til repositoriet ditt.$ git switch -c add-localhero
$ git add localhero.json .github/workflows/localhero-translate.yml
$ git commit -m "Add translation management with LocalHero"
$ git push origin add-localhero
CLI-kommandoer
$ localhero translate
Oversett manglende nøkler i prosjektet ditt, den vil også sjekke om det er nye nøkler som er lagt til i API-et som mangler lokalt.
Dette er kommandoen som vil kjøres av GitHub Action.
$ localhero init
Sett opp prosjektet ditt for LocalHero.ai, den vil sjekke om du har en API-nøkkel konfigurert og opprette en localhero.json
-fil i prosjektets rotmappe.
$ localhero login
Autentiser med API-et ved hjelp av API-nøkkelen din. Dette vil lagre API-nøkkelen din i .localhero_key
og legge til filen i .gitignore
om nødvendig. Du kan også sette API-nøkkelen din i miljøvariabelen LOCALHERO_API_KEY
.
$ localhero pull
Hent de nyeste oversettelsesoppdateringene fra LocalHero.ai til dine lokale filer. Denne kommandoen vil laste ned alle nye eller endrede oversettelser fra tjenesten til dine lokale filer.
Bruk --verbose for å se detaljert fremgangsinformasjon.
$ localhero push
Push oppdateringer fra dine lokale oversettelsesfiler til LocalHero.ai. Denne kommandoen vil laste opp alle nye eller endrede oversettelser fra dine lokale filer til tjenesten.
Bruk --verbose for detaljert fremgangsinformasjon og --yes for å hoppe over bekreftelsesdialogen.
GitHub Action
Automatiser oversettelser i CI/CD-prosessen din med vår GitHub Action.GitHub action krever at repository-hemmeligheten LOCALHERO_API_KEY
er satt.
Du setter hemmeligheten i repository-innstillingene under Settings > Secrets and variables > Actions
.
name: Localhero.ai - I18n translation
on:
pull_request:
paths:
- 'config/locales/**'
jobs:
translate:
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
steps:
- name: Checkout code
uses: actions/checkout@v4
with:
ref: ${{ github.head_ref }}
fetch-depth: 0
- name: Set up Node.js
uses: actions/setup-node@v4
with:
node-version: 18
- name: Run LocalHero CLI
env:
LOCALHERO_API_KEY: ${{ secrets.LOCALHERO_API_KEY }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: npx @localheroai/cli translate