mumble: install and initial configuration (WIP)

mumble/preprocess.py

@@ -0,0 +1,16 @@
+#! /usr/bin/env python3
+
+import sys
+import re
+
+base_url = "https://gitea.planet-casio.com/Lephenixnoir/Tutoriels/mumble/"
+
+if len(sys.argv) > 1:
+    print("warning: this script takes no arguments -- ignoring",
+        file=sys.stderr)
+
+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)
+    print(t)

mumble/utilisation-mumble.txt

@@ -0,0 +1,92 @@
+# Tutoriel d'installation et de configuration de Mumble
+
+Bienvenue à toi ! Ce tutoriel est destiné à toutes les personnes qui ont du mal à installer ou utiliser [url=https://www.mumble.info/]Mumble[/url], le logiciel de communication audio utilisé pour les réunions et discussions sur Planète Casio.
+
+On utilise Mumble car c'est un [url=https://fr.wikipedia.org/wiki/Logiciel_libre]logiciel libre[/url] que l'on peut installer où on le veut. Actuellement, le serveur de Planète Casio héberge son propre serveur Mumble [i](murmur)[/i], ce qui ne serait par exemple pas possible avec Discord.
+
+Dans ce tutoriel, je vais présenter les grandes de l'installation et la configuration de Mumble pour se connecter au serveur de Planète Casio. Il y a différentes parties à lire selon votre plateforme ; note que si tu utilises [target=web]le client web[/url] (ordinateur conseillé) alors tu n'aura rien à installer du tout.
+
+[b]Sommaire[/b]
+
+1. [target=pc]Mumble pour PC[/target]
+[color=white]`__`[/color]1.1. [target=pc-win]Installation sous Windows[/target]
+[color=white]`__`[/color]1.2. [target=pc-linux]Installation sous Linux[/target]
+[color=white]`__`[/color]1.3. [target=pc-conf]Configuration initiale[/target]
+[color=white]`__`[/color]1.4. [target=pc-serv]Enregistrement du serveur[/target]
+[color=white]`__`[/color]1.5. [target=pc-gui]L'interface graphique[/target]
+
+2. [target=android]Mumble pour Android[/target]
+[color=white]`__`[/color]... (à venir)
+
+3. [target=web]Client web Mumble avec un navigateur[/target]
+
+
+[label=pc][big][brown][b]Mumble pour PC[/b][/brown][/big]
+
+Dans cette partie, je couvre l'installation et la configuration de Mumble pour Windows et Linux. Mes excuses aux détenteurs de Mac... je n'ai pas de quoi tester. En théorie ça doit se passer entiellement comme sous Windows.
+
+[label=pc-win][brown][b]Installation sous Windows[/b][/brown]
+
+Commence par te rendre sur [url=https://www.mumble.info/downloads/]`www.mumble.info/downloads`[/url] pour télécharger la version appropriée pour ta machine. À moins que ton ordinateur ait plus de 5 ans (voire 10 ans), c'est la version [b]Windows 64-bit[/b] dont tu as besoin. Si tu as un doute sur ton architecture, consulte [url=https://support.microsoft.com/fr-fr/help/827218/how-to-determine-whether-a-computer-is-running-a-32-bit-version-or-64]l'aide en ligne de Microsoft[/url]. :)
+
+[center][img]windows-download.png[/img][/center]
+Tu obtiens un fichier exécutable, par exemple `mumble-1.3.0.winx64.msi` à l'heure où j'écris ce tutoriel. Lance-le et suis les étapes de l'installation comme d'habitude. Les paramètres par défaut doivent largement suffire.
+
+À l'étape « Installation personnalisée », sois attentif : tu dois installer [b]Mumble (client) mais pas Murmur (serveur)[/b]. Le serveur existe déjà, il est chez Planète Casio. ;)
+
+[center][img]windows-install.jpg[/img][/center]
+Une fois l'installation terminée, Mumble se lance automatiquement. Tu peux passer directement à la [target=pc-conf]configuration initiale[/target].
+
+[label=pc-linux][brown][b]Installation sous Linux[/b][/brown]
+
+Sous Linux, la façon préférée d'installer un logiciel est par le gestionnaire de paquets. La plupart des distributions supportées sont listées dans [url=https://wiki.mumble.info/wiki/Installing_Mumble]les instructions d'installation sur le wiki de Mumble[/url], qui est toujours la référence primaire. Je ne cite ici que quelques distributions dont on parle fréquemment :
+
+[b]Ubuntu[/b] (via PPA)
+[code]# sudo add-apt-repository ppa:mumble/release
+# sudo apt-get update
+# sudo apt-get install mumble[/code]
+[b]Debian[/b]
+[code]# sudo apt-get install mumble[/code]
+[b]Arch Linux, Manjaro[/b]
+[code]# sudo pacman -S mumble[/code]
+Une fois le paquet installé, localise Mumble dans ta liste de logiciels ou lance simplement la commande "`mumble`".
+
+[label=pc-conf][brown][b]Configuration initiale[/b][/brown]
+
+Lorsque Mumble démarre pour la première fois, une étape de configuration est nécessaire. La plupart des paramètres sont devinés automatiquement, mais certains sont mieux vérifiés. La première étape où il faut être attentif, surtout sous Linux, est la sélection du microphone et du périphérique audio.
+
+[center][img]config-1.png[/img][/center]
+Sur mon ordinateur, j'utilise le module basique ALSA. Selon ta distribution Linux, tu auras très probablement [b]PulseAudio[/b]. Sous Windows, tu auras probablement [b]WASAPI[/b] qui sera fixé sans possibilité de changer. Commence par tester avec le choix par défaut ; si tu ne peux rien entendre ou ne peux pas parler dans les tests qui suivent, reviens sur cet écran pour essayer d'autres périphériques.
+
+La deuxième étape est le choix de ta [b]méthode de transmission[/b]. Pour éviter qu'on t'entende taper au clavier ou à la souris lorsque tu es connecté(e), le logiciel n'enregistre et transmet le son de ton microphone que quand tu parlez. Et il y a deux façons principales de détecter que tu parles :
+
+1. [b]Selon le niveau de son[/b] : dès que le niveau de son dépasse un seuil fixé, Mumble transmet.
+2. [b]Lorsque tu appuies sur une touche[/b] : tu annonces explicitement que tu veux transmettre.
+[center][img]config-2.png[/img][/center]
+
+Pour utiliser le mode automatique (1), sélectionne la deuxième option dans la liste. Pour utiliser le mode manuel (2), sélectionne la première option et choisis la touche que tu utiliseras pour transmettre.
+
+[i](Note aux utilisateurs de Wayland sous Linux : le raccourci peut ne pas fonctionner selon si la fenêtre active utilise ou non XWayland.)[/i]
+
+Finalement, le dernier écran de la configuration consiste à créer un certificat pour s'identifier sur les serveurs. Planète Casio n'utilise actuellement pas de certificats, donc l'option par défaut d'en créer un nouveau suffit.
+
+[center][img]config-3.png[/img][/config]
+Une fois l'assistant terminé, il n'apparaîtra plus au lancement de Mumble. Si tu as besoin de le relancer, tu peux le trouver dans le menu [b]Configurer » Assistant audio[/b].
+
+[label=pc-serv][brown][b]Enregistrement du serveur[/b][/brown]
+
+(TODO)
+
+[label=pc-gui][brown][b]L'interface graphique[/b][/brown]
+
+(TODO)
+
+
+[label=android][big][brown][b]Mumble pour Android[/b][/brown][/big]
+
+(TODO)
+
+
+[label=web][big][brown][b]Client web Mumble avec un navigateur[/b][/brown][/big]
+
+(TODO)