Pour pouvoir tester le programme sans utiliser la version compilée (c'est-à-dire diffusée sous forme de logiciel), il faut disposer d'un ordinateur avec deux choses :

1. le langage Python en version 3 (3.5 ou 3.6) : par exemple avec la distribution Anaconda et y ajouter un peu de configuration
2. la possibilité de mettre à jour systématiquement l'ensemble des fichiers qui constituent le code du programme : avec Github Desktop, par exemple, en se raccrochant au projet transbiblio.

Par ailleurs il faut s'assurer que le PC peut accéder à internet depuis tous les programmes, et pas seulement depuis le navigateur web : la plupart des réseaux professionnels passent par un proxy, et nécessitent une autorisation spéciale pour que le programme transbiblio puisse lui aussi accéder au réseau.

Installation de Python

(on suppose que vous partez d'un PC qui n'a rien, standard, sous Windows)

Anaconda

Télécharger et installer la distribution Anaconda, qui contient Python dans sa dernière version, ainsi que la plupart des librairies de fonctions nécessaires pour transbiblio et des éditeurs Python. En particulier, au cours de l'installation, veillez à ce que les cases ci-dessous soient bien cochées

Ajout de librairies complémentaires

Certaines fonctions utilisées par le système sont bien implémentées pour Python, mais ne sont pas incluses dans Anaconda. Il suffit d'ouvrir le terminal Windows (menu Démarrer > cmd.exe) puis dans le terminal d'écrire :

conda install -c anaconda unidecode

conda install -c asmeurer pymarc ou pip install pymarc

et

conda install -c anaconda lxml

Et logiquement Python est bien installé pour faire tourner le code

Récupérer le code source du logiciel

Ce code est déposé systématiquement sur Github, et sera fréquemment mis à jour (il est encore en phase de débuggage et il lui manque certainement de nombreuses fonctionnalités). Il faut donc pouvoir récupérer systématiquement et facilement tous les fichiers de code qui le composent. Le plus simple est d'installer un logiciel de synchronisation automatique entre son ordinateur et Github. Une des manières de faire est de récupérer Github Desktop. Une fois installé, il faut l'ouvrir et aller dans le menu : File > Clone Repository

Dans la fenêtre, choisir l'onglet URL, puis copier-coller l'URL du projet transbiblio : et choisir un répertoire où le cloner sur son PC

Avant chaque exécution du programme, il faudra rouvrir Github Desktop, vérifier les mises à jour de transbiblio et les télécharger.

Exécuter le programme

Une fois que le code a été récupéré, un ensemble de fichiers se trouvent dans le répertoire sélectionné à l'étape précédente (sur l'image ci-dessus : C:\Users\Lully\Documents\transbiblio) Dans ce répertoire se trouve un fichier transbiblio.bat (qui est un exécutable sous Windows. Sur un autre système d'exploitation il faudrait lancer le code autrement. Ce programme ne fait que lancer le fichier main.py avec Python)

Il faut double-cliquer sur transbiblio.bat -- et logiquement le programme se lance en quelques secondes

Important : si le programme plante

Envoyer par mail une copie d'écran du terminal Windows, qui contient la description du problème rencontré par le programme, et (si possible) le fichier qui a été mis en entrée du programme.