mumble: complete PC and write Android (v1)

mumble/preprocess.py

@@ -3,7 +3,8 @@
 import sys
 import re
 
-base_url = "https://gitea.planet-casio.com/Lephenixnoir/Tutoriels/mumble/"
+base_url = "https://gitea.planet-casio.com/Lephenixnoir/Tutoriels/raw/branch" \
+           "/master/mumble/"
 
 if len(sys.argv) > 1:
     print("warning: this script takes no arguments -- ignoring",

mumble/utilisation-mumble.txt

@@ -2,28 +2,28 @@
 
 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.
+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.
+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]
+1. [target=pc][b]Mumble pour PC[/b][/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]
+2. [target=android][b]Mumble pour Android[/b][/target]
 [color=white]`__`[/color]... (à venir)
 
-3. [target=web]Client web Mumble avec un navigateur[/target]
-
+3. [target=web][b]Client web Mumble avec un navigateur[/b][/target]
 
+[center]•[/center]
 [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.
+Dans cette partie, je couvre l'installation et la configuration de Mumble pour Windows et Linux. Désolé pour les utilisateurs de Mac... je n'ai pas de quoi tester. En théorie ça doit se passer comme sous Windows.
 
 [label=pc-win][brown][b]Installation sous Windows[/b][/brown]
 
@@ -53,12 +53,12 @@ Une fois le paquet installé, localise Mumble dans ta liste de logiciels ou lanc
 
 [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.
+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 il vaut en vérifier certains. 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 :
+La deuxième étape important 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 parles. 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.
@@ -71,22 +71,50 @@ Pour utiliser le mode automatique (1), sélectionne la deuxième option dans la
 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].
+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)
+Tu te trouves maintenant sur l'écran principal de Mumble, et la fenêtre de connexion au serveur s'ouvre automatiquement. (Si non, tu peux l'ouvrir en cliquant sur le bouton avec l'icône de globe ou dans le menu [b]Serveur » Se connecter[/b].) Cette fenêtre présente les serveurs Mumble publics sur l'Internet ; on va ajouter celui de Planète Casio manuellement.
+
+Clique sur "`Add New`", et dans la boîte de dialogue qui s'ouvre, entre "`mumble.planet-casio.com`", port `64738`. Choisis ton nom d'utilisateur (de préférence ton pseudo ou surnom sur Planète Casio, mais ce n'est pas obligé pour l'instant) et un label quelconque. Ensuite, clique sur "`Ok`". ;)
+
+[center][img]server-1.png[/img][/center]
+Ça aussi tu n'as besoin de le faire qu'une fois. Désormais, quand tu ouvriras Mumble, tu pourras directement sélectionner le serveur de Planète Casio et te connecter !
 
 [label=pc-gui][brown][b]L'interface graphique[/b][/brown]
 
-(TODO)
+[center][img]gui.png[/img][/center]
+Voici l'interface principale de Mumble lorsqu'on est connecté à un serveur. Sur la droite, on trouve la liste des salons et des participants ; actuellement il n'y en a qu'un. À gauche se trouve le chat, on peut écrire dedans avec la boîte de message en bas. Cette boîte est parfois cachée par défaut, il faut alors attraper son bord supérieur en bas de la fenêtre et le tirer vers le haut. ^^
 
+Tu peux également changer la disposition de la fenêtre dans [b]Configurer » Réglages » Interface utilisateur[/b]. Ce menu contient beaucoup d'autres paramètres dont la gestion des entrées/sorties audio et les options de transmission.
 
+Parmi les boutons importants, il y a notamment les deux boutons permettant de couper ton micro ou la sortie de son. Ce statut est visible par tout le monde, donc pratique pour indiquer que tu n'as pas de micro ou que tu es parti temporairement. Le bouton en forme d'engrenage ouvre les paramètres, comme d'habitude. ^^
+
+[center]•[/center]
 [label=android][big][brown][b]Mumble pour Android[/b][/brown][/big]
 
-(TODO)
+... à venir (je n'ai pas de téléphone approprié). x_x
 
+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])
 
+[center]•[/center]
 [label=web][big][brown][b]Client web Mumble avec un navigateur[/b][/brown][/big]
 
-(TODO)
+En plus du serveur Mumble, Planète Casio héberge aussi un client web que tu peux utiliser dans un navigateur au lieu d'installer un logiciel. Note que ce client est plutôt conseillé sur ordinateur, car les navigateurs mobiles n'arriveront pas forcément à l'utiliser.
+
+Pour utiliser le client web, rends-toi à l'adresse [url=https://mumble.planet-casio.com][b]`mumble.planet-casio.com`[/b][/url]. Le client te demandera les paramètres du serveur pour te connecter. Ils sont déjà pré-remplis, tu n'as qu'à indiquer ton nom d'utilisateur !
+
+[center][adimg]web-connect.png[/adimg][/center]
+Clique sur « Connect » et voilà, tu es connecté sur notre serveur Mumble ! :D
+
+[center][adimg]web-ui.png[/adimg][/center]
+Dans le client Mumble, comme dans le client pour bureau, tu peux écrire sur le chat à gauche ou parler en autorisant ton navigateur à utiliser ton micro (il t'en demandera certainement l'autorisation dès l'ouverture de la page).
+
+Par défaut la transmission de voix s'active automatiquement quand tu parles (mode 1 présenté dans [target=pc-conf]Configuration initiale[/target]). Tu peux aussi utiliser le mode manuel et transmettre ta voix quand tu appuies sur une certaine touche. Pour cela, consulte les préférences et change les deux premiers paramètres :
+
+[center][adimg]mumble-web-settings.png[/adimg][/center]
+Attention, contrairement au client de bureau habituel, il faut que la fenêtre active soit le navigateur pour que le mode manuel fonctionne.
+
+[center]•[/center]
+Voilà qui fait le tour des différents options disponibles pour l'utilisation de Mumble ! J'espère que ce tutoriel t'a servi. Si tu rencontres des difficultés, poste un commentaire pour qu'on regarde et ajuste le tutoriel ! ;)