Browse Source

purge from gitea unsupported markdown

nas 3 years ago
parent
commit
cbe37d1e00
1 changed files with 38 additions and 116 deletions
  1. 38
    116
      README_fr.md

+ 38
- 116
README_fr.md View File

3
 
3
 
4
 ### Dépendences
4
 ### Dépendences
5
 
5
 
6
-Le guide d\'installation est relativement bien fait¹ Cependant
7
-l\'emplacement des dépendences est un peu floue :
6
+Le guide d'installation est relativement bien fait¹ Cependant
7
+l'emplacement des dépendences est un peu floue :
8
 
8
 
9
--   cppCMS : l\'installation est déjà renseigner [ici](#cppcms)
9
+-   cppCMS : l'installation est déjà renseigner [ici](#cppcms)
10
 -   CPPDB : il faut chopper le code et le compiler
10
 -   CPPDB : il faut chopper le code et le compiler
11
 
11
 
12
                 
12
                 
23
 -   Gettext : est normalement disponible via le gestionnaire de packet
23
 -   Gettext : est normalement disponible via le gestionnaire de packet
24
     `apt install gettext`
24
     `apt install gettext`
25
 
25
 
26
-### Notes sur l\'installation
26
+### Notes sur l'installation
27
 
27
 
28
-La procédure l\'installation est plutôt bien décrite mais il y une typo
29
-a un endroit, je remet la liste des commandes dans l\'ordre :
28
+La procédure l'installation est plutôt bien décrite mais il y une typo
29
+a un endroit, je remet la liste des commandes dans l'ordre :
30
 
30
 
31
           
31
           
32
             wget https://github.com/cppweb/wikipp.git
32
             wget https://github.com/cppweb/wikipp.git
39
           
39
           
40
         
40
         
41
 
41
 
42
-De même, il manque la création de l\'utilisateur gérant da base de
43
-donnée, je reprend cette phase en l\'y ajoutant. Les commandes suivantes
42
+De même, il manque la création de l'utilisateur gérant da base de
43
+donnée, je reprend cette phase en l'y ajoutant. Les commandes suivantes
44
 sont pour les moteurs mariadb ou mysql; réferes-toi sur le site¹ pour
44
 sont pour les moteurs mariadb ou mysql; réferes-toi sur le site¹ pour
45
 une base sqlite3 ou postgres. Adaptes la premières commande pour
45
 une base sqlite3 ou postgres. Adaptes la premières commande pour
46
-t\'authentifier avec les droits de créations de base et sur le moteur de
47
-base de données ; dans mon cas `sudo mariadb`, mais il peut s\'agir de
46
+t'authentifier avec les droits de créations de base et sur le moteur de
47
+base de données ; dans mon cas `sudo mariadb`, mais il peut s'agir de
48
 `mysql -u root -p`.
48
 `mysql -u root -p`.
49
 
49
 
50
         
50
         
57
 
57
 
58
 ### Note sur la configuration
58
 ### Note sur la configuration
59
 
59
 
60
-Si tu doutes de l\'emplacement de l\'installation de wikipp, lance la
60
+Si tu doutes de l'emplacement de l'installation de wikipp, lance la
61
 commande suivante :
61
 commande suivante :
62
 
62
 
63
         
63
         
65
         
65
         
66
           
66
           
67
 
67
 
68
-Ignore le résultat dans `/usr`, il s\'agit de la base de donnée; dans la
68
+Ignore le résultat dans `/usr`, il s'agit de la base de donnée; dans la
69
 suite je comsidère que ce répertoire est ` /usr/local/share/wikipp`. Une
69
 suite je comsidère que ce répertoire est ` /usr/local/share/wikipp`. Une
70
 fois obtenu, nous pouvons finaliser da base de donénes en important la
70
 fois obtenu, nous pouvons finaliser da base de donénes en important la
71
 structure par défaut; souviens toi que je suis sur mariadb, adaptes à
71
 structure par défaut; souviens toi que je suis sur mariadb, adaptes à
96
         
96
         
97
           
97
           
98
 
98
 
99
-Il faut ensuite générer une clef privée pour l\'application, en fonction
99
+Il faut ensuite générer une clef privée pour l'application, en fonction
100
 de la librairie utilisée.
100
 de la librairie utilisée.
101
 
101
 
102
 #### Avec libgcrypt et openssl
102
 #### Avec libgcrypt et openssl
112
           
112
           
113
 
113
 
114
 En cherchant les clefs des valeurs renvoyés par cette commande,
114
 En cherchant les clefs des valeurs renvoyés par cette commande,
115
-j\'obtiens le bloc suivant dans le fichier de configuration, où «CLEF
115
+j'obtiens le bloc suivant dans le fichier de configuration, où «CLEF
116
 PRIVÉE » finit les chaines de caractère générées :
116
 PRIVÉE » finit les chaines de caractère générées :
117
 
117
 
118
         
118
         
156
 
156
 
157
 #### Configuration du socket
157
 #### Configuration du socket
158
 
158
 
159
-L\'executable de wikipp peut-être atteinds via différents types de
159
+L'executable de wikipp peut-être atteinds via différents types de
160
 socket; la configuration se fait dans la partie `"service"` de notre
160
 socket; la configuration se fait dans la partie `"service"` de notre
161
-fichier conf.js qu\'on passe en option. On peut utiliser un fichier
162
-socket ou l\'interface réseau interne `127.*.*.*`. Je trouve plus simple
163
-d\'utiliser cette dernière solution, qui est aussi la solution retenue
161
+fichier conf.js qu'on passe en option. On peut utiliser un fichier
162
+socket ou l'interface réseau interne `127.*.*.*`. Je trouve plus simple
163
+d'utiliser cette dernière solution, qui est aussi la solution retenue
164
 dans mes autres billets sur nginx.
164
 dans mes autres billets sur nginx.
165
 
165
 
166
         
166
         
172
         
172
         
173
           
173
           
174
 
174
 
175
-Depuis ma machine, l\'adresse du wiki sera sur `http://127.0.0.89:8065`.
175
+Depuis ma machine, l'adresse du wiki sera sur `http://127.0.0.89:8065`.
176
 
176
 
177
 #### Configuration du serveur web
177
 #### Configuration du serveur web
178
 
178
 
179
 Je me suis basé sur la doc officiel pour configurer le serveur nginx;
179
 Je me suis basé sur la doc officiel pour configurer le serveur nginx;
180
 pour les autres serveurs, regarde la doc officiel dans les sources.
180
 pour les autres serveurs, regarde la doc officiel dans les sources.
181
-Sinon c\'est exactement le même bloc, mais avec une redirection vers
182
-l\'interface interne⁴. J\'ai ajouter toute la configuration, avec le
181
+Sinon c'est exactement le même bloc, mais avec une redirection vers
182
+l'interface interne⁴. J'ai ajouter toute la configuration, avec le
183
 certificat SSL multi-domaine générer par certbot, la redirection de HTTP
183
 certificat SSL multi-domaine générer par certbot, la redirection de HTTP
184
 vers HTTPS. Des billets dédiés existent pour expliquer spécifiquement
184
 vers HTTPS. Des billets dédiés existent pour expliquer spécifiquement
185
-ces configurations; si tu n\'en veux pas, ajoute simplement au bloc
185
+ces configurations; si tu n'en veux pas, ajoute simplement au bloc
186
 `location ~ ^/wikipp.*$`. Il faut aussi que les fichiers
186
 `location ~ ^/wikipp.*$`. Il faut aussi que les fichiers
187
 `/var/log/www/wiki/access.log` et `/var/log/www/wiki/error.log`
187
 `/var/log/www/wiki/access.log` et `/var/log/www/wiki/error.log`
188
 existent. Dans le fichie
188
 existent. Dans le fichie
253
 Après avoir fait un lien symbolique dans `/etc/nginx/sites-enabled/`,
253
 Après avoir fait un lien symbolique dans `/etc/nginx/sites-enabled/`,
254
 redémarre nginx; avec systemd : `systemctl restart nginx`
254
 redémarre nginx; avec systemd : `systemctl restart nginx`
255
 
255
 
256
-#### Droits d\'utilisations
256
+#### Droits d'utilisations
257
 
257
 
258
-Il faut que l\'utilisateur qui execute l\'application ai les droits de
259
-lecture sur le repo, voir d\'écriture sur le fichier socket (s\'il est
258
+Il faut que l'utilisateur qui execute l'application ai les droits de
259
+lecture sur le repo, voir d'écriture sur le fichier socket (s'il est
260
 utilisé). Je te conseille de créer un utilisateur dédié, membre du group
260
 utilisé). Je te conseille de créer un utilisateur dédié, membre du group
261
 www-data :
261
 www-data :
262
 
262
 
274
 ### Tester
274
 ### Tester
275
 
275
 
276
 Pour tester, place toi dans le répertoire des sources de wikipp en tant
276
 Pour tester, place toi dans le répertoire des sources de wikipp en tant
277
-qu\'utilisateur wikipp, après les avoir compilées, et lance la commande
277
+qu'utilisateur wikipp, après les avoir compilées, et lance la commande
278
 suivante :
278
 suivante :
279
 
279
 
280
 `wikipp -c config.js `
280
 `wikipp -c config.js `
281
 
281
 
282
-Si tu as interdit de s\'identifier en tant que wikipp, utilise su:
282
+Si tu as interdit de s'identifier en tant que wikipp, utilise su:
283
 
283
 
284
 `su -c "wikipp -c config.js"`
284
 `su -c "wikipp -c config.js"`
285
 
285
 
293
 
293
 
294
 #### Configuration de la racine
294
 #### Configuration de la racine
295
 
295
 
296
-En omettant `wikipp` à la fin de l\'url, on se tape une sale erreur
297
-`403`. Ce qui n\'est pas top. Il suffit simplemet de modifier les
296
+En omettant `wikipp` à la fin de l'url, on se tape une sale erreur
297
+`403`. Ce qui n'est pas top. Il suffit simplemet de modifier les
298
 configuration nginx. Remplace la ligne :
298
 configuration nginx. Remplace la ligne :
299
 
299
 
300
 `location ~ ^/wikipp.*$`
300
 `location ~ ^/wikipp.*$`
303
 
303
 
304
 `location ~ ^/(?!(favicon\.ico|.*.css|robots\.txt|.*.js)) {`
304
 `location ~ ^/(?!(favicon\.ico|.*.css|robots\.txt|.*.js)) {`
305
 
305
 
306
-Relance nginx, et c\'est bon.
306
+Relance nginx, et c'est bon.
307
 
307
 
308
-Au lieu de lancer l\'application à partir du point wikipp, on la lance
308
+Au lieu de lancer l'application à partir du point wikipp, on la lance
309
 toujours, sauf exceptions; ces exceptions étant les feuille de style
309
 toujours, sauf exceptions; ces exceptions étant les feuille de style
310
 (.css), les scripts .js et le fichier pour les crawlers (robots.txt). Ça
310
 (.css), les scripts .js et le fichier pour les crawlers (robots.txt). Ça
311
 ajoute une couche de sécurité; ce qui ne dispense bien sûr pas des
311
 ajoute une couche de sécurité; ce qui ne dispense bien sûr pas des
314
 `mv /var/www/wiki/conf.js /var/www/wiki/conf.ini`
314
 `mv /var/www/wiki/conf.js /var/www/wiki/conf.ini`
315
 
315
 
316
 Ça pose un problème de sécunité; le fichier de conf est lisible via le
316
 Ça pose un problème de sécunité; le fichier de conf est lisible via le
317
-serveur, puisqu\'il est en .js. Je propose le le changer en conf.ini
317
+serveur, puisqu'il est en .js. Je propose le le changer en conf.ini
318
 
318
 
319
 #### Wikipp en tant que service
319
 #### Wikipp en tant que service
320
 
320
 
321
 On va pas lancer wikipp à la main à chaque démarrage de la machine. Le
321
 On va pas lancer wikipp à la main à chaque démarrage de la machine. Le
322
-plus simple est de créer un service; je part lu principe que t\'es sur
322
+plus simple est de créer un service; je part lu principe que t'es sur
323
 systemd, regarde de la doc de ton gestionnaire de service pour adapter.
323
 systemd, regarde de la doc de ton gestionnaire de service pour adapter.
324
 On va créer un fichier de service; remplace ton éditeur de texte :
324
 On va créer un fichier de service; remplace ton éditeur de texte :
325
 
325
 
342
         
342
         
343
           
343
           
344
 
344
 
345
-Ensuite on donne l\'autorisation et on actualise les daemon :
345
+Ensuite on donne l'autorisation et on actualise les daemon :
346
 
346
 
347
         
347
         
348
           chmod +x /etc/systemd/system/wiki.service
348
           chmod +x /etc/systemd/system/wiki.service
360
 
360
 
361
 #### Autres configurations
361
 #### Autres configurations
362
 
362
 
363
-Le guide officiel prévoit d\'autres configuration pour les dictionnaires
364
-de traductions et la connection de la libraire CPPDB. Je n\'en ai pas eu
363
+Le guide officiel prévoit d'autres configuration pour les dictionnaires
364
+de traductions et la connection de la libraire CPPDB. Je n'en ai pas eu
365
 besoin, sauf pour les langues; le français étant absent par défaut.
365
 besoin, sauf pour les langues; le français étant absent par défaut.
366
 
366
 
367
-### Messages d\'erreurs
367
+### Messages d'erreurs
368
 
368
 
369
 -   `wikipp, error: system: Socket operation on non-socket (main.cpp:14)`
369
 -   `wikipp, error: system: Socket operation on non-socket (main.cpp:14)`
370
     : Le socket est mal définit dans le fichier de configuration ou le
370
     : Le socket est mal définit dans le fichier de configuration ou le
371
     fichier de configuration est mal définit.
371
     fichier de configuration est mal définit.
372
 -   `Failed to load skin:view, no shared object/dll found` : il manque
372
 -   `Failed to load skin:view, no shared object/dll found` : il manque
373
     des fichiers de la compilation. Soit la compilation a échouée, soit
373
     des fichiers de la compilation. Soit la compilation a échouée, soit
374
-    l\'execution n\'a pas eu lieu dans le répertoire des sources.
374
+    l'execution n'a pas eu lieu dans le répertoire des sources.
375
 
375
 
376
 La commande `wikipp` permet de lancer le logiciel. Il faut cependant
376
 La commande `wikipp` permet de lancer le logiciel. Il faut cependant
377
 spécifier `-c` en option, pour le fichier de configuration fournit avec
377
 spécifier `-c` en option, pour le fichier de configuration fournit avec
390
 -   \[5\][digitalocean.com
390
 -   \[5\][digitalocean.com
391
     manage-systemd-services-and-units](https://www.digitalocean.com/community/tutorials/how-to-use-systemctl-to-manage-systemd-services-and-units)
391
     manage-systemd-services-and-units](https://www.digitalocean.com/community/tutorials/how-to-use-systemctl-to-manage-systemd-services-and-units)
392
 :::
392
 :::
393
-
394
-::: {#20210311-audio-stream .billet data-tag="audio stream html5"}
395
-Lecteur web de flux audio
396
--------------------------
397
-
398
-HTML5 introduit des lecteurs média par défaut, capabde ve lire des fluxs
399
-de média. Bien sûr, les navigateurs intègre cette norme de manière
400
-inégale. La balise audio prend les atrributs suivants :
401
-
402
--   `controls` : affiche les controles
403
--   `preload` : pré-charge autonmatiquement
404
--   `autoplay` : lance aucomatiquement de contenu
405
-
406
-La source du flux peu-être précisée en attribut (`src`) ou dans des
407
-sous-éléments de types `<source>`. Il est possible de donner plusieurs
408
-sources; en cas d'échec, le lecteur tentera la suivante. C'est
409
-indispensable pour assurer une compatibilité entre les navigateurs.
410
-Aucun format audio n'est compatible partout pour le moment. Dans
411
-l'exemple suivant, jqai une source ogg ec ure autre en mp3, ce qui
412
-devrait mancher sur Opéra, Firefox, et Chromium.
413
-
414
-`     `
415
-
416
-            <audio controls preload autoplay>
417
-                    <source src="https://server.de.stream/1.mp3" type="audio/mpeg">
418
-                    <source src="https://server.de.stream/1.ogg" type="audio/ogg">
419
-                </audio>
420
-        
421
-:::
422
-
423
-::: {#20210310-vlc-radio .billet data-tag="vlc nginx"}
424
-Faire une webradio avec VLC
425
----------------------------
426
-
427
-On le dira jamais assez : VLC est magique. Je m\'attarderais pas sur
428
-tout ce que ce petit soft est capable de faire; c\'est très long. Ce qui
429
-nous intéresse ici c\'est sa capacité à être compdètement utilisé dans
430
-la console, et à pouvoir créer un flux audio ou vidéo sur le réseau. Par
431
-exemple, si mon adresse de réseau local est 192.168.1.2, et que je veux
432
-diffuser le fichier radio.mp4 :
433
-
434
-`     `
435
-
436
-    vlc -vvv radio.mp4 --sout "#standard{access=http,mux=ogg,dst=192.168.1.2}"
437
-        
438
-
439
-Pour tester, il est possible d\'ouvrir un flux réseau depuis
440
-l\'interface graphique, et y écrire `http://192.168.1.2`
441
-
442
-Pour faire une webradio, je propose de diffuser le contenu sur une
443
-interface réseau local (loop), et de rediriger les demandes de
444
-connexions externe vers ce flux interne. Pour cela, suit le tuto pour
445
-ajouter un sous-réseau, et créer le fichier de configuration suivant
446
-(ici pour radio\@example.cccp). Lance la cammande précédante, mais
447
-remplace l\'adresse de diffusion par 127.0.0.1.1032:
448
-
449
-`     `
450
-
451
-   server {
452
-        listen 80;
453
-        listen [::]:80;
454
-        server_name radio.example.com;
455
-
456
-        location / {
457
-            proxy_pass http://127.0.0.1:1032/;
458
-        }
459
-    }
460
-        
461
-
462
-Il est tout a fait possuble de faire passer le stream par une connexion
463
-https via nginx.
464
-
465
-Sources :
466
----------
467
-
468
--   [wiki.videolan.org RTSP on demand
469
-    streaming](https://wiki.videolan.org/Documentation:Streaming_HowTo/Command_Line_Examples/#RTSP_on-demand_streaming)
470
-:::

Loading…
Cancel
Save