Lire et étudier la Bible et l'enseignement de l'Église.
Voici quelques indications qui vous permettront de télécharger Theke et de l'utiliser à partir de son code source. De cette manière, vous pourrez le bidouiller et participer à son développement.
L'installation se fait en 3 temps.
- [15 min] Installer la librairie Sword.
- [5 min] Télécharger le code source de Theke.
- [10 min] Mettre en place l'environnement virtuel python.
Comptez une petite demi-heure pour suivre toutes ces étapes.
Convention. PROJECTS est le dossier de base à partir duquel nous allons travailler. Il n'est pas nécessairement vide. Il peut déjà contenir d'autres fichiers, d'autres projets.
Installez les utilitaires et les libraires nécessaires à la compilation de Sword.
sudo apt install subversion build-essential autotools-dev pkg-config libz-dev libclucene-dev libicu-dev libcurl4-gnutls-dev libtool m4 automake cmake swig python3-dev
Créez dans PROJECTS un dossier de travail et télécharger le code source de Sword.
mkdir sword && cd swordsvn co http://crosswire.org/svn/sword/trunk sources
Compilez et installez Sword.
mkdir build && cd buildcmake -DLIBSWORD_LIBRARY_TYPE="Shared" -DCMAKE_INSTALL_PREFIX="/usr" -DSWORD_PYTHON_3:BOOL=TRUE ../sourcesmake -j4sudo make install
Depuis le dossier PROJECTS, téléchargez le code source de Theke.
cd PROJECTSgit clone https://github.com/a2ohm/theke.git
Pour faire fonctionner Theke, vous devez installer plusieurs librairies python. Pour qu'elles n'interfèrent pas avec le reste de votre système, nous allons mettre en place un environnement virtuel python.
Si besoin, installez python3-venv.
sudo apt install python3-venv
Dans le dossier contenant le code source de Theke, créez l'environnement virtuel et basculez dedans.
cd thekepython3 -m venv .venvsource .venv/bin/activate
Remarque. En fonction de votre shell, peut-être devrez-vous utiliser source .venv/bin/activate.csh ou source .venv/bin/activate.fish.
Pour indiquer que vous êtes maintenant dans l'environnement virtuel, vous devez lire (.venv) devant l'invite de commande de votre terminal.
Remarque. Pour sortir de l'environnement virtuel, il suffit de lancer la commande deactivate.
Mettez à jour les paquets de base.
pip3 install --update pippip3 install --update setuptools
Installez PyGObject.
(source : https://pygobject.readthedocs.io/en/latest/getting_started.html )
sudo apt install libgirepository1.0-dev gcc libcairo2-dev pkg-config python3-dev gir1.2-gtk-3.0pip3 install pycairopip3 install PyGObject
Installez les autres librairies requises : BeautifulSoup4, Jinja2, PyYaml, Requests.
pip3 install beautifulsoup4pip3 install Jinja2pip3 install pyyamlpip3 install requests
Installez le paquet Sword que vous avez compilé tout à l'heure.
cd ../sword/build/bindings/swig/python3/python setup.py install
Et voilà ! Pour lancer Theke, revenez dans le répertoire du projet et exécutez la commande suivante.
cd PROJECTS/thekepython3 theke.py
Theke ne sait pas encore télécharger et installer les modules Sword. Il faut passer par un logiciel tiers pour le faire (ex. Xiphos). Vous trouverez les informations nécessaires dans la page d'aide de Theke.
Modules d'intérêts.
| Nom du module | Nom du dépôt | Description |
|---|---|---|
| OSHB | CrossWire > Texte bibliques > ﬠברית מקראית | Open Scriptures Hebrew Bible |
| EarlyFathers | Xiphos > Livres > English | - |
| MorphGNT | CrossWire > Textes bibliques > Κοινὴ Ἑλληνική | Morphologically Parsed Greek New Testament based on the SBLGNT |
| 2TGreek | Xiphos > Textes bibliques > Κοινὴ Ἑλληνική | Morphologically Parsed Greek Old and New Testament |
Pour lancer Theke, exécuter la commande suivante depuis le répertoire du projet.
python3 theke.py
--debug, -d: affiche tous les messages de débogage.--uri, -u: lance Theke et ouvre directement l'uri donnée.
Exemple. python3 theke.py --uri "theke:/doc/bible/Hebrews 1?sources=MorphGNT"
Chaque document accessible dans Theke est désigné par une uri. Cette uri peut aussi indiquer la ou les sources à utiliser pour afficher le document.
theke:/app/help: uri de la page d'aide.theke:/doc/bible/Hebrews 1: uri du premier chapitre de la lettre aux Hébreux.theke:/doc/bible/Isaiah 6?sources=OSHB: uri du sixième chapitre du livre d'Isaïe, dans le module OSHB.theke:/doc/book/Lumen Gentium: uri vers la constitution Lumen Gentium.
Astuce. Depuis la barre d'historique, obtenez rapidement l'uri d'un document par un clique droit sur l'onglet du document qui vous intéresse.
Astuce. Créer un fichier theke.desktop dans ~/.local/share/applications avec le contenu suivant vous permet à votre système d'exploitation de reconnaître les URI theke (redémarrage de la session probablement nécessaire). Penser à l'adapter selon votre installation : remplacer PROJECTS par le chemin idoine.
[Desktop Entry]
Name=Theke
Exec=env PATH=PROJECTS/theke/.venv/bin:$PATH VIRTUAL_ENV=PROJECTS/theke/.venv python3 PROJECTS/theke/theke.py %u
Path=PROJECTS/theke/
Icon=PROJECTS/theke/assets/img/theke-logo.svg
Type=Application
Terminal=false
Categories=Education;
MimeType=x-scheme-handler/theke
StartupNotify=true