La Sua prima traduzione

Dal Suo libro alla traduzione, passo dopo passo

Non serve saper programmare. Se sa scaricare un file, modificare una riga e copiare un comando, può preparare la Sua prima traduzione.

Che cosa serve

Prepari quattro elementi. Soltanto l’uso del modello linguistico scelto comporta un costo.

  • Un computer Windows, macOS o Linux.
  • Il Suo file EPUB, PDF o MOBI, che deve avere il diritto di trattare.
  • Python 3.10 o successivo, gratuito.
  • Una chiave API OpenAI o Anthropic. Non servono entrambe.

Ottenga una chiave API

Una chiave API è una password privata che permette a Berilo di inviare il testo direttamente al fornitore scelto e addebitare l’uso al Suo account. Un abbonamento ChatGPT o Claude non include necessariamente l’uso delle API; controlli la fatturazione nella console del fornitore.

OpenAI

Crei un account su OpenAI Platform, aggiunga credito o un metodo di pagamento, apra API keys e scelga Create new secret key. Copi subito la chiave, perché in seguito non sarà più mostrata per intero.

Crea una chiave OpenAI

Anthropic

Crei un account nella console Claude, configuri la fatturazione, apra API Keys e scelga Create Key. Anche questa chiave viene mostrata una sola volta.

Crea una chiave Anthropic

Non invii la chiave per e-mail, non la pubblichi e non la incolli in questo sito. La conservi soltanto nel file locale .env descritto qui sotto. Imposti un limite di spesa presso il fornitore.

Scarichi Berilo e Python

Scarichi il progetto Berilo in formato ZIP da GitHub e lo estragga in una posizione facile da ritrovare, per esempio Documenti/Berilo.

Installi quindi Python 3.10 o successivo. In Windows selezioni Add Python to PATH nel programma di installazione.

Scarica Python dal sito ufficiale

Aggiunga la chiave e installi il traduttore

Cerchi .env.example nella cartella Berilo estratta. Se non vede i file che iniziano con un punto, abiliti la visualizzazione dei file nascosti.

  1. Crei una copia di .env.example e rinomini la copia in .env.
  2. Apra .env in un editor di testo. Incolli la chiave dopo OPENAI_API_KEY= o ANTHROPIC_API_KEY=. L’altra riga può restare vuota.
  3. Apra un terminale nella cartella Berilo. In Windows scriva powershell nella barra degli indirizzi della cartella; in macOS apra Terminale e trascini la cartella nella finestra.
python -m pip install -e ./translator

Al termine dell’installazione, verifichi la connessione. Il test traduce una frase e ha un costo pressoché nullo.

berilo doctor

Controlli il costo e traduca

Copi il libro nella cartella Berilo oppure usi il percorso completo nel comando. Racchiuda sempre tra virgolette i percorsi che contengono spazi.

Per prima cosa verifichi che Berilo riesca a leggere il libro:

berilo inspect "moja-knjiga.epub"

Poi ottenga una stima gratuita del costo. Lo faccia sempre prima di tradurre:

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

Se la stima è accettabile, avvii la traduzione:

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

L’EPUB tradotto viene salvato accanto all’originale. Può riavviare una traduzione interrotta: Berilo riprende dalla cache e non addebita nuovamente le sezioni già completate.

Apra il libro tradotto

Può aprire subito l’EPUB tradotto in qualsiasi lettore EPUB. Quando verrà pubblicato l’APK ufficiale di Berilo, lo scarichi soltanto da Releases: consenta l’installazione di app sconosciute per il browser o il gestore file di Android, quindi apra l’APK scaricato.

Controlla le versioni ufficiali
Avanzato: compilare l’app Android dal codice sorgente

Questo percorso richiede Android Studio, un JDK e adb. È pensato per persone con esperienza tecnica e non è necessario per la prima traduzione.

cd android
./gradlew assembleRelease
adb install -r app/build/outputs/apk/release/app-release.apk

Un confine equo

Berilo aiuta a leggere. Non aiuta a procurarsi libri.

Usi soltanto file che possiede legalmente e che ha il diritto di trattare. Berilo non offre cataloghi, download, rimozione di DRM o condivisione. In questo modo lo strumento può restare aperto e utile a chi legge, nel rispetto di autori ed editori.

Torna a Berilo