Files
2023-12-07 20:47:44 +01:00

4.6 KiB

Automatsko prevođenje OpenAI dokumentacije

en| zh-Hans | es | ru | de | fr | ja | ko | pt | it | ar | tr | pl | nl | vi | th | fa | ro | sv | hu | cs | el | da | fi | he | no | hi | zh_tw | in | sl | sk | uk | bg | hr | lt | lv | et | cat

Ova dokumentacija je automatski prevedena i može sadržati greške. Ne oklevajte da otvorite Pull Request za predlaganje izmena.

Instalacija

Alat se može instalirati putem NPM-a:

    npm install -g autotranslatedoc

Obavezno postavite okruženjske promenljive: GITHUB_PERSONAL_ACCESS_TOKEN i OPENAI_API_KEY. Alternativno, ove tokene možete proslediti kao parametre. Pogledajte GitHub dokumentaciju za dobijanje GITHUB_PERSONAL_ACCESS_TOKEN.

"

Upotreba

Stranica za pomoć

Pristupite stranici za pomoć pomoću sledeće komande:

 autotranslatedoc -h

Prevođenje dokumentacije

Autotranslatedoc prima 3 argumenta i mnogo opcija

    autotranslatedoc <komanda> <repo_org> <repo_naziv> (opcije)
  • komanda može biti: translate (za prevođenje), update (za ažuriranje prevoda), build (za izgradnju prevoda)
  • repo_org je organizacija ciljnog repozitorijuma na GitHub-u
  • repo_naziv je naziv ciljnog repozitorijuma na GitHub-u

Glavne dostupne opcije su:

  • --jezik <jezik_1>(, <jezik_2>)* (ili -l) za odabir jezika na koji želite prevesti.
  • --putanjaDokumentacije </url/putanja> (ili -d) za ograničavanje prevoda na fajlove u određenoj putanji.
  • --putanjaCuvanja <./lokalnaPutanja> (ili -s) za odabir direktorijuma gde će se sačuvati fajl (podrazumevano je ./save).
  • --putanjaIzlaza <./lokalnaPutanja> (ili -o) kada koristite build, za određivanje gde će se izlazni dokumenti prevoda nalaziti (podrazumevano je ./build)

Da biste preveli dokumentaciju ciljnog repozitorijuma na francuski i španski jezik, koristite:

    autotranslatedoc translate run-llama llama_index -l fr,es

Ova komanda kreira fajl llama_index.json u direktorijumu run-lama određenog izlaznog direktorijuma (podrazumevano je ./save).

    ls ./save
        run-llama
            llama_index.json 

Sačuvani fajl sadrži sve prevode i može se koristiti za generisanje dokumentacije u ciljanom formatu (trenutno samo .md).

Za izgradnju prevedene dokumentacije, koristite:

    autotranslatedoc build run-llama llama_index -l fr,es

Ova komanda generiše direktorijume fr i es u buildPath-u (podrazumevano je ./build) koji sadrže fajlove prevedene dokumentacije.

Za ažuriranje prevedene dokumentacije na osnovu promena u originalnim fajlovima, koristite:

    autotranslatedoc update run-llama llama_index -l fr,es

Za pregled dokumentacije putem servera (eksperimentalna funkcionalnost), koristite:

    autotranslatedoc serve run-llama llama_index

Prevođenje Docusaurus dokumentacije

Za prevođenje dokumentacije hostovane u Docusaurus-u, koristite:

    autotranslatedoc translate run-llama LlamaIndexTS --docPath /apps/docs/docs -l fr,es -m docusaurus
    autotranslatedoc build run-llama LlamaIndexTS --docPath /apps/docs/docs -l fr,es -m docusaurus

Samo prevod README.md

Da biste preveli samo README fajl, koristite režim readme:

    autotranslatedoc translate run-llama LlamaIndexTS -l fr,es -m readme
    autotranslatedoc build run-llama LlamaIndexTS  -l fr,es -m readme

Prevođenje na sve podržane jezike

Da biste preveli na sve podržane jezike, koristite opciju -l all:

    autotranslatedoc translate run-llama LlamaIndexTS -l all -m readme
    autotranslatedoc build run-llama LlamaIndexTS  -l all -m readme

Poznati problemi

Trenutno, prevod sa -all je podržan samo iz engleskog na sve ostale jezike.