matty/peertube-plugin-livechat
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Fix translation conflict.

Browse Source
This commit is contained in:
John Livingston 2023-07-17 13:08:40 +02:00
commit 996cd7efc0
No known key found for this signature in database
GPG Key ID: B17B5640CE66CDBC
36 changed files with 4371 additions and 2315 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

70
support/documentation/content/en/contributing/develop/_index.md
View File

@ -14,13 +14,42 @@ Pull Request must be done on the `main` branch.
Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated. Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.
{{% /notice %}} {{% /notice %}}
Prerequisite for building this plugin: ## Prerequisite for building this plugin
- you must have `npm` installed It is highly recommended to be familiar with following concepts:
- you must have python venv installed (`python3-venv` package on Debian for example)
- you must have `build-essential` installed
To clone the repository: * Git
* NodeJS
* NPM
* Typescript
To build the plugin, you must have following packages:
* `git`
* `npm` (>=8.x)
* `nodejs` (>=14.x)
* `build-essential`
The plugin needs to build an AppImage for the Prosody XMPP server.
It appears that the way this AppImage is build requires `apt` and `dpkg` commands.
So it will only work "out of the box" on Debian-like systems.
If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.
See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).
We will provide another solution as soon as possible.
Building this AppImage also requires following packages:
* `python3-venv`
* `squashfs-tools`
{{% notice info %}}
These dependencies were tested on a Debian Bullseye.
If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.
{{% /notice }}
## Develop
Clone the repository, buid the plugin, and create your feature branch:
```bash ```bash
# Clone the repository. Dont forget the --recursive to clone submodules. # Clone the repository. Dont forget the --recursive to clone submodules.
@ -43,8 +72,8 @@ git push --set-upstream me my_development
``` ```
Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request. 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 Once you are ready for a code review before merge, submit a Pull Request.
link your PR to the issues it solves by using the GitHub syntax: "fixes #issue_number". In any case, please link your PR to the issues it solves by using the GitHub syntax: "fixes #issue_number".
The front-end code is in the `client` folder, the back-end code in `server`. There are some shared code in `shared` folder. The front-end code is in the `client` folder, the back-end code in `server`. There are some shared code in `shared` folder.
@ -59,8 +88,7 @@ NODE_ENV=dev npm run build
## ESBuild vs Typescript ## ESBuild vs Typescript
This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin. This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.
ESBuild can handle Typescript, but does not check types ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).
(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). 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. Then, if everything is okay, we run ESBuild to generate the compiled javascript.
@ -70,9 +98,7 @@ 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. 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. This permit to test more easily certain actions, for which it could normally take hours or days to wait.
To enable this mode, you juste have to create the 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).
`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file
(replacing `/var/www/peertube/storage/` by the correct path on your installation).
The simple existence of this file is sufficient to trigger the debug mode. 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. To make sure it's taken into account, you can restart your Peertube instance.
@ -88,11 +114,9 @@ This could cause security issues.
### Restart Prosody ### Restart Prosody
When debug mode is enabled, you can restart Prosody using this API call: When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.
`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.
This call don't need any authentificaiton. This call don't need any authentificaiton.
It can be done from a command line, for example using It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.
`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.
### Prosody debugger ### Prosody debugger
@ -117,24 +141,18 @@ Restart Peertube.
Start your debugger server. Start your debugger server.
For Prosody to connect to the debugger, call the API For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.
`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.
This call does not need any authentication. This call does not need any authentication.
It can be done from a command line, for example with It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.
`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. You can even configure your debug server to launch this request automatically.
Prosody will then restart, connecting to the debugger. Prosody will then restart, connecting to the debugger.
## Quick dev environment using Docker ## Quick dev environment using Docker
There is a tutorial, in french, on the 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.
[le 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.
A repo was made out of it, check out [pt-plugin-dev](https://codeberg.org/mose/pt-plugin-dev). A repo was made out of it, check out [pt-plugin-dev](https://codeberg.org/mose/pt-plugin-dev).
Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library. 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 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.
`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,
then restart containers.

158
support/documentation/po/livechat.ar.po
View File

@ -64,7 +64,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -90,34 +90,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -148,8 +229,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -187,8 +268,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -211,10 +291,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -252,11 +329,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -314,11 +389,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -337,10 +410,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -354,9 +424,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.ca.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.cs.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

865
support/documentation/po/livechat.de.po
View File

File diff suppressed because it is too large Load Diff

158
support/documentation/po/livechat.el.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

162
support/documentation/po/livechat.en.pot
View File

@ -7,7 +7,7 @@
msgid "" msgid ""
msgstr "" msgstr ""
"Project-Id-Version: peertube-plugin-livechat-documentation VERSION\n" "Project-Id-Version: peertube-plugin-livechat-documentation VERSION\n"
"POT-Creation-Date: 2023-07-14 19:55+0200\n" "POT-Creation-Date: 2023-07-17 12:46+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n" "Language-Team: LANGUAGE <LL@li.org>\n"
@ -61,9 +61,9 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, markdown-text, no-wrap
msgid "Develop" msgid "Develop"
msgstr "" msgstr ""
@ -87,34 +87,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap #, markdown-text, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap #, markdown-text, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -145,8 +226,8 @@ msgstr ""
#, markdown-text, no-wrap #, markdown-text, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -184,8 +265,7 @@ msgstr ""
#, markdown-text, no-wrap #, markdown-text, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -208,10 +288,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap #, markdown-text, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -249,11 +326,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap #, markdown-text, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -311,11 +386,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap #, markdown-text, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -334,10 +407,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, markdown-text, no-wrap #, markdown-text, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -351,9 +421,7 @@ msgstr ""
#, markdown-text, no-wrap #, markdown-text, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.eo.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

184
support/documentation/po/livechat.es.po
View File

@ -9,8 +9,7 @@ msgstr ""
"POT-Creation-Date: 2023-07-14 19:55+0200\n" "POT-Creation-Date: 2023-07-14 19:55+0200\n"
"PO-Revision-Date: 2023-07-17 10:58+0000\n" "PO-Revision-Date: 2023-07-17 10:58+0000\n"
"Last-Translator: Tony Simoes <asrmail@protonmail.com>\n" "Last-Translator: Tony Simoes <asrmail@protonmail.com>\n"
"Language-Team: Spanish <https://weblate.framasoft.org/projects/" "Language-Team: Spanish <https://weblate.framasoft.org/projects/peertube-livechat/peertube-plugin-livechat-documentation/es/>\n"
"peertube-livechat/peertube-plugin-livechat-documentation/es/>\n"
"Language: es\n" "Language: es\n"
"MIME-Version: 1.0\n" "MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n" "Content-Type: text/plain; charset=UTF-8\n"
@ -34,19 +33,13 @@ msgstr "Contáctame"
#: support/documentation/content/en/contact/_index.md #: support/documentation/content/en/contact/_index.md
#, no-wrap #, no-wrap
msgid "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).\n" msgid "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).\n"
msgstr "" msgstr "Si tiene alguna pregunta o si desea hablar sobre este plugin, puede unirse a esta sala XMPP con cualquier cliente Jabber.: [plugin-livechat-support@room.im.yiny.org](xmpp:plugin-livechat-support@room.im.yiny.org?join).\n"
"Si tiene alguna pregunta o si desea hablar sobre este plugin, puede unirse a "
"esta sala XMPP con cualquier cliente Jabber.: [plugin-livechat-support@room."
"im.yiny.org](xmpp:plugin-livechat-support@room.im.yiny.org?join).\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contact/_index.md #: support/documentation/content/en/contact/_index.md
#, no-wrap #, no-wrap
msgid "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/).\n" msgid "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/).\n"
msgstr "" msgstr "Si quieres apoyar financieramente el proyecto, puedes contactarme por correo electrónico en git.[at].john-livingston.fr, or check my [Liberapay profile](https://liberapay.com/JohnLivingston/).\n"
"Si quieres apoyar financieramente el proyecto, puedes contactarme por correo "
"electrónico en git.[at].john-livingston.fr, or check my [Liberapay "
"profile](https://liberapay.com/JohnLivingston/).\n"
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description
#: support/documentation/content/en/contributing/codeofconduct/_index.md #: support/documentation/content/en/contributing/codeofconduct/_index.md
@ -68,18 +61,11 @@ msgid ""
"Translations are available at [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations).\n" "Translations are available at [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations).\n"
"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.\n" "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.\n"
msgstr "" msgstr ""
"Este Código de Conducta es una adaptación del [Contributor " "Este Código de Conducta es una adaptación del [Contributor Covenant](https://www.contributor-covenant.org), version 2.1, disponible en [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).\n"
"Covenant](https://www.contributor-covenant.org), version 2.1, disponible en " "Las traducciones están a disposición en [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations).\n"
"[https://www.contributor-covenant.org/version/2/1/code_of_conduct." "Los casos de comportamiento abusivo, acosador o inaceptable se pueden informar a los líderes de la comunidad responsables de la aplicación por correo en git.[at].john-livingston.fr.\n"
"html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html)."
"\n"
"Las traducciones están a disposición en [https://www.contributor-covenant."
"org/translations](https://www.contributor-covenant.org/translations).\n"
"Los casos de comportamiento abusivo, acosador o inaceptable se pueden "
"informar a los líderes de la comunidad responsables de la aplicación por "
"correo en git.[at].john-livingston.fr.\n"
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -105,34 +91,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -163,8 +230,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -202,8 +269,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -226,10 +292,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -267,11 +330,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -329,11 +390,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -352,10 +411,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -369,9 +425,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.eu.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.fa.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.fi.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

507
support/documentation/po/livechat.fr.po
View File

@ -10,8 +10,7 @@ msgstr ""
"POT-Creation-Date: 2023-07-14 19:55+0200\n" "POT-Creation-Date: 2023-07-14 19:55+0200\n"
"PO-Revision-Date: 2023-07-17 10:59+0000\n" "PO-Revision-Date: 2023-07-17 10:59+0000\n"
"Last-Translator: John Livingston <git@john-livingston.fr>\n" "Last-Translator: John Livingston <git@john-livingston.fr>\n"
"Language-Team: French <https://weblate.framasoft.org/projects/" "Language-Team: French <https://weblate.framasoft.org/projects/peertube-livechat/peertube-plugin-livechat-documentation/fr/>\n"
"peertube-livechat/peertube-plugin-livechat-documentation/fr/>\n"
"Language: fr\n" "Language: fr\n"
"MIME-Version: 1.0\n" "MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n" "Content-Type: text/plain; charset=UTF-8\n"
@ -70,19 +69,11 @@ msgid ""
"Translations are available at [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations).\n" "Translations are available at [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations).\n"
"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.\n" "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.\n"
msgstr "" msgstr ""
"Ce code de conduite est adapté du [Contributor Covenant](https://www." "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).\n"
"contributor-covenant.org), version 2.1, disponible à l'adresse [https://www." "Les traductions sont disponibles à l'adresse [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations).\n"
"contributor-covenant.org/version/2/1/code_of_conduct.html](https://www." "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.\n"
"contributor-covenant.org/version/2/1/code_of_conduct.html).\n"
"Les traductions sont disponibles à l'adresse [https://www.contributor-"
"covenant.org/translations](https://www.contributor-covenant.org/"
"translations).\n"
"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.\n"
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -95,12 +86,8 @@ msgid ""
"Always talk about features you want to develop by creating/finding and commenting the issue tackling your problem\n" "Always talk about features you want to develop by creating/finding and commenting the issue tackling your problem\n"
"before you start working on it, and inform the community that you begin coding by claiming the issue.\n" "before you start working on it, and inform the community that you begin coding by claiming the issue.\n"
msgstr "" msgstr ""
"Toujours annoncer les fonctionnalités sur lesquelles vous voulez travailler " "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.\n"
"en créant un ticket ou en commentant un ticket existant, avant de commencer " "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.\n"
"à travailler dessus.\n"
"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.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
@ -116,19 +103,26 @@ msgstr ""
"Jusqu'à mars 2023, il fallait contribuer sur la branche `develop`. Cette " "Jusqu'à mars 2023, il fallait contribuer sur la branche `develop`. Cette "
"procédure est désormais obsolète.\n" "procédure est désormais obsolète.\n"
#. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md
#, fuzzy, no-wrap
#| msgid "Prerequisite for building this plugin:\n"
msgid "Prerequisite for building this plugin"
msgstr "Pré-requis pour compiler le plugin :\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr "Pré-requis pour compiler le plugin :\n" msgstr ""
#. type: Bullet: '- ' #. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "you must have `npm` installed\n" msgid "Git\n"
msgstr "vous devez avoir installé `npm`\n" msgstr ""
#. type: Bullet: '- ' #. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n" msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
@ -136,17 +130,97 @@ msgstr ""
"vous devez avoir installé les venv python (paquet `python3-venv` sous Debian " "vous devez avoir installé les venv python (paquet `python3-venv` sous Debian "
"par exemple)\n" "par exemple)\n"
#. type: Bullet: '- ' msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "you must have `build-essential` installed\n" msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, fuzzy, no-wrap
#| msgid "ESBuild vs Typescript"
msgid "Typescript\n"
msgstr "ESBuild versus Typescript"
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, fuzzy, no-wrap
#| msgid "you must have `build-essential` installed\n"
msgid "`build-essential`\n"
msgstr "vous devez avoir `build-essential` installé\n" msgstr "vous devez avoir `build-essential` installé\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid ""
msgstr "Pour clôner le dépot :\n" "The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
@ -198,18 +272,19 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, fuzzy, no-wrap
#| msgid ""
#| "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
#| "Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n"
#| "link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
"Quand vous êtes prêt⋅e à montrer votre code pour avoir un retour, soumettez " "Quand vous êtes prêt⋅e à montrer votre code pour avoir un retour, soumettez une Pull Request *draft*.\n"
"une Pull Request *draft*.\n" "Quand vous êtes prêt⋅e pour une relecture de code avant merge, soumettez une Pull Request.\n"
"Quand vous êtes prêt⋅e pour une relecture de code avant merge, soumettez une " "Dans tous les cas, merci de lier votre Pull Request au ticket concerné en utilisant la syntax de GitHub : «fixes #issue_number».\n"
"Pull Request.\n"
"Dans tous les cas, merci de lier votre Pull Request au ticket concerné en "
"utilisant la syntax de GitHub : «fixes #issue_number».\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
@ -251,11 +326,16 @@ msgstr "ESBuild versus Typescript"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, fuzzy, no-wrap
#| msgid ""
#| "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
#| "ESBuild can handle Typescript, but does not check types\n"
#| "(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
#| "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
#| "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -283,20 +363,18 @@ msgid ""
"For example, some log files will rotate every two minutes, instead of once per day.\n" "For example, some log files will rotate every two minutes, instead of once per day.\n"
"This permit to test more easily certain actions, for which it could normally take hours or days to wait.\n" "This permit to test more easily certain actions, for which it could normally take hours or days to wait.\n"
msgstr "" msgstr ""
"Il existe un mode de debug pour le plugin, qui va raccourcir le délais de " "Il existe un mode de debug pour le plugin, qui va raccourcir le délais de certaines actions.\n"
"certaines actions.\n" "Par exemple, il va faire tourner les journaux toutes les deux minutes, au lieu de tous les jours.\n"
"Par exemple, il va faire tourner les journaux toutes les deux minutes, au " "Cela permet de tester plus facilement certaines actions, pour lesquelles il faudrait normalement attendre des heures ou des jours.\n"
"lieu de tous les jours.\n"
"Cela permet de tester plus facilement certaines actions, pour lesquelles il "
"faudrait normalement attendre des heures ou des jours.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, fuzzy, no-wrap
msgid "" #| msgid ""
"To enable this mode, you juste have to create the\n" #| "To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n" #| "`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n" #| "(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgid "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).\n"
msgstr "" msgstr ""
"Pour activer ce mode, il suffit de créer un fichier\n" "Pour activer ce mode, il suffit de créer un fichier\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode`" "`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode`"
@ -348,13 +426,17 @@ msgstr "Redémarrer Prosody"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, fuzzy, no-wrap
#| msgid ""
#| "When debug mode is enabled, you can restart Prosody using this API call:\n"
#| "`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
#| "This call don't need any authentificaiton.\n"
#| "It can be done from a command line, for example using\n"
#| "`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
"Pour redémarrer Prosody quand le mode debug est activé, vous pouvez appeler " "Pour redémarrer Prosody quand le mode debug est activé, vous pouvez appeler "
"l'API\n" "l'API\n"
@ -374,9 +456,7 @@ msgstr "debugger Prosody"
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "It is possible to connect the Prosody AppImage to a remote debugger using [MobDebug](https://luarocks.org/modules/paulclinger/mobdebug).\n" msgid "It is possible to connect the Prosody AppImage to a remote debugger using [MobDebug](https://luarocks.org/modules/paulclinger/mobdebug).\n"
msgstr "" msgstr "Il est possible de connecter l'AppImage Prosody à un debugger distant en utilisant [MobDebug](https://luarocks.org/modules/paulclinger/mobdebug).\n"
"Il est possible de connecter l'AppImage Prosody à un debugger distant en "
"utilisant [MobDebug](https://luarocks.org/modules/paulclinger/mobdebug).\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
@ -385,8 +465,7 @@ msgid ""
"To do so, you have to setup MobDebug in a folder that can be accessed by the `peertube` user.\n" "To do so, you have to setup MobDebug in a folder that can be accessed by the `peertube` user.\n"
"Then, add this in the `debub_mode` file:\n" "Then, add this in the `debub_mode` file:\n"
msgstr "" msgstr ""
"Pour cela, placer MobDebug dans un dossier accessible par le user `peertube`." "Pour cela, placer MobDebug dans un dossier accessible par le user `peertube`.\n"
"\n"
"Ensuite, ajouter cela dans le fichier `debug_mode` du plugin :\n" "Ensuite, ajouter cela dans le fichier `debug_mode` du plugin :\n"
#. type: Fenced code block (json) #. type: Fenced code block (json)
@ -413,9 +492,7 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "`host` and `port` are optional. `debugger_path` must point to the folder where the `MobDebug` `.lua` file is.\n" msgid "`host` and `port` are optional. `debugger_path` must point to the folder where the `MobDebug` `.lua` file is.\n"
msgstr "" msgstr "`host` et `port` sont optionnels. `debugger_path` doit pointer vers le dossier où se trouve le fichier `.lua` de `MobDebug`.\n"
"`host` et `port` sont optionnels. `debugger_path` doit pointer vers le "
"dossier où se trouve le fichier `.lua` de `MobDebug`.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
@ -431,24 +508,26 @@ msgstr "Lancer votre serveur de debug.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, fuzzy, no-wrap
#| msgid ""
#| "For Prosody to connect to the debugger, call the API\n"
#| "`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
#| "This call does not need any authentication.\n"
#| "It can be done from a command line, for example with\n"
#| "`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
#| "You can even configure your debug server to launch this request automatically.\n"
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
"Pour que Prosody se connecte au debugger, appelez l'API\n" "Pour que Prosody se connecte au debugger, appelez l'API\n"
"`http://votre_instance.tld/plugins/livechat/router/api/" "`http://votre_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"restart_prosody?debugger=true`.\n"
"Cet appel n'a pas besoin d'authentification.\n" "Cet appel n'a pas besoin d'authentification.\n"
"Il peut se faire depuis une ligne de commande, par exemple avec\n" "Il peut se faire depuis une ligne de commande, par exemple avec\n"
"`curl http://votre_instance.tld/plugins/livechat/router/api/" "`curl http://votre_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"restart_prosody?debugger=true`.\n" "Vous pouvez même configurer votre serveur de debuggage pour lancer cette commande automatiquement.\n"
"Vous pouvez même configurer votre serveur de debuggage pour lancer cette "
"commande automatiquement.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
@ -464,40 +543,34 @@ msgstr "Environnement de développement rapide via Docker"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, fuzzy, no-wrap
msgid "" #| msgid ""
"There is a tutorial, in french, on the\n" #| "There is a tutorial, in french, on the\n"
"[le 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)\n" #| "[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n" #| "that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgid "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.\n"
"Un tutoriel est disponible sur [le forum Peertube](https://framacolibri.org/" msgstr "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.\n"
"t/tutoriel-creer-un-environnement-de-developpement-de-plugin-peertube-rapidem"
"ent-en-utilisant-docker-et-qui-permet-de-tester-la-federation/17631) pour "
"expliquer comment monter rapidement un environnement de développement en "
"utilisant Docker.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "A repo was made out of it, check out [pt-plugin-dev](https://codeberg.org/mose/pt-plugin-dev).\n" msgid "A repo was made out of it, check out [pt-plugin-dev](https://codeberg.org/mose/pt-plugin-dev).\n"
msgstr "" msgstr "Un dépot a été crée sur la base de ce tutoriel : https://codeberg.org/mose/pt-plugin-dev\n"
"Un dépot a été crée sur la base de ce tutoriel : https://codeberg.org/mose/"
"pt-plugin-dev\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, fuzzy, no-wrap
#| msgid ""
#| "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
#| "There is a dirty hack in the plugin: just create a\n"
#| "`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
#| "then restart containers.\n"
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
"Note : pour une raison obscure, Prosody n'arrive pas à résoudre les adresses " "Note : pour une raison obscure, Prosody n'arrive pas à résoudre les adresses DNS des conteneurs quand la librairie lua-unbound est utilisée.\n"
"DNS des conteneurs quand la librairie lua-unbound est utilisée.\n" "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.\n"
"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.\n"
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
@ -697,13 +770,9 @@ msgid ""
"Please make sure to install a compatible version.\n" "Please make sure to install a compatible version.\n"
"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.\n" "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.\n"
msgstr "" msgstr ""
"Certaines distributions linux (comme Debian Bullseye par exemple) ont une " "Certaines distributions linux (comme Debian Bullseye par exemple) ont une version trop ancienne de `po4a`.\n"
"version trop ancienne de `po4a`.\n"
"Veillez à installer une version compatible.\n" "Veillez à installer une version compatible.\n"
"Si vous utilisez Debian Bullseye par exemple, vous pouvez télécharger le " "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.\n"
"fichier Bookworm po4a.deb depuis [https://packages.debian."
"org](https://packages.debian.org/bookworm/all/po4a/download), et l'installer "
"manuellement.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
@ -721,9 +790,7 @@ msgstr "npm run doc:translate\n"
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
#, no-wrap #, no-wrap
msgid "You can then preview the result using `hugo serve -s support/documentation/`, and using the language selector.\n" msgid "You can then preview the result using `hugo serve -s support/documentation/`, and using the language selector.\n"
msgstr "" msgstr "Vous pouvez ensuite prévisualiser le résultat en utilisant `hugo serve -s support/documentation/`, et en utilisant le sélecteur de langue.\n"
"Vous pouvez ensuite prévisualiser le résultat en utilisant `hugo serve -s "
"support/documentation/`, et en utilisant le sélecteur de langue.\n"
#. type: Title ## #. type: Title ##
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
@ -743,10 +810,7 @@ msgstr ""
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
#, no-wrap #, no-wrap
msgid "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.\n" msgid "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.\n"
msgstr "" msgstr "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`.\n"
"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`.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
@ -755,10 +819,8 @@ msgid ""
"You can use the `livechat_label` short code to use application strings.\n" "You can use the `livechat_label` short code to use application strings.\n"
"See here: [Documentation translation](/peertube-plugin-livechat/contributing/translate/#documentation-translation).\n" "See here: [Documentation translation](/peertube-plugin-livechat/contributing/translate/#documentation-translation).\n"
msgstr "" msgstr ""
"Vous pouvez utiliser le code court `livechat_label` pour utiliser des " "Vous pouvez utiliser le code court `livechat_label` pour utiliser des chaînes de l'application.\n"
"chaînes de l'application.\n" "Voir ici : [Traduction de la documentation](/peertube-plugin-livechat/fr/contribuer/translate/#documentation-translation).\n"
"Voir ici : [Traduction de la documentation](/peertube-plugin-livechat/fr/"
"contribuer/translate/#documentation-translation).\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
@ -767,10 +829,8 @@ msgid ""
"It is possible to prevent a file from beeing translating, using `livechatnotranslation: true` in the Yaml Font Matter section.\n" "It is possible to prevent a file from beeing translating, using `livechatnotranslation: true` in the Yaml Font Matter section.\n"
"See here: [Documentation translation](/peertube-plugin-livechat/contributing/translate/#documentation-translation).\n" "See here: [Documentation translation](/peertube-plugin-livechat/contributing/translate/#documentation-translation).\n"
msgstr "" msgstr ""
"Il est possible d'empêcher un fichier d'être traduit, en utilisant `" "Il est possible d'empêcher un fichier d'être traduit, en utilisant `livechatnotranslation : true` dans la section Yaml Font Matter.\n"
"livechatnotranslation : true` dans la section Yaml Font Matter.\n" "Voir ici : [Traduction de la documentation](/peertube-plugin-livechat/fr/contribuer/translate/#documentation-translation).\n"
"Voir ici : [Traduction de la documentation](/peertube-plugin-livechat/fr/"
"contribuer/translate/#documentation-translation).\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
@ -779,10 +839,8 @@ msgid ""
"Please use the `livechatnotranslation` option for technical documentation.\n" "Please use the `livechatnotranslation` option for technical documentation.\n"
"We don't want technical documentation to be translated, to avoid issues because of a wrong translation.\n" "We don't want technical documentation to be translated, to avoid issues because of a wrong translation.\n"
msgstr "" msgstr ""
"Veuillez utiliser l'option `livechatnotranslation` pour la documentation " "Veuillez utiliser l'option `livechatnotranslation` pour la documentation technique.\n"
"technique.\n" "Nous ne voulons pas traduire la documentation technique, afin d'éviter les problèmes liés à une mauvaise traduction.\n"
"Nous ne voulons pas traduire la documentation technique, afin d'éviter les "
"problèmes liés à une mauvaise traduction.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
@ -794,9 +852,7 @@ msgid ""
msgstr "" msgstr ""
"Évitez d'ajouter des sauts de ligne au milieu d'une phrase.\n" "Évitez d'ajouter des sauts de ligne au milieu d'une phrase.\n"
"En revanche, ajoutez un saut de ligne après chaque phrase d'un paragraphe.\n" "En revanche, ajoutez un saut de ligne après chaque phrase d'un paragraphe.\n"
"Cela facilite le travail des traducteur⋅rices : iels peuvent ainsi " "Cela facilite le travail des traducteur⋅rices : iels peuvent ainsi facilement vérifier qu'iels n'oublient pas une phrase lorsqu'iels traduisent un paragraphe.\n"
"facilement vérifier qu'iels n'oublient pas une phrase lorsqu'iels traduisent "
"un paragraphe.\n"
#. type: Title ### #. type: Title ###
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
@ -808,10 +864,7 @@ msgstr "Que faire si je ne peux pas utiliser hugo et/ou po4a ?"
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
#, no-wrap #, no-wrap
msgid "Just edit english markdown files, and specify that you can't build translations when you make your Pull Request.\n" msgid "Just edit english markdown files, and specify that you can't build translations when you make your Pull Request.\n"
msgstr "" msgstr "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.\n"
"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.\n"
#. type: Title ## #. type: Title ##
#: support/documentation/content/en/contributing/document/_index.md #: support/documentation/content/en/contributing/document/_index.md
@ -875,13 +928,7 @@ msgstr "Crédits"
#: support/documentation/content/en/credits/_index.md #: support/documentation/content/en/credits/_index.md
#, no-wrap #, no-wrap
msgid "[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.\n" msgid "[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.\n"
msgstr "" msgstr "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).\n"
"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).\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/credits/_index.md #: support/documentation/content/en/credits/_index.md
@ -1011,11 +1058,8 @@ msgid ""
"Enabling these features requires configuration changes on the server, and on the DNS records.\n" "Enabling these features requires configuration changes on the server, and on the DNS records.\n"
"It is not possible to configure this only from the Peertube interface, and it requires some basic system some basic system admin skills.\n" "It is not possible to configure this only from the Peertube interface, and it requires some basic system some basic system admin skills.\n"
msgstr "" msgstr ""
"L'activation de ces fonctionnalités demande des changements de configuration " "L'activation de ces fonctionnalités demande des changements de configuration sur le serveur, et sur les enregistrements DNS.\n"
"sur le serveur, et sur les enregistrements DNS.\n" "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.\n"
"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.\n"
#. type: Title ## #. type: Title ##
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
@ -1165,17 +1209,13 @@ msgstr ""
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
#, no-wrap #, no-wrap
msgid "The easiest way to do this is to add an SRV record for the \"room\" [subdomain](https://prosody.im/doc/dns#subdomains):\n" msgid "The easiest way to do this is to add an SRV record for the \"room\" [subdomain](https://prosody.im/doc/dns#subdomains):\n"
msgstr "" msgstr "Le plus simple pour cela est d'ajouter un enregistrement SRV pour le [sous-domaine](https ://prosody.im/doc/dns#subdomains) «room» :\n"
"Le plus simple pour cela est d'ajouter un enregistrement SRV pour le [sous-"
"domaine](https ://prosody.im/doc/dns#subdomains) «room» :\n"
#. type: Bullet: '* ' #. type: Bullet: '* '
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
#, no-wrap #, no-wrap
msgid "record name: _xmpp-server._tcp.room.your_instance.tld. (replace «your_instance.tld» by your instance uri)\n" msgid "record name: _xmpp-server._tcp.room.your_instance.tld. (replace «your_instance.tld» by your instance uri)\n"
msgstr "" msgstr "nom de l'enregistrement : _xmpp-server._tcp.room.votre_instance.tld. (remplacez «votre_instance.tld» par la valeur adéquate)\n"
"nom de l'enregistrement : _xmpp-server._tcp.room.votre_instance.tld. ("
"remplacez «votre_instance.tld» par la valeur adéquate)\n"
#. type: Bullet: '* ' #. type: Bullet: '* '
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
@ -1565,9 +1605,7 @@ msgstr "Méthode en cas d'utilisation de Docker"
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
#, no-wrap #, no-wrap
msgid "This method works with the officially supported [Docker guide](https://docs.joinpeertube.org/install/docker) from PeerTube.\n" msgid "This method works with the officially supported [Docker guide](https://docs.joinpeertube.org/install/docker) from PeerTube.\n"
msgstr "" msgstr "Cette méthode marche avec le [guide Docker](https://docs.joinpeertube.org/install/docker) officiel de Peertube.\n"
"Cette méthode marche avec le [guide Docker](https://docs.joinpeertube.org/"
"install/docker) officiel de Peertube.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
@ -1577,11 +1615,9 @@ msgid ""
"You can use a CNAME entry (or an A entry and a AAAA entry).\n" "You can use a CNAME entry (or an A entry and a AAAA entry).\n"
"This is necessary for Let's Encrypt to validate the domain for certificate generation.\n" "This is necessary for Let's Encrypt to validate the domain for certificate generation.\n"
msgstr "" msgstr ""
"Tout d'abord, assurez-vous de créer une entrée DNS pour `room.your_instance." "Tout d'abord, assurez-vous de créer une entrée DNS pour `room.your_instance.tld`, qui pointe vers votre serveur.\n"
"tld`, qui pointe vers votre serveur.\n"
"Vous pouvez utiliser une entrée CNAME (ou une entrée A et une entrée AAAA).\n" "Vous pouvez utiliser une entrée CNAME (ou une entrée A et une entrée AAAA).\n"
"Ceci est nécessaire pour que Let's Encrypt valide le domaine pour la " "Ceci est nécessaire pour que Let's Encrypt valide le domaine pour la génération du certificat.\n"
"génération du certificat.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
@ -1617,9 +1653,7 @@ msgstr "certbot\n"
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
#, no-wrap #, no-wrap
msgid "You will be presented with a series of prompts. Enter `2` for the authentication type:\n" msgid "You will be presented with a series of prompts. Enter `2` for the authentication type:\n"
msgstr "" msgstr "Une série d'invites vous sera présentée. Entrez `2` pour le type d'authentification :\n"
"Une série d'invites vous sera présentée. Entrez `2` pour le type "
"d'authentification :\n"
#. type: Fenced code block (text) #. type: Fenced code block (text)
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
@ -1687,13 +1721,9 @@ msgid ""
"*Note*: This will also make the files readable to the group with id 999 on the host system.\n" "*Note*: This will also make the files readable to the group with id 999 on the host system.\n"
"Check the groups on your system to assess this as a risk before running this command.\n" "Check the groups on your system to assess this as a risk before running this command.\n"
msgstr "" msgstr ""
"Exécutez la commande suivante à l'intérieur du conteneur certbot pour donner " "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.\n"
"un accès en lecture aux nouveaux certificats et clés privées au groupe " "*Note* : Cette commande rendra également les fichiers accessibles en lecture au groupe dont l'identifiant est 999 sur le système hôte.\n"
"peertube.\n" "Vérifiez les groupes sur votre système pour évaluer le risque avant d'exécuter cette commande.\n"
"*Note* : Cette commande rendra également les fichiers accessibles en "
"lecture au groupe dont l'identifiant est 999 sur le système hôte.\n"
"Vérifiez les groupes sur votre système pour évaluer le risque avant "
"d'exécuter cette commande.\n"
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
@ -1730,10 +1760,8 @@ msgid ""
"Modify your `docker-compose.yml` file, changing the `entrypoint` line under the `certbot` service to the following.\n" "Modify your `docker-compose.yml` file, changing the `entrypoint` line under the `certbot` service to the following.\n"
"This is the same as the above, but to be automatically executed after every certificate renewal.\n" "This is the same as the above, but to be automatically executed after every certificate renewal.\n"
msgstr "" msgstr ""
"Modifiez votre fichier `docker-compose.yml`, en changeant la ligne " "Modifiez votre fichier `docker-compose.yml`, en changeant la ligne `entrypoint` sous le service `certbot` par ce qui suit.\n"
"`entrypoint` sous le service `certbot` par ce qui suit.\n" "C'est la même chose que ci-dessus, mais elle doit être exécutée automatiquement après chaque renouvellement de certificat.\n"
"C'est la même chose que ci-dessus, mais elle doit être exécutée "
"automatiquement après chaque renouvellement de certificat.\n"
#. type: Fenced code block (text) #. type: Fenced code block (text)
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
@ -1753,8 +1781,7 @@ msgid ""
"Continuing to modify `docker-compose.yml`, add the certbot certificate volume into the peertube container.\n" "Continuing to modify `docker-compose.yml`, add the certbot certificate volume into the peertube container.\n"
"It should look something like this:\n" "It should look something like this:\n"
msgstr "" msgstr ""
"En continuant à modifier `docker-compose.yml`, ajoutez le volume certbot " "En continuant à modifier `docker-compose.yml`, ajoutez le volume certbot dans le conteneur peertube.\n"
"dans le conteneur peertube.\n"
"Il devrait ressembler à ceci :\n" "Il devrait ressembler à ceci :\n"
#. type: Fenced code block (text) #. type: Fenced code block (text)
@ -1783,10 +1810,7 @@ msgstr "docker-compose down; docker-comopse up -d\n"
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
#, no-wrap #, no-wrap
msgid "In the livechat plugin settings from your PeerTube administration settings, set the certificate directory to the following:\n" msgid "In the livechat plugin settings from your PeerTube administration settings, set the certificate directory to the following:\n"
msgstr "" msgstr "Dans les paramètres du plugin livechat à partir des paramètres d'administration de PeerTube, définissez le répertoire des certificats comme suit :\n"
"Dans les paramètres du plugin livechat à partir des paramètres "
"d'administration de PeerTube, définissez le répertoire des certificats comme "
"suit :\n"
#. type: Fenced code block (text) #. type: Fenced code block (text)
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
@ -1798,9 +1822,7 @@ msgstr "/etc/letsencrypt/live\n"
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
#, no-wrap #, no-wrap
msgid "Save the plugin settings and verify Prosody can see the certificates:\n" msgid "Save the plugin settings and verify Prosody can see the certificates:\n"
msgstr "" msgstr "Sauvegardez les paramètres du plugin et vérifiez que Prosody peut voir les certificats :\n"
"Sauvegardez les paramètres du plugin et vérifiez que Prosody peut voir les "
"certificats :\n"
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
#: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md #: support/documentation/content/en/documentation/admin/advanced/xmpp_clients.md
@ -1874,8 +1896,7 @@ msgid ""
"When pressing the «List rooms» button, all existing chatrooms will be listed.\n" "When pressing the «List rooms» button, all existing chatrooms will be listed.\n"
"You can then find them and moderated them.\n" "You can then find them and moderated them.\n"
msgstr "" msgstr ""
"Lorsque vous appuyez sur le bouton \"Lister les salles\", toutes les salles " "Lorsque vous appuyez sur le bouton \"Lister les salles\", toutes les salles de chat existantes sont listées.\n"
"de chat existantes sont listées.\n"
"Vous pouvez alors les trouver et les modérer.\n" "Vous pouvez alors les trouver et les modérer.\n"
#. type: Title ## #. type: Title ##
@ -1888,9 +1909,7 @@ msgstr "Fédération"
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
#, no-wrap #, no-wrap
msgid "Following settings concern the federation with other Peertube instances, and other fediverse softwares.\n" msgid "Following settings concern the federation with other Peertube instances, and other fediverse softwares.\n"
msgstr "" msgstr "Les paramètres suivants concernent la fédération avec d'autres instances Peertube et d'autres logiciels du fediverse.\n"
"Les paramètres suivants concernent la fédération avec d'autres instances "
"Peertube et d'autres logiciels du fediverse.\n"
#. type: Title ## #. type: Title ##
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
@ -1905,27 +1924,20 @@ msgid ""
"This feature enables a «share chat link» modal. With this modal, you can generate URLs to join the chat.\n" "This feature enables a «share chat link» modal. With this modal, you can generate URLs to join the chat.\n"
"The chat can be customized (readonly mode, use the current theme, ...).\n" "The chat can be customized (readonly mode, use the current theme, ...).\n"
msgstr "" msgstr ""
"Cette fonctionnalité permet d'activer une fenêtre modale \"partager le lien " "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 chat.\n"
"du chat\". Avec cette modale, vous pouvez générer des URL pour rejoindre le " "Le chat peut être personnalisé (mode lecture seule, utilisation du thème actuel, ...).\n"
"chat.\n"
"Le chat peut être personnalisé (mode lecture seule, utilisation du thème "
"actuel, ...).\n"
#. type: Plain text #. type: Plain text
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
#, no-wrap #, no-wrap
msgid "You can for example generate a readonly URL and use it in OBS to integrate the chat in your live stream!\n" msgid "You can for example generate a readonly URL and use it in OBS to integrate the chat in your live stream!\n"
msgstr "" msgstr "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 !\n"
"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 !\n"
#. type: Plain text #. type: Plain text
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
#, no-wrap #, no-wrap
msgid "This settings allows you to choose who can access this modal.\n" msgid "This settings allows you to choose who can access this modal.\n"
msgstr "" msgstr "Ce paramètre vous permet de choisir qui peut accéder à cette fenêtre modale.\n"
"Ce paramètre vous permet de choisir qui peut accéder à cette fenêtre modale."
"\n"
#. type: Plain text #. type: Plain text
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
@ -1962,9 +1974,7 @@ msgstr "Vous pouvez choisir le thème à utiliser pour ConverseJS :\n"
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
#, no-wrap #, no-wrap
msgid "Peertube theme: this is a special theme, made especially for peertube's integration.\n" msgid "Peertube theme: this is a special theme, made especially for peertube's integration.\n"
msgstr "" msgstr "Thème Peertube : il s'agit d'un thème spécial, conçu spécialement pour l'intégration dans Peertube.\n"
"Thème Peertube : il s'agit d'un thème spécial, conçu spécialement pour "
"l'intégration dans Peertube.\n"
#. type: Bullet: '- ' #. type: Bullet: '- '
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
@ -1976,8 +1986,7 @@ msgstr "Thème ConverseJS par défaut : c'est le thème ConverseJS par défaut.\
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
#, no-wrap #, no-wrap
msgid "ConverseJS concord theme: this is a theme provided by ConverseJS.\n" msgid "ConverseJS concord theme: this is a theme provided by ConverseJS.\n"
msgstr "" msgstr "Thème ConverseJS concord : il s'agit d'un thème fourni par ConverseJS.\n"
"Thème ConverseJS concord : il s'agit d'un thème fourni par ConverseJS.\n"
#. type: Title ## #. type: Title ##
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
@ -1992,19 +2001,14 @@ msgid ""
"The plugin comes with an AppImage that is used to run the [Prosody XMPP server](https://prosody.im).\n" "The plugin comes with an AppImage that is used to run the [Prosody XMPP server](https://prosody.im).\n"
"If this AppImage is not working, you can fallback to the Prosody that is packaged for your server. Just install the `prosody` package.\n" "If this AppImage is not working, you can fallback to the Prosody that is packaged for your server. Just install the `prosody` package.\n"
msgstr "" msgstr ""
"Le plugin est livré avec une AppImage qui est utilisée pour exécuter le [" "Le plugin est livré avec une AppImage qui est utilisée pour exécuter le [serveur XMPP Prosody](https://prosody.im).\n"
"serveur XMPP Prosody](https://prosody.im).\n" "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`.\n"
"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`.\n"
#. type: Plain text #. type: Plain text
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
#, no-wrap #, no-wrap
msgid "This settings should only be used if the plugin is broken, and waiting for a patch.\n" msgid "This settings should only be used if the plugin is broken, and waiting for a patch.\n"
msgstr "" msgstr "Ce paramètre ne devrait être utilisé que si le plugin est cassé et en attente d'un correctif.\n"
"Ce paramètre ne devrait être utilisé que si le plugin est cassé et en "
"attente d'un correctif.\n"
#. type: Plain text #. type: Plain text
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
@ -2013,20 +2017,14 @@ msgid ""
"This setting enable XMPP clients to connect to the built-in Prosody server.\n" "This setting enable XMPP clients to connect to the built-in Prosody server.\n"
"For now, this option **only allows connections from localhost clients**.\n" "For now, this option **only allows connections from localhost clients**.\n"
msgstr "" msgstr ""
"Ce paramètre permet aux clients XMPP de se connecter au serveur Prosody " "Ce paramètre permet aux clients XMPP de se connecter au serveur Prosody intégré.\n"
"intégré.\n" "Pour l'instant, cette option **n'autorise que les connexions des clients sur le localhost**.\n"
"Pour l'instant, cette option **n'autorise que les connexions des clients sur "
"le localhost**.\n"
#. type: Plain text #. type: Plain text
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
#, no-wrap #, no-wrap
msgid "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.\n" msgid "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.\n"
msgstr "" msgstr "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.\n"
"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.\n"
#. type: Plain text #. type: Plain text
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
@ -2035,26 +2033,20 @@ msgid ""
"This settings enable XMPP external components to connect to the server.\n" "This settings enable XMPP external components to connect to the server.\n"
"For now, this option **only allows connections from localhost components**.\n" "For now, this option **only allows connections from localhost components**.\n"
msgstr "" msgstr ""
"Ce paramètre permet aux composants externes XMPP de se connecter au serveur." "Ce paramètre permet aux composants externes XMPP de se connecter au serveur.\n"
"\n" "Pour l'instant, cette option **n'autorise que les connexions des composants sur localhost**.\n"
"Pour l'instant, cette option **n'autorise que les connexions des composants "
"sur localhost**.\n"
#. type: Plain text #. type: Plain text
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
#, no-wrap #, no-wrap
msgid "This feature could be used to connect bridges or bots.\n" msgid "This feature could be used to connect bridges or bots.\n"
msgstr "" msgstr "Cette fonction pourrait être utilisée pour connecter des ponts ou des robots.\n"
"Cette fonction pourrait être utilisée pour connecter des ponts ou des robots."
"\n"
#. type: Plain text #. type: Plain text
#: build/documentation/pot_in/documentation/admin/settings.md #: build/documentation/pot_in/documentation/admin/settings.md
#, no-wrap #, no-wrap
msgid "More informations on Prosody external components [here](https://prosody.im/doc/components).\n" msgid "More informations on Prosody external components [here](https://prosody.im/doc/components).\n"
msgstr "" msgstr "Plus d'informations sur les composants externes de Prosody [ici] (https://prosody.im/doc/components).\n"
"Plus d'informations sur les composants externes de Prosody [ici] "
"(https://prosody.im/doc/components).\n"
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description
#: support/documentation/content/en/documentation/_index.md #: support/documentation/content/en/documentation/_index.md
@ -2361,25 +2353,20 @@ msgid ""
"You can access room settings and moderation tools by opening the chat in a new window,\n" "You can access room settings and moderation tools by opening the chat in a new window,\n"
"and using the dropdown menu at the top right.\n" "and using the dropdown menu at the top right.\n"
msgstr "" msgstr ""
"Vous pouvez accéder aux paramètres de la salle et aux outils de modération " "Vous pouvez accéder aux paramètres de la salle et aux outils de modération en ouvrant le tchat dans une nouvelle fenêtre,\n"
"en ouvrant le tchat dans une nouvelle fenêtre,\n"
"et en utilisant le menu déroulant en haut à droite.\n" "et en utilisant le menu déroulant en haut à droite.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/documentation/user/moderation.md #: support/documentation/content/en/documentation/user/moderation.md
#, no-wrap #, no-wrap
msgid "You can list all existing chatrooms: in the plugin settings screen, there is a button «List rooms».\n" msgid "You can list all existing chatrooms: in the plugin settings screen, there is a button «List rooms».\n"
msgstr "" msgstr "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\".\n"
"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\".\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/documentation/user/moderation.md #: support/documentation/content/en/documentation/user/moderation.md
#, no-wrap #, no-wrap
msgid "You can delete old rooms: join the room, and use the menu on the top to destroy the room.\n" msgid "You can delete old rooms: join the room, and use the menu on the top to destroy the room.\n"
msgstr "" msgstr "Vous pouvez supprimer d'anciennes salles : rejoignez la salle, et utilisez le menu en haut pour détruire la salle.\n"
"Vous pouvez supprimer d'anciennes salles : rejoignez la salle, et utilisez "
"le menu en haut pour détruire la salle.\n"
#. type: Title ## #. type: Title ##
#: support/documentation/content/en/documentation/user/moderation.md #: support/documentation/content/en/documentation/user/moderation.md
@ -2394,11 +2381,8 @@ msgid ""
"All instance moderators and admins will be owner of created chat rooms.\n" "All instance moderators and admins will be owner of created chat rooms.\n"
"If the video is local (not from a remote Peertube), the video owner will be admin in the chat room.\n" "If the video is local (not from a remote Peertube), the video owner will be admin in the chat room.\n"
msgstr "" msgstr ""
"Tous les modérateur⋅rics et administrateur⋅rices de l'instance seront " "Tous les modérateur⋅rics et administrateur⋅rices de l'instance seront propriétaires des salons de discussion créés.\n"
"propriétaires des salons de discussion créés.\n" "Si la vidéo est locale (et ne provient pas d'un Peertube distant), le⋅a propriétaire de la vidéo sera l'administrateur⋅rice de l'espace de discussion.\n"
"Si la vidéo est locale (et ne provient pas d'un Peertube distant), le⋅a "
"propriétaire de la vidéo sera l'administrateur⋅rice de l'espace de "
"discussion.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/documentation/user/moderation.md #: support/documentation/content/en/documentation/user/moderation.md
@ -2407,11 +2391,8 @@ msgid ""
"You can use [ConverseJS moderation commands](https://conversejs.org/docs/html/features.html#moderating-chatrooms) to moderate the room.\n" "You can use [ConverseJS moderation commands](https://conversejs.org/docs/html/features.html#moderating-chatrooms) to moderate the room.\n"
"When you open the chat room in full screen, there will also be a menu with dedicated commands on the top right.\n" "When you open the chat room in full screen, there will also be a menu with dedicated commands on the top right.\n"
msgstr "" msgstr ""
"Vous pouvez utiliser les [commandes de modération " "Vous pouvez utiliser les [commandes de modération ConverseJS](https://conversejs.org/docs/html/features.html#moderating-chatrooms) pour modérer le salon.\n"
"ConverseJS](https://conversejs.org/docs/html/features.html#moderating-" "Lorsque vous ouvrez la salle de discussion en plein écran, un menu avec des commandes dédiées s'affiche en haut à droite.\n"
"chatrooms) pour modérer le salon.\n"
"Lorsque vous ouvrez la salle de discussion en plein écran, un menu avec des "
"commandes dédiées s'affiche en haut à droite.\n"
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description
#: support/documentation/content/en/documentation/user/obs.md #: support/documentation/content/en/documentation/user/obs.md
@ -2435,9 +2416,7 @@ msgstr "Overlay OBS"
#: support/documentation/content/en/documentation/user/obs.md #: support/documentation/content/en/documentation/user/obs.md
#, no-wrap #, no-wrap
msgid "If you are using OBS for streaming, you can easily include the chat in your stream.\n" msgid "If you are using OBS for streaming, you can easily include the chat in your stream.\n"
msgstr "" msgstr "Si vous utilisez OBS pour la diffusion en direct, vous pouvez facilement inclure le tchat dans votre flux vidéo.\n"
"Si vous utilisez OBS pour la diffusion en direct, vous pouvez facilement "
"inclure le tchat dans votre flux vidéo.\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/documentation/user/obs.md #: support/documentation/content/en/documentation/user/obs.md
@ -2446,11 +2425,8 @@ msgid ""
"You can use the «share chat link» feature to generate an URL to your chat.\n" "You can use the «share chat link» feature to generate an URL to your chat.\n"
"The button should be near the chat if you are the video owner (unless it was desactivated by your server admins).\n" "The button should be near the chat if you are the video owner (unless it was desactivated by your server admins).\n"
msgstr "" msgstr ""
"Vous pouvez utiliser la fonction \"partager le lien du tchat\" pour générer " "Vous pouvez utiliser la fonction \"partager le lien du tchat\" pour générer une URL vers votre tchat.\n"
"une URL vers votre tchat.\n" "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).\n"
"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).\n"
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/documentation/user/obs.md #: support/documentation/content/en/documentation/user/obs.md
@ -2469,11 +2445,8 @@ msgid ""
"You can use the «Transparent background» to have a transparent background in OBS.\n" "You can use the «Transparent background» to have a transparent background in OBS.\n"
"If you want to customize the background transparency, you can add this CSS in your OBS browser source's settings:\n" "If you want to customize the background transparency, you can add this CSS in your OBS browser source's settings:\n"
msgstr "" msgstr ""
"Vous pouvez utiliser l'option \"Fond transparent\" pour obtenir un fond " "Vous pouvez utiliser l'option \"Fond transparent\" pour obtenir un fond transparent dans OBS.\n"
"transparent dans OBS.\n" "Si vous souhaitez personnaliser la transparence de l'arrière-plan, vous pouvez ajouter ce CSS dans les paramètres de la source de votre navigateur OBS :\n"
"Si vous souhaitez personnaliser la transparence de l'arrière-plan, vous "
"pouvez ajouter ce CSS dans les paramètres de la source de votre navigateur "
"OBS :\n"
#. type: Fenced code block (css) #. type: Fenced code block (css)
#: support/documentation/content/en/documentation/user/obs.md #: support/documentation/content/en/documentation/user/obs.md
@ -2492,12 +2465,9 @@ msgid ""
"in the modal, check «use curent theme colors», then you can try to manually change color values in the URL.\n" "in the modal, check «use curent theme colors», then you can try to manually change color values in the URL.\n"
"You must use valid CSS color values, and they must be properly URL encoded.\n" "You must use valid CSS color values, and they must be properly URL encoded.\n"
msgstr "" msgstr ""
"Remarque : vous pouvez personnaliser les couleurs. Ce n'est pas encore " "Remarque : vous pouvez personnaliser les couleurs. Ce n'est pas encore documenté, mais vous pouvez essayer ceci :\n"
"documenté, mais vous pouvez essayer ceci :\n" "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.\n"
"dans la fenêtre modale, cochez \"utiliser les couleurs actuelles du thème\", " "Vous devez utiliser des valeurs de couleur CSS valides, et elles doivent être correctement encodées dans l'URL.\n"
"puis essayez de modifier manuellement les valeurs de couleur dans l'URL.\n"
"Vous devez utiliser des valeurs de couleur CSS valides, et elles doivent "
"être correctement encodées dans l'URL.\n"
#. type: Title ## #. type: Title ##
#: support/documentation/content/en/documentation/user/obs.md #: support/documentation/content/en/documentation/user/obs.md
@ -2512,10 +2482,7 @@ msgid ""
"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.\n" "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.\n"
"The compatibility with this plugin was added in recent versions.\n" "The compatibility with this plugin was added in recent versions.\n"
msgstr "" msgstr ""
"Vous pouvez utiliser l'extension [social_stream browser " "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.\n"
"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.\n"
"La compatibilité avec ce plugin a été ajoutée dans les versions récentes.\n" "La compatibilité avec ce plugin a été ajoutée dans les versions récentes.\n"
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description
@ -2740,8 +2707,6 @@ msgstr ""
"souhaitez participer à l'évolution de ce plugin, n'hésitez pas à me " "souhaitez participer à l'évolution de ce plugin, n'hésitez pas à me "
"contacter.\n" "contacter.\n"
#. type: Plain text
#: support/documentation/content/en/contributing/document/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"Some linux distro (like Debian Bullseye for example) have too old version of `po4a`.\n" "Some linux distro (like Debian Bullseye for example) have too old version of `po4a`.\n"

158
support/documentation/po/livechat.gd.po
View File

@ -64,7 +64,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -90,34 +90,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -148,8 +229,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -187,8 +268,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -211,10 +291,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -252,11 +329,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -314,11 +389,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -337,10 +410,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -354,9 +424,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.gl.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.hr.po
View File

@ -64,7 +64,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -90,34 +90,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -148,8 +229,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -187,8 +268,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -211,10 +291,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -252,11 +329,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -314,11 +389,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -337,10 +410,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -354,9 +424,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.hu.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.is.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.it.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.ja.po
View File

@ -71,7 +71,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -97,34 +97,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -155,8 +236,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -194,8 +275,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -218,10 +298,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -259,11 +336,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -321,11 +396,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -344,10 +417,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -361,9 +431,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.kab.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.nb.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.nl.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.nn.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.oc.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.pl.po
View File

@ -64,7 +64,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -90,34 +90,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -148,8 +229,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -187,8 +268,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -211,10 +291,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -252,11 +329,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -314,11 +389,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -337,10 +410,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -354,9 +424,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.pt.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.ru.po
View File

@ -64,7 +64,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -90,34 +90,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -148,8 +229,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -187,8 +268,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -211,10 +291,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -252,11 +329,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -314,11 +389,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -337,10 +410,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -354,9 +424,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.sq.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.sv.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.th.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.tok.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.uk.po
View File

@ -64,7 +64,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -90,34 +90,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -148,8 +229,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -187,8 +268,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -211,10 +291,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -252,11 +329,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -314,11 +389,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -337,10 +410,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -354,9 +424,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.vi.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.zh-Hans.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description

158
support/documentation/po/livechat.zh-Hant.po
View File

@ -63,7 +63,7 @@ msgid ""
"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.\n" "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.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: title #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Develop" msgid "Develop"
@ -89,34 +89,115 @@ msgstr ""
msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n" msgid "Until march 2023, contribution were made on the `develop` branch. This procedure is now deprecated.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Title ##
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "Prerequisite for building this plugin:\n" msgid "Prerequisite for building this plugin"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `npm` installed\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have python venv installed (`python3-venv` package on Debian for example)\n"
msgstr ""
#. type: Bullet: '- '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "you must have `build-essential` installed\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "To clone the repository:\n" msgid "It is highly recommended to be familiar with following concepts:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Git\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NodeJS\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "NPM\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Typescript\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "To build the plugin, you must have following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`git`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`npm` (>=8.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`nodejs` (>=14.x)\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`build-essential`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"The plugin needs to build an AppImage for the Prosody XMPP server.\n"
"It appears that the way this AppImage is build requires `apt` and `dpkg` commands.\n"
"So it will only work \"out of the box\" on Debian-like systems.\n"
"If you are using another Linux distribution, you can try to install `apt` and `dpkg` manually.\n"
"See for example this [Github issue](https://github.com/JohnXLivingston/peertube-plugin-livechat/issues/200).\n"
"We will provide another solution as soon as possible.\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Building this AppImage also requires following packages:\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`python3-venv`\n"
msgstr ""
#. type: Bullet: '* '
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "`squashfs-tools`\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid ""
"These dependencies were tested on a Debian Bullseye.\n"
"If there is some dependencies issues on your UNIX/Linux system, please open an issue on Github.\n"
"{{% /notice }}\n"
msgstr ""
#. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap
msgid "Clone the repository, buid the plugin, and create your feature branch:\n"
msgstr "" msgstr ""
#. type: Fenced code block (bash) #. type: Fenced code block (bash)
@ -147,8 +228,8 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n" "Once you are ready to show your code to ask for feedback, submit a *draft* Pull Request.\n"
"Once you are ready for a code review before merge, submit a Pull Request. In any case, please\n" "Once you are ready for a code review before merge, submit a Pull Request.\n"
"link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n" "In any case, please link your PR to the issues it solves by using the GitHub syntax: \"fixes #issue_number\".\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -186,8 +267,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n" "This plugin uses ESBuild for frontend code generation, as the official `peertube-plugin-quickstart` plugin.\n"
"ESBuild can handle Typescript, but does not check types\n" "ESBuild can handle Typescript, but does not check types (see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"(see [ESBuild documentation](https://esbuild.github.io/content-types/#typescript)).\n"
"That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n" "That's why we first compile Typescript with the `-noEmit` option, just to check types (`check:client:ts` in package.json file).\n"
"Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n" "Then, if everything is okay, we run ESBuild to generate the compiled javascript.\n"
msgstr "" msgstr ""
@ -210,10 +290,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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).\n"
"To enable this mode, you juste have to create the\n"
"`/var/www/peertube/storage/plugins/data/peertube-plugin-livechat/debug_mode` file\n"
"(replacing `/var/www/peertube/storage/` by the correct path on your installation).\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -251,11 +328,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"When debug mode is enabled, you can restart Prosody using this API call:\n" "When debug mode is enabled, you can restart Prosody using this API call: `http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"This call don't need any authentificaiton.\n" "This call don't need any authentificaiton.\n"
"It can be done from a command line, for example using\n" "It can be done from a command line, for example using `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody`.\n"
msgstr "" msgstr ""
#. type: Title ### #. type: Title ###
@ -313,11 +388,9 @@ msgstr ""
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid ""
"For Prosody to connect to the debugger, call the API\n" "For Prosody to connect to the debugger, call the API `http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"This call does not need any authentication.\n" "This call does not need any authentication.\n"
"It can be done from a command line, for example with\n" "It can be done from a command line, for example with `curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"`curl http://your_instance.tld/plugins/livechat/router/api/restart_prosody?debugger=true`.\n"
"You can even configure your debug server to launch this request automatically.\n" "You can even configure your debug server to launch this request automatically.\n"
msgstr "" msgstr ""
@ -336,10 +409,7 @@ msgstr ""
#. type: Plain text #. type: Plain text
#: support/documentation/content/en/contributing/develop/_index.md #: support/documentation/content/en/contributing/develop/_index.md
#, no-wrap #, no-wrap
msgid "" msgid "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.\n"
"There is a tutorial, in french, on the\n"
"[le 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)\n"
"that explains how to quickly build a dev env using Docker.\n"
msgstr "" msgstr ""
#. type: Plain text #. type: Plain text
@ -353,9 +423,7 @@ msgstr ""
#, no-wrap #, no-wrap
msgid "" msgid ""
"Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n" "Note: for an unknown reason, Prosody can't resolve containers DNS address when using the lua-unbound library.\n"
"There is a dirty hack in the plugin: just create a\n" "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.\n"
"`/data/plugins/data/peertube-plugin-livechat/no_lua_unbound` file in your docker-volumes,\n"
"then restart containers.\n"
msgstr "" msgstr ""
#. type: Yaml Front Matter Hash Value: description #. type: Yaml Front Matter Hash Value: description