Merge branch 'master' into testing

2024-09-03 19:46:02 +02:00 · 2024-04-16 21:47:30 +02:00 · 2024-04-16 21:47:30 +02:00 · dff27bce45
commit dff27bce45
parent 30065b6eea a75e6726bc
5 changed files with 219 additions and 29 deletions
--- a/ALL_README.md
+++ b/ALL_README.md
@ -0,0 +1,6 @@
+# All available README files by language
+
+- [Read the README in English](README.md)
+- [Lire le README en français](README_fr.md)
+- [Le o README en galego](README_gl.md)
+- [Leggi il “README” in italiano](README_it.md)
--- a/README.md
+++ b/README.md
@ -1,5 +1,5 @@
 <!--
-N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/readme_generator
+N.B.: This README was automatically generated by <https://github.com/YunoHost/apps/tree/master/tools/readme_generator>
 It shall NOT be edited by hand.
 -->

@ -9,10 +9,10 @@ It shall NOT be edited by hand.

 [![Install Mastodon with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=mastodon)

-*[Lire ce readme en français.](./README_fr.md)*
+*[Read this README is other languages.](./ALL_README.md)*

-> *This package allows you to install Mastodon quickly and simply on a YunoHost server.
-If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/install) to learn how to install it.*
+> *This package allows you to install Mastodon quickly and simply on a YunoHost server.*  
+> *If you don't have YunoHost, please consult [the guide](https://yunohost.org/install) to learn how to install it.*

 ## Overview

@ -22,7 +22,7 @@ It is a decentralized alternative to commercial platforms like Twitter and avoid

 **Shipped version:** 4.2.8~ynh2

-**Demo:** https://joinmastodon.org/
+**Demo:** <https://joinmastodon.org/>

 ## Screenshots

@ -30,19 +30,19 @@ It is a decentralized alternative to commercial platforms like Twitter and avoid

 ## Documentation and resources

-* Official app website: <https://joinmastodon.org/>
-* Official admin documentation: <https://docs.joinmastodon.org/>
-* Upstream app code repository: <https://github.com/mastodon/mastodon>
-* YunoHost Store: <https://apps.yunohost.org/app/mastodon>
-* Report a bug: <https://github.com/YunoHost-Apps/mastodon_ynh/issues>
+- Official app website: <https://joinmastodon.org/>
+- Official admin documentation: <https://docs.joinmastodon.org/>
+- Upstream app code repository: <https://github.com/mastodon/mastodon>
+- YunoHost Store: <https://apps.yunohost.org/app/mastodon>
+- Report a bug: <https://github.com/YunoHost-Apps/mastodon_ynh/issues>

 ## Developer info

-Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing).
+Please send your pull request to the [`testing` branch](https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing).

-To try the testing branch, please proceed like that.
+To try the `testing` branch, please proceed like that:

-``` bash
+```bash
 sudo yunohost app install https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing --debug
 or
 sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing --debug
--- a/README_fr.md
+++ b/README_fr.md
@ -1,6 +1,6 @@
 <!--
-N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/readme_generator
-It shall NOT be edited by hand.
+Nota bene : ce README est automatiquement généré par <https://github.com/YunoHost/apps/tree/master/tools/readme_generator>
+Il NE doit PAS être modifié à la main.
 -->

 # Mastodon pour YunoHost
@ -9,10 +9,10 @@ It shall NOT be edited by hand.

 [![Installer Mastodon avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=mastodon)

-*[Read this readme in english.](./README.md)*
+*[Lire le README dans d'autres langues.](./ALL_README.md)*

-> *Ce package vous permet d’installer Mastodon rapidement et simplement sur un serveur YunoHost.
-Si vous n’avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour savoir comment l’installer et en profiter.*
+> *Ce package vous permet d’installer Mastodon rapidement et simplement sur un serveur YunoHost.*  
+> *Si vous n’avez pas YunoHost, consultez [ce guide](https://yunohost.org/install) pour savoir comment l’installer et en profiter.*

 ## Vue d’ensemble

@ -23,7 +23,7 @@ Mastodon évite ainsi les risques qu'une seule société monopolise votre commun

 **Version incluse :** 4.2.8~ynh2

-**Démo :** https://joinmastodon.org/
+**Démo :** <https://joinmastodon.org/>

 ## Captures d’écran

@ -31,22 +31,22 @@ Mastodon évite ainsi les risques qu'une seule société monopolise votre commun

 ## Documentations et ressources

-* Site officiel de l’app : <https://joinmastodon.org/>
-* Documentation officielle de l’admin : <https://docs.joinmastodon.org/>
-* Dépôt de code officiel de l’app : <https://github.com/mastodon/mastodon>
-* YunoHost Store: <https://apps.yunohost.org/app/mastodon>
-* Signaler un bug : <https://github.com/YunoHost-Apps/mastodon_ynh/issues>
+- Site officiel de l’app : <https://joinmastodon.org/>
+- Documentation officielle de l’admin : <https://docs.joinmastodon.org/>
+- Dépôt de code officiel de l’app : <https://github.com/mastodon/mastodon>
+- YunoHost Store : <https://apps.yunohost.org/app/mastodon>
+- Signaler un bug : <https://github.com/YunoHost-Apps/mastodon_ynh/issues>

 ## Informations pour les développeurs

-Merci de faire vos pull request sur la [branche testing](https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing).
+Merci de faire vos pull request sur la [branche `testing`](https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing).

-Pour essayer la branche testing, procédez comme suit.
+Pour essayer la branche `testing`, procédez comme suit :

-``` bash
+```bash
 sudo yunohost app install https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing --debug
 ou
 sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing --debug
 ```

-**Plus d’infos sur le packaging d’applications :** <https://yunohost.org/packaging_apps>
+**Plus d’infos sur le packaging d’applications :** <https://yunohost.org/packaging_apps>
--- a/README_gl.md
+++ b/README_gl.md
@ -0,0 +1,92 @@
+<!--
+NOTA: Este README foi creado automáticamente por <https://github.com/YunoHost/apps/tree/master/tools/readme_generator>
+NON debe editarse manualmente.
+-->
+
+# Mastodon para YunoHost
+
+[![Nivel de integración](https://dash.yunohost.org/integration/mastodon.svg)](https://dash.yunohost.org/appci/app/mastodon) ![Estado de funcionamento](https://ci-apps.yunohost.org/ci/badges/mastodon.status.svg) ![Estado de mantemento](https://ci-apps.yunohost.org/ci/badges/mastodon.maintain.svg)
+
+[![Instalar Mastodon con YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=mastodon)
+
+*[Le este README en outros idiomas.](./ALL_README.md)*
+
+> *Este paquete permíteche instalar Mastodon de xeito rápido e doado nun servidor YunoHost.*  
+> *Se non usas YunoHost, le a [documentación](https://yunohost.org/install) para saber como instalalo.*
+
+## Vista xeral
+
+Mastodon is a free, open-source microblogging social network. It is a decentralized alternative to commercial platforms like Twitter and avoids the risks of a single company monopolizing your communication for commercial purposes. 
+
+**Versión proporcionada:** 4.2.8~ynh1
+
+**Demo:** <https://joinmastodon.org/>
+
+## Capturas de pantalla
+
+![Captura de pantalla de Mastodon](./doc/screenshots/mastodon.png)
+
+## Avisos / información importante
+
+## Important points to read before installing
+
+1. **Mastodon** require a dedicated **root domain**, eg. mastodon.domain.tld
+1. The user choosen during the installation is automatically created in Mastodon with admin rights
+1. At the end of the installation a mail is sent to the user with the automatically generated password
+1. It seems important to close the inscriptions for your Mastodon, so that it remains a private body. We invite you to block remote malicious instances from the administration interface. You can also add text on your home page.
+
+## Configuration
+
+### Install
+
+#### Using *screen* in case of disconnect
+```
+$ sudo apt-get install screen
+$ screen
+$ sudo yunohost app install https://github.com/YunoHost-Apps/mastodon_ynh.git
+```
+Recover after disconnect:
+```
+$ screen -d
+$ screen -r
+```
+
+### Update
+
+#### Using *screen* highly recommended
+
+`$ sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh --debug `
+
+### Administrate with tootctl
+
+`$ (cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl --help)`
+
+## YunoHost specific features
+
+#### Multi-users support
+
+LDAP authentication is activated. All YunoHost users can authenticate.
+
+Log-out from YunoHost's portal doesn't log out from Mastodon. See https://github.com/YunoHost/issues/issues/501
+
+## Documentación e recursos
+
+- Web oficial da app: <https://joinmastodon.org/>
+- Documentación oficial para admin: <https://docs.joinmastodon.org/>
+- Repositorio de orixe do código: <https://github.com/mastodon/mastodon>
+- Tenda YunoHost: <https://apps.yunohost.org/app/mastodon>
+- Informar dun problema: <https://github.com/YunoHost-Apps/mastodon_ynh/issues>
+
+## Info de desenvolvemento
+
+Envía a túa colaboración á [rama `testing`](https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing).
+
+Para probar a rama `testing`, procede deste xeito:
+
+```bash
+sudo yunohost app install https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing --debug
+ou
+sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing --debug
+```
+
+**Máis info sobre o empaquetado da app:** <https://yunohost.org/packaging_apps>
--- a/README_it.md
+++ b/README_it.md
@ -0,0 +1,92 @@
+<!--
+N.B.: Questo README è stato automaticamente generato da <https://github.com/YunoHost/apps/tree/master/tools/readme_generator>
+NON DEVE essere modificato manualmente.
+-->
+
+# Mastodon per YunoHost
+
+[![Livello di integrazione](https://dash.yunohost.org/integration/mastodon.svg)](https://dash.yunohost.org/appci/app/mastodon) ![Stato di funzionamento](https://ci-apps.yunohost.org/ci/badges/mastodon.status.svg) ![Stato di manutenzione](https://ci-apps.yunohost.org/ci/badges/mastodon.maintain.svg)
+
+[![Installa Mastodon con YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=mastodon)
+
+*[Leggi questo README in altre lingue.](./ALL_README.md)*
+
+> *Questo pacchetto ti permette di installare Mastodon su un server YunoHost in modo semplice e veloce.*  
+> *Se non hai YunoHost, consulta [la guida](https://yunohost.org/install) per imparare a installarlo.*
+
+## Panoramica
+
+Mastodon is a free, open-source microblogging social network. It is a decentralized alternative to commercial platforms like Twitter and avoids the risks of a single company monopolizing your communication for commercial purposes. 
+
+**Versione pubblicata:** 4.2.8~ynh1
+
+**Prova:** <https://joinmastodon.org/>
+
+## Screenshot
+
+![Screenshot di Mastodon](./doc/screenshots/mastodon.png)
+
+## Attenzione/informazioni importanti
+
+## Important points to read before installing
+
+1. **Mastodon** require a dedicated **root domain**, eg. mastodon.domain.tld
+1. The user choosen during the installation is automatically created in Mastodon with admin rights
+1. At the end of the installation a mail is sent to the user with the automatically generated password
+1. It seems important to close the inscriptions for your Mastodon, so that it remains a private body. We invite you to block remote malicious instances from the administration interface. You can also add text on your home page.
+
+## Configuration
+
+### Install
+
+#### Using *screen* in case of disconnect
+```
+$ sudo apt-get install screen
+$ screen
+$ sudo yunohost app install https://github.com/YunoHost-Apps/mastodon_ynh.git
+```
+Recover after disconnect:
+```
+$ screen -d
+$ screen -r
+```
+
+### Update
+
+#### Using *screen* highly recommended
+
+`$ sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh --debug `
+
+### Administrate with tootctl
+
+`$ (cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl --help)`
+
+## YunoHost specific features
+
+#### Multi-users support
+
+LDAP authentication is activated. All YunoHost users can authenticate.
+
+Log-out from YunoHost's portal doesn't log out from Mastodon. See https://github.com/YunoHost/issues/issues/501
+
+## Documentazione e risorse
+
+- Sito web ufficiale dell’app: <https://joinmastodon.org/>
+- Documentazione ufficiale per gli amministratori: <https://docs.joinmastodon.org/>
+- Repository upstream del codice dell’app: <https://github.com/mastodon/mastodon>
+- Store di YunoHost: <https://apps.yunohost.org/app/mastodon>
+- Segnala un problema: <https://github.com/YunoHost-Apps/mastodon_ynh/issues>
+
+## Informazioni per sviluppatori
+
+Si prega di inviare la tua pull request alla [branch di `testing`](https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing).
+
+Per provare la branch di `testing`, si prega di procedere in questo modo:
+
+```bash
+sudo yunohost app install https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing --debug
+o
+sudo yunohost app upgrade mastodon -u https://github.com/YunoHost-Apps/mastodon_ynh/tree/testing --debug
+```
+
+**Maggiori informazioni riguardo il pacchetto di quest’app:** <https://yunohost.org/packaging_apps>