Vodnik za prvi prevod

Od svoje knjige do prevoda, korak za korakom

Ni ti treba znati programirati. Če znaš prenesti datoteko, urediti eno vrstico in kopirati ukaz, lahko pripraviš prvi prevod.

Kaj potrebuješ

Pripravi štiri stvari. Plačljiva je samo uporaba izbranega jezikovnega modela.

Računalnik z Windows, macOS ali Linuxom.
Svojo knjigo v obliki EPUB, PDF ali MOBI, ki jo imaš pravico obdelati.
Brezplačen Python 3.10 ali novejši.
En ključ API: OpenAI ali Anthropic. Ne potrebuješ obeh.

Pridobi ključ API

Ključ API je zasebno geslo, s katerim Berilo plača in pošlje besedilo neposredno izbranemu ponudniku. Naročnina na ChatGPT ali Claude ne vključuje nujno uporabe API; obračun preveri v ponudnikovi konzoli.

OpenAI

Ustvari račun na platformi OpenAI, dodaj dobroimetje ali način plačila, odpri stran API keys in izberi Create new secret key. Ključ kopiraj takoj, ker ga pozneje ne bo mogoče prikazati v celoti.

Ustvari ključ OpenAI

Anthropic

Ustvari račun v konzoli Claude, uredi obračun, odpri API Keys in izberi Create Key. Tudi ta ključ se po ustvarjanju pokaže samo enkrat.

Ustvari ključ Anthropic

Ključa ne pošiljaj po e-pošti, ne objavi ga in ga ne prilepi na to spletno stran. Shrani ga samo v lokalno datoteko .env, opisano spodaj. Pri ponudniku nastavi omejitev porabe.

Prenesi Berilo in Python

Na GitHubu prenesi ZIP projekta Berilo in ga razširi v mapo, ki jo boš našel pozneje, na primer Dokumenti/Berilo.

Prenesi Berilo kot ZIP Odpri projekt na GitHubu

Nato namesti Python 3.10 ali novejši. V namestitvenem programu Windows označi Add Python to PATH.

Prenesi Python z uradne strani

Dodaj ključ in namesti prevajalnik

V razširjeni mapi Berilo poišči datoteko .env.example. Če skritih datotek ne vidiš, v raziskovalcu omogoči prikaz skritih datotek.

Naredi kopijo .env.example in jo preimenuj v .env.
Odpri .env v urejevalniku besedila. Ključ prilepi za OPENAI_API_KEY= ali ANTHROPIC_API_KEY=. Druga vrstica lahko ostane prazna.
Odpri terminal v mapi Berilo. V Windows lahko v naslovno vrstico mape vpišeš powershell; v macOS uporabi Terminal in mapo povleci vanj.

python -m pip install -e ./translator

Ko se namestitev konča, preveri povezavo. Preizkus prevede samo en stavek in stane približno nič.

berilo doctor

Preveri strošek in prevedi

Knjigo kopiraj v mapo Berilo ali v ukazu uporabi njeno celotno pot. Če so v imenu presledki, pot vedno postavi med narekovaje.

Najprej preveri, ali Berilo pravilno prebere knjigo:

berilo inspect "moja-knjiga.epub"

Nato naredi brezplačno oceno stroška. To vedno naredi pred prevodom:

berilo translate "moja-knjiga.epub" --to sl --dry-run

Če je ocena sprejemljiva, zaženi prevod:

berilo translate "moja-knjiga.epub" --to sl

Prevedeni EPUB se shrani ob izvirni knjigi. Prekinjen prevod lahko zaženeš znova; Berilo nadaljuje iz predpomnilnika in že prevedenih odsekov ne zaračuna ponovno.

Odpri prevedeno knjigo

Prevedeni EPUB lahko takoj odpreš v katerem koli bralniku EPUB. Ko bo uradni APK Berilo objavljen, ga prenesi samo s strani Releases: v Androidu dovoli namestitev neznanih aplikacij za svoj brskalnik ali upravljalnik datotek, nato odpri preneseni APK.

Preveri uradne izdaje

Napredno: zgradi aplikacijo Android iz izvorne kode

Ta pot zahteva Android Studio, JDK in orodje adb. Namenjena je tehnično izkušenim uporabnikom; za prvi prevod je ne potrebuješ.

cd android
./gradlew assembleRelease

adb install -r app/build/outputs/apk/release/app-release.apk

Poštena meja

Berilo pomaga brati. Ne pomaga pridobivati knjig.

Uporabi samo datoteke, ki jih zakonito imaš in jih smeš obdelati. Berilo nima kataloga knjig, prenosa, odstranjevanja DRM ali deljenja. Tako lahko orodje ostane odprto in uporabno za bralce ter spoštljivo do avtorjev in založnikov.

Nazaj na Berilo