Questa guida spiega come registrarsi per un account alla home page di READ-COOP (https://readcoop.eu/) e come scaricare, installare ed eseguire il Transkribus expert client. Informazioni su come trascrivere documenti con Transkribus si possono trovare nella sezione Guida ai 10 passi e in Come trascrivere documenti con Transkribus - Introduzione.
Scarica il Transkribus Expert Client, o assicurati di usare l'ultima versione qui.
Registrazione
- Per lavorare con Transkribus, è necessario registrare un account su https://readcoop.eu/
- Per registrarti, clicca su "Sign in" e poi su "Register". Dovrai fornire il tuo nome, l'indirizzo e-mail e accettare il contratto di utente di Transkribus.
- Secondo la legge austriaca sulla protezione dei dati, rispetteremo la tua privacy e useremo i tuoi dati solo per migliorare i nostri servizi e sostenere la ricerca nelle scienze umanistiche e informatiche.
- Se hai bisogno di cambiare la tua password, puoi trovare l'opzione per resettarla cliccando su "Sign in" e poi "Forgot Password?".
- Se vuoi cancellare il tuo account, invia un messaggio a: info@readcoop.eu
Download e installazione
- Una volta che ti sei registrato per un account, puoi scaricare Transkribus gratuitamente dalla nostra homepage.
- Mentre tutte le altre funzionalità di Transkribus possono essere usate gratuitamente, per le trascrizioni automatiche sono necessari credits. Tutte le informazioni sul sistema di credits si possono trovare qui.
- Ogni nuovo account di Transkribus riceve 500 credits gratis per sperimentare. Inoltre, con questo vogliamo sostenere coloro che hanno piccoli progetti di trascrizione, che hanno bisogno di riconoscere solo poche pagine.
Sistemi operativi supportati
- Transkribus gira su Windows, Mac e Linux. È scritto in Java. Assicurati di avere una versione a 64 bit di Java installata sul tuo computer che non sia più vecchia di Java 11 perché Transkribus funzioni. Puoi scaricarlo da qui: https://www.oracle.com/java/technologies/downloads/
Transkribus richiede Windows 64 bit. Se Transkribus non parte, potrebbe essere perché è installato un sistema operativo a 32 bit. Allora bisognerebbe installare un nuovo sistema operativo a 64 bit.
Come si può scoprire questo?
1. andare in Impostazioni di Windows - Informazioni su
2. o eseguire Transkribus dalla console per ottenere un messaggio di errore più dettagliato:
a. Per farlo, digita 'cmd' nella ricerca di Windows, apri il 'Prompt dei comandi'. Poi passa alla cartella Transkribus con cd 'Transkribus directory' (per esempio cd C:UsersUsernameTranskribus-1.17.0) ed esegui 'java -jar Transkribus.exe'.
In caso di problemi con Java, il pacchetto Java può anche essere copiato direttamente nella cartella di Transkribus. Il pacchetto Java deve essere rinominato in 'jre', in modo che Transkribus usi questo Java.
Per scoprire la versione di Java sul tuo computer, avvia nuovamente la console e digita java -version. Allora verrà visualizzata la versione corrente. Se non viene visualizzata alcuna versione di java, allora il sistema operativo non può (ancora) trovare il Java installato. Allora un riavvio o l'impostazione della variabile 'PATH' può aiutare: https://michster.de/wie-setze-ich-die-path-umgebungsvariablen-unter-windows-10/
Decomprimere il file ZIP
- Dopo aver cliccato sul pulsante di download sulla homepage di READ-COOP, otterrai un file ZIP, che dovrai decomprimere (clicca con il tasto destro sulla cartella e scegli "Estrai tutto").
- Apri la directory di Transkribus. Lì troverai i file eseguibili per il tuo sistema operativo.
- Poi fai doppio clic sul file .exe per Windows, sul file .command per Mac o sul file .sh per Linux per avviare l'installazione.
Note per il primo avvio su Linux
- Se il sistema operativo è basato su Ubuntu 17.04, è necessario installare libwebkit: sudo apt install libwebkitgtk-1.0-0
Note per il primo avvio su Windows
- Se non hai i diritti di "Amministratore", Windows genererà un messaggio di avviso, come ad esempio: "Il tuo computer è protetto da Windows", ecc.
- Non confermare, invece apri "Ulteriori informazioni" e conferma che vuoi eseguire Transkribus comunque.
Note per il primo avvio su MAC
- Se esegui il programma la prima volta, potrebbe non avviarsi perché è un'applicazione non firmata (messaggio "... non può essere aperto perché proviene da uno sviluppatore non identificato")
- In questo caso, clicca con il tasto destro del mouse (o control-click) sull'applicazione e scegli "Open". Nella finestra di dialogo che appare, clicca di nuovo su "Apri".
- In alternativa, clicca con il tasto destro del mouse sul Track Pad per aprire il menu contestuale e aggiungere un'eccezione di sicurezza per Transkribus.
- Un'altra opzione: clicca con il tasto destro del mouse sull'icona del programma -> Open (nel menu contestuale) -> via Terminal.
- Se l'app non si avvia affatto
- Puoi provare a spostare l'applicazione fuori dalla cartella Download, cioè copiarla o spostarla in un'altra cartella di destinazione come il Desktop.
- Il messaggio di errore quando si cerca di avviare l'applicazione da un terminale usando open -a Transkribus.app è: LSOpenURLsWithRole() failed for the application /Users/xxx/Desktop/Transkribus.app with error -10810.
- Una soluzione per avviare comunque il programma fino ad allora è quella di avviare un nuovo terminale (cerca "terminale" dopo aver premuto cmd + spazio), poi entra nella directory dove Transkribus è stato decompresso, per esempio la directory "Downloads":
- Poi avvia il programma direttamente dallo script di avvio che è incluso nel pacchetto Transkribus.app:
- ./Transkribus.app/Contents/MacOS/Transkribus
Eseguire Transkribus
Eseguire Transkribus tramite la riga di comando
- Transkribus è contenuto nel file jar principale Transkribus-.jar
- Per eseguire il programma dalla linea di comando digitate: java -jar Transkribus-.jar
- Nota: è necessario Java 11 o una delle seguenti versioni.
- Alcuni problemi (principalmente lo spazio heap di Java) si verificano perché una versione di Java a 32 bit è installata su un sistema operativo a 64 bit.
- Nota: Per eseguire gli script in Mac (o Linux) è necessario renderli eseguibili dalla linea di comando: (qualsiasi versione prima della 0.6.8)
- Inoltre, troverai diversi file nel pacchetto Transkribus copiati sul tuo computer:
- config.properties può essere modificato per regolare semplici proprietà di aspetto
- virtualKeyboards.xml può essere usato per specificare un set di tastiere virtuali
- logback.xml può essere modificato per regolare le proprietà di registrazione (solo per utenti esperti)
- La sottocartella 'libs' contiene le librerie necessarie per tutte le piattaforme. Attualmente sono supportate:
- Windows 32/64 bit
- Linux 32/64 bit
- OSX 64 bit
Usare un server proxy
- Se continui a ricevere il messaggio di errore "Login failed: already connected" il problema può essere il server proxy.
- Quando il programma si è avviato, clicca sul pulsante del menu iniziale in alto a sinistra e seleziona "Impostazioni proxy...". Nella seguente finestra di dialogo puoi impostare l'host proxy, la porta, il nome utente (opzionale) e la password (opzionale). Questo è il metodo raccomandato per usare un server proxy.
- In alternativa, puoi modificare lo script di avvio (ad esempio Transkribus.bat su Windows, Transkribus.sh su Linux) per includere le variabili di ambiente per il server proxy:
java -Dhttps.proxyHost=<proxyserver>
-Dhttps.proxyPort=<proxyPort>
-Dhttps.proxyUser=<user name for proxy>
-Dhttps.proxyPassword=<password for proxy>
-jar Transkribus-0.14.0.jar
Tuttavia, la modifica di questo file sarà necessaria per ogni aggiornamento di Transkribus.
Problemi noti
Il login nel server non è possibile via Transkribus, ma sul sito web funziona.
- Un'altra possibile ragione per il messaggio di errore "Already connected": la tua installazione di Java potrebbe essere obsoleta e non può stabilire una connessione sicura al server. Puoi controllare la tua versione installata aprendo un terminale/linea di comando e inserendo "java -version". Se incontri questo problema, prova ad aggiornare Java sulla tua macchina. Raccomandiamo una versione attuale non più vecchia di Java 11 (Oracle o OpenJdk). La versione Mac di Transkribus include un runtime Java. Se incontri questo problema su un Mac per favore scarica un nuovo pacchetto da https://readcoop.eu/ e aggiorna la tua installazione. Se l'errore persiste, contatta info@readcoop.eu, idealmente includendo il file di log della tua installazione (dalla directory di Transkribus: logs/TrpGui.log) e/o informazioni sulla tua versione di Java e sul tuo sistema operativo.
- Nota: la versione Mac del client expert viene fornita con un java spedito all'interno dell'applicazione. Se questa versione java è superata, puoi provare a cancellarla o sostituirla con una versione aggiornata. Per trovare i file in Mac finder, clicca con il tasto destro del mouse (o cmd-click) sull'applicazione Transkribus nella tua vista programmi, clicca "mostra il contenuto dei pacchetti" nel menu contestuale, poi vai alla sottocartella "Contents/MacOS". Lì, la sottocartella "jre" contiene quella versione di java. Se cancelli questa cartella, lo starter dell'applicazione cercherà di trovare java sul tuo sistema.
- Potrebbe essere necessario configurare un server proxy tramite "menu principale" - "Impostazioni proxy".
Versione sbagliata di JAVA su Mac
- Dopo aver aperto il file di comando sul Mac, Transkribus dice che c'è una versione sbagliata di Java installata. Tuttavia, c'è la versione più recente di Java installata.
- Il problema è che una vecchia versione potrebbe essere ancora installata e impostata come Java di default. Puoi controllare la versione di default aprendo il terminale e digitando 'java -version'.
- Per risolvere il problema puoi scaricare l'ultimo jdk come pacchetto .tar.gz da qui:
https://www.oracle.com/java/technologies/downloads/
e decomprimilo nella cartella Transkribus - il file Transkribus.command controllerà automaticamente le installazioni di java nelle sue sottodirectory.
- In alternativa puoi provare a impostare la tua installazione di Java 11 (o una delle versioni successive) come predefinita nella linea di comando seguendo per esempio le istruzioni qui:
http://myshittycode.com/2014/03/17/mac-os-x-setting-default-java-version/
Spazio Heap Java / No more handles
- 32 bit Java su un sistema operativo Windows a 64 bit -> installare Java a 64 bit da qui: https://www.oracle.com/java/technologies/downloads/
- Troppo poca RAM: Prova ad allocare più memoria principale aprendo Transkribus.bat e imposta ad esempio java -Xmx2048m -jar Transkribus-1.14.0.jar
- Avviare Transkribus con questo file bat
L'accesso è impedito dal Firewall del tuo Internet Provider
- Alcuni dipartimenti IT stanno bloccando la porta SSL 443 e/o applicazioni sconosciute tramite un firewall. Per favore controlla con il tuo dipartimento IT se questo potrebbe essere il caso.
Avira o Norton Antivirus rileva una minaccia e blocca la decompressione del file zip.
- Soluzione: Questo è un falso allarme che Norton dà quando incontra un software che non conosce (WS.Reputation.1). Dovresti essere in grado di ripristinare il file dalla quarantena seguendo le istruzioni della seguente risorsa [1].
Transkribus non si avvia su (Fedora) Linux - messaggio di errore 'MOZILLA_FIVE_HOME not set
- Il pacchetto "libwebkitgtk" potrebbe non essere installato. Su Fedora puoi installare il pacchetto usando dnf sulla linea di comando (usa "yum" invece di "dnf" nelle vecchie versioni di Fedora): sudo dnf install webkitgtk
Modalità scura su Mac
- La modalità scura su un Mac a volte può causare problemi con Transkribus, quindi se Transkribus non funziona correttamente sul tuo Mac e hai la modalità scura attivata, prova a disattivarla. Potrebbe essere necessario reinstallare Transkribus dopo aver spento la modalità scura per rendere effettivo il cambiamento.
Crediti
Vorremmo ringraziare i molti utenti che con il loro feedback hanno contribuito a migliorare il software Transkribus.
La piattaforma Transkribus è fornita dalla Cooperativa Europea READ-COOP SCE.
Fino a giugno 2019 Transkribus è stato finanziato come parte del progetto Horizon 2020 READ sotto l'accordo di sovvenzione n. 674943.
