en	Contact the author
fr	Contacter l'auteur

en	Contact me
fr	Me contacter

en	If you have any question, or if you want to talk about this plugin, you can join this XMPP room with any Jabber client: [plugin-livechat-support@room.im.yiny.org](xmpp:plugin-livechat-support@room.im.yiny.org?join).
fr	Si vous avez des questions ou souhaitez parler de ce plugin, vous pouvez rejoindre ce salon XMPP avec n'importe quel client Jabber : [plugin-livechat-support@room.im.yiny.org](xmpp:plugin-livechat-support@room.im.yiny.org?join).

en	If you want to support the project financially, you can contact me by mail at git.[at].john-livingston.fr, or check my [Liberapay profile](https://liberapay.com/JohnLivingston/).
fr	Si vous souhaitez supporter le projet financièrement, vous pouvez me contacter par mail à l'adresse git.[arobase].john-livingston.fr, ou passer par mon [profil Liberapay](https://liberapay.com/JohnLivingston/).

en	Contributor Covenant Code of Conduct
fr	Convention de Code de conduite Contributeur⋅rices

en	Code of Conduct
fr	Code de conduite

en	This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1, available at [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html). Translations are available at [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations). Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement by mail at git.[at].john-livingston.fr.
fr	Ce code de conduite est adapté du [Contributor Covenant](https://www.contributor-covenant.org), version 2.1, disponible à l'adresse [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html). Les traductions sont disponibles à l'adresse [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations). Les cas de comportements abusifs, harcelants ou tout autre comportement inacceptables peuvent être signalés aux dirigeant·e·s de la communauté responsables de l’application du code de conduite à git.[at].john-livingston.fr.

en	Develop
fr	Développer

en	Always talk about features you want to develop by creating/finding and commenting the issue tackling your problem before you start working on it, and inform the community that you begin coding by claiming the issue.
fr	Toujours annoncer les fonctionnalités sur lesquelles vous voulez travailler en créant un ticket ou en commentant un ticket existant, avant de commencer à travailler dessus.Et annoncez clairement à la communauté que vous commencez à travailler dessus. Ceci afin d'éviter que plusieurs personnes travaillent sur la même chose et entrent en conflit.

en	Pull Request must be done on the `main` branch.
fr	Les Pull Request sont à faire sur la branche `main`.

en	Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.
fr	Jusqu'à mars 2023, il fallait contribuer sur la branche `develop`. Cette procédure est désormais obsolète.

en	Prerequisite for building this plugin
fr	Pré-requis pour compiler le plugin

en	It is highly recommended to be familiar with following concepts:
fr	Il est hautement recommandé d'être familier avec les concepts suivants :

en	Git

en	NodeJS

en	NPM

en	Typescript

en	To build the plugin, you must have following packages:
fr	Pour construire le module, vous avez besoin d'avoir installé les paquets suivants :

en	`git`

en	`npm` (>=8.x)

en	`nodejs` (>=14.x)

en	`build-essential`

en	`coreutils`

en	`wget`

en	Please note that this plugin needs an AppImage for the Prosody XMPP server. This AppImage is provided by the [Prosody AppImage](https://github.com/JohnXLivingston/prosody-appimage) sideproject. The `build-prosody.sh` script download binaries attached to this remote repository, and checks that their sha256 hashsum are correct.
fr	Veuillez noter que ce plugin a besoin d'une AppImage du serveur XMPP Prosody. Cette AppImage est fournie par le project [Prosody AppImage](https://github.com/JohnXLivingston/prosody-appimage). Le script `build-prosody.sh` télécharge les binaires attachés à ce dépôt distant, et vérifie que les sommes de contrôles sha256 sont correctes.

en	Clone the repository, buid the plugin, and create your feature branch:
fr	Clonez le dépôt, construisez le plugin, et créez votre branche de fonctionnalité :

en	# Clone the repository. Dont forget the --recursive to clone submodules. git clone https://github.com/JohnXLivingston/peertube-plugin-livechat.git --recursive cd peertube-plugin-livechat # Install NPM dependencies and build the module for the first time: npm install # Build the plugin after a modification: npm run build # If you have a fork from the repository, add it as remote (example): git remote add me git@github.com:MY_GITHUB_ACCOUNT/peertube-plugin-livechat.git # Create a local branch for you developments, and checkout it (example): git checkout my_development # Note: if an issue is associated, use fix_1234 as your branch name (where 1234 is the issue's number) # To propose your modifications, push your branch to your repository (example): git push --set-upstream me my_development # Then go to your github repository with your web browser to propose the Pull Request (see additional instructions below)
fr	# Cloner le dépot. N'oubliez pas le --recursive, pour clôner les sous-modules. git clone https://github.com/JohnXLivingston/peertube-plugin-livechat.git --recursive cd peertube-plugin-livechat # Installer les dépendances NPM et compiler le plugin pour la première fois : npm install # Compiler le plugin après une modification : npm run build # Si vous avez un fork du dépot, ajoutez le en remote (exemple) : git remote add me git@github.com:MON_COMPTE_GITHUB/peertube-plugin-livechat.git # Créez une branche locale pour vos développements et placez vous dessus (exemple) : git checkout mon_developpement # NB: si un ticket y est associé, utilisé le nom fix_1234 (où 1234 est le numéro du ticket) # Pour proposer vos modifications, poussez votre branche sur votre dépot (exemple) : git push --set-upstream me mon_developpement # Rendez-vous ensuite sur votre dépot github avec votre navigateur web pour proposer la Pull Request (voir les instructions complémentaires ci-dessous)

en	Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request. Once you are ready for a code review before merge, submit a Pull Request. In any case, please link your PR to the issues it solves by using the GitHub syntax: "fixes #issue_number".
fr	Quand vous êtes prêt⋅e à montrer votre code pour avoir un retour, soumettez une Pull Request *draft*. Quand vous êtes prêt⋅e pour une relecture de code avant merge, soumettez une Pull Request. Dans tous les cas, merci de lier votre Pull Request au ticket concerné en utilisant la syntax de GitHub : «fixes #issue_number».

en	The front-end code is in the `client` folder, the back-end code in `server`. There are some shared code in `shared` folder.
fr	Le code du front-end est dans le dossier `client`. Le code backend dans `server`. Il y a du code partagé entre les deux dans `shared`.

en	For general instructions (developping plugins, building, installation, ...), please refer to the [Peertube documentation](https://docs.joinpeertube.org/contribute-plugins?id=write-a-plugintheme).
fr	Pour les instructions génériques concernant le développement de plugins (building, installation, ...), merci de vous référer à la [documentation Peertube](https://docs.joinpeertube.org/contribute-plugins?id=write-a-plugintheme).

en	You can build the plugin with extra debug features simply by using:
fr	Vous pouvez *builder* le plugin avec des infos de debug supplémentaires en utilisant :

en	NODE_ENV=dev npm run build

en	ESBuild vs Typescript
fr	ESBuild versus Typescript

en	This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin. ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)). That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file). Then, if everything is okay, we run ESBuild to generate the compiled javascript.
fr	Ce plugin utilise ESBuild pour compiler le code front-end, comme le plugin `peertube-plugin-quickstart` officiel. ESBuild peut gérer Typescript, mais ne vérifie pas les types (voir [la documentation ESBuild](https://esbuild.github.io/content-types/#typescript)). C'est pourquoi on compile d'abord Typescript avec l'option `-noEmit`, juste pour vérifier les types (`check:client:ts` dans le fichier package.json). Ensuite, si tout est ok, on lance ESBuild pour générer le javascript compilé.

en	Debug Mode

en	There is a debug mode for this plugin, that shorten some delay. For example, some log files will rotate every two minutes, instead of once per day. This permit to test more easily certain actions, for which it could normally take hours or days to wait.
fr	Il existe un mode de debug pour le plugin, qui va raccourcir le délais de certaines actions. Par exemple, il va faire tourner les journaux toutes les deux minutes, au lieu de tous les jours. Cela permet de tester plus facilement certaines actions, pour lesquelles il faudrait normalement attendre des heures ou des jours.

en	To enable this mode, you juste have to create the `/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file (replacing `/var/www/peertube/storage/` by the correct path on your installation).
fr	Pour activer ce mode, il suffit de créer un fichier `/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` (en adaptant `/var/www/peertube/storage/` à votre installation le cas échéant).

en	The simple existence of this file is sufficient to trigger the debug mode. To make sure it's taken into account, you can restart your Peertube instance.
fr	La simple existance de ce fichier suffit à déclencher le mode debug. Pour être sûr qu'il est pris en compte, vous pouvez redémarrer votre instance Peertube.

en	This file can contain some JSON to enable more advanced options. To have a list of existing parameters, check `server/lib/debug.ts`. Restart Peertube after each content modification.
fr	Ce fichier peut également contenir du JSON qui pourra activer d'autres options. Pour en avoir la liste, vous pouvez regarder le code de `server/lib/debug.ts`. Redémarrez Peertube après chaque modification de son contenu.

en	Don't enable this mode on a production server, neither on a public server. This could cause security issues.
fr	N'activer jamais ce mode sur un serveur de production, ni même sur un serveur public. Cela pourrait poser des problèmes de sécurité.

en	Restart Prosody
fr	Redémarrer Prosody

en	When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`. This call don't need any authentificaiton. It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.
fr	Pour redémarrer Prosody quand le mode debug est activé, vous pouvez appeler l'API `http://votre_instance.tld/plugins/livechat/router/api/restart_prosody`. Cet appel n'a pas besoin d'authentification. Il peut se faire depuis une ligne de commande, par exemple avec `curl http://votre_instance.tld/plugins/livechat/router/api/restart_prosody.

en	Prosody debugger
fr	debugger Prosody

en	It is possible to connect the Prosody AppImage to a remote debugger using [MobDebug](https://luarocks.org/modules/paulclinger/mobdebug).
fr	Il est possible de connecter l'AppImage Prosody à un debugger distant en utilisant [MobDebug](https://luarocks.org/modules/paulclinger/mobdebug).

en	To do so, you have to setup MobDebug in a folder that can be accessed by the `peertube` user. Then, add this in the `debub_mode` file:
fr	Pour cela, placer MobDebug dans un dossier accessible par le user `peertube`. Ensuite, ajouter cela dans le fichier `debug_mode` du plugin :

en	{ "debug_prosody": { "debugger_path": "/the_path_to_mobdebug/src", "host": "localhost", "port": "8172" } }
fr	{ "debug_prosody": { "debugger_path": "/le_chemin_vers_mobdebug/src", "host": "localhost", "port": "8172" } }

en	`host` and `port` are optional. `debugger_path` must point to the folder where the `MobDebug` `.lua` file is.
fr	`host` et `port` sont optionnels. `debugger_path` doit pointer vers le dossier où se trouve le fichier `.lua` de `MobDebug`.

en	Restart Peertube.
fr	Redémarrer Peertube.

en	Start your debugger server.
fr	Lancer votre serveur de debug.

en	For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`. This call does not need any authentication. It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`. You can even configure your debug server to launch this request automatically.
fr	Pour que Prosody se connecte au debugger, appelez l'API `http://votre_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`. Cet appel n'a pas besoin d'authentification. Il peut se faire depuis une ligne de commande, par exemple avec `curl http://votre_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`. Vous pouvez même configurer votre serveur de debuggage pour lancer cette commande automatiquement.

en	Prosody will then restart, connecting to the debugger.
fr	Prosody va alors redémarrer en se connectant au debugger.

en	Quick dev environment using Docker
fr	Environnement de développement rapide via Docker

en	There is a tutorial, in french, on the [Peertube forum](https://framacolibri.org/t/tutoriel-creer-un-environnement-de-developpement-de-plugin-peertube-rapidement-en-utilisant-docker-et-qui-permet-de-tester-la-federation/17631) that explains how to quickly build a dev env using Docker.
fr	Un tutoriel est disponible sur [le forum Peertube](https://framacolibri.org/t/tutoriel-creer-un-environnement-de-developpement-de-plugin-peertube-rapidement-en-utilisant-docker-et-qui-permet-de-tester-la-federation/17631) pour expliquer comment monter rapidement un environnement de développement en utilisant Docker.

en	A repo was made out of it, check out [pt-plugin-dev](https://codeberg.org/mose/pt-plugin-dev).
fr	Un dépot a été crée sur la base de ce tutoriel : [pt-plugin-dev](https://codeberg.org/mose/pt-plugin-dev).

en	Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library. There is a dirty hack in the plugin: just create a `/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes, then restart containers.
fr	Note : pour une raison obscure, Prosody n'arrive pas à résoudre les adresses DNS des conteneurs quand la librairie lua-unbound est utilisée. Pour contourner cela, il y a un «dirty hack» : il suffit de créer une fichier `/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` dans vos docker-volumes, puis de les redémarrer.

en	Quickly rebuild and install the plugin

en	When you do modification, you don't have to always rebuild the full project, and reinstall the plugin on your dev environment. You can build only the modified part (for example, if you only modified client files: `npm run build:client`). Check the `package.json` files for available build scripts.

en	When the plugin is already installed on your dev instance, and you haven't changed any dependency, you can quickly install your work by following these steps:

en	re-build necessary parts of the plugin (client, styles, ...),

en	overwrite the `data/plugins/node_modules/peertube-plugin-livechat/dist/` content of your dev instance by the content of the plugin's `dist` folder,

en	change recursively `plugins/node_modules/peertube-plugin-livechat/dist/` files owner to your `peertube` user,

en	restart your instance.
fr	Redémarrez vos services :

en	Performance tests
fr	Tests de performance

en	The [livechat-perf-test](https://github.com/JohnXLivingston/livechat-perf-test) repository contains some tools to make performance tests. It can be used to evaluate code improvements, or find bottlenecks.
fr	Le dépôt [livechat-perf-test](https://github.com/JohnXLivingston/livechat-perf-test) contient quelques outils pour effectuer des tests de performance. Ils peuvent être utilisés pour évaluer les améliorations du code source, ou trouver les goulots d'étranglement.

en	Document the plugin, or translate the documentation.
fr	Documenter le plugin, ou traduire la documentation.

en	Documentation

en	General information
fr	Généralités

en	Always inform the community before working (by creating a new issue, or commenting an existing one). This is to avoid that two persons are working on the same thing, and prevent conflicts.
fr	Toujours vous annoncer avant de commencer à travailler (en créant un ticket ou en commentant un ticket existant). Ceci afin d'éviter que plusieurs personnes travaillent sur la même chose et entrent en conflit.

en	Documentation work has to be merged in the `main` branch.
fr	Le travail de documentation se fait sur la branche `main`.

en	The documentation source code is in the `support/documentation/content` folder.
fr	Le code source de la documentation se trouve dans le dossier `support/documentation/content` du dépot de code.

en	The documentation is generated using [Hugo](https://gohugo.io/). You have to install it on your computer if you want to preview your work.
fr	La documentation est générée via l'outils [Hugo](https://gohugo.io/). Celui-ci doit être installé sur votre machine pour pouvoir prévisualiser la documentation.

en	The used theme is [hugo-theme-learn](https://learn.netlify.app/). You should read its documentation before starting editing the documentation.
fr	Le thème utilisé est [hugo-theme-learn](https://learn.netlify.app/). Il est recommandé d'en lire la documentation avant de commencer.

en	When a new plugin version is released, or when documentation is updated, plugin maintainers will merge the `main` branch to the `documentation` branch. This will trigger github and gitlab pipelines, and update published documentation.
fr	Quand une version du plugin est publiée, ou quand la documentation est mise à jour, les mainteneur⋅euses du plugin fusionnerons la branche `main` dans la branche `documentation`. Ce qui aura pour effet de déclencher les pipelines github et gitlab pour mettre à jour les versions publiées.

en	Translations
fr	Traductions

en	The principal language is english (`en` code).
fr	La langue principale est l'anglais (code `en`).

en	The `support/documentation/content/en` folder contains only english documentation files.
fr	Le dossier `support/documentation/content/en`ne contient que les fichiers de documentation en anglais.

en	Documentation is translated using Weblate (see the [translation documentation](/peertube-plugin-livechat/contributing/translate/)). To do so, we use the [po4a tool](https://po4a.org/), as we will se later in this page.
fr	La documentation est traduite en utilisant Weblate (voir [la documentation sur la traduction](/peertube-plugin-livechat/fr/contributing/translate/)). Pour cela, on utilise l'outils [po4a](https://po4a.org), comme nous le verrons plus loin dans cette page.

en	Add a new language
fr	Ajout d'une nouvelle langue

en	In the `support/documentation/config.toml` file, please copy and modify the `[Languages.fr]` section.
fr	Dans le fichier `support/documentation/config.toml`, inspirez vous de la section `[Languages.fr]` pour déclarer la nouvelle langue.

en	If the translations are not complete, it does not matter, english will be used for missing strings.
fr	Si les traductions ne sont pas complètes, ce n'est pas grave, la version anglaise sera utilisée pour les chaînes manquantes.

en	Preview
fr	Prévisualiser

en	To preview your modifications, just run:
fr	Pour prévisualiser vos modification, il suffit de lancer :

en	hugo serve -s support/documentation/

en	Then open your browser on the address [http://localhost:1313/peertube-plugin-livechat/](http://localhost:1313/peertube-plugin-livechat/). This page will automatically refresh on each modification.
fr	Puis d'ouvrir votre navigateur à l'adresse [http://localhost:1313/peertube-plugin-livechat/](http://localhost:1313/peertube-plugin-livechat/). Cette page se raffraichira automatiquement à chaque modification.

en	Update localization files and generate documentation translations
fr	Mettre à jour les fichiers de localisation et générer les traductions de la documentation

en	For now, you only have the english version. To update documentation strings, and generate translations, you have to run the `doc-translate.sh` script.
fr	Pour l'instant, vous n'avez que la version anglaise. Pour mettre à jour les chaînes et générer les traductions, vous devez lancer le script `doc-translate.sh`.

en	To do so, make sure you have `po4a` (version >= 0.69) installed on your computer.
fr	Pour cela, assurez vous d'avoir `po4a` (version >= 0.69) installé sur votre ordinateur.

en	Some linux distro (like Debian Bullseye for example) have too old version of `po4a`. Please make sure to install a compatible version. If you are using Debian Bullseye for example, you can download the Bookworm po4a.deb file from [https://packages.debian.org](https://packages.debian.org/bookworm/all/po4a/download), and install it manually.
fr	Certaines distributions linux (comme Debian Bullseye par exemple) ont une version trop ancienne de `po4a`. Veillez à installer une version compatible. Si vous utilisez Debian Bullseye par exemple, vous pouvez télécharger le fichier Bookworm po4a.deb depuis [https://packages.debian.org](https://packages.debian.org/bookworm/all/po4a/download), et l'installer manuellement.

en	To handle translations, just do:
fr	Pour gérer les traductions, il suffit de faire :

en	npm run doc:translate

en	You can then preview the result using `hugo serve -s support/documentation/`, and using the language selector.
fr	Vous pouvez ensuite prévisualiser le résultat en utilisant `hugo serve -s support/documentation/`, et en utilisant le sélecteur de langue.

en	Write documentation
fr	Écrire la documentation

en	Just edit the english files in `support/documentation/content/en`.
fr	Éditez seulement les fichiers anglais dans `support/documentation/content/en`.

en	Then, before commiting, always run `npm run doc:translate`, so that changes in english files can be propagated to the `support/documentation/po/livechat.en.pot` file.
fr	Ensuite, avant de commiter, lancez toujours `npm run doc:translate`, afin que les changements dans les fichiers anglais puissent être propagés dans le fichier `support/documentation/po/livechat.en.pot`.

en	You can use the `livechat_label` short code to use application strings. See here: [Documentation translation](/peertube-plugin-livechat/contributing/translate/#documentation-translation).
fr	Vous pouvez utiliser le code court `livechat_label` pour utiliser des chaînes de l'application. Voir ici : [Traduction de la documentation](/peertube-plugin-livechat/fr/contribuer/translate/#documentation-translation).

en	It is possible to prevent a file from beeing translating, using `livechatnotranslation: true` in the Yaml Font Matter section. See here: [Documentation translation](/peertube-plugin-livechat/contributing/translate/#documentation-translation).
fr	Il est possible d'empêcher un fichier d'être traduit, en utilisant `livechatnotranslation : true` dans la section Yaml Font Matter. Voir ici : [Traduction de la documentation](/peertube-plugin-livechat/fr/contribuer/translate/#documentation-translation).

en	Please use the `livechatnotranslation` option for technical documentation. We don't want technical documentation to be translated, to avoid issues because of a wrong translation.
fr	Veuillez utiliser l'option `livechatnotranslation` pour la documentation technique. Nous ne voulons pas traduire la documentation technique, afin d'éviter les problèmes liés à une mauvaise traduction.

en	To facilitate translators work, avoid making too long paragraphs.
fr	Pour faciliter le travail des traducteur⋅rices, évitez de faire des paragraphes trop longs.

en	For now, it is not possible to use Markdown tables: the translation tools will break them.
fr	Pour l'instant il n'est pas possible d'utiliser des tableaux Markdown : les outils de translation ne savent pas les gérer.

en	There may be links to documentation elsewhere on the web. Try not to change the urls of the documentation pages. Or at the very least, put links to the new location on the previous url.
fr	Il peut y avoir des liens vers la documentation ailleurs sur le web. Essayez de ne pas changer les urls des pages de documentation. Ou au moins, mettez des liens vers les nouvelles pages dans les anciennes urls.

en	What if I can't use hugo and/or po4a?
fr	Que faire si je ne peux pas utiliser hugo et/ou po4a ?

en	Just edit english markdown files, and specify that you can't build translations when you make your Pull Request.
fr	Il suffit d'éditer les fichiers markdown en anglais, et de spécifier que vous ne pouvez pas compiler les traductions lorsque vous faites votre Pull Request.

en	Publication

en	Publishing the documentation is automatic, as soon as the changes are merged into the `documentation` branch.
fr	La publication de la documentation est automatique, dès que les modifications sont fusionnées dans la branche `documentation`.

en	Give your feedback
fr	Donnez vos retours

en	You don't need to know how to code to start contributing to this plugin! Other contributions are very valuable too, among which: you can test the software and report bugs, you can give feedback, features that you are interested in, user interface, design, ...
fr	Vous n'avez pas besoin de coder pour commencer à contribuer à ce plugin ! Les autres formes de contributions sont également précieuses, parmis lesquelles : vous pouvez tester le plugin et remonter les bugs que vous rencontrez, partager vos retours d'expérience, proposer des fonctionnalités qui vous intéressent, remonter vos remarques sur l'interface, le design, etc.

en	Contributing
fr	Contribuer

en	Interested in contributing? Awesome!
fr	Intéressé⋅e pour contribuer ? Super !

en	Translate the plugin
fr	Traduire le plugin

en	Translate
fr	Traduction

en	You can contribute to this plugin translation. Translations are handled using the [Weblate](https://weblate.org/) software, using [Framasoft Weblate instance](https://weblate.framasoft.org/).
fr	Vous pouvez contribuer à la traduction de ce plugin Peertube. Les traductions sont gérées par le logiciel [Weblate](https://weblate.org/), via [l'instance Weblate de Framasoft](https://weblate.framasoft.org/).

en	Never modify directly files in the `languages` folder, this could lead to conflicts.
fr	Ne modifiez jamais directement les fichiers dans le dossier `languages` du plugin, vous risqueriez de créer des conflits.

en	How to
fr	Comment faire

en	Create an account: https://weblate.framasoft.org/accounts/register/
fr	Créez-vous un compte : https://weblate.framasoft.org/accounts/register/

en	Validate your email and follow the link sent
fr	Validez votre email en cliquant sur le lien reçu

en	Create your password and setup your account
fr	Choisissez votre mot de passe, et configurez votre compte

en	Go to the plugin project page: https://weblate.framasoft.org/projects/peertube-livechat/peertube-plugin-livechat/
fr	Allez sur le projet du plugin de tchat : https://weblate.framasoft.org/projects/peertube-livechat/peertube-plugin-livechat/

en	Choose the locale you want to translate
fr	Choisissez la langue que vous voulez traduire

en	Just translate missing sentences, or correct the ones that seems incorrect to you.
fr	Il ne vous reste plus qu'à ajouter les traductions manquantes, ou corriger celles qui vous semblent erronées.

en	There might be some «very technical» strings. If you are not 100% sure of the meaning, or of your translation, you better not translate it, so it will display in english.
fr	Il peut y avoir des chaînes «assez techniques». Si vous n'êtes pas sûr⋅e à 100% du sens, ou de la traduction, il vaut mieux ne pas la traduire du tout ; ainsi la version anglaise s'affichera.

en	ConverseJS translations
fr	Traductions de ConverseJS

en	This plugin relies on [ConverseJS](https://conversejs.org/) for the chat front-end. ConverseJS has its own translations, on its own [weblate instance](https://hosted.weblate.org/projects/conversejs/#languages). You can also translate directly in the code repository. For more information, check [ConverseJS translations documentation](https://conversejs.org/docs/html/translations.html).
fr	Ce plugin s'appuie sur [ConverseJS](https://conversejs.org/) pour l'affichage du tchat. ConverseJS a ses propres traductions, sur sa propre [instance Weblate](https://hosted.weblate.org/projects/conversejs/#languages). Vous pouvez également traduire directement dans le dépôt de code. Pour plus d'information, veuillez vous référer à la [documentation de traduction de ConverseJS](https://conversejs.org/docs/html/translations.html).

en	Adding a new locale
fr	Ajouter une nouvelle langue

en	If you think there is a missing locale, please check first if it is handled in Peertube. If so, you can [open an issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues) to ask for it.
fr	Si la langue qui vous intéresse n'est pas présente, assurez-vous d'abord qu'elle est bien supportée par Peertube. Si c'est le cas, vous pouvez [ouvrir un ticket](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues) pour en demander l'ajout.

en	Adding new strings / use translations in the code
fr	Ajout de nouveau segment / utilisation dans le code

en	If you are working on new features, and need new strings, you can create them directly in Weblate. The english version is mandatory. Start with it.
fr	Si vous travaillez sur une nouvelle fonctionnalité, et que vous avez besoin de nouveaux segments, créez les directement dans Weblate. La version anglaise est obligatoire, commencez par celle-ci.

en	Each string is linked to a key (for example `use_chat`). Choose an explicit key in english, lower case.
fr	Chaque segment est lié à une clé (par exemple `use_chat`). Choisissez une clé en anglais, suffisamment explicite, et en minuscule.

en	If you have to test new strings without waiting for a Weblate merge, you can modify `languages/*.yml` files, but avoid to commit these changes (to minimize conflict risks).
fr	Si vous avez besoin de tester vos localisations sans attendre la fusion venant de Weblate, vous pouvez modifier les fichiers `languages/*.yml`, mais évitez de les commit (pour minimiser le risque de conflits).

en	Use translations in front-end code
fr	Utiliser un segment dans le code front-end

en	Before using a string in front-end, you need to declare a new constant in `client/@types/global.d.ts`. The constant name must:
fr	Avant d'utiliser une chaîne en front-end, il faut déclarer une nouvelle constante dans `client/@types/global.d.ts`. La constante doit :

en	start with the prefix "LOC_"
fr	commencer par le préfixe "LOC_"

en	use the string key, upper cased
fr	utiliser la clé de la chaîne, en majuscule

en	you just have to declare its type, not its value
fr	vous ne devez déclarer que son type, pas sa valeur

en	For example, to use "use_chat", you have to declare:
fr	Par exemple, pour utiliser "use_chat", vous devez déclarer :

en	declare const LOC_USE_CHAT: string

en	The `build-client.js` script will read the `client/@types/global.d.ts`, search for such constants, and load their values from the languages files.
fr	Le script `build-client.js` va lire ce fichier `client/@types/global.d.ts`, chercher pour de telles constantes, et charger leurs valeurs depuis le fichier de langue.

en	Now, you can simply call `peertubeHelpers.translate(LOC_USE_CHAT)` in your code.
fr	Vous pouvez maintenant utiliser `peertubeHelpers.translate(LOC_USE_CHAT)` dans votre code.

en	Use translations in back-end code
fr	Utiliser un segment dans le code back-end

en	In theory, the only parts of the backend code where you need localization is the settings declaration and standardized data (ActivityPub, RSS, ...). Here we need to get english strings from the translation key.
fr	En théorie, les seules parties du code qui ont besoin de traductions sont les déclarations de paramètres et la génération de données standardisées (ActivityPub, RSS, ...). Ici on a besoin de récupérer les chaînes anglaises à partir des clés de traduction.

en	Note: you should never need another language translation from backend code. Localization must be done on front-end.
fr	Note : vous ne devriez jamais avoir besoin d'autres langues que l'anglais pour le code backend. Les traductions doivent se faire coté front-end.

en	There is a `lib/loc.ts` module providing a `loc()` function. Just pass it the key to have the english string: `loc('diagnostic')`'.
fr	Il y a un module `lib/loc.ts` qui fourni une function `loc()`. Passez juste la clé pour récupérer la phrase anglaise : `loc('diagnostic')`.

en	Documentation translation
fr	Traduction de la documentation

en	The documentation translation is done using the corresponding Weblate component.
fr	La traduction de la documentation est faite en utilisant le composant Weblate correspondant.

en	There is a specific "Hugo shortcodes" you can use to display an application string. Saying you want to display the name of the button "open_chat_new_window", you can use this in the documentation markdown file:
fr	Il y a un «shortcode Hugo» spécifique qui vous permet d'afficher une chaîne issue de l'application. Si vous voulez par exemple afficher le libellé du bouton «open_chat_new_window», vous pouvez utiliser le code suivant dans le fichier markdown de la documentation :

en	{{%/* livechat_label open_chat_new_window */%}}

en	You can also prevent a whole page from being translating by adding `livechatnotranslation: true` in the Yaml Font Matter section:
fr	Vous pouvez également empêcher qu'une page entière ne soit traduite en ajoutant `livechatnotranslation:true` dans la section Yaml Font Matter du fichier :

en	--- title: "Third party" description: "Displaying the livechat with 3rd party software." weight: 20 chapter: false livechatnotranslation: true ---

en	Never translate a string in the `livechat.en.pot` file, it would be ignored. Instead, edit directly the markdown files.
fr	Ne traduisez jamais une chaîne dans le fichier `livechat.en.pot`, ce serait ignoré. À la place, éditez directement le fichier markdown.

en	If a string contains a link, you can change it for the correct link in the translated language. For example, for a link to this documentation, you can add the language code in the url.
fr	Si une chaîne contient un lien, vous pouvez le changer pour le lien correct dans la langue cible. Par exemple, si c'est un lien vers la documentation, vous pouvez ajouter le code langue dans l'url.

en	Some strings are block of code. Don't translate code. But you can translate comments, or parameters if relevant.
fr	Certaines chaînes sont des blocs de code. Ne les traduisez pas. Toutefois vous pouver traduire les commentaires, ou les paramètres si c'est pertinent.

en	If you are not sure, just don't translate, and ask what to do.
fr	Si vous avez un doute, ne traduisez pas, et demandez plutôt quoi faire.

en	The tool I use to handle translations for the documentation can have strange behaviours. When I add sentences that looks like other existing sentences, it sometimes copies existing translations. So, when you have translations marked as "to check", please make sure it doesn't copy a string that has nothing to do with the english one before validating.
fr	L'outils utilisé pour gérer les traductions de la documentation peut avoir des comportements étranges. Quand j'ajoute une phrase qui ressemble à une phrase existante, il va parfois copier les traductions. Donc quand vous avez des traductions marquées comme «à vérifier», veuillez vous assurer qu'il n'a pas copié une traduction qui n'a rien à voir avec la version anglaise avant de valider.

en	If you are now sure about the context of a string, you can check the string location in the weblate's right pane, and open the corresponding documentation page. For example, for a string located in the file `support/documentation/content/en/documentation/user/streamers.md`, the corresponding url is `https://livingston.frama.io/peertube-plugin-livechat/documentation/user/streamers/`.
fr	Si vous n'êtes pas sûr du contexte d'une chaîne de texte, vous pouvez vérifier l'emplacement de la chaîne source dans le panneau droit de Weblate, et ouvrir la page de documentation correspondante. Par exemple, pour une chaîne localisée dans le fichier `support/documentation/content/en/documentation/user/streamers.md`, l'url correspondante est `https://livingston.frama.io/peertube-plugin-livechat/documentation/user/streamers/`.

en	Generic recommandations
fr	Recommandations génériques

en	Please be inclusive in your wordings, and please respect the [code of coduct](/peertube-plugin-livechat/contributing/codeofconduct/).
fr	Merci d'être inclusif⋅ve dans vos phrasés, et merci de respecter le [code de conduite](/peertube-plugin-livechat/contributing/codeofconduct/).

en	Plugin Credits
fr	Crédits pour le plugin

en	Credits
fr	Crédits

en	[package.json](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/package.json), [COPYRIGHT](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/COPYRIGHT.md) and [LICENSE](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/LICENSE) files contain the license information for this software and its dependencies.
fr	Les fichiers [package.json](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/package.json), [COPYRIGHT](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/COPYRIGHT.md) et [LICENSE](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/LICENSE) contiennent les informations sur la licence du présent logiciel (en anglais).

en	The plugin is maintained by [John Livingston](https://www.john-livingston.fr/).
fr	Le plugin est maintenu par [John Livingston](https://www.john-livingston.fr/).

en	Thanks to David Revoy for his work on Peertube's mascot, [Sepia](https://www.davidrevoy.com/index.php?tag/peertube). The character design is under CC-By licence, and the SVG files used to create some logo and avatars in this plugin are GPLv3.0. PNG files are under CC-By licences, and comes from the [online Sepia Avatar Generator](https://www.peppercarrot.com/extras/html/2023_peertube-generator/).
fr	Merci à David Revoy pour son travail sur la mascotte de Peertube, [Sepia](https://www.davidrevoy.com/index.php?tag/peertube). Le design est en licence CC-By, et les fichiers SVG utilisés pour créer certains logos et avatars en GPLv3.0.

en	Thanks to [Framasoft](https://framasoft.org) for making [Peertube](https://joinpeertube.org/) possible, for the financial support, and for hosting the project translations on their [Weblate instance](https://weblate.framasoft.org).
fr	Merci à [Framasoft](https://framasoft.org) pour avoir rendu [Peertube](https://joinpeertube.org/) possible, pour le support financier, et pour héberger les traductions du projet sur [leur instance Weblate](https://weblate.framasoft.org).

en	Thanks to [ritimo](https://www.ritimo.org/) for the financial support.
fr	Merci à [ritimo](https://www.ritimo.org/) pour le support financier.

en	Thanks to [Code Lutin](https://www.codelutin.com/) and [Rétribution Copie Publique](https://copiepublique.fr/) for the financial support.
fr	Merci à [Code Lutin](https://www.codelutin.com/) et à la [Rétribution Copie Publique](https://copiepublique.fr) pour le support financier.

en	Thanks to [NlNet](https://nlnet.nl/) and the [NGI0 Entrust fund](https://nlnet.nl/entrust/) for the financial support.
fr	Merci à [NlNet](https://nlnet.nl/) et au [fond NGI0 Entrust](https://nlnet.nl/entrust/) pour le support financier.

en	Thanks to [Octopuce](https://www.octopuce.fr/) for the financial support.
fr	Merci à [Octopuce](https://www.octopuce.fr/) pour le support financier.

en	And thanks to all individual contributors who have made a donation via my [liberapay page](https://liberapay.com/JohnLivingston/).
fr	Et merci à toustes les contributeur⋅rices individuel⋅les qui ont fait un don via ma [page liberapay](https://liberapay.com/JohnLivingston/).

en	Some advanced features
fr	Quelques fonctionnalités avancées

en	Advanced usage
fr	Usage avancé

en	Using Matterbridge to bridge with other chats
fr	Utiliser Matterbridge pour faire un pont vers d'autres tchats

en	Using Matterbridge
fr	Utiliser Matterbridge

en	Here is a tutorial to use Matterbridge with the plugin: <https://gitlab.com/refrac/obs-matterbridge-overlay/-/blob/master/documentation/peertube.md>
fr	Voici un tutoriel sur comment utiliser Matterbridge avec ce plugin : <https://gitlab.com/refrac/obs-matterbridge-overlay/-/blob/master/documentation/peertube.md>

en	Allow connections using XMPP clients
fr	Autoriser la connexion en utilisant des clients XMPP

en	XMPP clients
fr	Clients XMPP

en	This chat module is based on the XMPP protocol, also known as Jabber. It is therefore possible to connect to the chats using [XMPP client software](https://en.wikipedia.org/wiki/XMPP#Clients). This can for example be useful to facilitate moderation operations.
fr	Ce module de tchat repose sur le protocole XMPP, aussi connu sous le nom de Jabber. Il est donc possible de se connecter aux tchats en utilisant des [logiciels clients XMPP](https://fr.wikipedia.org/wiki/Clients_XMPP). Cela peut par exemple être utile pour faciliter les opérations de modération.

en	For the user documentation associated with these features, please refer to the [user documentation page](/peertube-plugin-livechat/documentation/user/xmpp_clients/).
fr	Pour la documentation utilisateur⋅rice associé à ces fonctionnalités, veuillez vous référer à la page [de documentation utilisateur⋅rice](/peertube-plugin-livechat/fr/documentation/user/xmpp_clients/).

en	Enabling these features requires configuration changes on the server, and on the DNS records. It is not possible to configure this only from the Peertube interface, and it requires some basic system some basic system admin skills.
fr	L'activation de ces fonctionnalités demande des changements de configuration sur le serveur, et sur les enregistrements DNS. Il n'est pas possible de les activer uniquement depuis l'interface de Peertube, et cela demande d'avoir quelques compétences basiques d'admin système.

en	Login to your Peertube account
fr	Connexion à votre compte Peertube

en	This feature is not yet available, and will come in a future version of the plugin.
fr	Cette fonctionnalité n'est pas encore disponible, et viendra dans une prochaine version du plugin.

en	Connection using an external XMPP account
fr	Connexion en utilisant un compte XMPP externe

en	To enable this feature, you will need to set up your server and DNS records, so that XMPP clients can find and access the [Prosody server](https://prosody.im) that this plugin uses internally.
fr	Pour activer cette fonctionnalité, il va falloir paraméter votre serveur et vos enregistrements DNS, de sorte que les clients XMPP puissent trouver et accéder au serveur [Prosody](https://prosody.im) que ce plugin utilise en interne.

en	Plugin settings
fr	Paramètres du plugin

en	Start by going to the livechat plugin settings of your instance, then enable the setting "Enable connection to room using external XMPP accounts". By checking this settings, new settings appear below.
fr	Commencez par aller dans les paramètres du plugin livechat de votre instance, puis activez le paramètre «Autoriser les connexions aux salons via des comptes XMPP externes». En cochant celui-ci, de nouveaux champs apparaissent en dessous.

en	First of all, the "Prosody server to server port" field. This one defaults to 5269, which is the standard port for this service. You can however change to another port, if this is already in use on your server.
fr	Tout d'abord, le champs «Port Prosody serveur vers serveur». Celui-ci prend par défaut la valeur 5269, qui est le port standard pour ce service. Vous pouvez toutefois changer pour un autre port, si celui-ci est déjà utilisé sur votre serveur.

en	Next, the field "Server to server network interfaces" field allows you to specify which network interfaces the server should listen on. The default value "*, ::" indicates to listen on all IP addresses. You can change these values, if you wish to listen on only certain IP addresses. The syntax is explained next to the setting.
fr	Ensuite, le champs «Interfaces réseau pour les connexions serveur vers serveur» vous permet d'indiquer sur quelles interfaces réseau le serveur doit écouter. La valeur par défaut «*, ::» indique d'écouter sur toutes les addresses IP. Vous pouvez changer ces valeurs, si vous souhaiter n'écouter que sur certaines IP. La syntaxe est expliquée à coté du champs.

en	For the "Certificate folder" setting, you can leave it empty. In this case, the plugin will automatically generate self-signed certificates. Some XMPP servers may refuse to connect, depending on their configuration. In this case, you can indicate here a path on the server, in which you must place certificates to be used by the module. It is up to you to generate and renew them. See bellow for more information.
fr	Pour le champs «Dossiers des certificats», vous pouvez le laisser vide. Dans ce cas là, le plugin va générer automatiquement des certificats auto-signés. Il se pourrait que certains serveurs XMPP refusent de se connecter, cela dépendant de leur paramétrage. Dans ce cas, vous pouvez indiquer ici un chemin sur le serveur, dans lequel vous placerez des certificats à utiliser par le module. Charge à vous de les générer et de les renouveller. Voir plus loin pour une explication plus détaillée.

en	Firewall
fr	Pare-feu

en	You must open the configured port (5269 by default) on your firewall.
fr	Vous devez ouvrir le port configuré (5269 par défaut) sur votre pare-feu.

en	If you are using Docker for your Peertube, you need to modify the `docker-compose.yml` file to open port 5269 of the `peertube` container, so that the outer world can connect to it.
fr	Si vous utilisez Docker pour votre Peertube, il faut modifier le fichier `docker-compose.yml` pour ouvrir le port 5269 du conteneur `peertube` au monde extérieur.

en	DNS

en	You need to add [DNS records](https://prosody.im/doc/dns) allowing remote servers to find "room.your_instance.tld" and "external.your_instance.tld" components.
fr	Vous devez ajouter un [enregistrement DNS](https://prosody.im/doc/dns) permettant aux serveurs distant de trouver le composant «room.votre_instance.tld».

en	The easiest way to do this is to add SRV records for the "room" and "external" [subdomain](https://prosody.im/doc/dns#subdomains):
fr	Le plus simple pour cela est d'ajouter un enregistrement SRV pour le [sous-domaine](https://prosody.im/doc/dns#subdomains) «room» :

en	record name: _xmpp-server._tcp.room.your_instance.tld. (replace «your_instance.tld» by your instance uri)
fr	nom de l'enregistrement : _xmpp-server._tcp.room.votre_instance.tld. (remplacez «votre_instance.tld» par la valeur adéquate)

en	TTL: 3600

en	class: IN

en	SRV: 0

en	priority: 0

en	weight: 5

en	port: 5269 (adapt if your changed the default port)
fr	port: 5269 (adaptez si vous avez changé le port)

en	target: your_instance.tld. (replace by your instance uri)
fr	target: votre_instance.tld. (remplacez par la valeur adéquate)

en	record name: _xmpp-server._tcp.external.your_instance.tld. (replace «your_instance.tld» by your instance uri)
fr	nom de l'enregistrement : _xmpp-server._tcp.room.votre_instance.tld. (remplacez «votre_instance.tld» par la valeur adéquate)

en	Be careful to keep the dot after "your_instance.tld".
fr	Attention à bien conserver le point après «votre_instance.tld».

en	Using the `dig` command to check your records, you should get a result similar to this:
fr	En utilisant la commande `dig` pour vérifier votre enregistrement, vous devriez obtenir un résultat similaire à celui-ci :

en	$ dig +short _xmpp-server._tcp.room.videos.john-livingston.fr. SRV 0 5 5269 videos.john-livingston.fr. $ dig +short _xmpp-server._tcp.external.videos.john-livingston.fr. SRV 0 5 5269 videos.john-livingston.fr.
fr	$ dig +short _xmpp-server._tcp.room.videos.john-livingston.fr. SRV 0 5 5269 videos.john-livingston.fr.

en	If you are **not using the standard `5269` port**, you must also add a SRV record for `_xmpp-server._tcp.your_instance.tld.` (same as above, just without the `room.` prefix). Of course, you can also add this record if you use the standard port. It will also work.
fr	Si vous **n'utilisez pas le port standard `5269`**, vous devez ajouter un autre enregistrement SRV pour `_xmpp-server._tcp.votre_instance.tld.` (pareil que précédemment, mais en enlevant le préfixe `room.`). Bien sûr, vous pouvez l'ajouter même si vous utilisez le port standard. Cela fonctionnera également.

en	Using trusted certificates
fr	Utilisation de certificats de confiance

en	The self-signed certificates that this plugin uses by default can be rejected by some XMPP servers, for security reasons.
fr	Les certificats auto-signés que le plugin utilise par défaut peuvent ne pas convenir à tous les serveurs distants. En effet, ceux-ci peuvent les refuser pour raison de sécurité.

en	It is possible to use certificates validated by a certification authority. However, this requires advanced system administration knowledge. Indeed, due to the multitude of possible use cases, it is impossible to document all situations here. This documentation will therefore only explain the goal to be reached, and give an example which will only be suitable for a "basic" situation (manual installation of Peertube, using letsencrypt). If you are in another situation (Docker installation, certificates signed by another authority, etc...), you will have to adapt this approach by yourself.
fr	Il est possible d'utiliser des certificats validés par une autorité de certification. Cependant cela demande des connaissances d'administration système avancées. En effet, devant la multitude de cas possibles, il est impossible de documenter ici toutes les situations. La présente documentation va donc se contenter de vous expliquer le but à atteindre, et donner un example qui ne conviendra qu'à une situation «basique» (installation manuelle de Peertube, avec utilisation de letsencrypt). Si vous êtes dans une autre situation (installation Docker, certificats signés par une autre autorité, etc...), il vous faudra adapter la démarche.

en	Basic principle
fr	Principe de base

en	It is up to you to generate valid certificates for domains `your_instance.tld` and `room.your_instance.tld`. You can use any [method supported by Prosody](https://prosody.im/doc/certificates).
fr	À vous de générer des certificats valides pour les domaines `votre_instance.tld` et `room.votre_instance.tld`. Vous pouvez utiliser n'importe quelle [méthode supportées par Prosody](https://prosody.im/doc/certificates).

en	You must then place these certificates in a folder that will be accessible to the `peertube` user, and specify this folder in the plugin setting "Certificate folder".
fr	Vous devez ensuite placer ces certificats dans un dossier qui sera accessible au user `peertube`, puis indiquer ce dossier dans le paramètre du plugin «Dossiers des certificats».

en	If you want to use the ProsodyCtl utility to import certificates, this utility is available (once Peertube is started) using the following command (adapting the path to your Peertube data folder, and replacing "xxx" with the arguments you wish to pass to prosodyctl): `sudo -u peertube /var/www/peertube/storage/plugins/data/peertube-plugin-livechat/prosodyAppImage/squashfs-root/AppRun prosodyctl xxx`
fr	Si vous voulez utiliser l'utilitaire ProsodyCtl (pour importer des certificats letsencrypts, générer des certificats, etc...), cet utilitaire est disponible (une fois Peertube démarré) en utilisant la commande qui suit (en adaptant le chemin vers votre dossier data Peertube, et en remplaçant «xxx» par les arguments que vous souhaitez passer à prosodyctl) : `sudo -u peertube /var/www/peertube/storage/plugins/data/peertube-plugin-livechat/prosodyAppImage/squashfs-root/AppRun prosodyctl xxx`

en	The plugin will check once a day to see if any files have been modified in this folder, and reload Prosody if necessary.
fr	Le plugin va vérifier une fois par jour si des fichiers ont été modifiés dans ce dossier, et recharger Prosody le cas échéant.

en	Method for the simple case
fr	Méthode dans le cas simple

en	We assume here that your Peertube installation is "classic" (no use of Docker), and that the certificates are generated by letsencrypt, using the certbot tool.
fr	Nous supposons ici que votre installation de Peertube est «classique» (pas d'utilisation de Docker), et que les certificats sont générés par letsencrypt, en utilisant l'outils certbot.

en	First of all, we'll have to create a certificate for the subdomain `room.your_instance.tld` : this is the uri of the MUC (XMPP chat rooms) component. Even if the connections are made on `your_instance.tld`, we will need a valid certificate for this subdomain.
fr	Tout d'abord, on va devoir créer un certificat pour le sous-domain `room.votre_instance.tld` : c'est l'uri du composant MUC (salons de discussion XMPP). Même si les connections se font sur `votre_instance.tld`, il va nous falloir un certificat valide pour ce sous-domaine.

en	So start by setting up a DNS entry for `room.your_instance.tld`, which points to your server. You can use a CNAME entry (or an A entry and a AAAA entry).
fr	Commencez donc par paramétrer une entrée DNS pour `room.votre_instance.tld`, qui pointe sur votre serveur. Vous pouvez tout à fait faire une entrée CNAME (ou une entrée A et une entrée AAAA).

en	Next, we'll use nginx (already installed for your Peertube) to generate the certbot certificate. We will create a new site. In the file `/etc/nginx/site-available/room.peertube`, add:
fr	Ensuite, nous allons utiliser nginx (déjà installé pour votre Peertube) pour générer le certificat certbot. On va créer un nouveau site. Dans le fichier `/etc/nginx/site-available/room.peertube`, ajoutez :

en	server { listen 80; listen [::]:80; server_name room.your_instance.tld; location /.well-known/acme-challenge/ { default_type "text/plain"; root /var/www/certbot; } location / { return 301 https://your_instance.tld; } }
fr	server { listen 80; listen [::]:80; server_name room.votre_instance.tld; location /.well-known/acme-challenge/ { default_type "text/plain"; root /var/www/certbot; } location / { return 301 https://votre_instance.tld; } }

en	Then enable the site:
fr	Ensuite on active ce site :

en	ln -s /etc/nginx/sites-available/room.peertube /etc/nginx/sites-enabled/ systemc reload nginx

en	Then we prepare the folder in which we will later import the certificates. We assume here that you already have the plugin active. We will create the following folder (if it doesn't already exist), with the user `peertube` to make sure there are no permissions issues:
fr	On prépare ensuite le dossier dans lequel on va plus tard importer les certificats. On suppose ici que vous avez déjà le plugin actif. On va créer le dossier suivant (s'il n'existe pas déjà), avec le user `peertube` pour être sûr qu'il n'y a pas de problème de droits :

en	sudo -u peertube mkdir /var/www/peertube/storage/plugins/data/peertube-plugin-livechat/prosody/certs

en	Now you have to configure this folder in the plugin settings, for the parameter "Certificate folders". It's important to do this now, otherwise the certificate import script will put the certificates in the wrong folder.
fr	Il faut maintenant configurer ce dossier dans les paramètres du plugin, pour «Dossiers des certificats». C'est important de le faire avant la suite, sinon le script d'import des certificats va les placer au mauvais endroit.

en	We will configure certbot to import the generated certificates into the Prosody folder. We can use the ProsodyCtl utility packaged in the plugin.
fr	On va configurer certbot pour qu'il importe les certificats générés dans le dossier de Prosody. On va pouvoir utiliser l'utilistaire ProsodyCtl packagé dans le plugin.

en	Note: for it to be available, the plugin must have been started at least once.
fr	Note : pour qu'il soit disponible, il faut que le plugin ai démarré au moins une fois.

en	We will create a file `/etc/letsencrypt/renewal-hooks/deploy/prosody.sh` containing:
fr	On va créer un fichier `/etc/letsencrypt/renewal-hooks/deploy/prosody.sh` contenant :

en	#!/bin/sh /var/www/peertube/storage/plugins/data/peertube-plugin-livechat/prosodyAppImage/squashfs-root/AppRun prosodyctl \ --root \ --config /var/www/peertube/storage/plugins/data/peertube-plugin-livechat/prosody/prosody.cfg.lua \ cert import \ room.your_instance.tld your_instance.tld /etc/letsencrypt/live
fr	#!/bin/sh /var/www/peertube/storage/plugins/data/peertube-plugin-livechat/prosodyAppImage/squashfs-root/AppRun prosodyctl \ --root \ --config /var/www/peertube/storage/plugins/data/peertube-plugin-livechat/prosody/prosody.cfg.lua \ cert import \ room.votre_instance.tld votre_instance.tld /etc/letsencrypt/live

en	Then we ask to generate the certificate:
fr	Puis on demande à générer le certificat :

en	certbot -d room.videos.john-livingston.fr

en	If certbot offers you several methods to generate the certificate, choose "nginx".
fr	Si certbot vous propose plusieurs méthodes pour générer le certificat, choisissez «nginx».

en	Normally you should now find the certificates in the configured folder.
fr	Normalement vous devriez maintenant trouver les certificats dans le dossier configuré.

en	Note: the first time you do this, you will have to reload Prosody. The easiest way to do this is to restart Peertube.
fr	Note : la première fois que vous faites tout ça, il va falloir recharger Prosody. Le plus simple pour cela est de redémarrer Peertube.

en	Method for the Docker case
fr	Méthode en cas d'utilisation de Docker

en	This method works with the officially supported [Docker guide](https://docs.joinpeertube.org/install/docker) from PeerTube.
fr	Cette méthode marche avec le [guide Docker](https://docs.joinpeertube.org/install/docker) officiel de Peertube.

en	First, ensure you create a DNS entry for `room.your_instance.tld`, which points to your server. You can use a CNAME entry (or an A entry and a AAAA entry). This is necessary for Let's Encrypt to validate the domain for certificate generation.
fr	Tout d'abord, assurez-vous de créer une entrée DNS pour `room.your_instance.tld`, qui pointe vers votre serveur. Vous pouvez utiliser une entrée CNAME (ou une entrée A et une entrée AAAA). Ceci est nécessaire pour que Let's Encrypt valide le domaine pour la génération du certificat.

en	Enter the directory where your `docker-compose.yml` file exists.
fr	Entrez le répertoire où se trouve votre fichier `docker-compose.yml`.

en	Open a shell in the certbot container:
fr	Ouvrez un shell dans le conteneur certbot :

en	docker exec -it certbot /bin/sh

en	Run certbot:
fr	Lancez certbot :

en	certbot

en	You will be presented with a series of prompts. Enter `2` for the authentication type:
fr	Une série d'invites vous sera présentée. Entrez `2` pour le type d'authentification :

en	How would you like to authenticate with the ACME CA? Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

en	Enter the domain name `room.your_instance.tld`:

en	Please enter the domain name(s) you would like on your certificate (comma and/or space separated) (Enter 'c' to cancel): room.your_instance.tld

en	Enter the directory where the PeerTube webserver serves requests for Let's Encrypt, `/var/www/certbot`:

en	Input the webroot for <room.your_instance.tld>: (Enter 'c' to cancel): /var/www/certbot

en	You should see output like the following:
fr	Vous devriez obtenir un résultat semblable à celui qui suit :

en	Successfully received certificate. Certificate is saved at: /etc/letsencrypt/live/room.your_instance.tld/fullchain.pem Key is saved at: /etc/letsencrypt/live/room.your_instance.tld/privkey.pem

en	Run the below command inside the certbot container to give read access to the new certs and private keys to the peertube group. *Note*: This will also make the files readable to the group with id 999 on the host system. Check the groups on your system to assess this as a risk before running this command.
fr	Exécutez la commande suivante à l'intérieur du conteneur certbot pour donner un accès en lecture aux nouveaux certificats et clés privées au groupe peertube. *Note* : Cette commande rendra également les fichiers accessibles en lecture au groupe dont l'identifiant est 999 sur le système hôte. Vérifiez les groupes sur votre système pour évaluer le risque avant d'exécuter cette commande.

en	chown -R root:999 /etc/letsencrypt/live; \ chmod 750 /etc/letsencrypt/live; \ chown -R root:999 /etc/letsencrypt/archive; \ chmod 750 /etc/letsencrypt/archive; \ find /etc/letsencrypt/ -name 'privkey*' -exec chmod 0640 {} \;

en	Exit the certbot container:
fr	Sortez du conteneur certbot :

en	exit

en	Modify your `docker-compose.yml` file, changing the `entrypoint` line under the `certbot` service to the following. This is the same as the above, but to be automatically executed after every certificate renewal.
fr	Modifiez votre fichier `docker-compose.yml`, en changeant la ligne `entrypoint` sous le service `certbot` par ce qui suit. C'est la même chose que ci-dessus, mais elle doit être exécutée automatiquement après chaque renouvellement de certificat.

en	entrypoint: /bin/sh -c "trap exit TERM; while :; do certbot renew --webroot -w /var/www/certbot; chown -R root:999 /etc/letsencrypt/live; chmod 750 /etc/letsencrypt/live; chown -R root:999 /etc/letsencrypt/archive; chmod 750 /etc/letsencrypt/archive; find /etc/letsencrypt/ -name 'privkey*' -exec chmod 0640 {} +; sleep 12h & wait $${!}; done;"

en	Continuing to modify `docker-compose.yml`, add the certbot certificate volume into the peertube container. It should look something like this:
fr	En continuant à modifier `docker-compose.yml`, ajoutez le volume certbot dans le conteneur peertube. Il devrait ressembler à ceci :

en	volumes: - ./docker-volume/certbot/conf:/etc/letsencrypt

en	Restart your services:
fr	Redémarrez vos services :

en	docker-compose down; docker-comopse up -d

en	In the livechat plugin settings from your PeerTube administration settings, set the certificate directory to the following:
fr	Dans les paramètres du plugin livechat à partir des paramètres d'administration de PeerTube, définissez le répertoire des certificats comme suit :

en	/etc/letsencrypt/live

en	Save the plugin settings and verify Prosody can see the certificates:
fr	Sauvegardez les paramètres du plugin et vérifiez que Prosody peut voir les certificats :

en	docker-compose exec -u peertube \ peertube \ /data/plugins/data/peertube-plugin-livechat/prosodyAppImage/squashfs-root/AppRun \ prosodyctl \ --config /data/plugins/data/peertube-plugin-livechat/prosody/prosody.cfg.lua \ check certs

en	Troubleshooting
fr	En cas de problème

en	If you can't make it work, you can use the diagnostic tool (there is a button on top of the plugin settings page), and take a close look on the «Prosody check» section.
fr	Si cela ne fonctionne pas, vous pouvez utiliser l'outils de diagnostic (un bouton se trouve en haut de la page des paramètres du plugin), et notamment regarder ce que dit la section «Prosody check».

en	Plugin Peertube Livechat settings - External Authentication
fr	Paramètres du Plugin Peertube Livechat

en	External Authentication

en	Users that are not connected to your Peertube instance are joining the chat using "anonymous accounts" (they can freely choose a nickname, and will be assigned a random avatar).

en	You can enable some external authentication methods to allow user to create chat accounts. In such case their nickname and avatar will be automatically initialized with the remote account information.

en	Such "external account users" will be easier to moderate than anonymous accounts.

en	This also allows user to join the chat without creating Peertube account (in case your instance has closed registration for example, or without waiting for account approval).

en	![External login button](/peertube-plugin-livechat/images/external_login_button.png?classes=shadow,border&height=200px)
fr	![Bouton connexion avec compte externe](/peertube-plugin-livechat/images/external_login_button.png?classes=shadow,border&height=200px)

en	![External login dialog - OpenID Connect](/peertube-plugin-livechat/images/external_login_dialog_oidc.png?classes=shadow,border&height=200px)
fr	![Fenêtre de dialogue connexion avec un compte externe](/peertube-plugin-livechat/images/external_login_dialog.png?classes=shadow,border&height=200px)

en	This page will describe available authentication methods.

en	For the user documentation, see [user documentation](/peertube-plugin-livechat/documentation/user/viewers/)
fr	Pour la documentation utilisateur⋅rice associé à ces fonctionnalités, veuillez vous référer à la page [de documentation utilisateur⋅rice](/peertube-plugin-livechat/fr/documentation/user/xmpp_clients/).

en	OpenID Connect

en	This feature is still experimental. This feature is available with the plugin version >= 9.0.0.
fr	Cette fonctionnalité arrive avec le plugin livechat version 9.0.0.

en	You can configure one external [OpenID Connect](https://openid.net/developers/how-connect-works/) compatible provider.

en	Doing so, you can for example use your website for Single Sign-On.

en	Popular CMS softwares (Wordpess, ...) offers plugins implementing OpenID Connect.

en	To enable this feature, first you have to create a client on your provider side (check the related documentation for enabling OpenID Connect). Then go to the [plugin settings](/peertube-plugin-livechat/documentation/admin/settings), and enable "{{% livechat_label external_auth_custom_oidc_label %}}".

en	Note: if you want to restrict allowed redirection urls on the provider side (best security practice), the plugin will show you the url to allow. Just copy it in your OpenID Connect application configuration.

en	You will now have to fill some settings.

en	This is the button label in the following screenshot:

en	For now, it is not possible to localize this label.
fr	Pour l'instant il n'est pas possible d'utiliser des tableaux Markdown : les outils de translation ne savent pas les gérer.

en	Your OpenID Connect provider must implement the [discovery URL](https://openid.net/specs/openid-connect-discovery-1_0.html). Just set here the discovery url, that should be something like `https://example.com/.well-known/openid-configuration`.

en	Note: if your provider use the standard `/.well-known/openid-configuration` path, you can omit it. For example `https://accounts.google.com` will work.

en	Your application Client ID.

en	You application Client secret.

en	Google, Facebook, ...

en	In addition to that, you can also configure one or several "standard" Open ID Connect provider (Google, Facebook, ...).

en	For these providers, discovery url and button label are preset. You just have to create an OAuth2 application on the provider side, and configure Client ID and Client Secret.

en	If you think of a standard provider that is not available, you can ask for implementation by [opening a new issue](/peertube-plugin-livechat/issues/).

en	If the button does not appear for end users, there might be a configuration issue. You can try the [diagnostic tool](/peertube-plugin-livechat/documentation/installation/troubleshooting/) to get more information.

en	Note: if you are connected to your Peertube account, the button will never show. So use a private browser window to test.

en	If the button is displayed but is not working, check your Peertube logs. It could be because the remote service does not use standard scopes or attribute names.

en	More to come
fr	Nouvelles fonctionnalités à venir...

en	Other authentication methods will be implemented in the future.

en	Plugin Peertube Livechat administration
fr	Administration du Plugin Peertube Livechat

en	Admin documentation
fr	Documentation administrateur⋅rice

en	Plugin Peertube Livechat settings
fr	Paramètres du Plugin Peertube Livechat

en	Settings
fr	Paramètres

en	This section describes the plugin settings page.
fr	Cette section décrit la page de configuration du plugin.

en	When pressing the «List rooms» button, all existing chatrooms will be listed. You can then find them and moderated them.
fr	Lorsque vous appuyez sur le bouton "Lister les salles", toutes les salles de chat existantes sont listées. Vous pouvez alors les trouver et les modérer.

en	Federation
fr	Fédération

en	Following settings concern the federation with other Peertube instances, and other fediverse softwares.
fr	Les paramètres suivants concernent la fédération avec d'autres instances Peertube et d'autres logiciels du fediverse.

en	See the detailed documentation page:
fr	Voir la page de documentation dédiée à la documentation.

en	[External Authentication](/peertube-plugin-livechat/documentation/admin/external_auth/)
fr	[Le bot de tchat](/peertube-plugin-livechat/documentation/fr/user/streamers/bot)

en	Channel advanced configuration
fr	Configuration avancée de la chaîne

en	Following settings concern the advanced channel options: users will be able to add some customization on their channels, activate the moderation bot, ...
fr	Les paramètres suivants concernent les options de chaîne avancées : les utilisateur⋅rices pourront personnaliser leurs chaînes, activer le bot de modération, ...

en	If you encounter any issue with this feature, you can disable it.
fr	Si vous rencontrez un problème avec cette fonctionnalité, vous pouvez la désactiver.

en	Chat behaviour
fr	Comportement en chat

en	This feature enables a «share chat link» modal. With this modal, you can generate URLs to join the chat. The chat can be customized (readonly mode, use the current theme, ...).
fr	Cette fonctionnalité permet d'activer une fenêtre modale "partager le lien du chat". Avec cette modale, vous pouvez générer des URL pour rejoindre le tchat. Le tchat peut être personnalisé (mode lecture seule, utilisation du thème actuel, ...).

en	You can for example generate a readonly URL and use it in OBS to integrate the chat in your live stream!
fr	Vous pouvez par exemple générer une URL en lecture seule et l'utiliser dans OBS pour intégrer le chat dans votre flux en direct !

en	This settings allows you to choose who can access this modal.
fr	Ce paramètre vous permet de choisir qui peut accéder à cette fenêtre modale.

en	The video owner will be able to activate web chats.
fr	Le⋅a propriétaire de la vidéo pourra activer le tchat en ligne.

en	Note: for now this feature simply hide the chat. In a future release, the chat will be replaced by a message saying «please log in to [...]». See [v5.7.0 Release Notes](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/CHANGELOG.md#570) for more information.
fr	Note : pour l'instant, c'est fonctionnalité masque simplement le tchat. Dans une future version, le tchat sera remplacé par un message précisant «merci de vous connecter [...]». Voir les notes de publication [de la version 5.7.0](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/CHANGELOG.md#570) pour plus d'informations.

en	**Important note**: If you enable this feature, and are using a custom reverse proxy on front of Peertube, please make sure that your setup is correctly configured to forward real user's IPs to Peertube. Otherwise it could block all anonymous users at once.
fr	**Note importante** : Si vous activez cette fonctionnalité, et que vous utilisez un reverse proxy personnalisé devant Peertube, merci de vous assurer que vous avez correctement configuré celui-ci pour faire suivre les IPs réelles des utilisateur⋅rices à Peertube. Sinon cela pourrait bloquer tous les utilisateur⋅rices anonymes d'un coup.

en	Theming
fr	Personnalisation de l'apparence

en	You can choose from several different sets the default avatars that will be used for chat users.
fr	Vous pouvez choisir parmi plusieurs jeux différents les avatars par défaut qui seront utilisés pour les utilisateurs du tchat.

en	{{% livechat_label avatar_set_option_sepia %}}: [David Revoy's Peertube avatar generator](https://www.peppercarrot.com/extras/html/2023_peertube-generator/), [CC-By](https://creativecommons.org/licenses/by/4.0/) license
fr	{{% livechat_label avatar_set_option_sepia %}} : [Générateur d'avatars Peertube de David Revoy](https://www.peppercarrot.com/extras/html/2023_peertube-generator/), Licence [CC-By](https://creativecommons.org/licenses/by/4.0/)

en	![Sepia](/peertube-plugin-livechat/images/avatar_sepia.png?classes=shadow,border&height=40px)

en	{{% livechat_label avatar_set_option_cat %}}: [David Revoy's cat avatar generator](https://www.peppercarrot.com/extras/html/2016_cat-generator/), [CC-By](https://creativecommons.org/licenses/by/4.0/) license
fr	{{% livechat_label avatar_set_option_cat %}} : [Générateur d'avatar de chat de David Revoy](https://www.peppercarrot.com/extras/html/2016_cat-generator/), Licence [CC-By](https://creativecommons.org/licenses/by/4.0/)

en	![Cats](/peertube-plugin-livechat/images/avatar_cat.png?classes=shadow,border&height=40px)
fr	![Chats](/peertube-plugin-livechat/images/avatar_cat.png?classes=shadow,border&height=40px)

en	{{% livechat_label avatar_set_option_bird %}}: [David Revoy's bird avatar generator](https://www.peppercarrot.com/extras/html/2019_bird-generator/), [CC-By](https://creativecommons.org/licenses/by/4.0/) license
fr	{{% livechat_label avatar_set_option_bird %}} : [Générateur d'avatar d'oiseaux de David Revoy](https://www.peppercarrot.com/extras/html/2016_cat-generator/), Licence [CC-By](https://creativecommons.org/licenses/by/4.0/)

en	![Birds](/peertube-plugin-livechat/images/avatar_bird.png?classes=shadow,border&height=40px)
fr	![Oiseaux](/peertube-plugin-livechat/images/avatar_bird.png?classes=shadow,border&height=40px)

en	{{% livechat_label avatar_set_option_fenec %}}: [David Revoy's fenec/mobilizon avatar generator](https://www.peppercarrot.com/extras/html/2020_mobilizon-generator/), [CC-By](https://creativecommons.org/licenses/by/4.0/) license
fr	{{% livechat_label avatar_set_option_fenec %}} : [Générateur d'avatar fénnec/mobilizon de David Revoy](https://www.peppercarrot.com/extras/html/2020_mobilizon-generator/), licence [CC-By](https://creativecommons.org/licenses/by/4.0/)

en	![Fenecs](/peertube-plugin-livechat/images/avatar_fenec.png?classes=shadow,border&height=40px)
fr	![Fénnecs](/peertube-plugin-livechat/images/avatar_fenec.png?classes=shadow,border&height=40px)

en	{{% livechat_label avatar_set_option_abstract %}}: [David Revoy's Abstract avatar generator](https://www.peppercarrot.com/extras/html/2017_abstract-generator/index.php), [CC-By](https://creativecommons.org/licenses/by/4.0/) license
fr	{{% livechat_label avatar_set_option_abstract %}} : [Générateur d'avatar abstrait de David Revoy](https://www.peppercarrot.com/extras/html/2017_abstract-generator/index.php), licence [CC-By](https://creativecommons.org/licenses/by/4.0/)

en	![Abstracts](/peertube-plugin-livechat/images/avatar_abstract.png?classes=shadow,border&height=40px)
fr	![Abstraits](/peertube-plugin-livechat/images/avatar_abstract.png ?classes=shadow,border&height=40px)

en	{{% livechat_label avatar_set_option_legacy %}}: Based on [David Revoy' work](https://www.davidrevoy.com), [AGPL-v3](https://www.gnu.org/licenses/agpl-3.0.en.html) license
fr	{{% livechat_label avatar_set_option_legacy %}} : Basé sur le travail de [David Revoy](https://www.davidrevoy.com), licence [AGPL-v3](https://www.gnu.org/licenses/agpl-3.0.fr.html)

en	![Legacy](/peertube-plugin-livechat/images/avatar_legacy.jpg?classes=shadow,border&height=40px)
fr	![Anciens avatars](/peertube-plugin-livechat/images/avatar_legacy.jpg?classes=shadow,border&height=40px)

en	If you can't see the change immediatly, it could be because of your browser cache. Just clear your browser session storage, or restart it.
fr	Si vous ne voyez pas le changement immédiatement, cela peut être dû au cache de votre navigateur. Effacez le stockage de session de votre navigateur ou redémarrez-le.

en	You can choose which theme to use for ConverseJS:
fr	Vous pouvez choisir le thème à utiliser pour ConverseJS :

en	Peertube theme: this is a special theme, made especially for peertube's integration.
fr	Thème Peertube : il s'agit d'un thème spécial, conçu spécialement pour l'intégration dans Peertube.

en	Default ConverseJS theme: this is the default ConverseJS theme.
fr	Thème ConverseJS par défaut : c'est le thème ConverseJS par défaut.

en	ConverseJS concord theme: this is a theme provided by ConverseJS.
fr	Thème ConverseJS concord : il s'agit d'un thème fourni par ConverseJS.

en	Chat server advanced settings
fr	Paramètres avancés du tchat

en	The plugin comes with an AppImage that is used to run the [Prosody XMPP server](https://prosody.im). If this AppImage is not working, you can fallback to the Prosody that is packaged for your server. Just install the `prosody` package.
fr	Le plugin est livré avec une AppImage qui est utilisée pour exécuter le [serveur XMPP Prosody](https://prosody.im). Si cet AppImage ne fonctionne pas, vous pouvez vous rabattre sur la version de Prosody qui est packagé pour votre serveur. Installez simplement le paquet `prosody`.

en	This settings should only be used if the plugin is broken, and waiting for a patch.
fr	Ce paramètre ne devrait être utilisé que si le plugin est cassé et en attente d'un correctif.

en	If this settings is left empty, and you are using Peertube >= 5.1 or later, the plugin will use values from your Peertube configuration file to guess on which interface and port request have to be done.
fr	Si ce paramètre est laissé vide, et que vous utilisez Peertube >= 5.1, le plugin va utiliser les valeurs de votre fichier de configuration Peertube pour devenir sur quelle interface et quel port les requêtes doivent être faites.

en	In last resort, it will use your Peertube public URI. So, any API Call will go throught your Nginx server. This could fail in some case: for example if you are in a Docker container, where the public hostname does not resolve to the correct IP. In such case, try changing the "{{% livechat_label prosody_peertube_uri_label %}}" settings, by setting `http://127.0.0.1:9000` (assuming 9000 is the port on which Peertube listen, ask your instance administrators if you don't know).
fr	En dernier recours, cela utilisera l'URI publique de votre instance. Donc les appels d'API passeront à traver Nginx. Cela peut échouer dans certains cas : par exemple si vous êtes dans un conteneur Docker pour lequel le hostname publique ne résoud pas sur la bonne IP. Dans ce cas, essayez de changer le paramètre "{{% livechat_label prosody_peertube_uri_label %}}", en mettant `http ://127.0.0.1 :9000` (si c'est bien le port 9000 qui est utilisé par votre Peertube, demandez aux administrateur⋅rices de votre instance si vous ne savez pas).

en	This setting enable XMPP clients to connect to the built-in Prosody server. For now, this option **only allows connections from localhost clients**.
fr	Ce paramètre permet aux clients XMPP de se connecter au serveur Prosody intégré. Pour l'instant, cette option **n'autorise que les connexions des clients sur le localhost**.

en	As example, this option can allow an instance of Matterbridge (once it could use anonymous login) *on the same machine* to bridge your chat with another services like a Matrix room.
fr	Par exemple, cette option peut permettre à une instance Matterbridge (une fois qu'elle pourra utiliser une connexion anonyme) *sur la même machine* de faire le lien entre votre tchat et d'autres services tels qu'une salle Matrix.

en	This settings enable XMPP external components to connect to the server. By default, this option **only allows connections from localhost components**. You have to change the "{{% livechat_label prosody_components_interfaces_label %}}" value to listen on other network interfaces.
fr	Ce paramètre permet aux composants externes XMPP de se connecter au serveur. Par défaut cette option **n'autorise que les connexions des composants sur localhost**. Vous devez changer la valeur du paramètre «{{% livechat_label prosody_components_interfaces_label %}}» pour écouter sur d'autres interfaces réseau.

en	This feature could be used to connect bridges or bots.
fr	Cette fonction pourrait être utilisée pour connecter des ponts ou des robots.

en	More informations on Prosody external components [here](https://prosody.im/doc/components).
fr	Plus d'informations sur les composants externes de Prosody [ici] (https://prosody.im/doc/components).

en	Plugin documentation
fr	Documentation du plugin

en	For now, the plugin only works out of the box for x86_64 and arm64 CPU architecture. Here are some instructions for other CPU architectures.
fr	Pour l'instant le plugin ne supporte de base que les architectures CPU x86_64 et arm64. Veuillez trouver ici des instructions pour le faire fonctionner sur d'autres architectures CPU.

en	Known issues: CPU Compatibility
fr	Problème connu : compatibilité CPU

en	The Prosody AppImage included in the plugin will only work on x86_64 and arm64 CPU. It is not compatible with other CPU architectures.
fr	L'AppImage Prosody inclue dans le plugin ne fonctionne que sur des CPU x86_64 et arm64. Elle n'est pas compatible avec d'autres architectures CPU.

en	To use the plugin, you will have to manually install Prosody on your server (see below).
fr	Pour utiliser le plugin, vous allez devoir installer manuellement Prosody sur votre serveur (voir plus bas).

en	Note: the plugin requires Prosody >= 0.12.0. If you are using an older version, Chat Federation could be broken, and it could have some unexpected behaviour.
fr	Note : la version de Prosody devrait être supérieure ou égale à 0.12.0. Si vous utilisez une version plus ancienne, il pourrait y avoir des bugs sur la fédération du tchat, et d'autres comportements inattendus.

en	Once it is done, you have to check `Use system Prosody` in the plugin settings.
fr	Une fois cela fait, vous aurez à cocher le paramètre `Use system Prosody` du plugin.

en	On non-docker Peertube installation
fr	Installation autres que Docker

en	For standard installation, you just have to install the official `prosody` package for your linux distribution.
fr	Pour les installations standard, vous avez juste à installer le paquet `prosody` officiellement disponible pour votre distribution linux.

en	For example, on Debian/Ubuntu:
fr	Par exemple, sur Debian/Ubuntu :

en	sudo apt install prosody

en	You can then disable the service that starts automatically when you install Prosody (the plugin will launch a Prosody process, there is no need for the service to run). For example, on Debian/Ubuntu (and other Systemd based linux distributions):
fr	Vous pouvez alors désactiver le service qui démarre automatiquement quand vous installé le paquet (le plugin va lancer son propre processus Prosody, et n'a pas besoin que le service tourne sur le serveur). Par exemple, sur Debian/Ubuntu (et les autres distributions se basant sur Systemd) :

en	sudo systemctl disable prosody && sudo systemctl stop prosody

en	Warning: do not disable Prosody if it is used for another service on your server, like for example Jitsi.
fr	Attention : ne désactivez pas Prosody s'il est utilisé par un autre service sur votre serveur, par exemple pour Jitsi.

en	Docker

en	You will have to generate a Peertube image that includes Prosody in the same container that Peertube. I know this is not the standard way to do this with Docker, but keep in mind it is a temporary workaround.
fr	Vous allez devoir générer une image de Peertube qui inclu Prosody dans le même conteneur que Peertube. Je sais que ce n'est pas la façon de faire standard avec Docker, mais gardez en tête que ceci est une solution de contournement temporaire.

en	To generate and use such an image, please refer to the Docker documentation. The Docker file to generate the image should be:
fr	Pour générer cette image, merci de vous référer à la documentation de Docker. Le fichier Docker pour générer l'image devrait être :

en	FROM chocobozzz/peertube:production-bullseye RUN apt -y update && apt install -y prosody && apt -y clean

en	Yunohost

en	You have to disable `metronome` (the XMPP server provided by Yunohost), and install `prosody`.
fr	Vous avez à désactiver `metronome` (le serveur XMPP utilisé par Yunohost), et installer`prosody`.

en	This is already done by the Yunohost Peertube application, as it was required for the plugin before the v6.0.0.
fr	Ceci est déjà fait par l'application Yunohost Peertube, étant donné que c'était un pré-requis pour les version du plugin antérieures à la v6.0.0.

en	But it may be removed in a near feature (to avoid drawbacks of this method). I have to discuss with Yunohost team, to decide how we can do to minimize drawbacks, and maximize compatibility.
fr	Mais il se pourrait que ce soit retiré de l'application Yunohost Peertube dans un futur proche (pour éviter les inconvénients de cette méthode). Je dois discuter avec l'équipe Yunohost, pour décider de la bonne façon de faire pour minimiser les inconvénients et maximiser la compatibilité.

en	Plugin peertube-plugin-livechat installation guide
fr	Installation du plugin peertube-plugin-livechat

en	Installation guide
fr	Documentation d'installation

en	Before updating to a major release, please read the release notes and breaking changes list : [CHANGELOG](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/CHANGELOG.md).
fr	Avant de mettre à jour le plugin vers une nouvelle version majeure, merci de lire les notes de version, et la liste des éventuelles modifications non rétro-compatibles : [CHANGELOG](https://github.com/JohnXLivingston/peertube-plugin-livechat/blob/main/CHANGELOG.md).

en	To install or update the plugin, **just use the Peertube web admin interface**.
fr	Pour installer ou mettre à jour ce plugin, **utilisez simplement l'interface web d'administration de votre Peertube**.

en	Here are some other more specific instructions:
fr	Vous trouverez ci-dessous d'autres instructions :

en	Some classic mistakes and workarounds.
fr	Quelques erreurs classiques, et solutions de contournement.

en	I just installed/upgraded the plugin, but nothing happens
fr	Je viens juste d'installer/mettre-à-jour le plugin, mais rien ne se passe

en	If you have just installed/upgraded the plugin, but nothing happens (no chat, no settings, buttons in the settings page does not work, ...), just try to reload the page.
fr	Si vous venez juste d'installer/mettre-à-jour le plugin, et que rien ne se passe (pas de tchat, pas de paramètres, des boutons qui ne fonctionnent pas dans les paramètres, ...), essayez juste de recharger la page.

en	Diagnostic tool
fr	Outil de diagnostic

en	If the chat does not work, there is a diagnostic tool in the plugin's settings pages.
fr	Si le tchat ne fonctionne pas, il y a un outil de diagnostic dans la page des paramètres du plugin.

en	Open the plugin settings, and click on the "launch diagnostic" button.
fr	Ouvrez les paramètres du plugin, et cliquez sur le bouton "lancer le diagnostique".

en	![Launch diagnostic](/peertube-plugin-livechat/images/launch_diagnostic.png?classes=shadow,border&height=200px)
fr	![Lancer le diagnostique](/peertube-plugin-livechat/images/launch_diagnostic.png?classes=shadow,border&height=200px)

en	If there is any error in the diagnostic page, you can search in this page for a solution, or refer to the [Bug tracking documentation page](/peertube-plugin-livechat/issues/) if you can't find any response.
fr	S'il y a une erreur sur la page de diagnostique, vous pouvez chercher une solution sur cette page, ou si vous ne trouvez pas de réponse, vous référer à [la page de documentation «évolutions / bugs»](/peertube-plugin-livechat/fr/issues/).

en	![Diagnostic result](/peertube-plugin-livechat/images/diagnostic.png?classes=shadow,border&height=200px)
fr	![Résultat du diagnostique](/peertube-plugin-livechat/images/diagnostic.png?classes=shadow,border&height=200px)

en	Chat does not load
fr	Le tchat ne se charge pas

en	Internal API calls
fr	Appels d'API interne

en	In some case (like for some Docker Peertube installation), the diagnostic tools displays an error for the test called "API Prosody -> Peertube is KO".
fr	Dans certains cas (comme par exemple les installation Peertube sous Docker), l'outil de diagnostique affiche une erreur appelée "API Prosody Peertube is KO".

en	In such case, try changing the "{{% livechat_label prosody_peertube_uri_label %}}" settings, by setting `http://127.0.0.1:9000` (assuming 9000 is the port on which Peertube listen, ask your instance administrators if you don't know).
fr	Dans ce cas, essayez de changer le paramètre "{{% livechat_label prosody_peertube_uri_label %}}", en mettant `http://127.0.0.1:9000` (si c'est bien le port 9000 qui est utilisé par votre Peertube, demandez aux administrateur⋅rices de votre instance si vous ne savez pas).

en	Check the help for [this settings](/peertube-plugin-livechat/documentation/admin/settings/) for more information.
fr	Veuillez vous référer à la page d'aide [pour ce paramètre](/peertube-plugin-livechat/fr/documentation/admin/settings).

en	Websocket

en	If everything is fine in the diagnostic tools, but chat windows remains empty: it can be a Websocket issue. Since Peertube version 5.0.0, there are some additional configuration to do on the server side. Check with the instance administrators that they did not forgot to apply changes listed in the [Peertube v5.0.0 release notes](https://github.com/Chocobozzz/PeerTube/blob/master/CHANGELOG.md#v500).
fr	Si tout est OK d'après l'outil de diagnostique, mais que la fenêtre de tchat reste vide : cela peut être un soucis Websocket. Depuis la version 5.0.0 de Peertube, il y a de la configuration supplémentaire à faire du côté du serveur. Vérifiez avec les administrateur⋅rices de votre instance s'iels n'ont pas oublié d'appliquer les changements listés dans les [notes de version 5.0.0 de Peertube](https://github.com/Chocobozzz/PeerTube/blob/master/CHANGELOG.md#v500).

en	You can confirm that it is a Websocket issue by opening your browser console, and checking for error logs talking about failed Websocket connection.
fr	Vous pouvez confirmer si c'est un problème de Websocket en ouvrant la console de votre navigateur, et en vérifiant s'il y a des journaux d'erreur mentionnant une connexion Websocket échouée.

en	If you can't fix this immediatly, you can disable Websocket by unchecking "{{% livechat_label disable_websocket_label %}}" in the plugin setting page. In such case, you should also check "{{% livechat_label federation_dont_publish_remotely_label %}}", as chat federation won't work without Websocket.
fr	Si vous ne pouvez pas corriger cela tout de suite, vous pouvez déactiver Websocket en décochant "{{% livechat_label disable_websocket_label %}}" dans la page des paramètres du plugin. En pareil cas, vous devriez aussi décocher "{{% livechat_label federation_dont_publish_remotely_label %}}", car la fédération du tchat ne fonctionnera pas sans Websocket.

en	Important notes when upgrading for an older version.
fr	Notes importantes pour la mise à jour depuis une ancienne version du plugin.

en	Upgrade from version older than 6.0.0
fr	Mise à jour depuis une version antérieure à 6.0.0

en	IMPORTANT NOTE

en	Since version v6.0.0, this plugin does not need any Prosody installation.
fr	Depuis la version v6.0.0, ce plugin ne nécessite plus l'installation de Prosody.

en	If you were using this plugin before this version, and if you had installed Prosody manually, you can safely uninstall Prosody.
fr	Si vous utilisiez ce plugin avant, et que vous aviez installé Prosody manuellement, vous pouvez le désinstaller en tout sécurité.

en	If you were using the custom Peertube docker image that is embedding Prosody, you can switch back to the official Peertube image.
fr	Si vous utilisiez l'image docker spéciale de Peertube (qui incluais Prosody), vous pouvez basculer sur l'image officielle de Peertube.

en	Plugin peertube-plugin-livechat user documentation
fr	Documentation utilisateur⋅rice du plugin peertube-plugin-livechat

en	User documentation
fr	Documentation utilisateur⋅rice

en	Documentation to stream the chat content using OBS.
fr	Documentation pour diffuser le contenu du tchat à l'aide d'OBS.

en	OBS

en	[OBS](https://obsproject.com) is a popular Free And Open Source streaming software, with advanced capacities for your live streams. In the current page, you will find some advices to handle your live chats using OBS.
fr	[OBS](https://obsproject.com) est un logiciel populaire de diffusion en direct, libre et open source, avec des capacités avancées pour vos diffusions. Dans la présente page, vous allez trouver quelques conseils pour gérer les tchats de vos directs en utilisant OBS.

en	OBS Overlay
fr	Overlay OBS

en	You can easily include the chat in your stream.
fr	Vous pouvez facilement inclure le tchat dans votre flux vidéo.

en	![Embeding the chat in a live stream](/peertube-plugin-livechat/images/embed_chat_in_livestream.png?classes=shadow,border&height=200px)
fr	![Inclure le tchat dans un flux en direct](/peertube-plugin-livechat/images/embed_chat_in_livestream.png?classes=shadow,border&height=200px)

en	You can use the "{{% livechat_label share_chat_link %}}" feature to generate an URL to your chat. This button should be near the chat if you are the video owner (unless it was desactivated by your server admins).
fr	Vous pouvez utiliser la fonction «{{% livechat_label share_chat_link %}}» pour générer une URL vers votre tchat. Le bouton devrait se trouver près du tchat si vous êtes le⋅a propriétaire de la vidéo (à moins qu'il n'ait été désactivé par les administrateur⋅rices de votre serveur).

en	Check the "{{% livechat_label read_only %}}" checkbox in the modal.
fr	Cochez la case à cocher «{{% livechat_label read_only %}}» dans la modale.

en	![Share link popup](/peertube-plugin-livechat/images/share_readonly.png?classes=shadow,border&height=200px)
fr	![Popup de partage de lien](/peertube-plugin-livechat/images/share_readonly.png?classes=shadow,border&height=200px)

en	Then use this link as a "web browser source" in OBS.
fr	Utilisez alors ce lien en tant que «source navigateur web» dans OBS.

en	![Embeding the chat in OBS](/peertube-plugin-livechat/images/embed_chat_in_obs.png?classes=shadow,border&height=200px)
fr	![Inclure le tchat dans OBS](/peertube-plugin-livechat/images/embed_chat_in_obs.png?classes=shadow,border&height=200px)

en	You can use the "{{% livechat_label transparent_background %}}" option to have a transparent background in OBS. If you want to customize the background transparency, you can add this CSS in your OBS browser source's settings:
fr	Vous pouvez utiliser l'option «{{% livechat_label transparent_background %}}» pour obtenir un fond transparent dans OBS. Si vous souhaitez personnaliser la transparence de l'arrière-plan, vous pouvez ajouter ce CSS dans les paramètres de la source navigateur dans OBS :

en	:root { --livechat-transparent: rgba(255 255 255 / 90%) !important; }

en	In the previous CSS snippet, you can of course change the color or the transparency, by adapting the color values.
fr	Dans l'extrait CSS précédent, vous pouvez bien sûr changer la couleur ou la transparence, en adaptant les valeurs de couleur.

en	Note: you can entirely customize chat colors. This is undocumented yet, but you can try this: in the modal, check «use curent theme colors», then you can try to manually change color values in the URL. You must use valid CSS color values, and they must be properly URL encoded.
fr	Remarque : vous pouvez personnaliser les couleurs. Ce n'est pas encore documenté, mais vous pouvez essayer ceci : dans la fenêtre modale, cochez «utiliser les couleurs actuelles du thème», puis essayez de modifier manuellement les valeurs de couleur dans l'URL. Vous devez utiliser des valeurs de couleur CSS valides, et elles doivent être correctement encodées dans l'URL.

en	Mixing multiple chats in your live stream
fr	Mélanger plusieurs tchats dans votre flux en direct

en	You can use the [social_stream browser extension](https://github.com/steveseguin/social_stream#readme) to mix multiple chat source (from Peertube, Twitch, Youtube, Facebook, ...) and include their contents in your live stream. The compatibility with this plugin was added in recent versions.
fr	Vous pouvez utiliser l'extension [social_stream browser extension](https://github.com/steveseguin/social_stream#readme) pour mélanger plusieurs sources de tchat (Peertube, Twitch, Youtube, Facebook, ...) et inclure leurs contenus dans votre flux en direct. La compatibilité avec ce plugin a été ajoutée dans les versions récentes.

en	Some basics about how to setup and use the chat for your live stream
fr	Quelques basiques sur comment configurer et utiliser le tchat pour vos directs

en	Some basics
fr	Quelques basiques

en	Enabling the chat for you live streams
fr	Activer le tchat pour vos diffusions en direct

en	Instance administrators can choose to disable or enable chat in specific cases. Information in this section are only true in the default case.
fr	Les administrateur⋅rices de l'instance peuvent choisir de désactiver ou activer le tchat dans certains cas spécifiques. Les informations dans cette section ne sont applicables que dans le cas par défaut.

en	When you create or modify a Peertube live, there is a "plugin settings" tab:
fr	Quand vous créez ou modifiez un direct Peertube, il y a un onglet «paramètres du plugins» :

en	![New live](/peertube-plugin-livechat/images/new_live.png?classes=shadow,border&height=200px)
fr	![Nouveau direct](/peertube-plugin-livechat/images/new_live.png?classes=shadow,border&height=200px)

en	In the "plugin settings" tab, there is a "{{% livechat_label use_chat %}}" checkbox. Just check or uncheck it to enable or disable the chat associated to your video.
fr	Dans l'onglet «paramètres du plugin», il y a une case à cocher «{{% livechat_label use_chat %}}». Cochez ou décochez la simplement pour activer ou désactiver le tchat associé à votre vidéo.

en	![Activate the chat](/peertube-plugin-livechat/images/new_live_activate_chat.png?classes=shadow,border&height=200px)
fr	![Activer le tchat](/peertube-plugin-livechat/images/new_live_activate_chat.png?classes=shadow,border&height=200px)

en	There can be other settings in this tab, depending on plugins installed on your Peertube instance.
fr	Il peut y avoir d'autres paramètres dans cet onglet, en fonction des plugins installés sur votre instance Peertube.

en	Per channel chat
fr	Tchat par chaîne

en	On the instance level, Peertube's administrators can choose if chat rooms are unique per video, or if there will be an unique chat room per channel. Please contact your instance's administrators for more information on how they configure the livechat plugin.
fr	Au niveau de l'instance, les administrateur⋅rices peuvent choisir si les salons de discussions sont uniques par vidéo, ou s'ils vont être uniques par chaîne. Veuillez contacter les administrateur⋅rices de votre instance pour plus d'information sur la façon dont est configuré le plugin livechat.

en	Share the chat
fr	Partager le tchat

en	On top of the chat, there is a "{{% livechat_label share_chat_link %}}" button.
fr	Au dessus du tchat, il y a un bouton «{{% livechat_label share_chat_link %}}».

en	This button opens a popup, where you can obtain an url to join the chat. This url can be shared.
fr	Ce bouton ouvre une popup, où vous trouverez une url pour rejoindre le tchat. Vous pouvez partager cette url.

en	You can customize some options:
fr	Vous pouvez personnaliser certaines options :

en	{{% livechat_label read_only %}}: you will only be able to read the chat, not write. This is useful to include the chat content in your live stream (see the [OBS documentation](/peertube-plugin-livechat/documentation/user/obs)).
fr	{{% livechat_label read_only %}} : vous ne pourrez que lire le tchat, et non y écrire. Ceci est utile pour inclure le contenu du tchat dans vos diffusions directes (voir la [documentation OBS](/peertube-plugin-livechat/documentation/user/obs)).

en	{{% livechat_label use_current_theme_color %}}: if checked, your current theme colors will be added to the url, so that any user that opens the link will have the same color set.
fr	{{% livechat_label use_current_theme_color %}} : si coché, les couleurs de votre thème courant seront ajoutés à l'url, de sorte que ls personnes ouvrant ce lien auront le même jeu de couleurs.

en	{{% livechat_label generate_iframe %}}: instead of an url, you will obtain an HTML snippet that you can add to your website to embed the chat.
fr	{{% livechat_label generate_iframe %}} : à la place d'une url, vous aurez un extrait HTML que vous pouvez ajouter à votre site web pour inclure le tchat.

en	The "{{% livechat_label share_chat_link %}}" popup can also contain a "{{% livechat_label connect_using_xmpp %}}" tab. This will only be available if your instance's administators have enabled an correctly configured this option. Using this option, you can provide a link to join the chat using any [XMPP client software](https://en.wikipedia.org/wiki/XMPP#Clients). Using such softwares can for example facilitate moderation actions.
fr	La popup «{{% livechat_label share_chat_link %}}» peut également contenir un onglet «{{% livechat_label connect_using_xmpp %}}». Cet onglet n'est disponible que si les admintrateur⋅rices de votre instance ont activé et configuré correctement cette option. En utilisant cette option, vous pouvez fournir un lien permettant de rejoindre le salon en utilisant n'importe quel [client XMPP](https://fr.wikipedia.org/wiki/Clients_XMPP). En utilisant de tels logiciels, il sera par exemple plus simple de gérer les actions de modération.

en	Moderation
fr	Modération

en	Please refer to the [moderation documentation](/peertube-plugin-livechat/documentation/user/streamers/moderation).
fr	Veuillez vous référer à la [documentation de modération](/peertube-plugin-livechat/fr/documentation/user/streamers/moderation).

en	Include the chat in your video stream
fr	Inclure plusieurs tchats dans votre flux en direct

en	Please refer to the [OBS documentation](/peertube-plugin-livechat/documentation/user/obs).
fr	Veuillez vous référer à la [documentation OBS](/peertube-plugin-livechat/fr/documentation/user/obs).

en	Chat persistence
fr	Persistance du tchat

en	By default, the chat is persistent. This means that the room content will be kept for a while. User joining will see messages posted before their arrival.
fr	Par défaut, le tchat est persistant. Cela veut dire que le contenu des salons sera conservé pendant un moment. Les utilisateur⋅rices qui le rejoignent pourront voir les messages envoyés avant leur arrivée.

en	You can change the persistence behaviour. [Open the chat dropdown menu](/peertube-plugin-livechat/documentation/user/viewers), and click on "Configure".
fr	Vous pouvez changer le comportement de la persistance. [Ouvrez le menu déroulant](/peertube-plugin-livechat/fr/documentation/user/viewers), et cliquez sur «Configurer».

en	![Chat menu](/peertube-plugin-livechat/images/top_menu.png?classes=shadow,border&height=200px)
fr	![Menu du tchat](/peertube-plugin-livechat/images/top_menu.png?classes=shadow,border&height=200px)

en	There are several options that can be changed.
fr	Il y a plusieurs options qui peuvent être changées.

en	![Configure chat room](/peertube-plugin-livechat/images/configure.png?classes=shadow,border&height=200px)
fr	![Configurer le salon](/peertube-plugin-livechat/images/configure.png?classes=shadow,border&height=200px)

en	You can for example set the default and maximum number of messages to return to 0, so that new incomers won't see any previously sent message.
fr	Vous pouvez par exemple définir la valeur par défaut, et la valeur maximum du nombre de messages à retourner à 0. Ainsi les personnes rejoignant le salon ne pourront voir les messages envoyés précédemment.

en	You can also uncheck "enable archiving": if unchecked, messages will be pruned if the server restarts.
fr	Vous pouvez aussi décocher «activer l'archivage» : si décoché, les messages seront nettoyés si le serveur redémarre.

en	By unchecking "Persistent", the room will be cleared if there is no more participant.
fr	En décochant «Persistant», le salon sera effacé quand il n'y aura plus de participant⋅es.

en	Delete the chat content
fr	Détruire le contenu du tchat

en	If you want to delete the chat content, [open the chat dropdown menu](/peertube-plugin-livechat/documentation/user/viewers), then click on "Destroy". A popup will open, asking a confirmation.
fr	Si vous voulez détruire le contenu du tchat, [ouvrez le menu déroulant](/peertube-plugin-livechat/fr/documentation/user/viewers), et cliquez sur «Détruire». Une popup va s'ouvrir, demandant confirmation.

en	The chat will be automatically recreated each time someone tries to join it as long as the video exists, and has the "{{% livechat_label use_chat %}}" feature activated.
fr	Le tchat sera automatiquement recréé à chaque fois que quelqu'un essayera de le rejoindre, tant que la vidéo existe et qu'elle a le paramètre «{{% livechat_label use_chat %}}» activé.

en	The bot can respond to several commands.
fr	Le bot peut répondre à différentes commandes.

en	Commands
fr	Commandes

en	![Commands configuration](/peertube-plugin-livechat/images/bot_commands.png?classes=shadow,border&height=400px)
fr	![Configuration des commandes](/peertube-plugin-livechat/images/bot_commands.png?classes=shadow,border&height=400px)

en	You can setup several commands.
fr	Vous pouvez paramétrer différentes commandes.

en	The bot can automatically moderate messages containing forbidden words.
fr	Le bot peut automatiquement modérer les messages contenant des mots interdits.

en	Forbidden words
fr	Mots interdits

en	![Forbidden words configuration](/peertube-plugin-livechat/images/bot_forbidden_words.png?classes=shadow,border&height=400px)
fr	![Configuration des mots interdits](/peertube-plugin-livechat/images/bot_forbidden_words.png?classes=shadow,border&height=400px)

en	![Deleted message](/peertube-plugin-livechat/images/bot_deleted_message.png?classes=shadow,border&height=100px)
fr	![Messages supprimés](/peertube-plugin-livechat/images/bot_deleted_message.png?classes=shadow,border&height=100px)

en	You can fill several "{{% livechat_label livechat_configuration_channel_forbidden_words_label %}}" fields. When a user sends a message that match the configured criteria, the message will automatically be deleted.
fr	Vous pouvez remplir plusieurs champs «{{% livechat_label livechat_configuration_channel_forbidden_words_label %}}"». Quand un⋅e utilisateur⋅rice envoie un message qui correspond à l'un des critère configuré, le message sera automatiquement supprimé.

en	In this field, you can set several words, group of words, or "regular expressions".
fr	Dans ce champs, vous pouvez mettre plusieurs mots, groupes de mots, ou «expressions régulières».

en	Each time a user sends a message, these words will be tested. If the message containes one of them, the message will be deleted.
fr	Chaque fois qu'un⋅e utilisateur⋅rice envoi un message, ces mots seront testés. Si le message contient l'un d'entre eux, le message sera supprimé.

en	You can for example fill this field with a swear words list.
fr	Vous pouvez par exemple remplir ce champs avec une liste d'insultes.

en	To get some examples, please check these [forbidden words suggestions](https://framagit.org/Livingston/peertube-plugin-livechat/-/tree/main/support/forbidden_words).
fr	Pour avoir quelques exemples, merci de vous référer aux [suggestions de mots interdits](https://framagit.org/Livingston/peertube-plugin-livechat/-/tree/main/support/forbidden_words).

en	If you have some usefull words lists, you are welcome to contribute to this suggestion page. There are in the `support/forbidden_words` folder of the livechat source code. See the [contribution guide](/peertube-plugin-livechat/contributing/) for more information.
fr	Si vous avez des listes de mots utiles, vous êtes les bienvenu⋅es pour contribuer à cette page de suggestion. Elles sont dans le dossier `support/forbidden_words` du code source. Veuillez vous référer au [guide de contribution](/peertube-plugin-livechat/fr/contributing/) pour plus d'informations.

en	These words are case insensitive.
fr	Ces mots ne sont pas sensibles à la casse.

en	This features is still experimental. There might be some issues with non-latin alphabets. You can [open an issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues) to report your problems.
fr	Cette fonction est encore expérimentale. Il pourrait y avoir quelques problèmes avec les alphabets non-latin. Si c'est le cas, vous pouvez [ouvrir un ticket](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues) pour signaler votre problème.

en	By checking this option, each line of the "{{% livechat_label livechat_configuration_channel_forbidden_words_label %}}" field will be considered as a [regular expression](https://en.wikipedia.org/wiki/Regular_expression).
fr	En cochant cette option, chaque ligne du champs «{{% livechat_label livechat_configuration_channel_forbidden_words_label %}}» sera considéré comme une [expression régulière](https://fr.wikipedia.org/wiki/Expression_r%C3%A9guli%C3%A8re).

en	Chat bot setup
fr	Configuration du bot de tchat

en	Chat bot
fr	Bot de tchat

en	This feature comes with the livechat plugin version 8.0.0, and can be disabled by your instance's admins.
fr	Cette fonctionnalité arrive avec le plugin livechat version 8.0.0, et peut être désactivée par les admins de votre instance.

en	You can enable a chat bot on your chatrooms. The bot configuration is made channel per channel, and will apply to all related videos' chatrooms.
fr	Vous pouvez activer un bot de tchat dans vos salons. La configuration du bot se fait chaîne par chaîne, et s'applique aux salons de toutes les vidéos de celles-ci.

en	![Channel configuration](/peertube-plugin-livechat/images/channel_configuration.png?classes=shadow,border&height=400px)
fr	![Configuration de la chaîne](/peertube-plugin-livechat/images/channel_configuration.png?classes=shadow,border&height=400px)

en	To access this page, check the [channel configuration documentation](/peertube-plugin-livechat/documentation/user/streamers/channel).
fr	Pour accéder à cette page, veuillez vous référer à la [documentation sur la configuration des chaînes](/peertube-plugin-livechat/fr/documentation/user/streamers/channel).

en	Once there, you can enable the bot, and setup several options:
fr	Une fois ici, vous pouvez activer le bot, et configurer quelques options :

en	The bot will reload instantly when you save the page.
fr	Le bot recharge automatiquement ses options quand vous sauvegardez la page.

en	The bot can send periodically some messages.
fr	Le bot peut envoyer des messages périodiquement.

en	Timers
fr	Messages pré-enregistrés

en	If there is no user in the chatroom, the bot won't send any message.
fr	S'il n'y a pas d'utilisateur⋅rice dans le salon, le bot n'enverra pas de message.

en	![Timers configuration](/peertube-plugin-livechat/images/bot_quotes.png?classes=shadow,border&height=200px)
fr	![Configuration des messages pré-enregistrés](/peertube-plugin-livechat/images/bot_quotes.png?classes=shadow,border&height=200px)

en	Peertube channel chatrooms configuration
fr	Configuration des salons de discussion des chaînes Peertube

en	Channel configuration
fr	Configuration de la chaîne

en	In the Peertube left menu, there is a "{{% livechat_label menu_configuration_label %}}" entry:
fr	Dans le menu gauche de Peertube, il y a une entrée «{{% livechat_label menu_configuration_label %}}» :

en	![Chatrooms menu](/peertube-plugin-livechat/images/chatrooms_menu.png?classes=shadow,border&height=400px)
fr	![Menu salons de discussion](/peertube-plugin-livechat/images/chatrooms_menu.png?classes=shadow,border&height=400px)

en	This "{{% livechat_label menu_configuration_label %}}" link takes you to a list of your channels. By clicking on a channel, you will then be able to setup some options for your channels:
fr	Ce lien «{{% livechat_label menu_configuration_label %}}» vous emmène sur une liste de vos chaînes. En cliquant sur une chaîne, vous pourrez effectuer certains réglages pour vos chaînes :

en	Here you can configure:
fr	Ici vous pouvez configurer :

en	[The slow mode](/peertube-plugin-livechat/documentation/user/streamers/slow_mode)
fr	[Le mode lent](/peertube-plugin-livechat/documentation/user/streamers/slow_mode)

en	[The chat bot](/peertube-plugin-livechat/documentation/user/streamers/bot)
fr	[Le bot de tchat](/peertube-plugin-livechat/documentation/fr/user/streamers/bot)

en	More features to come...
fr	Nouvelles fonctionnalités à venir...

en	How to setup the chat for your live stream
fr	Comment mettre en place le tchat pour vos diffusions en direct

en	For streamers
fr	Pour les streameur⋅euses

en	Plugin peertube-plugin-livechat advanced moderation features
fr	Fonctionnalités de modération avancées du plugin peertube-plugin-livechat

en	This section is still incomplete.
fr	Cette section est encore incomplète.

en	The chat bot
fr	Le bot de tchat

en	You can use a chat bot, that will help you for moderation. Check [the chat bot documentation](/peertube-plugin-livechat/documentation/user/streamers/bot) for more information.
fr	Vous pouvez utiliser un bot de tchat, qui vous aidera pour la modération. Veuillez vous référer à la [documentation du bot de tchat](/peertube-plugin-livechat/documentation/fr/user/streamers/bot) pour plus d'informations.

en	Accessing moderation tools
fr	Accéder aux outils de modération

en	You can access room settings and moderation tools using the [chat dropdown menu](/peertube-plugin-livechat/documentation/user/viewers) at the top of the chat.
fr	Vous pouvez accéder aux paramètres de la salle et aux outils de modération en utilisant le [menu déroulant du tchat](/peertube-plugin-livechat/fr/documentation/user/viewers) en haut à droite de celui-ci.

en	All instance moderators and admins will be owner of created chat rooms. The video owner will be admin in the chat room.
fr	Tous les modérateur⋅rices et administrateur⋅rices de l'instance seront propriétaires des salons de discussion créés. Le ou la propriétaire de la vidéo sera admin du salon.

en	You can use [ConverseJS moderation commands](https://conversejs.org/docs/html/features.html#moderating-chatrooms) to moderate the room. When you open the chat room in full screen, there will also be a menu with dedicated commands on the top right.
fr	Vous pouvez utiliser les [commandes de modération ConverseJS](https://conversejs.org/docs/html/features.html#moderating-chatrooms) pour modérer le salon. Lorsque vous ouvrez la salle de discussion en plein écran, un menu avec des commandes dédiées s'affiche en haut à droite.

en	Roles and affiliations
fr	Rôles et affiliations

en	There are several roles that can be assignated to users in chat rooms: owner, moderators, member, ...
fr	Il y a différents rôles qui peuvent être assignés aux utilisateur⋅rices dans les salons de discussion : propriétaire, modérateur⋅rice, membre, ...

en	You can promote users as moderators, if you need some help.
fr	Vous pouvez promouvoir des utilisateur⋅rices en tant que modérateur⋅rices, si vous avez besoin d'aide.

en	Delete room content
fr	Supprimer le contenu des salons

en	You can delete old rooms: join the room, and use the menu on the top to destroy the room.
fr	Vous pouvez supprimer d'anciennes salles : rejoignez la salle, et utilisez le menu en haut pour détruire la salle.

en	Instance moderation
fr	Modération de l'instance

en	As Peertube instance moderator or administrator, you will probably need to check that your users are not behaving badly.
fr	En tant que modérateur⋅rice ou administrateur⋅rice de l'instance Peertube, vous allez probablement vouloir vérifier que les utilisateur⋅rices n'ont pas de comportement problématique.

en	You can list all existing chatrooms: in the plugin settings screen, there is a button «List rooms».
fr	Vous pouvez lister toutes les salles de discussion existantes : dans l'écran des paramètres du plugin, il y a un bouton "Lister les salles".

en	Plugin peertube-plugin-livechat slow mode
fr	Mode lent du plugin peertube-plugin-livechat

en	Slow mode
fr	Mode lent

en	This feature comes with the livechat plugin version 8.3.0.
fr	Cette fonctionnalité arrive avec le plugin livechat version 8.3.0.

en	Introduction

en	As a streamer, you can choose to rate limit your viewers messages in the chat.
fr	En tant que streameur⋅euse, vous pouvez choisir de limiter la fréquence des messages de vos spectateur⋅rices dans le tchat.

en	This can be really usefull to:
fr	Cela peut s'avérer très utile pour :

en	avoid message flooding
fr	éviter l'inondation de messages

en	avoid unreadable chat if there are many viewers talking
fr	éviter que le tchat ne devienne illisible si de nombreux⋅ses personnes y parlent

en	You can set a number of seconds that users will have to wait after sending a message, before sending another.
fr	Vous pouvez définir le nombre de secondes que les utilisateur⋅rices devront attendre après avoir envoyé un message avant d'en envoyer un autre.

en	This limitation does not apply to moderators.
fr	Cette limitation ne s'applique pas aux modérateur⋅rices.

en	Slow mode option
fr	Option du mode lent

en	On the [channel configuration page](/peertube-plugin-livechat/documentation/user/streamers/channel), you can set the slow mode option:
fr	Sur la [page de configuration de la chaîne](/peertube-plugin-livechat/fr/documentation/user/streamers/channel), vous pouvez définir une valeur pour l'option mode lent :

en	![Channel configuration / Slow Mode](/peertube-plugin-livechat/images/slow_mode_channel_option.png?classes=shadow,border&height=400px)
fr	![Configuration de la chaîne / Mode lent](/peertube-plugin-livechat/images/slow_mode_channel_option.png?classes=shadow,border&height=400px)

en	This value will apply to all your channel's chatrooms.
fr	Cette valeur va s'appliquer à tous les salons de discussion de votre chaîne.

en	Setting the value to `0` will disable the feature.
fr	La valeur `0` désactive la fonctionnalité.

en	Setting the value to a positive integer will set the period during which users will not be able to post additional messages.
fr	Positionner la valeur à un nombre entier positif permet de fixer la période pendant laquelle les utilisateur⋅rices ne pourront pas envoyer de messages supplémentaires.

en	For viewers
fr	Pour les spectateur⋅rices

en	If the slow mode is enabled, users will be informed by a message.
fr	Si le mode lent est activé, les utilisateur⋅rices en seront informé⋅es par un message.

en	![Slow mode infobox](/peertube-plugin-livechat/images/slow_mode.png?classes=shadow,border&height=400px)
fr	![Information mode lent](/peertube-plugin-livechat/images/slow_mode.png?classes=shadow,border&height=400px)

en	When they send a message, the input field will be disabled for X seconds (where X is the slow mode duration).
fr	Lorsqu'iels envoient un message, le champ de saisie est désactivé pendant X secondes (X étant la durée du mode lent).

en	How to chat for stream viewers
fr	Comment tchater pour les spectateur⋅rices

en	Joining chat rooms
fr	Rejoindre les salons de discussion

en	When you are watching a Peertube video that has the chat activated, you will see the chat next to the video:
fr	Quand vous regardez une vidéo Peertube qui a le tchat activé, vous le verrez à coté de celle-ci :

en	![Chat screenshot](/peertube-plugin-livechat/images/chat.png?classes=shadow,border&height=200px)
fr	![Capture d'écran du tchat](/peertube-plugin-livechat/images/chat.png?classes=shadow,border&height=200px)

en	There are two slightly different use cases, depending on wether or not you have an account on the Peertube instance. See bellow for more informations.
fr	Il y a deux cas d'usages légèrement différents, dépendant de si vous avez un compte sur l'instance Peertube ou non. Voir plus bas pour plus d'informations.

en	If you haven't a Peertube account
fr	Si vous n'avez pas de compte Peertube

en	This feature can be disabled by the instance's adminitrators.
fr	Cette fonction peut être désactivée par les administrateur⋅rices de l'instance.

en	If you are not logged in on the Peertube instance where you are watching the video, you will automatically join the chat. You will be assigned a random nickname (something like "Anonymous 12345").
fr	Si vous n'êtes pas identifié⋅e sur l'instance Peertube où vous regardez la vidéo, vous allez automatiquement rejoindre le tchat. Un pseudonyme aléatoire vous sera assigné (quelque chose de la forme «Anonyme 12345»).

en	![Chat with an anonymous user](/peertube-plugin-livechat/images/chat_with_anonymous.png?classes=shadow,border&height=200px)
fr	![Tchat avec utilisateur anonyme](/peertube-plugin-livechat/images/chat_with_anonymous.png?classes=shadow,border&height=200px)

en	Before being able to speak in the chat room, you have to enter a nickname in the field on the bottom of the window.
fr	Avant de pouvoir parler dans le salon, vous allez devoir choisir un pseudonyme dans le champ au bas de la fenêtre.

en	![Joining chat when not connected](/peertube-plugin-livechat/images/chat_anonymous.png?classes=shadow,border&height=200px)
fr	![Rejoindre le tchat quand pas connecté](/peertube-plugin-livechat/images/chat_anonymous.png?classes=shadow,border&height=200px)

en	Log in using an external authentication provider

en	The Peertube instance can configure external authentication providers (Mastodon accounts, Google accounts, ...). In such case, you will see a "{{% livechat_label login_using_external_account %}}" button, that will open a dialog modal. In this dialog modal, there will be some buttons to connect using a remote account.

en	Once you signed in the remote account, and have granted access, your nickname and avatar (if available) will be automatically fetched. No other data will be stored. These data will be automatically deleted several hours after your quit the chat.

en	If you have a Peertube account
fr	Si vous avez un compte Peertube

en	If you are connected with your Peertube account, you will automatically join the room, using your Peertube nickname and avatar.
fr	Si vous êtes connecté avec votre compte Peertube, vous allez automatiquement rejoindre le salon, en utilisant votre pseudonyme Peertube et votre avatar.

en	If you are watching a live on an instance on which you have no account, but you have an account on another instance: if the livechat plugin is installed on both instances, it is possible to join the chat using your account. To do so, just open the video on your instance (you can for example copy/paste the video url in the search field of your instance).
fr	Si vous regardez un direct sur une instance où vous n'avez pas de compte, mais que vous avez un compte Peertube sur une autre instance : sous réserve que le plugin livechat soit installé sur les deux instances, vous pouvez rejoindre le tchat avec votre compte. Pour cela, ouvrez la vidéo sur votre instance (vous pouvez par exemple copier/coller l'url de la vidéo dans le champs de recherche de votre instance).

en	If you have a Peertube account on another Peertube instance
fr	Si vous avez un compte Peertube sur une autre instance Peertube

en	This feature comes with the livechat plugin version 9.0.0.
fr	Cette fonctionnalité arrive avec le plugin livechat version 9.0.0.

en	If you have a Peertube account, but not on the current instance, there is a "{{% livechat_label login_using_external_account %}}" button. This button will open a dialog where you can enter your Peertube instance URL. Once you entered it, it will check if the livechat plugin is available on the remote instance, and if the video is available. If it is the case, you will be redirected to the video on the remote instance.
fr	Si vous avez un compte Peertube, mais pas sur l'instance courante, il y a un bouton "{{% livechat_label login_using_external_account %}}". Ce bouton va ouvrir un fenêtre de dialogue où vous pourrez entrer l'URL de votre instance Peertube. Une fois celle-ci entrée, cela vérifiera sur le plugin livechat est disponible sur l'instance distante, et si la vidéo y est disponible. Dans ce cas, vous serez redirigé vers la vidéo sur l'instance distante.

en	![External login dialog](/peertube-plugin-livechat/images/external_login_dialog.png?classes=shadow,border&height=200px)
fr	![Fenêtre de dialogue connexion avec un compte externe](/peertube-plugin-livechat/images/external_login_dialog.png?classes=shadow,border&height=200px)

en	Chatting
fr	Tchatter

en	To send messages, just type them in the "message" field on the bottom of the screen. You can send them by pressing the enter key on your keyboard, or by clicking on the "send" button.
fr	Pour envoyer des messages, saisissez les simplement dans le champ «message» en bas de l'écran. Vous pouvez les envoyer en tapant la touche entrée de votre clavier, ou en cliquant sur le bouton «envoyer».

en	If you want to add line breaks in your messages, you can use the "shift+enter" key combination.
fr	Si vous voulez ajouter des retours à la ligne à vos messages, vous pouvez utiliser la combinaison de touche «shift + entrée».

en	You can add emojis to your messages. You can for example use the emojis menu, or directly type emojis shortcuts like `:smiley:`.
fr	Vous pouvez ajouter des emojis à vos messages. Vous pouvez par exemple utiliser le menu emojis, ou directement taper les raccourcis du type `:smiley:`.

en	You can mention other participants. To do so, you can type the first nickname letters, then press the tab key. You can also type `@`: this will directly open the menu. You can also click on a nickname in the participants list to insert it in the message field.
fr	Vous pouvez mentionner d'autres participant⋅es. Pour cela, vous pouvez taper les premières lettres du pseudo, puis appuyer sur la touche tabulation. Vous pouvez aussi taper le caractère `@` : cela ouvrira directement un menu. Vous pouvez également cliquer sur un pseudonyme dans la liste des participant⋅es pour insérer celui-ci dans le champs de saisie de message.

en	Participants list
fr	Liste des participant⋅es

en	To see the list of participants, just open the right menu:
fr	Pour voir la liste des participant⋅es, ouvrez juste le menu droit :

en	![Participants list](/peertube-plugin-livechat/images/open_participants_list.png?classes=shadow,border&height=200px)
fr	![Liste des participant⋅es](/peertube-plugin-livechat/images/open_participants_list.png?classes=shadow,border&height=200px)

en	You can see that some participants have special rights (moderator, owner, ...).
fr	Vous pouvez constater que certain⋅es participant⋅es ont des droits spéciaux (modérateur⋅rice, propriétaire, ...).

en	Chat dropdown menu
fr	Menu déroulant du tchat

en	There is a dropdown menu on the top of the chat, with some advanced features. This is especially useful for [moderation features](/peertube-plugin-livechat/documentation/user/streamers/moderation). Available features depends on your access level.
fr	Il y a un menu déroulant au dessus du tchat, comprenant quelques fonctionnalités avancées. Cela est particulièrement utile pour les [fonctions de modération](/peertube-plugin-livechat/fr/documentation/user/streamers/moderation). Les fonctionnalités disponibles dépendent de votre niveau d'accès.

en	Opening full screen
fr	Ouvrir en plein écran

en	On top of the chat, there is a button to open the chat in fullscreen. This will open a new browser tab with the following content:
fr	Au dessus du tchat, il y a un bouton qui permet de l'ouvrir en plein écran. Cela l'ouvrira dans un nouvel onglet du navigateur avec le contenu suivant :

en	![Fullscreen chat screenshot](/peertube-plugin-livechat/images/fullscreen.png?classes=shadow,border&height=200px)
fr	![Capture d'écran du tchat en plein écran](/peertube-plugin-livechat/images/fullscreen.png?classes=shadow,border&height=200px)

en	It can be easier to chat using a full browser tab.
fr	Cela peut être plus facile de tchatter en utilisant un onglet de navigateur complet.

en	Changing nickname
fr	Changer de pseudonyme

en	You can change your nickname by typing `/nick your_new_nickname` in the message field.
fr	Vous pouvez changer de pseudonyme en tapant `/nick votre_nouveau_pseudo` dans le champs de message.

en	You can also change your nickname using the chat menu.
fr	Vous pouvez également changer votre pseudonyme en utilisant le menu déroulant du tchat.

en	Connect to chat using a XMPP client
fr	Se connecter au tchat avec un client XMPP

en	XMPP Clients
fr	Clients XMPP

en	This chat plugin relies on the XMPP protocol (also known as Jabber). It is therefore possible to connect to the chats using [XMPP client software](https://en.wikipedia.org/wiki/XMPP#Clients). This can be useful for example to facilitate moderation operations.
fr	Ce module de tchat repose sur le protocole XMPP, aussi connu sous le nom de Jabber. Il est donc possible de se connecter aux tchats en utilisant des [logiciels clients XMPP](https://fr.wikipedia.org/wiki/Clients_XMPP). Cela peut par exemple être utile pour faciliter les opérations de modération.

en	The features described on this page must be enabled and configured by your Peertube instance's administrators. You may therefore not have access to them.
fr	Les fonctions décrites dans cette page doivent être activées et configurées par les administrateur⋅rices de votre instance Peertube. Il se peut donc que vous n'y ayez pas accès.

en	If this feature is enabled on your instance, you can connect to Peertube chats using any XMPP account.
fr	Si cette fonctionnalité est activée sur votre instance, vous pouvez vous connecter aux tchats Peertube en utilisant un compte XMPP quelconque.

en	To get the address of the room you want to join, you can use the "share chat" button that is located above the chat:
fr	Pour obtenir l'adresse du salon à rejoindre, vous pouvez utiliser la fenêtre de «partage» du tchat, dont le bouton est situé au dessus du tchat :

en	![Share button](/peertube-plugin-livechat/images/share_button.png?classes=shadow,border&height=200px)
fr	![Partage](/peertube-plugin-livechat/images/share_button.png?classes=shadow,border&height=200px)

en	By default, the share button is only visible to the owner of the video, and the admins/moderators of the instance. However, admins can decide to display this button for everyone.
fr	Par défaut, le bouton de partage n'est visible que pour le ou la propriétaire de la vidéo, et les admins/modérateur⋅rices de l'instance. Toutefois, les admins peuvent décider d'afficher ce bouton pour tout le monde.

en	Then, choose "Connect using XMPP":
fr	Ensuite, dans la modale qui s'affiche, choississez «Connexion avec un client XMPP» :

en	![Share XMPP](/peertube-plugin-livechat/images/share_xmpp_dialog.png?classes=shadow,border&height=200px)
fr	![Partage XMPP](/peertube-plugin-livechat/images/share_xmpp_dialog.png?classes=shadow,border&height=200px)

en	Then you just have to click on "open" or copy/paste the address of the chat room into your XMPP client (using the "join a room" feature).
fr	Il vous suffit ensuite, soit de cliquer sur «ouvrir», soit de copier/coller l'adresse du salon dans votre client XMPP (en utilisant la fonctionnalité «rejoindre un salon»).

en	PeerTube plugin livechat

en	You can use the language selector in the left menu to view this documentation in different languages. Some translations are missing or incomplete. In this case, you'll see the English version of the text.
fr	Vous pouvez utiliser le sélecteur de langue dans le menu de gauche pour afficher cette documentation dans différentes langues. Certaines traductions sont manquantes ou incomplètes. Dans ce cas, vous verrez la version anglaise du texte.

en	Welcome the **Peertube Livechat Plugin** documentation.
fr	Bienvenue sur la documentation du **Plugin Peertube Livechat**.

en	[Peertube](https://joinpeertube.org/) is a decentralized streaming platform, that can provide both live streaming and VOD (Video On Demand) features. The present plugin adds chatting capatibilities to your Peertube installation, allowing viewers to interract with streamers.
fr	[Peertube](https://joinpeertube.org/) est une plateforme de streaming décentralisée, qui peut permettre de diffuser aussi bien des directs que de la vidéo à la demande (VOD : Video On Demand). Ce plugin permet d'ajouter la possibilité de tchatter à votre installation Peertube, permettant ainsi des interactions avec les streameur⋅euses.

en	To have a glimpse on this plugin capabilities, checkout the [introduction](/peertube-plugin-livechat/intro/). For more precise informations, please find bellow the summary of this documentation.
fr	Pour avoir un aperçu des possibilités de ce plugin, aller jeter un œil à [l'introduction](/peertube-plugin-livechat/fr/intro/). Pour des informations plus précises, vous trouverez plus bas le sommaire de cette documentation.

en	You can use the searchbox in the left menu to quickly find specific documentation parts.
fr	Vous pouvez utiliser la barre de recherche dans le menu gauche pour rapidement trouver des documentations spécifiques.

en	What is the livechat plugin?
fr	Qu'est ce que le plugin livechat ?

en	This [Peertube](https://joinpeertube.org/) plugin is meant to provide a chat system for Peertube videos.
fr	Ce plugin pour [Peertube](https://joinpeertube.org/) permet d'intégrer un système de «chat» (clavardage) à coté des vidéos.

en	By default, once you have installed the plugin on your Peertube instance, a chat room will automatically be created for each live stream.
fr	Par défaut, une fois le plugin installé sur votre instance Peertube, un salon de discussion sera automatiquement créé pour chaque diffusion en direct.

en	On the following screenshot, you can see a classic Peertube video page, with a chat room on the right (click on the picture to view it full screen):
fr	Sur la capture d'écran ci-dessous, vous pouvez voir une page classique de vidéo Peertube, avec un salon de discussion sur la droite (cliquez sur l'image pour la voir en plein écran) :

en	The chat room will be accessible for all viewers, even those who don't have an account on your instance. Those "anonymous" users just have to choose a nickname before they can begin talking in the chat.
fr	Le salon sera accessible pour les spectateur⋅rices, même si celleux-ci n'ont pas de compte sur votre instance. Ces utilisateur⋅rices «anonymes» auront juste à choisir un pseudonyme avant de pouvoir parler dans le tchat.

en	By default, the chat is displayed next to the video. But you can open it in another browser tab, using the button on top of it :
fr	Par défaut, le chat est affiché à côté de la vidéo. Mais vous pouvez l'ouvrir dans un autre onglet du navigateur, en utilisant le bouton situé au-dessus :

en	You can test the livechat plugin with this [demo page](https://www.yiny.org/w/399a8d13-d4cf-4ef2-b843-98530a8ccbae).
fr	Vous pouvez tester le plugin livechat via cette [page de démo](https://www.yiny.org/w/399a8d13-d4cf-4ef2-b843-98530a8ccbae).

en	Installation

en	As a Peertube administrator, you can setup this plugin on your instance simply by using the Peertube plugin marketplace included in the administration interface. Search for "livechat", then click "install": that's it!
fr	En tant qu'administrateur⋅rice Peertube, vous pouvez installer ce plugin sur votre instance simplement en utilisant la boutique de plugin incluse dans l'interface d'administration de Peertube. Cherchez «livechat», puis cliquez sur «installer» : et voilà !

en	![Livechat installation](/peertube-plugin-livechat/images/installation.png?classes=shadow,border&height=200px)
fr	![Installation livechat](/peertube-plugin-livechat/images/installation.png?classes=shadow,border&height=200px)

en	Livechat capabilities
fr	Possibilités du livechat

en	The plugin has many advanced features. As it is using the [XMPP](https://xmpp.org/) standard "under the hood", it is possible for Peertube administrators to allow advanced usages (connection using XMPP clients, chatbots, bridge to other chat protocols, ...). More information in the relevant sections of this documentation.
fr	Le plugin a de nombreuses fonctionnalités avancées. Il utilise le standard [XMPP](https://xmpp.org/) «sous le capot», ce qui permet aux adminstrateur⋅rices d'activer des fonctionnalités avancées (se connecter en utilisant des clients XMPP, bots de tchat, pont vers d'autres protocoles, ...). Plus d'informations dans les sections correspondantes de cette documentation.

en	Peertube is part of the fediverse: you can create a network of Peertube instances, sharing content between them.
fr	Peertube fait parti du fédiverse : vous pouvez créer un réseau d'instances Peertube, en partageant le contenu entre elles.

en	This plugin can handle federation: when viewing a livestream from a remote instance, you will join the chat room with your local account. You will be automatically connected with your current nickname and avatar.
fr	Ce plugin est capable de gérer la fédération : quand vous regardez un direct d'une instance distante, vous rejoindrez le tchat avec votre compte local. Vous serez automatiquement connecté avec votre pseudonyme et votre avatar.

en	Of course, for the federation to work, the plugin must be installed on both instances.
fr	Bien sûr, pour que la fédération fonctionne, le plugin doit être installé sur les deux instances.

en	Some times, you have to protect your community from bad people. As an instance administrator, you can choose to disallow federation for the livechat plugin. If remote actors behave badly, streamers, moderators and administrators can ban or mute users.
fr	Parfois, vous devez protéger votre communauté contre les personnes mal intentionnées. En tant qu'administrateur⋅rice d'instance, vous pouvez choisir de désactiver la fédération pour le plugin livechat. Si des acteur⋅rices distant⋅es se comportent mal, les streameur⋅euses, les modérateur⋅rices et les administrateur⋅rices peuvent bannir ou mettre en sourdine des utilisateur⋅ices.

en	This plugin comes with a built-in [chat bot](/peertube-plugin-livechat/documentation/user/streamers/bot/). Check its documentation for more information.
fr	Ce plugin via avec un [bot de tchat](/peertube-plugin-livechat/fr/documentation/user/streamers/bot/) intégré. Veuillez vous référer à sa documentation pour plus d'informations.

en	You can also plug in any other XMPP chat bot, using [XMPP External Components](https://prosody.im/doc/components). To do so, you just have to configure External Components access in the [plugin settings](/peertube-plugin-livechat/documentation/admin/settings).
fr	Vous pouvez également brancher tout autre bot de tchat XMPP, en utilisant les [Composants XMPP externes](https://prosody.im/doc/components). Pour cela, vous avez juste à configurer les accès des composants externes via la page des [paramètres du plugin](/peertube-plugin-livechat/fr/documentation/admin/settings).

en	When joining a room, you will see previous messages. Even those sent before you joined the room.
fr	En rejoignant un salon, vous verrez les anciens messages. Même ceux envoyés avant que vous ne rejoignez le salon.

en	This behaviour can be changed room by room, and default retention duration can be chosen by instance's administrators.
fr	Ce comportement peut changer salon par salon, et la durée de rétention peut être choisie par les administrateur⋅rices de l'instance.

en	Integrate the chat in your live stream
fr	Intégrer le tchat dans vos directs

en	When using software as [OBS](https://obsproject.com) for you live stream, you can embed the chat in the video stream. This is for example useful for replays.
fr	Lorsque vous utilisez un logiciel tel que [OBS](https://obsproject.com) pour votre diffusion en direct, vous pouvez intégrer le tchat dans le flux vidéo. C'est par exemple utile pour les rediffusions.

en	In the following screenshot, you can see a live replay, where the chat content is embeded on bottom of the video:
fr	Dans la capture d'écran suivante, vous pouvez voir une rediffusion de direct où le contenu du tchat est inclus dans le bas de la vidéo :

en	In the following screenshot, you can see an OBS setup, where the chat is included as a source in the current scene (background color can be changed, and can be transparent):
fr	Dans la capture d'écran suivante, vous pouvez voir une configuration OBS, où le chat est inclus en tant que source dans la scène actuelle (la couleur de fond peut être modifiée et peut être transparente) :

en	Other usages
fr	Autres usages

en	By default, each streamer will be able to activate/deactivate the chat for their live streams.
fr	Par défaut, chaque streameur⋅euse peut activer/désactiver le tchat pour leurs directs.

en	But on the instance level, administrators can choose to activate the chat for all videos (live and/or VOD).
fr	Mais au niveau de l'instance, les administrateur⋅rices peuvent choisir d'activer le tchat pour toutes les vidéos (directs et/ou vidéo à la demande).

en	You can even activate the chat for specific VOD videos. This is how the [demo](https://www.yiny.org/w/399a8d13-d4cf-4ef2-b843-98530a8ccbae) page works: it is not a live stream, but I have activated the chat specifically for this video.
fr	Vous pouvez également activer le tchat pour des vidéos à la demande spécifiques. C'est comme cela que fonctionne la page de [démo](https://www.yiny.org/w/399a8d13-d4cf-4ef2-b843-98530a8ccbae) : ce n'est pas un direct, mais j'ai activé le tchat spécifiquement pour cette vidéo.

en	Bug tracking / New features requests
fr	Évolutions / suivi des bugs

en	Bug tracking & new features
fr	Évolutions / Bugs

en	If you have new feature requests, bugs, or difficulties to setup the plugin, you can use the [Github issue tracker](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues). If possible, try using english or french.
fr	Si vous avez des demandes de nouvelles fonctionnalités, des bugs, ou des difficultés à installer et utiliser le plugin, vous pouvez utiliser l'outils [Github issue tracker](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues). Si possible, merci d'y écrire en anglais ; mais le français sera accepté.

en	To have a glimpse to the roadmap for upcoming features, please refer to:
fr	Pour avoir un aperçu de la feuille de routes pour les fonctionnalités à venir, vous pouvez vous référer à :

en	this [github project](https://github.com/users/JohnXLivingston/projects/1).
fr	ce [projet github](https://github.com/users/JohnXLivingston/projects/1).

en	the [milestones on github](https://github.com/JohnXLivingston/peertube-plugin-livechat/milestones).
fr	les [jalons sur github](https://github.com/JohnXLivingston/peertube-plugin-livechat/milestones).

en	If you are a webdesigner or a ConverseJS/Prosody/XMPP expert, and want to help improve this plugin, you are welcome.
fr	Si vous êtes webdesigner ou avez une expertise en ConverseJS/Prosody/XMPP et souhaitez participer à l'évolution de ce plugin, n'hésitez pas à me contacter.