mumble: android tutorial

mumble/preprocess.py

@@ -2,6 +2,7 @@
 
 import sys
 import re
+import os
 
 base_url = "https://gitea.planet-casio.com/Lephenixnoir/Tutoriels/raw/branch" \
            "/master/mumble/"
@@ -13,5 +14,11 @@ if len(sys.argv) > 1:
 with open("utilisation-mumble.txt", "r") as fp:
     t = fp.read()
     t = re.sub(r'^#[^\n]*[\n]+', "", t, count=1)
-    t = re.sub(r'\[img\]([^[:]+)\[/img\]', "[img]"+base_url+"\\1[/img]", t)
+
+    def one(m):
+        if not os.path.exists(m[1]):
+            print("warning: file", m[1], "does not exist", file=sys.stderr)
+        return "[img]" + base_url + m[1] + "[/img]"
+
+    t = re.sub(r'\[img\]([^[:]+)\[/img\]', one, t)
     print(t)

mumble/utilisation-mumble.txt

@@ -15,7 +15,8 @@ Dans ce tutoriel, je vais présenter les grandes lignes de l'installation et la
 [color=white]`__`[/color]1.4. [target=pcserv]Enregistrement du serveur[/target]
 [color=white]`__`[/color]1.5. [target=pcgui]L'interface graphique[/target]
 2. [target=android][b]Mumble pour Android[/b][/target]
-[color=white]`__`[/color]... (à venir)
+[color=white]`__`[/color]2.1. [target=androidinstall]Installation et configuration[/target]
+[color=white]`__`[/color]2.2. [target=androidgui]Connexion et interface[/target]
 3. [target=web][b]Client web Mumble avec un navigateur[/b][/target]
 
 [center]•[/center]
@@ -93,9 +94,40 @@ Parmi les boutons importants, il y a notamment les deux boutons permettant de co
 [center]•[/center]
 [label=android][big][brown][b]Mumble pour Android[/b][/brown][/big]
 
-... à venir (je n'ai pas de téléphone approprié). x_x
+[label=androidinstall][brown][b]Installation et configuration[/b][/brown]
 
-Typiquement, tu as envie d'utiliser le client [b]Pumble[/b], qui marche très bien de façon générale. ([url=https://play.google.com/store/apps/details?id=com.morlunk.mumbleclient.free]Google Play[/url], [url=https://f-droid.org/packages/com.morlunk.mumbleclient/]F-Droid[/url])
+Sous Android, je te conseille d'utiliser le client [b]Plumble[/b]. L'application fonctionne très bien de façon générale, et tu peux la télécharger [url=https://play.google.com/store/apps/details?id=com.morlunk.mumbleclient.free]sur Google Play[/url] ou [url=https://f-droid.org/packages/com.morlunk.mumbleclient/]sur F-Droid[/url], selon tes préférences. :)
+
+La première fois que tu lances l'application, Plumble te demande de générer un certificat, qui est une sorte d'identité Mumble. On ne s'en sert pas sur Planète Casio, mais il te sera utile sur d'autres sites. ^^
+
+[center][img]android-certificate.png[/img][/center]
+Une fois dans le menu principal, appuie sur le bouton `(+)` pour enregistrer un nouveau serveur. Cela ouvre une boîte de dialogue où tu dois rentrer les paramètres. Dans "`Adresse`", mets "`mumble.planet-casio.com`". Le port est 64738, tu n'as pas besoin de l'indiquer (c'est la valeur par défaut). Inscris ton nom d'utilisateur et un libellé de ton choix, puis appuie sur "`Ajouter`".
+
+Et voilà, Plumble est configuré pour ton téléphone. Toute cette étape n'a besoin d'être faite qu'une fois, donc chaque fois que tu ouvriras l'application désormais, tu pourras passer directement à la prochaine partie. :)
+
+[label=androidgui][brown][b]Connexion et interface[/b][/brown]
+
+Une fois le serveur enregistré, il est listé sur l'accueil de l'application. Tape dessus pour te connecter.
+
+[center][img]android-home.png[/img][/center]
+L'interface de Plumble comporte deux onglets : le premier montre les salons et la liste des personnes connectées. Actuellement il y a un unique salon « Planète Casio ». Le second contient le chat. Pour y passer, tape sur "`Chat`" ou fait glisser la barre d'onglets.
+
+[center][img]android-gui-channel.png[/img]
+
+[img]android-gui-chat.png[/img][/center]
+Si tu as autorisé Plumble à afficher des notifications alors un petit contrôle s'affichera dans ton centre de notifications, comme durant un appel. Ce contrôle te permet de désactiver ton microphone ou ta sortie audio, et d'activer le widget [i]overlay[/i] qui te suit d'application en application.
+
+[center][img]android-notification.png[/img]
+
+[img]android-overlay.png[/img][/center]
+Enfin, le menu en haut à droite (icône avec trois points) contient plusieurs éléments importants :
+
+• Le choix du mode d'activation de la transmission (lorsque le niveau de son dépasse un certain seuil, lorsque tu appuies sur l'écran, ou en continu).
+• Une copie de l'option qui coupe la sortie audio du client.
+• Et notamment le bouton pour te déconnecter du serveur.
+
+[center][img]android-options.png[/img][/center]
+Voilà pour la partie Android ! :D
 
 [center]•[/center]
 [label=web][big][brown][b]Client web Mumble avec un navigateur[/b][/brown][/big]