mirror of
https://github.com/YunoHost-Apps/gotosocial_ynh.git
synced 2024-09-03 19:16:06 +02:00
Upgrade to v0.3.3 & add of instructions for administration to readmes (#22)
* added instructions for administration * correcting the layout * Auto-update README * Important disclaimer about the config.yaml * Auto-update README * fixed a lists inconsistency * Auto-update README * Added image description for the logo * Upgrade to version 0.3.3 (#21) * Upgrade to v0.3.3 * Auto-update README Co-authored-by: yunohost-bot <yunohost-bot@users.noreply.github.com> Co-authored-by: yunohost-bot <yunohost@yunohost.org> * Silence warnings (#24) * fix cli commands * fix an extra spacing * fix markdown link syntax * Auto-update README Co-authored-by: yunohost-bot <yunohost@yunohost.org> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: yunohost-bot <yunohost-bot@users.noreply.github.com> Co-authored-by: Éric Gaspar <46165813+ericgaspar@users.noreply.github.com>
This commit is contained in:
OniriCorpe
GitHub
parent
8006ef3f26
commit
f31f904284
15 changed files with 283 additions and 39 deletions
73
README.md
73
README.md
|
|
@ -19,12 +19,12 @@ GoToSocial is an [ActivityPub](https://activitypub.rocks/) social network server
|
||||||
|
|
||||||
With GoToSocial, you can keep in touch with your friends, post, read, and share images and articles. All without being tracked or advertised to!
|
With GoToSocial, you can keep in touch with your friends, post, read, and share images and articles. All without being tracked or advertised to!
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org).
|
Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org).
|
||||||
|
|
||||||
|
|
||||||
**Shipped version:** 0.3.1~ynh1
|
**Shipped version:** 0.3.3~ynh1
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -34,18 +34,79 @@ Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org).
|
||||||
|
|
||||||
## Disclaimers / important information
|
## Disclaimers / important information
|
||||||
|
|
||||||
GoToSocial is still in alpha and **may be unstable**.
|
GoToSocial is still in alpha and **may be unstable**. You can read [the roadmap](https://github.com/superseriousbusiness/gotosocial/blob/main/ROADMAP.md) to check the progress of GoToSocial's features.
|
||||||
|
|
||||||
GoToSocial require a **dedicated root domain**, for example: gotosocial.domain.tld.
|
GoToSocial require a **dedicated root domain**, for example: gotosocial.domain.tld.
|
||||||
|
|
||||||
This package is not-working single-sign on or LDAP integration.
|
This package is not-working SSO (single-sign on) or LDAP integration.
|
||||||
You will have a separate account from the rest of your Yunohost server, potentially with a different username and password.
|
You will have a separate account from the rest of your Yunohost server, potentially with a different username and password.
|
||||||
|
|
||||||
GoToSocial **does not provide a user interface**.
|
GoToSocial **does not provide a user interface**.
|
||||||
You will need to use a Mastodon-compatible client such as [Tusky](https://tusky.app/) on Android or an instance of [Pinafore](https://pinafore.social/) on the Web.
|
You will need to use a Mastodon-compatible client such as [Tusky](https://tusky.app/) on Android or an instance of [Pinafore](https://pinafore.social/) on the Web.
|
||||||
|
|
||||||
You can login to [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) to administrate your GoToSocial instance.
|
### Things to know
|
||||||
The [source code of this administration panel](https://github.com/superseriousbusiness/gotosocial-admin) is available on github.
|
|
||||||
|
#### Administration
|
||||||
|
|
||||||
|
You can login to [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) to administrate your GoToSocial instance.
|
||||||
|
[The source code of this administration panel](https://github.com/superseriousbusiness/gotosocial-admin) is available on github.
|
||||||
|
[The GTS admin panel documentation](https://docs.gotosocial.org/en/latest/admin/admin_panel/).
|
||||||
|
|
||||||
|
In this administration interface, you can configure the following things:
|
||||||
|
|
||||||
|
* The name of your instance
|
||||||
|
* Its description
|
||||||
|
* Your contact e-mail address
|
||||||
|
* The referring user
|
||||||
|
* Blocked domains (not to federate with)
|
||||||
|
|
||||||
|
#### Configuration
|
||||||
|
|
||||||
|
You can configure your instance using the config panel integrated in Yunohost, you will find it in the admin interface of your Yunohost by following these steps:
|
||||||
|
`Applications > gotosocial > Configure this app (Config Panel)`
|
||||||
|
|
||||||
|
In this control panel you can configure the following things:
|
||||||
|
|
||||||
|
* Account configuration :
|
||||||
|
* Are registrations open?
|
||||||
|
* Manual validation of registrations?
|
||||||
|
* Required reason for registration?
|
||||||
|
* Media configuration
|
||||||
|
* Maximum image size
|
||||||
|
* Maximum video size
|
||||||
|
* Minimum number of characters for media descriptions
|
||||||
|
* Maximum number of characters for media descriptions
|
||||||
|
* Number of days media can be cached
|
||||||
|
* Post configuration
|
||||||
|
* Maximum number of characters for a new post
|
||||||
|
* Maximum number of characters in a Content Warning / subject of a new post
|
||||||
|
* Maximum number of options for a poll
|
||||||
|
* Maximum number of characters for a poll option
|
||||||
|
* Maximum number of media that can be added to a post
|
||||||
|
|
||||||
|
Note: **Do not edit** the `config.yaml` file by hand. Always use this control panel instead. Otherwise your changes will be deleted at each update!
|
||||||
|
|
||||||
|
#### Command line (CLI)
|
||||||
|
|
||||||
|
To use the GoToSocial command line, you first need to place yourself in the folder of your instance:
|
||||||
|
`cd /var/www/gotosocial/` or `cd /var/www/gotosocial__x/` (where `x` is the installation number of your instance, in the case of multi-installation)
|
||||||
|
Feel free to refer to the [GoToSocial command line documentation](https://docs.gotosocial.org/en/latest/admin/cli/).
|
||||||
|
|
||||||
|
#### User creation
|
||||||
|
|
||||||
|
To create a new user, proceed as follows:
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
./gotosocial admin account create --username some_username --email someuser@example.org --password 'somelongandcomplicatedpassword'
|
||||||
|
|
||||||
|
./gotosocial admin account confirm --username some_username
|
||||||
|
```
|
||||||
|
|
||||||
|
And to promote them as an administrator of your instance:
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
./gotosocial admin account promote --username some_username
|
||||||
|
```
|
||||||
|
|
||||||
## Documentation and resources
|
## Documentation and resources
|
||||||
|
|
||||||
|
|
|
||||||
71
README_fr.md
71
README_fr.md
|
|
@ -15,12 +15,12 @@ Un serveur de réseau social basé sur [ActivityPub](https://activitypub.rocks/)
|
||||||
|
|
||||||
Avec GoToSocial, vous pouvez rester en contact avec vos amis, publier, lire et partager des images et des articles. Tout cela sans être pisté ni subir de publicité !
|
Avec GoToSocial, vous pouvez rester en contact avec vos amis, publier, lire et partager des images et des articles. Tout cela sans être pisté ni subir de publicité !
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Vous pouvez consulter la documentation à l'adresse : [docs.gotosocial.org](https://docs.gotosocial.org).
|
Vous pouvez consulter la documentation à l'adresse : [docs.gotosocial.org](https://docs.gotosocial.org).
|
||||||
|
|
||||||
|
|
||||||
**Version incluse :** 0.3.1~ynh1
|
**Version incluse :** 0.3.3~ynh1
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -30,7 +30,7 @@ Vous pouvez consulter la documentation à l'adresse : [docs.gotosocial.org](http
|
||||||
|
|
||||||
## Avertissements / informations importantes
|
## Avertissements / informations importantes
|
||||||
|
|
||||||
GoToSocial est encore en alpha et **peut etre instable**.
|
GoToSocial est encore en alpha et **peut etre instable**. Vous pouvez consulter [la roadmap](https://github.com/superseriousbusiness/gotosocial/blob/main/ROADMAP.md) pour vérifier l'avancée des fonctionnalités de GoToSocial.
|
||||||
|
|
||||||
GoToSocial nécessite un **nom de domaine dédié**, par exemple : gotosocial.domain.tld.
|
GoToSocial nécessite un **nom de domaine dédié**, par exemple : gotosocial.domain.tld.
|
||||||
|
|
||||||
|
|
@ -40,8 +40,69 @@ Vous aurez un compte séparé du reste de votre serveur Yunohost, avec potentiel
|
||||||
GoToSocial **ne dispose pas d'une interface utilisateur-ice**.
|
GoToSocial **ne dispose pas d'une interface utilisateur-ice**.
|
||||||
Vous devrez utiliser un client compatible avec Mastodon comme [Tusky](https://tusky.app/) sur Android ou une instance de [Pinafore](https://pinafore.social/) en Web.
|
Vous devrez utiliser un client compatible avec Mastodon comme [Tusky](https://tusky.app/) sur Android ou une instance de [Pinafore](https://pinafore.social/) en Web.
|
||||||
|
|
||||||
Vous pouvez vous connecter sur [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) pour administrer votre insance GoToSocial.
|
### Choses à savoir
|
||||||
Le [code source de cette interface d'administration](https://github.com/superseriousbusiness/gotosocial-admin) est consultable sur github.
|
|
||||||
|
#### Administration
|
||||||
|
|
||||||
|
Vous pouvez vous connecter sur [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) pour administrer votre insance GoToSocial.
|
||||||
|
[Le code source de cette interface d'administration](https://github.com/superseriousbusiness/gotosocial-admin) est consultable sur github.
|
||||||
|
[La documentation de l'interface d'administration de GoToSocial](https://docs.gotosocial.org/en/latest/admin/admin_panel/).
|
||||||
|
|
||||||
|
Dans cette interface d'administration, vous pouvez paramétrer les choses suivantes :
|
||||||
|
|
||||||
|
* Le nom de votre instance
|
||||||
|
* Sa description
|
||||||
|
* Votre adresse e-mail de contact
|
||||||
|
* L'utilisateurice référent-e
|
||||||
|
* Les domaines bloqués (pour ne pas fédérer avec)
|
||||||
|
|
||||||
|
#### Configuration
|
||||||
|
|
||||||
|
Vous pouvez configurer votre instance en utilisant le panneau de configuration intégré à YuNohost, vous le trouverez dans l'interface d'administration de votre Yunohost en suivant ces étapes :
|
||||||
|
`Applications > gotosocial > Configurez cette application (Panneau de configuration)`
|
||||||
|
|
||||||
|
Dans ce panneau de configuration, vous pouvez configurer les choses suivantes :
|
||||||
|
|
||||||
|
* Configuration des comptes :
|
||||||
|
* Ouverture des inscriptions ?
|
||||||
|
* Validation manuelle des inscriptions ?
|
||||||
|
* Motif d'inscription requis ?
|
||||||
|
* Configuration des médias
|
||||||
|
* Taille maximale des images
|
||||||
|
* Taille maximale des vidéos
|
||||||
|
* Nombre minimum de caractères pour les descriptions des médias
|
||||||
|
* Nombre maximum de caractères pour les descriptions des médias
|
||||||
|
* Nombre de jour de mise en cache des médias
|
||||||
|
* Configuration des posts
|
||||||
|
* Nombre maximum de caractères pour un nouveau post
|
||||||
|
* Nombre maximum de caractères dans un Content Warning / sujet d'un nouveau post
|
||||||
|
* Nombre maximum d'options pour un sondage
|
||||||
|
* Nombre maximum de caractères pour une option d'un sondage
|
||||||
|
* Nombre maximum de médias pouvant etre ajoutés à un post
|
||||||
|
|
||||||
|
N.B. : **N'éditez pas** le fichier `config.yaml` à la main. Utilisez toujours ce panneau de configuration à la place. Sinon vos modifications seront effacées à chaque mise à jour !
|
||||||
|
|
||||||
|
#### Ligne de commande
|
||||||
|
|
||||||
|
Pour utiliser la ligne de commande de GoToSocial, vous devez d'abord vous placer dans le répertoire de votre instance :
|
||||||
|
`cd /var/www/gotosocial/` ou `cd /var/www/gotosocial__x/` (où `x` est le numéro de votre installation, dans la cas d'une installation de multiples instances)
|
||||||
|
N'hésitez pas à vous référer à la [documentation de la ligne de commande de GoToSocial](https://docs.gotosocial.org/en/latest/admin/cli/).
|
||||||
|
|
||||||
|
#### Création de compte utilisateur
|
||||||
|
|
||||||
|
Pour créer un nouveau compte utilisateur, procédez comme suit :
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
./gotosocial admin account create --username nom_dutilisateur --email utilisateur@example.org --password 'UnMotDePasseTrèsComplexe'
|
||||||
|
|
||||||
|
./gotosocial admin account confirm --username nom_dutilisateur
|
||||||
|
```
|
||||||
|
|
||||||
|
Et pour promouvoir un compte en tant qu'administrateur de votre instance :
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
./gotosocial admin account promote --username nom_dutilisateur
|
||||||
|
```
|
||||||
|
|
||||||
## Documentations et ressources
|
## Documentations et ressources
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.1/gotosocial_0.3.1_linux_arm64.tar.gz
|
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.3/gotosocial_0.3.3_linux_arm64.tar.gz
|
||||||
SOURCE_SUM=c7022ed07a2e6e61c9205a907f477c78d8ea904c3ba968281f9d9affee3366bc
|
SOURCE_SUM=67a85a297112d1f6b249dfa1ed8ce4ac1f05ebbf2d8fbf7520415fefc201a708
|
||||||
SOURCE_SUM_PRG=sha256sum
|
SOURCE_SUM_PRG=sha256sum
|
||||||
SOURCE_FORMAT=tar.gz
|
SOURCE_FORMAT=tar.gz
|
||||||
SOURCE_EXTRACT=true
|
SOURCE_EXTRACT=true
|
||||||
SOURCE_IN_SUBDIR=false
|
SOURCE_IN_SUBDIR=false
|
||||||
SOURCE_FILENAME=gotosocial_0.3.1_linux_arm64.tar.gz
|
SOURCE_FILENAME=gotosocial_0.3.3_linux_arm64.tar.gz
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.1/gotosocial_0.3.1_linux_armv6.tar.gz
|
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.3/gotosocial_0.3.3_linux_armv6.tar.gz
|
||||||
SOURCE_SUM=8daf110b8a699dcd3e1e055702540d830de2bdeeb031972bbd9a9e8b0113a0c6
|
SOURCE_SUM=7495d86cea4eeaee43ae88e7cd65ca01615ef20967e8775b55580c9a7dc9e9de
|
||||||
SOURCE_SUM_PRG=sha256sum
|
SOURCE_SUM_PRG=sha256sum
|
||||||
SOURCE_FORMAT=tar.gz
|
SOURCE_FORMAT=tar.gz
|
||||||
SOURCE_EXTRACT=true
|
SOURCE_EXTRACT=true
|
||||||
SOURCE_IN_SUBDIR=false
|
SOURCE_IN_SUBDIR=false
|
||||||
SOURCE_FILENAME=gotosocial_0.3.1_linux_armv6.tar.gz
|
SOURCE_FILENAME=gotosocial_0.3.3_linux_armv6.tar.gz
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.1/gotosocial_0.3.1_linux_armv7.tar.gz
|
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.3/gotosocial_0.3.3_linux_armv7.tar.gz
|
||||||
SOURCE_SUM=05d8dbfe1c996587c6f6e56ae4f117602f6dfb8cfcca14e59a977a3006e9d5ad
|
SOURCE_SUM=dc5172a1bdbb8f8ccd1844237cdd8defea28148c201c00995036d670cfe4de14
|
||||||
SOURCE_SUM_PRG=sha256sum
|
SOURCE_SUM_PRG=sha256sum
|
||||||
SOURCE_FORMAT=tar.gz
|
SOURCE_FORMAT=tar.gz
|
||||||
SOURCE_EXTRACT=true
|
SOURCE_EXTRACT=true
|
||||||
SOURCE_IN_SUBDIR=false
|
SOURCE_IN_SUBDIR=false
|
||||||
SOURCE_FILENAME=gotosocial_0.3.1_linux_armv7.tar.gz
|
SOURCE_FILENAME=gotosocial_0.3.3_linux_armv7.tar.gz
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.1/gotosocial_0.3.1_linux_386.tar.gz
|
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.3/gotosocial_0.3.3_linux_386.tar.gz
|
||||||
SOURCE_SUM=b772d73f5608b5c87c9f2c6f473c794f9aa0eac507e43e139d34d19772e1c72c
|
SOURCE_SUM=a4e2adcad726b4e3a5b542bf0e8411e8c80f7c94905e9eb8d69ed5eea4e8c0f3
|
||||||
SOURCE_SUM_PRG=sha256sum
|
SOURCE_SUM_PRG=sha256sum
|
||||||
SOURCE_FORMAT=tar.gz
|
SOURCE_FORMAT=tar.gz
|
||||||
SOURCE_EXTRACT=true
|
SOURCE_EXTRACT=true
|
||||||
SOURCE_IN_SUBDIR=false
|
SOURCE_IN_SUBDIR=false
|
||||||
SOURCE_FILENAME=gotosocial_0.3.1_linux_386.tar.gz
|
SOURCE_FILENAME=gotosocial_0.3.3_linux_386.tar.gz
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.1/gotosocial_0.3.1_linux_amd64.tar.gz
|
SOURCE_URL=https://github.com/superseriousbusiness/gotosocial/releases/download/v0.3.3/gotosocial_0.3.3_linux_amd64.tar.gz
|
||||||
SOURCE_SUM=5854f47c6c92a28fc713e0e92db1510c2a05348185bf5dc41008f166296e0686
|
SOURCE_SUM=62a6e6d07f5d0fb704b51583b789363c3d2b6e1c483a9611e2984ec7c3162d29
|
||||||
SOURCE_SUM_PRG=sha256sum
|
SOURCE_SUM_PRG=sha256sum
|
||||||
SOURCE_FORMAT=tar.gz
|
SOURCE_FORMAT=tar.gz
|
||||||
SOURCE_EXTRACT=true
|
SOURCE_EXTRACT=true
|
||||||
SOURCE_IN_SUBDIR=false
|
SOURCE_IN_SUBDIR=false
|
||||||
SOURCE_FILENAME=gotosocial_0.3.1_linux_amd64.tar.gz
|
SOURCE_FILENAME=gotosocial_0.3.3_linux_amd64.tar.gz
|
||||||
|
|
|
||||||
|
|
@ -2,6 +2,6 @@ GoToSocial is an [ActivityPub](https://activitypub.rocks/) social network server
|
||||||
|
|
||||||
With GoToSocial, you can keep in touch with your friends, post, read, and share images and articles. All without being tracked or advertised to!
|
With GoToSocial, you can keep in touch with your friends, post, read, and share images and articles. All without being tracked or advertised to!
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org).
|
Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org).
|
||||||
|
|
|
||||||
|
|
@ -2,6 +2,6 @@ Un serveur de réseau social basé sur [ActivityPub](https://activitypub.rocks/)
|
||||||
|
|
||||||
Avec GoToSocial, vous pouvez rester en contact avec vos amis, publier, lire et partager des images et des articles. Tout cela sans être pisté ni subir de publicité !
|
Avec GoToSocial, vous pouvez rester en contact avec vos amis, publier, lire et partager des images et des articles. Tout cela sans être pisté ni subir de publicité !
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Vous pouvez consulter la documentation à l'adresse : [docs.gotosocial.org](https://docs.gotosocial.org).
|
Vous pouvez consulter la documentation à l'adresse : [docs.gotosocial.org](https://docs.gotosocial.org).
|
||||||
|
|
|
||||||
|
|
@ -1,12 +1,73 @@
|
||||||
GoToSocial is still in alpha and **may be unstable**.
|
GoToSocial is still in alpha and **may be unstable**. You can read [the roadmap](https://github.com/superseriousbusiness/gotosocial/blob/main/ROADMAP.md) to check the progress of GoToSocial's features.
|
||||||
|
|
||||||
GoToSocial require a **dedicated root domain**, for example: gotosocial.domain.tld.
|
GoToSocial require a **dedicated root domain**, for example: gotosocial.domain.tld.
|
||||||
|
|
||||||
This package is not-working single-sign on or LDAP integration.
|
This package is not-working SSO (single-sign on) or LDAP integration.
|
||||||
You will have a separate account from the rest of your Yunohost server, potentially with a different username and password.
|
You will have a separate account from the rest of your Yunohost server, potentially with a different username and password.
|
||||||
|
|
||||||
GoToSocial **does not provide a user interface**.
|
GoToSocial **does not provide a user interface**.
|
||||||
You will need to use a Mastodon-compatible client such as [Tusky](https://tusky.app/) on Android or an instance of [Pinafore](https://pinafore.social/) on the Web.
|
You will need to use a Mastodon-compatible client such as [Tusky](https://tusky.app/) on Android or an instance of [Pinafore](https://pinafore.social/) on the Web.
|
||||||
|
|
||||||
You can login to [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) to administrate your GoToSocial instance.
|
### Things to know
|
||||||
The [source code of this administration panel](https://github.com/superseriousbusiness/gotosocial-admin) is available on github.
|
|
||||||
|
#### Administration
|
||||||
|
|
||||||
|
You can login to [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) to administrate your GoToSocial instance.
|
||||||
|
[The source code of this administration panel](https://github.com/superseriousbusiness/gotosocial-admin) is available on github.
|
||||||
|
[The GTS admin panel documentation](https://docs.gotosocial.org/en/latest/admin/admin_panel/).
|
||||||
|
|
||||||
|
In this administration interface, you can configure the following things:
|
||||||
|
|
||||||
|
* The name of your instance
|
||||||
|
* Its description
|
||||||
|
* Your contact e-mail address
|
||||||
|
* The referring user
|
||||||
|
* Blocked domains (not to federate with)
|
||||||
|
|
||||||
|
#### Configuration
|
||||||
|
|
||||||
|
You can configure your instance using the config panel integrated in Yunohost, you will find it in the admin interface of your Yunohost by following these steps:
|
||||||
|
`Applications > gotosocial > Configure this app (Config Panel)`
|
||||||
|
|
||||||
|
In this control panel you can configure the following things:
|
||||||
|
|
||||||
|
* Account configuration :
|
||||||
|
* Are registrations open?
|
||||||
|
* Manual validation of registrations?
|
||||||
|
* Required reason for registration?
|
||||||
|
* Media configuration
|
||||||
|
* Maximum image size
|
||||||
|
* Maximum video size
|
||||||
|
* Minimum number of characters for media descriptions
|
||||||
|
* Maximum number of characters for media descriptions
|
||||||
|
* Number of days media can be cached
|
||||||
|
* Post configuration
|
||||||
|
* Maximum number of characters for a new post
|
||||||
|
* Maximum number of characters in a Content Warning / subject of a new post
|
||||||
|
* Maximum number of options for a poll
|
||||||
|
* Maximum number of characters for a poll option
|
||||||
|
* Maximum number of media that can be added to a post
|
||||||
|
|
||||||
|
Note: **Do not edit** the `config.yaml` file by hand. Always use this control panel instead. Otherwise your changes will be deleted at each update!
|
||||||
|
|
||||||
|
#### Command line (CLI)
|
||||||
|
|
||||||
|
To use the GoToSocial command line, you first need to place yourself in the folder of your instance:
|
||||||
|
`cd /var/www/gotosocial/` or `cd /var/www/gotosocial__x/` (where `x` is the installation number of your instance, in the case of multi-installation)
|
||||||
|
Feel free to refer to the [GoToSocial command line documentation](https://docs.gotosocial.org/en/latest/admin/cli/).
|
||||||
|
|
||||||
|
#### User creation
|
||||||
|
|
||||||
|
To create a new user, proceed as follows:
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
./gotosocial admin account create --username some_username --email someuser@example.org --password 'somelongandcomplicatedpassword'
|
||||||
|
|
||||||
|
./gotosocial admin account confirm --username some_username
|
||||||
|
```
|
||||||
|
|
||||||
|
And to promote them as an administrator of your instance:
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
./gotosocial admin account promote --username some_username
|
||||||
|
```
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,4 @@
|
||||||
GoToSocial est encore en alpha et **peut etre instable**.
|
GoToSocial est encore en alpha et **peut etre instable**. Vous pouvez consulter [la roadmap](https://github.com/superseriousbusiness/gotosocial/blob/main/ROADMAP.md) pour vérifier l'avancée des fonctionnalités de GoToSocial.
|
||||||
|
|
||||||
GoToSocial nécessite un **nom de domaine dédié**, par exemple : gotosocial.domain.tld.
|
GoToSocial nécessite un **nom de domaine dédié**, par exemple : gotosocial.domain.tld.
|
||||||
|
|
||||||
|
|
@ -8,5 +8,66 @@ Vous aurez un compte séparé du reste de votre serveur Yunohost, avec potentiel
|
||||||
GoToSocial **ne dispose pas d'une interface utilisateur-ice**.
|
GoToSocial **ne dispose pas d'une interface utilisateur-ice**.
|
||||||
Vous devrez utiliser un client compatible avec Mastodon comme [Tusky](https://tusky.app/) sur Android ou une instance de [Pinafore](https://pinafore.social/) en Web.
|
Vous devrez utiliser un client compatible avec Mastodon comme [Tusky](https://tusky.app/) sur Android ou une instance de [Pinafore](https://pinafore.social/) en Web.
|
||||||
|
|
||||||
Vous pouvez vous connecter sur [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) pour administrer votre insance GoToSocial.
|
### Choses à savoir
|
||||||
Le [code source de cette interface d'administration](https://github.com/superseriousbusiness/gotosocial-admin) est consultable sur github.
|
|
||||||
|
#### Administration
|
||||||
|
|
||||||
|
Vous pouvez vous connecter sur [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) pour administrer votre insance GoToSocial.
|
||||||
|
[Le code source de cette interface d'administration](https://github.com/superseriousbusiness/gotosocial-admin) est consultable sur github.
|
||||||
|
[La documentation de l'interface d'administration de GoToSocial](https://docs.gotosocial.org/en/latest/admin/admin_panel/).
|
||||||
|
|
||||||
|
Dans cette interface d'administration, vous pouvez paramétrer les choses suivantes :
|
||||||
|
|
||||||
|
* Le nom de votre instance
|
||||||
|
* Sa description
|
||||||
|
* Votre adresse e-mail de contact
|
||||||
|
* L'utilisateurice référent-e
|
||||||
|
* Les domaines bloqués (pour ne pas fédérer avec)
|
||||||
|
|
||||||
|
#### Configuration
|
||||||
|
|
||||||
|
Vous pouvez configurer votre instance en utilisant le panneau de configuration intégré à YuNohost, vous le trouverez dans l'interface d'administration de votre Yunohost en suivant ces étapes :
|
||||||
|
`Applications > gotosocial > Configurez cette application (Panneau de configuration)`
|
||||||
|
|
||||||
|
Dans ce panneau de configuration, vous pouvez configurer les choses suivantes :
|
||||||
|
|
||||||
|
* Configuration des comptes :
|
||||||
|
* Ouverture des inscriptions ?
|
||||||
|
* Validation manuelle des inscriptions ?
|
||||||
|
* Motif d'inscription requis ?
|
||||||
|
* Configuration des médias
|
||||||
|
* Taille maximale des images
|
||||||
|
* Taille maximale des vidéos
|
||||||
|
* Nombre minimum de caractères pour les descriptions des médias
|
||||||
|
* Nombre maximum de caractères pour les descriptions des médias
|
||||||
|
* Nombre de jour de mise en cache des médias
|
||||||
|
* Configuration des posts
|
||||||
|
* Nombre maximum de caractères pour un nouveau post
|
||||||
|
* Nombre maximum de caractères dans un Content Warning / sujet d'un nouveau post
|
||||||
|
* Nombre maximum d'options pour un sondage
|
||||||
|
* Nombre maximum de caractères pour une option d'un sondage
|
||||||
|
* Nombre maximum de médias pouvant etre ajoutés à un post
|
||||||
|
|
||||||
|
N.B. : **N'éditez pas** le fichier `config.yaml` à la main. Utilisez toujours ce panneau de configuration à la place. Sinon vos modifications seront effacées à chaque mise à jour !
|
||||||
|
|
||||||
|
#### Ligne de commande
|
||||||
|
|
||||||
|
Pour utiliser la ligne de commande de GoToSocial, vous devez d'abord vous placer dans le répertoire de votre instance :
|
||||||
|
`cd /var/www/gotosocial/` ou `cd /var/www/gotosocial__x/` (où `x` est le numéro de votre installation, dans la cas d'une installation de multiples instances)
|
||||||
|
N'hésitez pas à vous référer à la [documentation de la ligne de commande de GoToSocial](https://docs.gotosocial.org/en/latest/admin/cli/).
|
||||||
|
|
||||||
|
#### Création de compte utilisateur
|
||||||
|
|
||||||
|
Pour créer un nouveau compte utilisateur, procédez comme suit :
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
./gotosocial admin account create --username nom_dutilisateur --email utilisateur@example.org --password 'UnMotDePasseTrèsComplexe'
|
||||||
|
|
||||||
|
./gotosocial admin account confirm --username nom_dutilisateur
|
||||||
|
```
|
||||||
|
|
||||||
|
Et pour promouvoir un compte en tant qu'administrateur de votre instance :
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
./gotosocial admin account promote --username nom_dutilisateur
|
||||||
|
```
|
||||||
|
|
|
||||||
|
|
@ -6,7 +6,7 @@
|
||||||
"en": "An ActivityPub social network server, written in Golang.",
|
"en": "An ActivityPub social network server, written in Golang.",
|
||||||
"fr": "Un serveur de réseau social basé sur ActivityPub écrit en Golang."
|
"fr": "Un serveur de réseau social basé sur ActivityPub écrit en Golang."
|
||||||
},
|
},
|
||||||
"version": "0.3.1~ynh1",
|
"version": "0.3.3~ynh1",
|
||||||
"url": "https://github.com/superseriousbusiness/gotosocial",
|
"url": "https://github.com/superseriousbusiness/gotosocial",
|
||||||
"upstream": {
|
"upstream": {
|
||||||
"license": " AGPL-3.0-only",
|
"license": " AGPL-3.0-only",
|
||||||
|
|
|
||||||
|
|
@ -112,7 +112,7 @@ ynh_app_setting_set --app="$app" --key=port --value="$port"
|
||||||
#=================================================
|
#=================================================
|
||||||
ynh_script_progression --message="Installing dependencies..." --weight=5
|
ynh_script_progression --message="Installing dependencies..." --weight=5
|
||||||
|
|
||||||
ynh_install_app_dependencies "$pkg_dependencies"
|
ynh_exec_warn_less ynh_install_app_dependencies "$pkg_dependencies"
|
||||||
|
|
||||||
#=================================================
|
#=================================================
|
||||||
# CREATE DEDICATED USER
|
# CREATE DEDICATED USER
|
||||||
|
|
|
||||||
|
|
@ -127,7 +127,7 @@ chown -R "$app:www-data" "$datadir"
|
||||||
ynh_script_progression --message="Reinstalling dependencies..." --weight=5
|
ynh_script_progression --message="Reinstalling dependencies..." --weight=5
|
||||||
|
|
||||||
# Define and install dependencies
|
# Define and install dependencies
|
||||||
ynh_install_app_dependencies "$pkg_dependencies"
|
ynh_exec_warn_less ynh_install_app_dependencies "$pkg_dependencies"
|
||||||
|
|
||||||
#=================================================
|
#=================================================
|
||||||
# RESTORE THE POSTGRESQL DATABASE
|
# RESTORE THE POSTGRESQL DATABASE
|
||||||
|
|
|
||||||
|
|
@ -172,7 +172,7 @@ ynh_add_nginx_config
|
||||||
#=================================================
|
#=================================================
|
||||||
ynh_script_progression --message="Upgrading dependencies..."
|
ynh_script_progression --message="Upgrading dependencies..."
|
||||||
|
|
||||||
ynh_install_app_dependencies "$pkg_dependencies"
|
ynh_exec_warn_less ynh_install_app_dependencies "$pkg_dependencies"
|
||||||
|
|
||||||
#=================================================
|
#=================================================
|
||||||
# UPDATE A CONFIG FILE
|
# UPDATE A CONFIG FILE
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue