Projet:Biologie/Taxobot/Installation Windows 10 et 11 (WSL)

Procédure d'installation de Taxobot sur Windows 10 et 11, en utilisant WSL (Windows Subsystem Linux) permettant de faire tourner un Linux sur son Windows mais de façon plus légère qu'une « vraie » virtualisation.

Première étape : installer WSL

Ouvrir les paramètres Windows (menu Windows → application « Paramètres » − symbole engrenage).

Sélectionnez « Applications », puis « Fonctionnalités facultatives », et enfin « Plus de fonctionnalités Windows ».
Une fenêtre avec une liste cochable apparaît : cherchez et cochez « Sous-système Windows pour Linux » (si vous êtes en français, probablement « Windows Subsystem Linux » en anglais); de même cochez « Plateforme de l'hyperviseur windows » et « Plateforme d'ordinateur virtuel » ; puis cliquez le bouton « Ok ».

WSL s'installe, ce qui peut prendre un peu de temps.

Une fois l'installation terminée il est nécessaire de redémarrer l'ordinateur (l'outil d'installation le propose, d'ailleurs).

Optionnel : après le redémarrage il est conseillé de faire en sorte que la version 2 de WSL soit la version par défaut (c'est optionnel car ça améliore les performances mais n'empêche pas de fonctionner si non fait).
Pour cela ouvrir l'invite de commandes (menu Windows, chercher « cmd », ou, au clavier pressez les touches Windows + R), après ouverture tapez-y :
wsl --set-default-version 2

Vous pouvez ensuite fermer la fenêtre.

Deuxième étape : installer une Ubuntu

Cliquez sur « Ubuntu » dans la référence suivante : Canonical Group Limited, « Ubuntu », sur www.microsoft.com, sur le site cliquez sur « Get in Store app » (« obtenir dans l'appli du store » en français) puis « Ouvrir Microsoft Store », installez ;

OU :

Ouvrez l'application « Microsoft Store » (menu Windows : il est possible d'effectuer une recherche). Tapez « Ubuntu » dans la zone de recherche, et cliquez sur « Ubuntu » sans numéro de version (c'est normalement la plus récente). Lancez son installation (bouton « Obtenir » ou « Télécharger ») et patientez

Puis (indépendamment de la méthode précédente) :

Une fois l'installation terminée vous avez une nouvelle application « Ubuntu » disponible. Lancez-la (l'installeur de l'étape précédente vous propose de l'ouvrir, mais vous pouvez passer par le menu Windows comme pour toutes les applications).

Une fenêtre sur fond noir s'ouvre : c'est votre Ubuntu (elle est uniquement en mode texte).
Lors de la première ouverture elle termine son installation et ses mises à jour : patientez.

Une fois terminé Ubuntu vous demande un nom d'utilisateur (utilisez uniquement des minuscules, sans espace) puis un mot de passe associé (qu'il faut re-saisir une deuxième fois).

Troisième étape : installer Taxobot

Il faut au préalable installer certains outils nécessaires. Pour cela tapez (copier-coller possible) dans la fenêtre de Ubuntu :

• sudo apt-get update
• sudo apt-get install -y git php php-curl php-json php-xml php-bz2 php-zip php-yaml php-mbstring php-readline

La commande "sudo" permet de lancer des commandes avec les droits administrateur. Elle vous demandera (au moins la première fois) votre mot de passe (celui que vous avez défini à la fin de l'installation Ubuntu).

Maintenant récupérer Taxobot. Tapez la commande :
git clone https://github.com/Hexasoft/taxobot.git

Ça y est !

Utiliser Taxobot

Pour utiliser Taxobot il vous suffit de vous rendre dans le dossier de Taxobot en tapant la commande :
cd taxobot

Mettez à jour le code de Taxobot :
git pull

Note : ces deux actions sont à faire à chaque fois que vous démarrez votre application Ubuntu.

Ensuite appelez Taxobot comme suit :
php taxobot.php -taxon "Uroplatus fimbriatus"

Et patientez (ça peut être long selon les sources consultées).

Pour connaître toutes les options tapez :
php taxobot.php -help

Remarque : les options indiquées "flag" ont juste besoin d'être présente ; les options indiquées "bool" doivent être suivies de "oui" ou de "non" ; les options indiquées "string" doivent être suivies d'un texte.

Important : si le nom du taxon comporte plusieurs mots vous devez mettre des guillemets autour du nom (comme dans l'exemple ci-dessus).

Résultats

Lorsque Taxobot retourne un résultat (en supposant qu'il ait trouvé le taxon) celui-ci se compose de plusieurs zones :

• le squelette de l'article (wikicode)
• une série de liens (format HTML) vers les différentes ressources trouvées (Biorefs mais aussi commons, species, wikidata…)
• le log de fonctionnement, où chaque module explique ce qu'il a fait et la raison pour laquelle il n'a pas trouvé d'information (le cas échéant)

Résolutions des problèmes

• Problèmes liés à la machine virtuelle, lors de l'édition de « Fonctionnalités facultatives », assurez-vous d'avoir coché ou que les options suivantes sont déjà cochées : Hyper-V et/ou Plateforme de l'hyperviseur windows et/ou Plateforme d'ordinateur virtuel ; si ces options ne sont pas activées, Ubuntu devrait renvoyer l'erreur 0x80370102 (aide à la résolution). Conseil d'ami : n'éditez pas votre BIOS sans être certain que vous savez ce que vous faîtes !
• Problèmes liés à l'installation de WSL, l'erreur 0x800701bc est la plus courante, les instructions Microsoft peuvent être utiles mais une mise à jour avec wsl_update_x64 suffit en général à régler le problème.
• Pour toutes autres problèmes, demandez de l’aide sur Discussion utilisateur:Hexasoft/Taxobot