YunoHost-Apps/gotosocial_ynh
1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/gotosocial_ynh.git synced 2024-09-03 19:16:06 +02:00
Code Issues Activity Actions

Merge pull request #105 from YunoHost-Apps/testing

Browse source 
Testing v0.12.0~ynh2
This commit is contained in:
OniriCorpe 2023-10-24 00:39:34 +02:00 committed by GitHub
commit 2f78dee64f
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
10 changed files with 116 additions and 72 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
README.md
View file

@ -16,16 +16,14 @@ If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/in
## Overview ## Overview
GoToSocial is an [ActivityPub](https://activitypub.rocks/) social network server, written in Golang. GoToSocial is a fast [ActivityPub](https://activitypub.rocks/) social network server, written in Golang.
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!
![GoToSocial's logo, a stylized sloth head](./doc/logo_sloth.png)
Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org). Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org).
**Shipped version:** 0.12.0~ynh1 **Shipped version:** 0.12.0~ynh2
## Screenshots ## Screenshots
@ -35,21 +33,21 @@ Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org).
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 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 domain (or subdomain) name**, for example: gotosocial.example.com
This package is not-working SSO (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, [Feditext](https://fedi.software/@Feditext) for iOS or an instance of [Semaphore](https://semaphore.social/) on the Web.
### Things to know ### Things to know
#### Administration #### Administration
You can login with your admin user (the one automatically created at the instalaltion) to your-instance.com/**admin** or using the public instance [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) to administrate your GoToSocial instance. You can login with your admin user (the one automatically created at the instalaltion) to your-instance.com/**admin** to administrate your GoToSocial instance.
[The source code of this administration panel](https://github.com/superseriousbusiness/gotosocial-admin) is available on github. [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/). [The GTS admin panel documentation](https://docs.gotosocial.org/en/latest/admin/settings/).
In this administration interface, you can configure the following things: In this administration interface, you can configure the following things:
@ -61,15 +59,17 @@ In this administration interface, you can configure the following things:
#### Configuration #### 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: You can configure your instance using the config panel integrated in Yunohost, you will find it in the web admin interface of your Yunohost by following these steps:
`Applications > gotosocial > Configure this app (Config Panel)` `Applications > GoToSocial > Config Panel`
In this control panel you can configure the following things: In this control panel you can configure the following things (non-exhaustive list):
* Account configuration : * Account configuration :
* Are registrations open? * Are registrations open?
* Manual validation of registrations? * Manual validation of registrations?
* Required reason for registration? * Required reason for registration?
* Allow user custom CSS?
* Custom CSS max length?
* Media configuration * Media configuration
* Maximum image size * Maximum image size
* Maximum video size * Maximum video size
@ -82,26 +82,35 @@ In this control panel you can configure the following things:
* Maximum number of options for a poll * Maximum number of options for a poll
* Maximum number of characters for a poll option * Maximum number of characters for a poll option
* Maximum number of media that can be added to a post * Maximum number of media that can be added to a post
* Instance config
* Federation mode to use for this instance (blocklist / allowlist)
* Landing page user
* Exposed API options
* SMTP config
* Cache settings
* Advanced settings
* SameSite attribute
* Rate limit
Note: **Do not edit** the `config.yaml` file by hand. Always use this config panel instead. Otherwise your changes will be deleted at each update! Note: **Do NOT edit** the `config.yaml` file by hand. Always use this config panel instead. Otherwise your changes will be deleted at each update!
#### Command line (CLI) #### Command line (CLI)
To use the GoToSocial command line, you first need to place yourself in the folder of your instance: 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) `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/). Feel free to refer to the [GoToSocial command line documentation](https://docs.gotosocial.org/en/latest/admin/cli/).
#### User creation #### User creation
To create a new user, proceed as follows: To create a new user, proceed as follows:
``` bash ```bash
./gotosocial --config-path config.yaml admin account create --username some_username --email someuser@example.org --password 'SomeLongAndComplicatedPassword' ./gotosocial --config-path config.yaml admin account create --username some_username --email someuser@example.com --password 'SomeLongAndComplicatedPassword'
``` ```
And to promote them as an administrator of your instance: And to promote them as an administrator of your instance:
``` bash ```bash
./gotosocial --config-path config.yaml admin account promote --username some_username ./gotosocial --config-path config.yaml admin account promote --username some_username
``` ```

41
README_fr.md
View file

@ -16,16 +16,14 @@ Si vous n’avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) po
## Vue d’ensemble ## Vue d’ensemble
Un serveur de réseau social basé sur [ActivityPub](https://activitypub.rocks/) écrit en Golang. Un serveur de réseau social véloce basé sur [ActivityPub](https://activitypub.rocks/) écrit en Golang.
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é !
![Le logo de GoToSocial, une tête de paresseux stylisée](./doc/logo_sloth.png)
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.12.0~ynh1 **Version incluse :** 0.12.0~ynh2
## Captures d’écran ## Captures d’écran
@ -35,21 +33,21 @@ Vous pouvez consulter la documentation à l'adresse : [docs.gotosocial.org](http
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 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 (ou sous domaine) dédié**, par exemple : gotosocial.example.com
Ce paquet ne fonctionne pas avec l'authentification unique (SSO) ou l'intégration LDAP. Ce paquet ne fonctionne pas avec l'authentification unique (SSO) ou l'intégration LDAP.
Vous aurez un compte séparé du reste de votre serveur Yunohost, avec potentiellement un nom d'utilisateur et un mot de passe différent. Vous aurez un compte séparé du reste de votre serveur Yunohost, avec potentiellement un nom d'utilisateur et un mot de passe différent.
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, [Feditext](https://fedi.software/@Feditext) sur iOS ou une instance de [Semaphore](https://semaphore.social/) en Web.
### Choses à savoir ### Choses à savoir
#### Administration #### Administration
Vous pouvez vous connecter avec votre utilisateur admin (celui créé automatiquement à l'installation) à l'interface d'administration à l'adresse votre-instance.com/**admin** ou sur l'instance publique [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) pour administrer votre insance GoToSocial. Vous pouvez vous connecter avec votre utilisateur admin (celui créé automatiquement à l'installation) à l'interface d'administration à l'adresse votre-instance.com/**admin** pour administrer votre insance GoToSocial.
[Le code source de cette interface d'administration](https://github.com/superseriousbusiness/gotosocial-admin) est consultable sur github. [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/). [La documentation de l'interface d'administration de GoToSocial](https://docs.gotosocial.org/en/latest/admin/settings/).
Dans cette interface d'administration, vous pouvez paramétrer les choses suivantes : Dans cette interface d'administration, vous pouvez paramétrer les choses suivantes :
@ -61,15 +59,17 @@ Dans cette interface d'administration, vous pouvez paramétrer les choses suivan
#### Configuration #### 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 : Vous pouvez configurer votre instance en utilisant le panneau de configuration intégré à YuNohost, vous le trouverez dans l'interface d'administration Web de votre Yunohost en suivant ces étapes :
`Applications > gotosocial > Configurez cette application (Panneau de configuration)` `Applications > GoToSocial > Panneau de configuration`
Dans ce panneau de configuration, vous pouvez configurer les choses suivantes : Dans ce panneau de configuration, vous pouvez configurer les choses suivantes (liste non exhaustive) :
* Configuration des comptes : * Configuration des comptes :
* Ouverture des inscriptions ? * Ouverture des inscriptions ?
* Validation manuelle des inscriptions ? * Validation manuelle des inscriptions ?
* Motif d'inscription requis ? * Motif d'inscription requis ?
* Autoriser le CSS personnalisé des utilisateurices ?
* Longueur max du CSS personnalisé ?
* Configuration des médias * Configuration des médias
* Taille maximale des images * Taille maximale des images
* Taille maximale des vidéos * Taille maximale des vidéos
@ -82,26 +82,35 @@ Dans ce panneau de configuration, vous pouvez configurer les choses suivantes :
* Nombre maximum d'options pour un sondage * Nombre maximum d'options pour un sondage
* Nombre maximum de caractères pour une option d'un sondage * Nombre maximum de caractères pour une option d'un sondage
* Nombre maximum de médias pouvant etre ajoutés à un post * Nombre maximum de médias pouvant etre ajoutés à un post
* Configuration de l'instance
* Le mode de fédération à utiliser pour cette instance (blocklist / allowlist)
* Utilisateurice en tant que page d'accueil
* Options d'exposition de l'API
* Configuration SMTP
* Configuration du cache
* Configuration avancée
* SameSite attribute
* Rate limit
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 ! 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 #### Ligne de commande
Pour utiliser la ligne de commande de GoToSocial, vous devez d'abord vous placer dans le répertoire de votre instance : 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) `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/). 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 #### Création de compte utilisateur
Pour créer un nouveau compte utilisateur, procédez comme suit : Pour créer un nouveau compte utilisateur, procédez comme suit :
``` bash ```bash
./gotosocial --config-path config.yaml admin account create --username nom_dutilisateur --email utilisateur@example.org --password 'UnMotDePasseTrèsComplexe' ./gotosocial --config-path config.yaml admin account create --username nom_dutilisateur --email utilisateur@example.com --password 'UnMotDePasseTrèsComplexe'
``` ```
Et pour promouvoir un compte en tant qu'administrateur de votre instance : Et pour promouvoir un compte en tant qu'administrateur de votre instance :
``` bash ```bash
./gotosocial --config-path config.yaml admin account promote --username nom_dutilisateur ./gotosocial --config-path config.yaml admin account promote --username nom_dutilisateur
``` ```

8
conf/config.yaml
View file

@ -1,3 +1,11 @@
# ⚠️ IMPORTANT WARNING: do NOT edit this config file by hand,
# else your modifications will be ERASED at each update of the GTS package!
# Instead, use the config panel in your web admin interface:
# Applications ➡️ GoToSocial ➡️ Config panel ➡️ do your config edit ➡️ Save
# Most of the relevant settings are available in the config panel, if you're
# missing one, open an issue: https://github.com/YunoHost-Apps/gotosocial_ynh/issues
# GoToSocial # GoToSocial
# Copyright (C) 2021-2023 GoToSocial Authors admin@gotosocial.org # Copyright (C) 2021-2023 GoToSocial Authors admin@gotosocial.org

12
config_panel.toml
View file

@ -4,8 +4,8 @@ version = "1.0"
services = ["__APP__"] services = ["__APP__"]
name.en = "Main configuration" name.en = "Config panel"
name.fr = "Configuration principale" name.fr = "Panneau de configuration"
help = "Here you can easily configure some things about your GoToSocial instance." help = "Here you can easily configure some things about your GoToSocial instance."
@ -50,8 +50,8 @@ help.fr = "Les demandes d'inscription doivent-elles être motivées (par exemple
type = "select" type = "select"
[main.accounts.accounts_allow_custom_css] [main.accounts.accounts_allow_custom_css]
ask.en = "Allow custom CSS?" ask.en = "Allow user custom CSS?"
ask.fr = "Autoriser le CSS personnalisé ?" ask.fr = "Autoriser le CSS personnalisé des utilisateurices ?"
bind = "accounts-allow-custom-css:__FINALPATH__/config.yaml" bind = "accounts-allow-custom-css:__FINALPATH__/config.yaml"
choices = ["true", "false"] choices = ["true", "false"]
default = "false" default = "false"
@ -66,8 +66,8 @@ Quelle que soit la valeur de ce paramètre, tout CSS téléchargé ne sera pas f
type = "select" type = "select"
[main.accounts.accounts_custom_css_length] [main.accounts.accounts_custom_css_length]
ask.en = "Custom CSS length?" ask.en = "Custom CSS max length?"
ask.fr = "Longueur du CSS personnalisé ?" ask.fr = "Longueur max du CSS personnalisé ?"
bind = "accounts-custom-css-length:__FINALPATH__/config.yaml" bind = "accounts-custom-css-length:__FINALPATH__/config.yaml"
default = "10000" default = "10000"
help.en = "If accounts-allow-custom-css is 'true', this is the permitted length in characters for CSS uploaded by accounts on this instance. No effect if accounts-allow-custom-css is 'false'. Default: 10000" help.en = "If accounts-allow-custom-css is 'true', this is the permitted length in characters for CSS uploaded by accounts on this instance. No effect if accounts-allow-custom-css is 'false'. Default: 10000"

4
doc/DESCRIPTION.md
View file

@ -1,7 +1,5 @@
GoToSocial is an [ActivityPub](https://activitypub.rocks/) social network server, written in Golang. GoToSocial is a fast [ActivityPub](https://activitypub.rocks/) social network server, written in Golang.
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!
![GoToSocial's logo, a stylized sloth head](./doc/logo_sloth.png)
Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org). Documentation is at [docs.gotosocial.org](https://docs.gotosocial.org).

4
doc/DESCRIPTION_fr.md
View file

@ -1,7 +1,5 @@
Un serveur de réseau social basé sur [ActivityPub](https://activitypub.rocks/) écrit en Golang. Un serveur de réseau social véloce basé sur [ActivityPub](https://activitypub.rocks/) écrit en Golang.
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é !
![Le logo de GoToSocial, une tête de paresseux stylisée](./doc/logo_sloth.png)
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).

35
doc/DISCLAIMER.md
View file

@ -1,20 +1,20 @@
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 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 domain (or subdomain) name**, for example: gotosocial.example.com
This package is not-working SSO (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, [Feditext](https://fedi.software/@Feditext) for iOS or an instance of [Semaphore](https://semaphore.social/) on the Web.
### Things to know ### Things to know
#### Administration #### Administration
You can login with your admin user (the one automatically created at the instalaltion) to your-instance.com/**admin** or using the public instance [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) to administrate your GoToSocial instance. You can login with your admin user (the one automatically created at the instalaltion) to your-instance.com/**admin** to administrate your GoToSocial instance.
[The source code of this administration panel](https://github.com/superseriousbusiness/gotosocial-admin) is available on github. [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/). [The GTS admin panel documentation](https://docs.gotosocial.org/en/latest/admin/settings/).
In this administration interface, you can configure the following things: In this administration interface, you can configure the following things:
@ -26,15 +26,17 @@ In this administration interface, you can configure the following things:
#### Configuration #### 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: You can configure your instance using the config panel integrated in Yunohost, you will find it in the web admin interface of your Yunohost by following these steps:
`Applications > gotosocial > Configure this app (Config Panel)` `Applications > GoToSocial > Config Panel`
In this control panel you can configure the following things: In this control panel you can configure the following things (non-exhaustive list):
* Account configuration : * Account configuration :
* Are registrations open? * Are registrations open?
* Manual validation of registrations? * Manual validation of registrations?
* Required reason for registration? * Required reason for registration?
* Allow user custom CSS?
* Custom CSS max length?
* Media configuration * Media configuration
* Maximum image size * Maximum image size
* Maximum video size * Maximum video size
@ -47,25 +49,34 @@ In this control panel you can configure the following things:
* Maximum number of options for a poll * Maximum number of options for a poll
* Maximum number of characters for a poll option * Maximum number of characters for a poll option
* Maximum number of media that can be added to a post * Maximum number of media that can be added to a post
* Instance config
* Federation mode to use for this instance (blocklist / allowlist)
* Landing page user
* Exposed API options
* SMTP config
* Cache settings
* Advanced settings
* SameSite attribute
* Rate limit
Note: **Do not edit** the `config.yaml` file by hand. Always use this config panel instead. Otherwise your changes will be deleted at each update! Note: **Do NOT edit** the `config.yaml` file by hand. Always use this config panel instead. Otherwise your changes will be deleted at each update!
#### Command line (CLI) #### Command line (CLI)
To use the GoToSocial command line, you first need to place yourself in the folder of your instance: 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) `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/). Feel free to refer to the [GoToSocial command line documentation](https://docs.gotosocial.org/en/latest/admin/cli/).
#### User creation #### User creation
To create a new user, proceed as follows: To create a new user, proceed as follows:
``` bash ```bash
./gotosocial --config-path config.yaml admin account create --username some_username --email someuser@example.org --password 'SomeLongAndComplicatedPassword' ./gotosocial --config-path config.yaml admin account create --username some_username --email someuser@example.com --password 'SomeLongAndComplicatedPassword'
``` ```
And to promote them as an administrator of your instance: And to promote them as an administrator of your instance:
``` bash ```bash
./gotosocial --config-path config.yaml admin account promote --username some_username ./gotosocial --config-path config.yaml admin account promote --username some_username
``` ```

35
doc/DISCLAIMER_fr.md
View file

@ -1,20 +1,20 @@
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 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 (ou sous domaine) dédié**, par exemple : gotosocial.example.com
Ce paquet ne fonctionne pas avec l'authentification unique (SSO) ou l'intégration LDAP. Ce paquet ne fonctionne pas avec l'authentification unique (SSO) ou l'intégration LDAP.
Vous aurez un compte séparé du reste de votre serveur Yunohost, avec potentiellement un nom d'utilisateur et un mot de passe différent. Vous aurez un compte séparé du reste de votre serveur Yunohost, avec potentiellement un nom d'utilisateur et un mot de passe différent.
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, [Feditext](https://fedi.software/@Feditext) sur iOS ou une instance de [Semaphore](https://semaphore.social/) en Web.
### Choses à savoir ### Choses à savoir
#### Administration #### Administration
Vous pouvez vous connecter avec votre utilisateur admin (celui créé automatiquement à l'installation) à l'interface d'administration à l'adresse votre-instance.com/**admin** ou sur l'instance publique [gts.superseriousbusiness.org/admin](https://gts.superseriousbusiness.org/admin/) pour administrer votre insance GoToSocial. Vous pouvez vous connecter avec votre utilisateur admin (celui créé automatiquement à l'installation) à l'interface d'administration à l'adresse votre-instance.com/**admin** pour administrer votre insance GoToSocial.
[Le code source de cette interface d'administration](https://github.com/superseriousbusiness/gotosocial-admin) est consultable sur github. [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/). [La documentation de l'interface d'administration de GoToSocial](https://docs.gotosocial.org/en/latest/admin/settings/).
Dans cette interface d'administration, vous pouvez paramétrer les choses suivantes : Dans cette interface d'administration, vous pouvez paramétrer les choses suivantes :
@ -26,15 +26,17 @@ Dans cette interface d'administration, vous pouvez paramétrer les choses suivan
#### Configuration #### 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 : Vous pouvez configurer votre instance en utilisant le panneau de configuration intégré à YuNohost, vous le trouverez dans l'interface d'administration Web de votre Yunohost en suivant ces étapes :
`Applications > gotosocial > Configurez cette application (Panneau de configuration)` `Applications > GoToSocial > Panneau de configuration`
Dans ce panneau de configuration, vous pouvez configurer les choses suivantes : Dans ce panneau de configuration, vous pouvez configurer les choses suivantes (liste non exhaustive) :
* Configuration des comptes : * Configuration des comptes :
* Ouverture des inscriptions ? * Ouverture des inscriptions ?
* Validation manuelle des inscriptions ? * Validation manuelle des inscriptions ?
* Motif d'inscription requis ? * Motif d'inscription requis ?
* Autoriser le CSS personnalisé des utilisateurices ?
* Longueur max du CSS personnalisé ?
* Configuration des médias * Configuration des médias
* Taille maximale des images * Taille maximale des images
* Taille maximale des vidéos * Taille maximale des vidéos
@ -47,25 +49,34 @@ Dans ce panneau de configuration, vous pouvez configurer les choses suivantes :
* Nombre maximum d'options pour un sondage * Nombre maximum d'options pour un sondage
* Nombre maximum de caractères pour une option d'un sondage * Nombre maximum de caractères pour une option d'un sondage
* Nombre maximum de médias pouvant etre ajoutés à un post * Nombre maximum de médias pouvant etre ajoutés à un post
* Configuration de l'instance
* Le mode de fédération à utiliser pour cette instance (blocklist / allowlist)
* Utilisateurice en tant que page d'accueil
* Options d'exposition de l'API
* Configuration SMTP
* Configuration du cache
* Configuration avancée
* SameSite attribute
* Rate limit
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 ! 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 #### Ligne de commande
Pour utiliser la ligne de commande de GoToSocial, vous devez d'abord vous placer dans le répertoire de votre instance : 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) `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/). 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 #### Création de compte utilisateur
Pour créer un nouveau compte utilisateur, procédez comme suit : Pour créer un nouveau compte utilisateur, procédez comme suit :
``` bash ```bash
./gotosocial --config-path config.yaml admin account create --username nom_dutilisateur --email utilisateur@example.org --password 'UnMotDePasseTrèsComplexe' ./gotosocial --config-path config.yaml admin account create --username nom_dutilisateur --email utilisateur@example.com --password 'UnMotDePasseTrèsComplexe'
``` ```
Et pour promouvoir un compte en tant qu'administrateur de votre instance : Et pour promouvoir un compte en tant qu'administrateur de votre instance :
``` bash ```bash
./gotosocial --config-path config.yaml admin account promote --username nom_dutilisateur ./gotosocial --config-path config.yaml admin account promote --username nom_dutilisateur
``` ```

BIN
doc/logo_sloth.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 35 KiB

6
manifest.json
View file

@ -3,10 +3,10 @@
"id": "gotosocial", "id": "gotosocial",
"packaging_format": 1, "packaging_format": 1,
"description": { "description": {
"en": "ActivityPub social network server", "en": "Fast ActivityPub social network server written in Go",
"fr": "Serveur de réseau social basé sur ActivityPub" "fr": "Serveur de réseau social véloce basé sur ActivityPub écrit en Go"
}, },
"version": "0.12.0~ynh1", "version": "0.12.0~ynh2",
"url": "https://github.com/superseriousbusiness/gotosocial", "url": "https://github.com/superseriousbusiness/gotosocial",
"upstream": { "upstream": {
"license": "AGPL-3.0-only", "license": "AGPL-3.0-only",