Zen

Traduction

Anglais type: Plain text
For now, you only have the english version. To update documentation strings, and generate translations, you have to run the `doc-translate.sh` script.
0/1510 · 151

Connectez-vous pour enregistrer vos traductions.

Anglais Occitan Actions
The minimum required version for Hugo is 0.121.0. It was tested using version 0.132.2.
 
The used theme is [hugo-theme-relearn](https://mcshelby.github.io/hugo-theme-relearn). You should read its documentation before starting editing the documentation.
 
When a new plugin version is released, or when documentation is updated, plugin maintainers will merge the `main` branch to the `documentation` branch. This will trigger github and gitlab pipelines, and update published documentation.
 
Translations
 
The principal language is english (`en` code).
 
The `support/documentation/content/en` folder contains only english documentation files.
 
Documentation is translated using Weblate (see the [translation documentation](/peertube-plugin-livechat/contributing/translate/)). To do so, we use the [po4a tool](https://po4a.org/), as we will se later in this page.
 
Add a new language
 
In the `support/documentation/config.toml` file, please copy and modify the `[Languages.fr]` section.
 
If the translations are not complete, it does not matter, english will be used for missing strings.
 
Preview
 
To preview your modifications, just run:
 
hugo serve -s support/documentation/
 
Then open your browser on the address [http://localhost:1313/peertube-plugin-livechat/](http://localhost:1313/peertube-plugin-livechat/). This page will automatically refresh on each modification.
 
Update localization files and generate documentation translations
 
For now, you only have the english version. To update documentation strings, and generate translations, you have to run the `doc-translate.sh` script.
 
To do so, make sure you have `po4a` (version >= 0.69) installed on your computer.
 
Some linux distro (like Debian Bullseye for example) have too old version of `po4a`. Please make sure to install a compatible version. If you are using Debian Bullseye for example, you can download the Bookworm po4a.deb file from [https://packages.debian.org](https://packages.debian.org/bookworm/all/po4a/download), and install it manually.
 
To handle translations, just do:
 
npm run doc:translate
 
You can then preview the result using `hugo serve -s support/documentation/`, and using the language selector.
 
Write documentation
 
Just edit the english files in `support/documentation/content/en`.
 
Then, before commiting, always run `npm run doc:translate`, so that changes in english files can be propagated to the `support/documentation/po/livechat.en.pot` file.
 
You can use the `livechat_label` short code to use application strings. See here: [Documentation translation](/peertube-plugin-livechat/contributing/translate/#documentation-translation).
 
It is possible to prevent a file from beeing translating, using `livechatnotranslation: true` in the Yaml Font Matter section. See here: [Documentation translation](/peertube-plugin-livechat/contributing/translate/#documentation-translation).
 
Please use the `livechatnotranslation` option for technical documentation. We don't want technical documentation to be translated, to avoid issues because of a wrong translation.
 
To facilitate translators work, avoid making too long paragraphs.
 
For now, it is not possible to use Markdown tables: the translation tools will break them.
 
There may be links to this documentation elsewhere on the web. Try not to change the urls of the documentation pages. Or at the very least, put links to the new location on the previous url.
 
When a new feature is released, you can use the `livechat_version_notice` short code to display an infobox with the version with which the features is available. This short code takes the version number as parameter. Here is an example:
 

Chargement…

Avatar de l’utilisateur Aucun

Chaîne mise à jour dans le dépôt
For now, you only have the english version. To update documentation strings, and generate translations, you have to run the `doc-translate.sh` script.
 
Il y a un an
Parcourir toutes les modifications de chaînes

Glossaire

Anglais Occitan
only sonque / solament PeerTube
the lo-a-s PeerTube
to update metre à jorn PeerTube
you tu / vos PeerTube

Informations sur la chaîne

Description de la chaîne source
type: Plain text
Emplacement de la chaîne source
support/documentation/content/en/contributing/document/_index.md
Âge de la chaîne
Il y a un an
Date de dernière mise à jour
Il y a 2 mois
Âge de la chaîne source
Il y a un an
Fichier de traduction
support/documentation/po/livechat.oc.po, chaîne 89