Cette page est une traduction automatique de la page en anglais, qui fait foi. Lire la page en anglais
La page en anglais a changé depuis la traduction de ces sections :
Paramètres de l’instance
Les paramètres qui définissent la façon dont votre instance est exploitée : mode d’inscription, longueur des publications, langue par défaut, qui peut voir les fils, nom de l’instance, description, conditions, règles, thème et émojis personnalisés.
Configuration et paramètres de l’instance
Section intitulée « Configuration et paramètres de l’instance »| Configuration | Paramètres de l’instance | |
|---|---|---|
| Quoi | Comment le déploiement est construit : rôles, adaptateurs, points de terminaison, noms d’hôte, secrets | Comment l’instance est exploitée : mode d’inscription, limite de longueur des publications, langue par défaut, qui peut voir les fils, nom de l’instance, description et conditions |
| Où | Variables d’environnement MY_* et fichier de configuration (référence de configuration) |
La base de données. Chaque modification est conservée comme une révision |
| Modification | Prend effet au redémarrage du processus | Prend effet immédiatement avec my instance set, les écrans d’administration du client web ou l’API client (écrans d’administration et API client) |
| Si non défini | La valeur par défaut du schéma (le serveur ne démarre pas si la clé est obligatoire) | La valeur par défaut définie dans le code |
- Aucune clé n’est dans les deux. Aucune ne remplace l’autre. Vous ne pouvez pas donner un paramètre d’instance par une variable d’environnement ou le fichier de configuration, et vous ne pouvez pas stocker une valeur de configuration dans la base de données.
- Une valeur fixée par déploiement et qui change la structure du processus relève de la configuration ; une valeur qui change pendant que l’instance fonctionne est un paramètre d’instance.
Prérequis
Section intitulée « Prérequis »- La configuration est fournie comme décrit dans la référence de configuration (
my config check). - Le schéma est appliqué à la base de données (
my schema apply; voir Base de données).
Paramètres (une clé, une valeur)
Section intitulée « Paramètres (une clé, une valeur) »| Clé | Type | Par défaut | Description |
|---|---|---|---|
registration_mode |
open / approval / invite / closed |
approval |
Le mode d’inscription (inscription). Tant qu’un arrêt du service est annoncé et après sa fermeture, et sur un serveur d’une seule personne, la valeur effective est closed. La valeur stockée ne change pas, et annuler l’annonce ou désactiver single_user la rétablit. GET /instance et NodeInfo affichent la valeur effective |
max_status_length |
entier 1-100000 | 500 |
La longueur maximale d’une publication, en caractères |
default_locale |
balise de langue BCP 47 | en |
La locale par défaut. C’est la locale initiale de l’interface des nouveaux utilisateurs, et la valeur de repli lorsqu’aucun catalogue ne correspond à la préférence d’un utilisateur |
local_timeline_visibility |
off / signed_in / everyone |
everyone |
Qui peut voir le fil local (GET /api/v1/timelines/local) : personne, les utilisateurs connectés, ou tout le monde. off répond 404 et signed_in répond 401 aux visiteurs non connectés ; dans les deux cas la navigation le masque. Sauf si la valeur est everyone, la page d’accueil n’affiche aucun exemple de publication. Sur un serveur d’une seule personne, il se lit comme off |
federated_timeline_visibility |
off / signed_in / everyone |
signed_in |
Qui peut voir le fil fédéré (GET /api/v1/timelines/federated). Les valeurs signifient la même chose que pour le fil local, et il se lit aussi comme off sur un serveur d’une seule personne |
preview_image |
ID de média (vide = non défini) | vide | L’image d’aperçu de lien (og:image) pour les pages sans image propre, sous « Aperçus de liens » dans Paramètres → Général. Lorsqu’elle n’est pas définie, la miniature, puis le logo, puis l’image fournie sont utilisés (aperçus de liens) |
contact_account |
nom d’utilisateur d’un compte local (vide = non défini) | vide | Le compte pour contacter les opérateurs. Voir contact et miniature |
contact_email |
adresse e-mail (vide = non définie) | vide | L’adresse e-mail pour contacter les opérateurs. C’est aussi le Reply-To et la signature des e-mails que le serveur envoie |
thumbnail |
ID de média (vide = non défini) | vide | Une image qui représente l’instance (miniature), sur les pages À propos et d’accueil, et dans les aperçus de liens lorsque preview_image n’est pas défini |
remote_media_policy |
none / avatars / all |
none |
S’il faut conserver des copies des médias distants. none : le proxy de médias relaie chaque requête. avatars : les avatars, les en-têtes et les émojis personnalisés sont mis en cache dans le stockage de blobs pendant remote_media_cache_ttl_seconds. all : tous les médias distants le sont. La taille totale du cache est limitée par la configuration remote_media_cache_max_bytes |
remote_media_cache_ttl_seconds |
entier 60-31536000 (secondes) | 86400 |
Combien de temps les médias distants récupérés peuvent être conservés. C’est aussi le Cache-Control: max-age des réponses du proxy de médias, de sorte que les CDN et les navigateurs mettent en cache pendant ce temps |
remote_media_cache_max_bytes |
entier à partir de 1 (octets) | 1073741824 |
La limite de taille des copies de médias distants que le proxy de médias conserve. Le nettoyage horaire supprime les copies expirées, puis les moins récemment consultées au-delà de cette limite |
authorized_fetch |
true / false |
false |
Authorized Fetch (mode sécurisé). Lorsque true, un GET ActivityPub sans signature HTTP vérifiable reçoit 401 pour les objets et les collections, et un document minimal qui porte la clé pour l’acteur d’un utilisateur. L’acteur de l’instance renvoie toujours son document entier, afin que tout serveur puisse récupérer la clé pour vérifier une signature |
federation_mode |
off / inbound / outbound / both |
both |
Le sens de la fédération. off : aucune fédération. inbound : vous suivez et lisez des comptes distants, mais les publications, profils et réactions locaux ne sont pas envoyés, et les abonnements venant de l’extérieur sont refusés (Reject). outbound : vous acceptez les abonnements venant de l’extérieur et livrez les publications locales, mais les publications et réactions distantes ne sont pas reçues. both : envoyer et recevoir. Un changement prend effet aussitôt et exige la permission manage_settings |
federation_scope |
open / allowlist |
open |
Avec quels serveurs ce serveur fédère. open : tout serveur qu’aucune action de domaine ne suspend. allowlist : uniquement les domaines de la liste d’autorisation et leurs sous-domaines ; tout autre serveur est traité comme suspendu, et les GET ActivityPub exigent une signature d’un serveur autorisé quoi que dise authorized_fetch. Passer à allowlist met fin définitivement aux abonnements avec les serveurs qu’il coupe ; voir fédérer uniquement avec des serveurs autorisés. Un changement prend effet aussitôt et exige la permission manage_settings |
dynamic_client_registration |
true / false |
true |
Enregistrement dynamique de clients (RFC 7591). Tant que true, POST /oauth/register accepte l’enregistrement de clients publics sans authentification. Lorsque false, le point de terminaison refuse chaque requête avec 403 (access_denied) ; les clients déjà enregistrés continuent de fonctionner. Un job périodique supprime les clients enregistrés dynamiquement qui ne sont pas utilisés, selon la configuration dynamic_client_unredeemed_retention et dynamic_client_idle_retention. Un changement prend effet aussitôt et exige manage_settings |
domain_actions_visibility |
off / signed_in / everyone |
off |
Qui peut voir la liste des domaines visés par des actions (GET /api/v1/instance/domain_actions) : personne, les utilisateurs connectés, ou tout le monde (modération) |
domain_actions_rationale_visibility |
off / signed_in / everyone |
off |
Qui peut voir les commentaires publics de cette liste. Une personne qui ne peut pas voir la liste ne les voit jamais |
appeal_window_days |
entier 20-365 (jours) | 180 |
Combien de jours après une mesure la personne concernée peut contester (modération). Le changer change aussi la date limite des mesures déjà prises |
session_origins_retention_days |
entier 90-3650 (jours) | 180 |
Combien de jours après une connexion conserver l’adresse IP et le User-Agent de la connexion (modération) |
registration_origins_retention_days |
entier 90-3650 (jours) | 180 |
Combien de jours après l’inscription conserver l’adresse IP de l’inscription |
reports_retention_days |
entier 180-3650 (jours) | 365 |
Combien de jours après la dernière résolution conserver un signalement. Un signalement auquel renvoie une mesure est conservé aussi longtemps que la mesure |
moderation_actions_retention_days |
entier 180-3650 (jours) | 365 |
Combien de jours après la fin d’une mesure (la levée, l’expiration, ou l’examen d’une contestation, le plus tardif des trois) conserver les mesures contre les comptes et les contestations |
audit_log_retention_days |
entier 365-3650 (jours) | 730 |
Combien de jours après son enregistrement conserver une ligne du journal d’audit |
remote_status_retention_days |
entier 1-3650 (jours) | 90 |
Combien de jours une publication distante est conservée après sa publication lorsque rien sur cette instance n’y renvoie (une réponse locale, un boost, un favori, un marque-page, une notification, ou une discussion avec une publication locale) |
remote_status_max_retention_days |
entier 0-3650 (jours) | 0 |
Le plus grand nombre de jours qu’une publication distante est conservée après sa publication, même lorsque cette instance y renvoie. Les réponses, boosts, favoris et marque-pages locaux restent et l’affichent comme supprimée. 0 ne fixe aucune limite |
relay_status_retention_days |
entier 1-3650 (jours) | 7 |
Combien de jours est conservée une publication distante que seul un relais a apportée, lorsque rien sur cette instance n’y renvoie et qu’aucun compte local ne suit son auteur |
oauth_client_rate_limits |
paires client_id=requests séparées par des virgules |
vide | Plafonds sur les requêtes de l’API cliente des clients OAuth, pour retenir un client qui surcharge le serveur : les requêtes que tous ses utilisateurs ensemble peuvent faire en 5 minutes. Un changement met jusqu’à une minute à s’appliquer |
search_indexing |
allow / deny |
deny |
Si les moteurs de recherche peuvent indexer l’instance. Même avec allow, seuls les profils des comptes indexable et les publications public sont indexés (moteurs de recherche et robots d’IA) |
ai_usage |
allow / deny_training / deny |
deny |
La déclaration aux services d’IA. deny_training refuse l’entraînement ; deny refuse l’entraînement et l’utilisation par l’IA (recherche par IA, assistants, agents) |
indexable_default |
true / false |
false |
La valeur par défaut de indexable pour les nouveaux comptes. La changer ne change pas les comptes existants |
auto_delete_default_enabled |
true / false |
false |
Si les nouveaux comptes démarrent avec la suppression automatique de leurs anciennes publications activée. Avec les autres clés auto_delete_default_*, c’est la politique que reçoit un nouveau compte (suppression automatique des anciennes publications) |
auto_delete_default_min_age_days |
entier 1-3650 (jours) | 30 |
Combien de jours après sa publication la politique d’un nouveau compte supprime une publication |
auto_delete_default_keep_pinned, auto_delete_default_keep_bookmarked, auto_delete_default_keep_favourited |
true / false |
true |
Si la politique d’un nouveau compte conserve les publications que son auteur a épinglées, mises en marque-page ou en favori |
auto_delete_default_keep_media, auto_delete_default_keep_polls |
true / false |
false |
Si la politique d’un nouveau compte conserve les publications avec des médias ou un sondage |
auto_delete_default_keep_articles |
true / false |
true |
Si la politique d’un nouveau compte conserve les articles |
auto_delete_default_keep_public, auto_delete_default_keep_local, auto_delete_default_keep_unlisted, auto_delete_default_keep_private |
true / false |
false |
Si la politique d’un nouveau compte conserve les publications de cette visibilité |
auto_delete_default_keep_direct |
true / false |
true |
Si la politique d’un nouveau compte conserve les publications directes |
auto_delete_default_keep_min_boosts, auto_delete_default_keep_min_favourites |
entier 0-1000000 | 0 |
La politique d’un nouveau compte conserve une publication boostée ou mise en favori au moins ce nombre de fois. 0 ne fixe aucun seuil |
auto_delete_max_age_days |
entier 0-3650 (jours) | 0 |
Le plus grand nombre de jours après sa publication qu’une publication locale est conservée (maximum). 0 ne fixe aucun maximum |
auto_delete_max_allow_pinned |
true / false |
true |
Si les publications épinglées peuvent encore être conservées sous le maximum |
auto_delete_max_kept_pins |
entier 1-5 | 5 |
Combien d’épingles conservent des publications sous le maximum, les plus récemment épinglées d’abord. 5, le plus grand nombre d’épingles d’un compte, conserve toutes les publications épinglées |
auto_delete_max_allow_bookmarked, auto_delete_max_allow_favourited, auto_delete_max_allow_media, auto_delete_max_allow_polls |
true / false |
false |
Si les publications que l’auteur a mises en marque-page ou en favori, ou avec des médias ou un sondage, peuvent encore être conservées sous le maximum |
auto_delete_max_allow_articles |
true / false |
true |
Si les articles peuvent encore être conservés sous le maximum |
auto_delete_max_allow_visibilities |
true / false |
false |
Si les publications peuvent encore être conservées selon leur visibilité sous le maximum |
auto_delete_max_allow_thresholds |
true / false |
false |
Si les publications peuvent encore être conservées selon leurs boosts et favoris sous le maximum |
auto_delete_grace_days |
entier 0-365 (jours) | 30 |
Combien de jours un compte auquel le maximum s’applique pour la première fois conserve ses propres paramètres après en avoir été informé. Un changement ne déplace pas les dates des comptes déjà informés |
search_visibilities |
public / local / public,local |
public |
Quelles publications couvre la recherche en texte intégral d’un serveur doté d’un backend de recherche. Les publications unlisted, private et direct ne sont jamais couvertes, et seuls les comptes avec indexable le sont. Omettre une visibilité retire ses publications de l’index. En ajouter une ne trouve que ses nouvelles publications, jusqu’à ce que vous reconstruisiez l’index. Cela ne fait rien avec search = none |
security_contact |
URI https: ou mailto: (vide = non défini) |
vide | Où signaler les problèmes de sécurité de ce serveur : sa configuration et son exploitation, ses comptes et ses données. Lorsqu’il est défini, le serveur sert /.well-known/security.txt (RFC 9116). C’est votre contact, pas celui du logiciel : transmettez le signalement d’une vulnérabilité du logiciel lui-même au projet comme le décrit sa politique de sécurité |
require_media_description |
true / false |
false |
Si chaque fichier de média (image, vidéo ou audio) joint à une publication locale exige une description. Lorsque true, une publication ou une modification avec un fichier dont la description est absente ou ne contient que des espaces est rejetée avec 422. Il est publié comme limits.require_media_description dans GET /api/v1/instance, et le client web rend le champ de description obligatoire. Il est distinct du paramètre par utilisateur require_media_description, qui ne vérifie qu’avant l’envoi |
link_cards |
true / false |
true |
S’il faut afficher des cartes pour les liens dans les publications. Lorsque true, le serveur récupère la page liée pour construire une carte. Lorsque false, il cesse de récupérer et masque aussi les cartes déjà construites. Pour l’arrêter seulement sur certains domaines, voir domaines de cartes de lien |
link_cards_ignore_robots_txt |
true / false |
false |
Si les récupérations de cartes de lien ignorent robots.txt. Lorsque false, le serveur obéit au robots.txt des sites liés, si bien qu’un site qui interdit my-linkcard ou * n’obtient aucune carte (aperçus de liens). /about/crawler indique aux sites liés lequel c’est. Lorsque true, le serveur ne récupère ni n’utilise robots.txt, et un site lié ne peut plus refuser ces récupérations avec lui ; le serveur se nomme toujours my-linkcard. N’activez-le que si trop de cartes manquent. Les cartes construites pendant qu’il était activé sont vérifiées à leur prochaine récupération après sa désactivation. Les directives d’une page et les domaines de cartes de lien s’appliquent dans les deux cas |
ux_measurement |
true / false |
false |
Si le client web envoie des échantillons de sa rapidité de réponse, et si ce serveur les conserve (mesures d’expérience utilisateur). Les échantillons ne portent aucun compte, aucune adresse ni aucune URL. Lorsque false, le serveur n’en prend aucun, et ux_measurement dans GET /api/v1/instance dit au client de ne pas en envoyer |
ux_measurement_share |
entier 1-100 (pourcentage) | 10 |
La part des sessions de navigateur dont le client web envoie des échantillons tant que ux_measurement vaut true. Chaque session est tirée une fois, au démarrage du client web ; un petit serveur peut mesurer chaque session avec 100 |
oauth_metadata_document_clients |
true / false |
true |
S’il faut accepter les clients Client ID Metadata Document. Lorsque true, pour une demande d’autorisation dont le client_id est une URL https, le serveur récupère les métadonnées à cette URL et les traite comme le client (sans enregistrement préalable). La récupération ne suit aucune redirection, lit au plus 5 Ko et réutilise la réponse au plus 24 heures selon ses directives de cache. Lorsque false, il cesse de récupérer et refuse les demandes d’autorisation, les échanges de jetons et les actualisations de ces clients |
finance_visibility |
private / totals / breakdown |
private |
Quelle part des coûts d’exploitation (enregistrés sur /admin/finance/costs, et définie sur /admin/finance/publication) publier. private : rien n’est publié (GET /api/v1/instance/cost_totals renvoie 404). totals : uniquement le total par période et par devise. breakdown : les totaux et une ventilation par fournisseur et par catégorie, affichés à tout le monde sur les pages d’information (/about et /about/costs) et dans l’API. breakdown révèle chez quel fournisseur (par exemple, quel cloud) vous fonctionnez. À chaque niveau, les noms des éléments, les mémos et les paiements individuels restent privés. Les périodes jusqu’à celle qui contient aujourd’hui (UTC) comprise sont publiées |
finance_viewer_item_names |
true / false |
false |
Si les utilisateurs avec la permission view_finance voient les noms des éléments de coût et les noms de services des coûts importés sur l’écran des finances (/finance, GET /api/v1/finance/cost_totals). Les totaux et la ventilation par fournisseur et par catégorie sont toujours affichés, quel que soit ce paramètre |
finance_viewer_item_memos |
true / false |
false |
Si les utilisateurs avec view_finance voient les mémos des éléments de coût sur l’écran des finances. Si l’un des paramètres, nom ou mémo, vaut true, chaque période affiche des lignes d’éléments (fournisseur, catégorie et montant de cette période, plus le nom et le mémo lorsqu’ils sont activés). Les personnes avec manage_finance voient tout dans tous les cas |
finance_viewer_income |
totals / plans |
totals |
Si les utilisateurs avec view_finance ne voient que les totaux des revenus (totals) ou aussi le nombre d’abonnés par formule (plans). Le montant par formule et qui a payé ne sont jamais affichés. Si income_visibility vaut plans, les nombres publiés sont affichés quelle que soit cette valeur. Les revenus se lisent sur l’écran des finances du client web (/finance) et dans GET /api/v1/finance/income_totals |
income_visibility |
private / totals / plans |
private |
Quelle part des revenus des soutiens (le montant après les frais du fournisseur de paiement) publier. Il se choisit séparément de finance_visibility. private : rien n’est publié (GET /api/v1/instance/income_totals renvoie 404). totals : uniquement le total des revenus par période et par devise. plans : aussi le nombre actuel d’abonnés par formule, affiché à tout le monde. Pour une formule avec peu d’abonnés, le nombre peut permettre de deviner qui s’abonne. Le solde (revenus moins coûts) n’est affiché que lorsque ni cette valeur ni finance_visibility n’est private ; sinon le solde révélerait le côté que vous avez masqué. À chaque niveau, les paiements individuels, les abonnés, le montant par formule, ainsi que les montants bruts et les frais restent privés. Les périodes jusqu’à celle qui contient aujourd’hui (UTC) comprise sont publiées |
funding_meter_visibility |
off / percent / amounts |
off |
Ce que publie la jauge de financement : jusqu’où les revenus de ce mois (après les frais du fournisseur de paiement) vont vers l’objectif mensuel, affichés sur la page À propos, sur la liste des soutiens (/about/supporters) et dans GET /api/v1/instance (funding_meter). Elle se définit avec l’objectif sur /admin/finance/publication, qui ne propose que les choix que les visibilités actuelles autorisent et en dit la raison. off : rien. percent : uniquement le pourcentage, arrondi à l’inférieur à 1 %, si le mois est couvert, et si des coûts estimés sont dans l’objectif. Il ne peut être choisi que tant que finance_visibility et income_visibility sont tous deux private. amounts : aussi les revenus et l’objectif. Il ne peut être choisi que tant qu’aucun des deux n’est private. Tant qu’un seul des deux est publié, la jauge ne peut pas être affichée : les montants publiés et le pourcentage révéleraient le côté masqué. Changer l’une ou l’autre visibilité de sorte que la valeur choisie ne soit plus autorisée met la jauge sur off, et ce changement est enregistré et audité comme tout autre. Le mois est le mois calendaire contenant aujourd’hui (UTC), et seuls les revenus dans la devise de l’objectif comptent |
funding_meter_target_amount |
décimal supérieur à zéro, ou vide | vide | L’objectif mensuel de la jauge de financement, dans l’unité principale de funding_meter_target_currency (1650 yens, 12.50 dollars), avec pas plus de décimales que la devise n’en a. Vide : l’objectif est les coûts de ce mois, qui doivent être dans une seule devise ; dans un mois dont les coûts sont dans plusieurs devises, ou sont nuls, la jauge n’est pas affichée |
funding_meter_target_currency |
code ISO 4217, ou vide | vide | La devise de funding_meter_target_amount, comme JPY. Vide : la devise des coûts de ce mois |
funding_meter_rail |
true / false |
false |
Si le client web affiche aussi la jauge de financement dans la colonne de droite de la mise en page large, en plus de la page À propos, tant que funding_meter_visibility n’est pas off |
supporter_list_visibility |
off / signed_in / everyone |
off |
Qui peut voir la liste des soutiens (GET /api/v1/instance/supporters et /about/supporters). off : personne (l’API répond 404 et /about n’a aucun lien). signed_in : uniquement les personnes connectées à ce serveur (l’API répond 401 sinon). everyone : tout le monde. La liste n’affiche que les comptes et les formules des abonnés actifs qui ont choisi d’y figurer ; les montants, la facturation mensuelle ou annuelle, les dates et les nombres ne sont jamais affichés. La page de la liste et la réponse de l’API sont toujours noindex, noarchive, quel que soit search_indexing |
user_app_registration |
true / false |
true |
Si les utilisateurs connectés peuvent enregistrer leurs propres applications OAuth (publiques ou confidentielles) avec l’API cliente (POST /api/v1/oauth_apps). Lorsque false, l’enregistrement répond 403. Lister, modifier et supprimer les applications enregistrées, réémettre les secrets, émettre un jeton pour soi-même et l’autorisation par d’autres utilisateurs continuent de fonctionner |
voice_room_starters |
everyone / permitted |
permitted |
Qui peut ouvrir des salons de chat vocal, tant que la configuration voice n’est pas off (configuration). everyone : tout utilisateur local connecté qui n’est ni suspendu ni limité. permitted : uniquement les titulaires de la permission start_voice_rooms, que seul le rôle intégré admin a par défaut et que le rôle d’une formule de soutien peut avoir |
voice_public_summary |
true / false |
false |
Si la page d’un salon de chat vocal dont la visibilité est local affiche son nom, sa description, son hôte et s’il est encore ouvert aux visiteurs non connectés à ce serveur et aux utilisateurs distants, et dans son aperçu de lien. Les participants ne sont jamais affichés. Lorsque false, ces visiteurs voient seulement que le salon est destiné aux utilisateurs locaux de ce serveur |
event_creators |
everyone / permitted |
everyone |
Qui peut créer des événements (événements). everyone : tout utilisateur local connecté qui n’est ni suspendu ni limité. permitted : uniquement les titulaires de la permission create_events, que seul le rôle intégré admin a par défaut et que le rôle d’une formule de soutien peut avoir |
public_counts |
true / false |
true |
Si la page d’accueil (/, hors connexion) et GET /api/v1/instance/overview affichent combien de membres compte le serveur, combien de publications publiques ses utilisateurs ont faites chacun des 7 derniers jours, et quand le serveur a démarré. Seules les publications publiques des utilisateurs de ce serveur comptent ; les nombres sont actualisés toutes les quelques minutes. Lorsque false, l’API les omet |
landing_fediverse_explanation |
true / false |
true |
Si la page d’accueil (/, hors connexion) explique comment fonctionne le fédivers : qu’un compte ici suit et est suivi par des personnes d’autres serveurs |
landing_features |
true / false |
true |
Si la page d’accueil montre ce que fait le logiciel sur ce serveur, avec un exemple de chaque fonctionnalité activée (salons vocaux, événements, articles, recherche, traduction, soutiens) |
featured_accounts |
noms d’utilisateur de 20 comptes locaux au plus, séparés par des espaces ou des virgules (vide = aucun) | vide | Les comptes que les suggestions de personnes à suivre affichent en premier, dans cet ordre, avant les personnes de ce serveur qui ont publié récemment. Un compte dont le titulaire a désactivé « Suggérer mon compte et le trouver par une partie de son nom » n’est pas suggéré. Voir suggestions |
login_providers_only |
true / false |
false |
Si l’inscription et la connexion sont limitées aux fournisseurs de connexion tant qu’au moins un est activé : les mots de passe et les clés d’accès ne permettent plus de se connecter, et les utilisateurs sans fournisseur lié ne peuvent plus se connecter une fois leurs sessions terminées. Sans fournisseur activé, il ne s’applique pas. my instance set affiche combien d’utilisateurs actifs n’ont aucun lien avec un fournisseur activé. Voir limiter la connexion aux fournisseurs de connexion. |
invite_creators |
everyone / permitted |
permitted |
Qui peut créer ses propres invitations en plus du personnel avec manage_invites (invitations des membres). everyone : tout utilisateur local connecté qui n’est ni suspendu ni limité. permitted : uniquement les titulaires de la permission create_invites, que seul le rôle intégré admin a par défaut et que le rôle d’une formule de soutien peut avoir. En mode approval, une invitation utilisable approuve aussitôt le nouvel utilisateur ; everyone permet donc à chaque utilisateur de contourner l’examen |
member_invite_max_active |
entier 0-100 | 5 |
Combien d’invitations utilisables (ni révoquées, ni expirées, ni épuisées) un membre peut détenir à la fois ; 0 n’en laisse créer aucune aux membres. Les invitations du personnel ne comptent pas |
member_invite_max_uses |
entier 1-1000 | 10 |
Combien de personnes peuvent s’inscrire avec une même invitation qu’un membre crée |
member_invite_max_lifetime_seconds |
entier 3600-31536000 (secondes) | 2592000 (30 jours) |
Pendant combien de temps au plus une invitation qu’un membre crée peut fonctionner. L’abaisser ne raccourcit pas les invitations existantes |
translation_providers |
ID de fournisseurs séparés par des virgules | vide | Les fournisseurs de traduction côté serveur qui sont activés, le premier essayé d’abord. Lorsqu’il est vide, rien n’est envoyé à aucun fournisseur. Un ID pour lequel ce serveur n’a pas de fournisseur ne fait rien. Les fournisseurs de traduction intégrés ont les ID libretranslate, deepl, google et aws, et un plugin de traduction l’ID plugin |
translation_provider_visibilities |
paires provider=visibility|visibility séparées par des virgules |
vide | Ce que chaque fournisseur peut recevoir. Un fournisseur non nommé reçoit les publications public, local et unlisted ; provider= sans rien après n’en reçoit aucune. private et direct ne vont qu’à un fournisseur nommé avec elles ; autoriser un fournisseur n’autorise donc pas le suivant |
translation_browser |
booléen | false |
Si les lecteurs peuvent utiliser la traduction intégrée à leur navigateur, qui n’envoie rien à ce serveur ni à un fournisseur. Avec aussi un fournisseur côté serveur activé, le fournisseur passe en premier, et le navigateur traduit ce que le serveur refuse : une publication ou une langue qu’aucun fournisseur ne prend, une limite mensuelle, ou un fournisseur en échec |
translation_user_monthly_characters |
entier 0-1000000000000 | 50000 |
Combien de caractères les requêtes d’un utilisateur peuvent envoyer aux fournisseurs de traduction sur un mois UTC. À 0, rien n’est envoyé. Il n’existe pas de valeur illimitée : définissez un grand nombre |
translation_server_monthly_characters |
entier 0-1000000000000 | 500000 |
Combien de caractères tout le serveur peut envoyer aux fournisseurs de traduction sur un mois UTC. À 0, rien n’est envoyé. Il n’existe pas de valeur illimitée : définissez un grand nombre |
translation_retention_days |
entier 1-3650 (jours) | 30 |
Combien de jours une traduction est conservée après avoir été faite. La lire ne prolonge pas cette durée, et elle disparaît avec la publication |
translation_reports_to_server |
booléen | false |
Si les modérateurs peuvent envoyer le texte d’un signalement, les publications signalées et le commentaire de l’auteur du signalement, aux fournisseurs côté serveur. Chaque fournisseur ne reçoit toujours que les visibilités que translation_provider_visibilities lui autorise, quel que soit le demandeur : une publication directe signalée ne va qu’à un fournisseur autorisé pour direct, et le commentaire compte comme private. La traduction du commentaire n’est jamais conservée, pas plus que celle d’une publication supprimée, et les caractères ne comptent que dans translation_server_monthly_characters. Lorsque false, rien d’un signalement n’atteint un fournisseur |
event_records_retention_days |
entier 30-3650 (jours) | 90 |
Combien de jours après la fin ou l’annulation d’un événement conserver qui y a répondu, qui a été approuvé, qui a été invité, et qui a voté sur ses dates candidates. Un événement dont la date n’a jamais été fixée se termine avec sa dernière date candidate. L’événement lui-même (ses paramètres, lieux, date et dates candidates, et annulation) est conservé. Les enregistrements d’un événement signalé sont conservés aussi longtemps que le signalement, et les gels s’appliquent comme aux autres enregistrements (conservation des enregistrements) |
voice_participants_retention_days |
entier 30-3650 (jours) | 90 |
Combien de jours après la fin d’un salon de chat vocal conserver les enregistrements de qui y a participé : les participations, les intervenants et auditeurs, les mains levées, les invitations et les retraits. Le salon lui-même (son nom, sa description, ses hôtes et comment il s’est terminé) est conservé. Les enregistrements d’un salon signalé sont conservés aussi longtemps que le signalement, et les gels s’appliquent comme aux autres enregistrements |
hook_inbound_status_mode, hook_inbound_follow_mode, hook_signup_check_mode, hook_media_check_mode, hook_local_status_mode, hook_inbound_actor_mode, hook_local_profile_mode |
off, observe, enforce |
observe |
Jusqu’où chaque hook de décision agit tant qu’il a un plugin. off ne passe à enforce que par observe. |
hook_inbound_status_on_failure, hook_inbound_follow_on_failure, hook_media_check_on_failure, hook_inbound_actor_on_failure |
pass, retry |
pass |
Ce que fait le hook lorsqu’il applique ses décisions et que son plugin échoue (détails). |
hook_inbound_status_unfollowed_direct |
booléen | false |
Si inbound.status envoie aussi les publications directes d’auteurs qu’aucun compte local ne suit (détails). La page d’information (/about) l’indique tant que le hook est utilisé. |
hook_signup_check_on_failure |
pass, require_approval |
pass |
Ce que fait signup.check lorsqu’il applique ses décisions et que son plugin échoue. |
hook_signup_check_reject |
booléen | false |
Si un reject de signup.check refuse l’inscription tant qu’il applique ses décisions. Lorsque désactivé, la réponse est seulement enregistrée, comme en observe. |
hook_local_status_account_age_days |
entier 0-3650 (jours) | 7 |
local.status examine les publications et leurs modifications des comptes plus récents que cette durée ; 0 examine chaque compte. La page d’information (/about) l’indique tant que le hook est utilisé. |
hook_local_profile_account_age_days |
entier 0-3650 (jours) | 7 |
local.profile examine les modifications de profil des comptes plus récents que cette durée ; 0 examine chaque compte. La page d’information (/about) l’indique tant que le hook est utilisé. |
hook_decisions_retention_days |
entier 30-3650 (jours) | 90 |
Combien de jours conserver les décisions des hooks. |
single_user |
booléen | false |
Si le serveur est un serveur d’une seule personne. Il ne peut être activé que tant que le serveur a exactement un compte local, et désactivé à tout moment |
max_drafts |
entier 1-10000 | 100 |
Combien de brouillons non programmés un utilisateur peut conserver sur le serveur. L’abaisser ne supprime aucun brouillon : un utilisateur au-dessus n’en enregistre plus de nouveau |
max_scheduled_posts |
entier 1-10000 | 300 |
Combien de publications programmées d’un utilisateur peuvent attendre. L’abaisser n’annule aucune programmation |
max_scheduled_posts_per_day |
entier 1-10000 | 25 |
Combien de publications programmées d’un utilisateur peuvent attendre pour un même jour UTC |
scheduled_post_min_lead_minutes |
entier 1-1440 (minutes) | 5 |
Combien de minutes à l’avance, au minimum, une publication peut être programmée |
scheduled_post_max_lead_days |
entier 1-3660 (jours) | 366 |
Combien de jours à l’avance, au maximum, une publication peut être programmée |
article_authoring |
everyone / permission |
everyone |
Qui peut écrire de nouveaux articles : tout utilisateur local, ou uniquement les utilisateurs dont les rôles ont la permission create_articles |
max_article_bytes |
entier 1000-100000 (octets) | 100000 |
Le plus grand nombre d’octets du HTML que produit le corps d’un article |
max_article_images |
entier 0-100 | 20 |
Le plus grand nombre d’images issues des propres téléversements de l’auteur dans le corps d’un article, en plus de sa couverture |
- Les valeurs sont normalisées avant d’être stockées (
TRUEdevienttrue,0750devient750,ja_jpdevientja-JP, les ID de médias sont mis en minuscules). Une valeur invalide est rejetée et rien n’est écrit. preview_imageetthumbnailn’acceptent que le média d’une image qui existe (y compris une image encore en cours de traitement). Tant que le traitement n’est pas terminé, et à la place d’une image dont le traitement a échoué,preview_imageretombe sur l’image par défaut. Une fois qu’un média a été défini dans une révision quelconque, le nettoyage des téléversements non rattachés ne le supprime pas.contact_accountn’accepte que le nom d’utilisateur d’un utilisateur local non supprimé (stocké en minuscules).contact_emailn’accepte qu’une adresse de la formealice@example.com.featured_accountsn’accepte que les noms d’utilisateur d’utilisateurs locaux non supprimés ; un@initial est ignoré, les noms sont mis en minuscules, un nom répété n’est conservé qu’une fois, et ils sont stockés séparés par des espaces simples.
Suggestions de comptes
Section intitulée « Suggestions de comptes »Les utilisateurs connectés voient des suggestions de personnes à suivre (sur le fil d’accueil vide après l’inscription, et avec
GET /api/v1/accounts/suggestions). Les suggestions sont les comptes de featured_accounts dans leur ordre, puis les
comptes de ce serveur qui ont publié une publication publique ou locale au cours des 30 derniers jours, celui qui a publié en dernier en premier. Le
compte de l’utilisateur lui-même, les comptes que l’utilisateur suit, bloque ou met en sourdine, ou par lesquels il est bloqué, ainsi que les comptes suspendus ou
désactivés sont omis.
Les nouveaux comptes sont suggérés et peuvent être trouvés par une partie de leur nom dans la recherche de comptes. Un utilisateur qui désactive « Suggérer mon compte et permettre de le trouver par une partie de son nom » dans les paramètres du profil sort des deux : la recherche ne trouve alors le compte que par son nom d’utilisateur complet, ou pour les personnes qui le suivent.
Suppression automatique des anciennes publications
Section intitulée « Suppression automatique des anciennes publications »Les utilisateurs peuvent faire supprimer automatiquement leurs propres publications quelques jours après les avoir publiées (Paramètres, « Supprimer les anciennes publications »).
La politique de chaque utilisateur lui est propre : si elle est activée, après combien de jours, et quelles publications elle conserve (les publications épinglées, mises en marque-page ou en favori, les publications avec des médias ou un sondage, les articles, les publications de certaines visibilités, et les publications comptant au moins un certain nombre de boosts ou de favoris). Supprimer une publication de cette manière revient à ce que son auteur la supprime : les serveurs auxquels elle a été envoyée reçoivent un Delete.
Seules les publications des comptes locaux sont supprimées de cette manière, jamais les boosts.
Les clés auto_delete_default_* sont la politique avec laquelle chaque nouveau compte local démarre, quelle que soit la façon dont il est créé (le formulaire d’inscription, un fournisseur de connexion externe, une invitation ou my admin). Le compte la reçoit à sa création et en est ensuite propriétaire : modifier les clés plus tard ne change ni les comptes existants ni ceux qui ont reçu une valeur antérieure.
L’écran des paramètres montre les valeurs comme étant celles de l’utilisateur. Avec les clés non définies, un nouveau compte démarre avec la suppression automatique désactivée, après 30 jours, en conservant les publications épinglées, mises en marque-page ou en favori, les articles et les publications directes. La valeur par défaut n’est pas montrée aux personnes extérieures à l’instance. Lorsqu’un maximum est défini, un nouveau compte reçoit la valeur par défaut ramenée au maximum, comme décrit ci-dessous, de sorte qu’il démarre dans cette limite.
Un maximum de conservation des publications
Section intitulée « Un maximum de conservation des publications »Avec auto_delete_max_age_days supérieur à 0, aucune publication locale n’est conservée plus de ce nombre de jours après sa publication.
Pour chaque compte local sans la permission keep_posts_longer :
- La suppression automatique est toujours activée : un utilisateur ne peut pas la désactiver, et ne peut pas choisir plus de jours que le maximum (moins, c’est
possible). L’écran des paramètres et
PUT /api/v1/preferences/auto_deleterefusent les deux. - Seules les exceptions que les clés
auto_delete_max_allow_*autorisent conservent des publications. Par défaut, seules les publications épinglées le font, toutes ; avecauto_delete_max_kept_pinsinférieur à 5, seules les épingles les plus récentes, en ce nombre, conservent leurs publications. - Les utilisateurs qui ont désactivé la suppression automatique, ou ne l’ont jamais définie, sont aussi soumis au maximum.
Activer le maximum, l’abaisser ou modifier les exceptions ne réécrit les paramètres de personne. À la place, chaque heure, la
tâche content.auto_delete_statuses trouve les comptes dont les propres paramètres conservent des publications que le maximum ne conserve pas (parce que
le maximum a été activé ou abaissé, ou que le compte a perdu keep_posts_longer). Elle en informe chacun une seule fois, avec une
notification et un e-mail activés par défaut, et indique à partir de quand le maximum s’applique : auto_delete_grace_days après
l’avis. D’ici là, les propres paramètres du compte restent en vigueur ; ensuite, ses publications suivent le maximum. Un compte
qui rentre de nouveau dans le maximum (son utilisateur modifie ses paramètres, il obtient keep_posts_longer, ou le maximum disparaît ou
augmente) n’est plus concerné, et une modification ultérieure l’en informe de nouveau avec un nouveau délai de grâce.
Activer le maximum informe en l’espace d’une heure chaque compte qu’il concerne. Les suppressions gardent leur rythme : au plus 100 publications
d’un compte par heure, chacune envoyée comme un Delete aux serveurs auxquels la publication est parvenue ; un compte comptant beaucoup d’anciennes publications
met donc des heures ou des jours à se vider. Un utilisateur qui modifie ses paramètres entre-temps arrête le reste.
keep_posts_longer est une permission de membre : donnez-la à un rôle pour permettre à ses titulaires de conserver leurs publications aussi longtemps qu’ils le choisissent
et de désactiver la suppression automatique. Le rôle intégré admin l’a. Une formule de soutien peut la porter, de sorte que
conserver ses publications plus longtemps peut être un avantage de la formule ; lorsque la souscription se termine, le maximum s’applique de nouveau après le délai de
grâce.
Le maximum est public : GET /api/v1/instance le renvoie dans auto_delete_limit, et la page À propos l’affiche, afin que les gens
le connaissent avant de s’inscrire. Les modifications de ces clés exigent manage_settings et sont enregistrées dans le journal d’audit comme tout autre
paramètre. Dans le client web, elles se trouvent sur la page « Suppression des publications » de « Paramètres du serveur », qui demande confirmation avant d’enregistrer un
maximum qui est activé ou rendu plus strict.
Brouillons et publications programmées
Section intitulée « Brouillons et publications programmées »Les utilisateurs enregistrent des brouillons de publications sur le serveur, continuent de les écrire sur un autre appareil et les publient immédiatement ou à l’heure de leur choix. Seul leur auteur lit un brouillon ; les brouillons ne sont jamais fédérés, ne figurent pas dans l’export des données d’un compte et disparaissent avec le compte lorsqu’il est effacé. Les cinq réglages max_drafts et scheduled_post_* ci-dessus les bornent ; un enregistrement ou une programmation au-delà d’une limite est refusé avec un message qui la nomme.
- Une publication programmée est publiée par la tâche
content.publish_scheduled_draftà son heure ou peu après, y compris lorsque l’heure est plus lointaine que la limite de délai du service de file : la tâche revient et attend de nouveau. Définissez-les avecmy instance set, par exemplemy instance set max_scheduled_posts 100. - La publication est vérifiée lorsqu’elle est publiée, et pas seulement lorsqu’elle est programmée : un utilisateur qu’une mesure de modération empêche de publier à ce moment-là, ou dont la publication répond à une publication disparue ou la cite, n’obtient aucune publication. Le brouillon reste, et l’utilisateur reçoit une notification qui en explique la raison (
scheduled_status_failed, que les utilisateurs peuvent désactiver dans leurs réglages de notification, et qui n’est jamais envoyée par e-mail). L’examen automatisé des publications locales, tant qu’il est utilisé, examine la publication lorsqu’elle est publiée. - Une publication est horodatée au moment de sa publication, et la suppression automatique des anciennes publications compte à partir de là.
- Les fichiers médias qu’un brouillon joint sont conservés tant que le brouillon l’est ; supprimer le brouillon les rend non rattachés, et ils partent avec le nettoyage des téléversements non rattachés. La couverture du brouillon d’un article et les téléversements que son corps montre sont conservés de la même façon.
- Les brouillons et les publications programmées incluent les articles, qui sont programmés et comptés comme des publications. Le brouillon d’un article peut ne pas avoir de titre pendant que son auteur écrit ; il est vérifié comme un nouvel article lorsqu’il est publié, et un utilisateur qui n’a plus le droit d’écrire de nouveaux articles à ce moment-là n’obtient aucun article.
Articles
Section intitulée « Articles »Un article est une longue publication avec un titre, un résumé et une image de couverture, dont l’auteur écrit le corps en Markdown. Les articles sont des publications à tous les autres égards : ils ont une visibilité, peuvent être modifiés avec leur historique conservé, boostés, mis en favori, cités, recevoir des réponses, être signalés et supprimés, et la modération agit sur eux comme sur les publications. Le serveur rend le corps une seule fois, lorsqu’il est écrit : le HTML brut qu’il contient n’est pas rendu, et seules les images des propres téléversements de l’auteur s’affichent comme des images ; toute autre image devient un lien, de sorte que les lecteurs ne chargent jamais d’images depuis d’autres sites. Les fils, les notifications et la recherche montrent le titre, le résumé et la couverture ; le corps s’affiche là où l’article est ouvert.
- Par défaut, chaque utilisateur local peut écrire des articles. Avec
article_authoringdéfini surpermission, seuls les utilisateurs dont les rôles ont la permissioncreate_articlespeuvent en écrire de nouveaux ; les articles déjà écrits restent, et leurs auteurs peuvent toujours les modifier. Une mesure de modération qui empêche un compte de publier l’empêche aussi d’écrire et de modifier des articles. Une formule de soutien peut donnercreate_articlescomme avantage. max_article_bytesborne le HTML d’un corps, pas le Markdown : les serveurs qui reçoivent des articles comptent le HTML, et 100 000 octets, le maximum possible, est ce qu’ils conservent en entier. Un corps en japonais d’environ 30 000 caractères y tient.max_article_imagesborne les images d’un corps. L’éditeur montre les deux avant la publication de l’article.- Un article n’est jamais une publication directe, et n’a ni sondage, ni pièces jointes autres que ses images, ni avertissement de contenu : un article sensible montre son titre et son résumé et replie le corps et la couverture.
- La suppression automatique des anciennes publications conserve les articles sauf si l’utilisateur le désactive (
auto_delete_default_keep_articlespour les nouveaux comptes,auto_delete_max_allow_articlessous un maximum). GET /api/v1/instancerenvoie les limites danslimits.articleset le réglage de rédaction dansarticle_authoring. Définissez-les avecmy instance set, par exemplemy instance set article_authoring permission.
Événements
Section intitulée « Événements »Les utilisateurs locaux planifient des événements avec une date, un fuseau horaire et jusqu’à trois lieux : un salon de chat vocal de ce serveur, un lieu de rendez-vous en personne et un lien. Au lieu d’une date, un organisateur peut proposer jusqu’à 20 dates candidates : les utilisateurs qui voient l’événement répondent à chacune par oui, peut-être ou non, et l’organisateur ou un co-organisateur en confirme ensuite une, ce qui fixe la date. D’ici là, personne ne répond s’il viendra. Les événements sont réservés aux utilisateurs de ce serveur : ils ne sont jamais fédérés, et les utilisateurs distants et les visiteurs qui ne sont pas connectés n’en voient aucun.
- Qui peut en créer un est défini par
event_creators. Un organisateur doit aussi pouvoir ouvrir des salons de chat vocal (voice_room_starterset le réglage de configurationvoice) pour tenir un événement dans l’un d’eux. - Le salon de chat vocal d’un événement s’ouvre à son début, hébergé par l’organisateur, et attend jusqu’à 30 minutes le premier participant. Il prend le titre de l’événement et la visibilité de l’événement (chaque utilisateur local, les abonnés, les personnes que l’organisateur suit, les abonnés mutuels, ou les invités). Les co-organisateurs, les personnes qui ont répondu qu’elles viennent ou viendront peut-être, et les invités qui n’ont pas répondu sont invités au salon, afin qu’ils continuent de le voir lorsqu’un co-hôte le reprend. Le salon ne crée aucune publication de début, et la notification de début de l’événement est sa seule notification.
- Un salon qui ne peut pas s’ouvrir (le chat vocal est désactivé, l’organisateur ne peut plus ouvrir de salons ou en héberge un autre, ou autant de salons sont ouverts que le réglage de configuration
voice_max_open_roomsle permet) laisse l’événement tel quel : l’organisateur est notifié, et la page de l’événement indique que le salon n’a pas pu s’ouvrir. Le serveur le vérifie lorsque la date est fixée ou modifiée et aussi un jour avant le début, et notifie l’organisateur de ce qui garderait le salon fermé. L’organisateur est aussi notifié lorsque personne n’est venu dans le salon. Annuler l’événement, ou retirer son salon de chat vocal, termine le salon et conserve l’événement. - L’organisateur choisit qui voit l’événement : chaque utilisateur local, les abonnés de l’organisateur, les personnes que l’organisateur suit, les abonnés mutuels, ou uniquement les invités. Les invités et les personnes qui y ont répondu, ou ont répondu à ses dates candidates, le voient toujours, et un blocage entre un utilisateur et l’organisateur ou un co-organisateur le masque pour cet utilisateur.
- L’adresse et le lien d’un événement ne sont montrés qu’aux participants que l’organisateur ou un co-organisateur a approuvés, sauf si l’organisateur les montre à toutes les personnes qui voient l’événement. Les liens doivent être
httpouhttps, et le serveur ne les ouvre jamais. - Un utilisateur qui voit un événement peut l’enregistrer sous forme de fichier iCalendar (
.ics) pour l’ajouter à son propre agenda. Le fichier ne nomme que les lieux que cet utilisateur voit ; une adresse réservée aux participants approuvés n’y apparaît donc jamais. Il n’existe aucune adresse d’abonnement au calendrier. - Un utilisateur crée au plus 10 événements par heure, et un événement envoie au plus 100 invitations par heure.
- Les utilisateurs peuvent signaler un événement, et les modérateurs peuvent en annuler un ; suspendre ou supprimer un organisateur annule les événements de l’organisateur qui n’ont pas commencé (modération). Qui a répondu et qui a été invité est conservé pendant
event_records_retention_daysaprès l’événement, tout comme les votes sur ses dates candidates.
Textes (une clé, une valeur)
Section intitulée « Textes (une clé, une valeur) »| Clé | Limite | Description |
|---|---|---|
name |
100 caractères, une ligne (des espaces seuls ne sont pas autorisés) | Le nom de l’instance (nom d’affichage). Voir nom et domaine |
short_description |
500 caractères | Une courte description |
description |
20000 caractères | La description |
terms |
100000 caractères | Les conditions d’utilisation (Markdown) |
privacy_policy |
100000 caractères | La politique de confidentialité (Markdown) |
commerce_disclosure |
100000 caractères | Les mentions du vendeur pour les formules payantes, comme l’avis qu’exige la loi japonaise (Markdown ; soutiens) |
preview_image_alt |
1500 caractères | Le texte alternatif de l’image preview_image (og:image:alt). Lorsqu’il n’est pas défini, « Image de {nom de l’instance} » est utilisé |
thumbnail_alt |
1500 caractères | Le texte alternatif de l’image thumbnail |
- Chaque texte a une seule valeur. Un administrateur l’écrit une fois dans la langue qu’il veut, et les lecteurs de chaque locale voient la même valeur ; les lecteurs d’autres langues s’appuient sur la traduction automatique ou équivalent. Les libellés et les descriptions des champs d’administration sont traduits dans la langue de la personne comme tout autre texte d’écran ; seule la valeur qu’un administrateur écrit ne l’est pas.
- Le serveur ne connaît pas la langue d’un texte ; le client web et les écrans rendus par le serveur produisent donc les textes avec
dir="auto"etlang=""(la valeur HTML pour une langue inconnue) au lieu d’hériter de la langue de l’écran. - Définir un texte vide le supprime.
- Outre la CLI, les textes peuvent être modifiés sur les écrans d’administration du client web (nom, courte description et description sur
la page Général des « Paramètres du serveur »,
/admin/settings/general; les conditions sur/admin/documents/terms, la politique de confidentialité sur/admin/documents/privacy-policy, et les mentions de commerce sur/admin/documents/commerce-disclosure, chacune une page de « Conditions et politiques »,/admin/documents) et avec l’API cliente (GET /api/v1/admin/instance_texts,PUT /api/v1/admin/instance_texts/{key}). Les deux exigent la permission de rôlemanage_settings, et les changements sont enregistrés dans le journal d’audit (text_changed).
Conditions et politique de confidentialité
Section intitulée « Conditions et politique de confidentialité »- Écrivez
terms,privacy_policyetcommerce_disclosureen Markdown (CommonMark plus les tableaux, le texte barré et les liens automatiques de GitHub Flavored Markdown). Un saut de ligne à l’intérieur d’un paragraphe reste un saut de ligne, et les titres#commencent un niveau en dessous du titre de la page (h2). - Le serveur les convertit en HTML et le nettoie (
GET /api/v1/instance/documents/{kind}anonyme), et les pages du client web/about/terms,/about/privacyet/about/commerceles affichent. Le HTML brut, les images et les liens autres quehttp,httpsetmailtosont supprimés. Les pages ne demandent aucune connexion (ce sont des pages du client web ; elles exigent donc JavaScript)./about/commerceest l’URL à donner au fournisseur de paiement. - Un document que vous rédigez est lié depuis l’écran d’inscription, le pied de page de chaque écran rendu par le serveur et le client web (la troisième colonne, le menu, les paramètres et l’écran de connexion). Un document qui n’est pas rédigé n’est pas lié, et son API répond 404.
- Tant que les conditions d’utilisation ou la politique de confidentialité sont rédigées, l’écran d’inscription les liste avant le bouton de création avec une case à cocher obligatoire, « J’ai lu et j’accepte les documents ci-dessus ». Le serveur refuse une inscription sans elle, y compris une inscription par un fournisseur de connexion. Sans l’un ni l’autre document, l’écran ne demande aucun accord.
Nom et domaine
Section intitulée « Nom et domaine »Une instance a un domaine et un nom, séparément.
- Le domaine est la configuration
host(etaccount_domain, le domaine des identifiants). Il ne peut pas être modifié pendant que l’ instance fonctionne. Les identifiants (@alice@example.com), les URL, les ID ActivityPub etdomaindansGET /api/v1/instancerestent le domaine même lorsqu’il y a un nom. - Le nom est le texte
name. Il apparaît partout où l’instance est nommée aux personnes : la barre latérale et « À propos de ce serveur » du client web, le titre de l’onglet du navigateur, les écrans de connexion, d’inscription, de confirmation d’e-mail, d’état du compte et de consentement à l’autorisation rendus par le serveur, les e-mails (confirmation de l’adresse e-mail et notifications aux modérateurs),og:site_namedes aperçus de liens,name/short_namedu Web App Manifest,metadata.nodeNamede NodeInfo etnamedansGET /api/v1/instance. - Le nom est le même dans toutes les langues. Lorsqu’il n’y a pas de nom, le domaine (
host) est affiché à la place. - Une modification prend effet à partir de la requête suivante, sans redémarrage. Le titre de l’onglet et la barre latérale d’un client web ouvert se mettent à jour lorsque vous enregistrez sur l’écran d’administration.
Contact et miniature
Section intitulée « Contact et miniature »Le contact des opérateurs (contact_account, contact_email) et l’image qui représente l’instance (thumbnail
et le texte thumbnail_alt) apparaissent aux endroits ci-dessous. Ce qui n’est pas défini n’apparaît pas.
- « À propos de ce serveur » du client web (
/about). La miniature et le compte de contact apparaissent aussi sur le premier écran (/) pour les personnes qui ne sont pas connectées. contact(accountetemail) etthumbnail(url,width,height,alt) dansGET /api/v1/instance.metadatadans NodeInfo :maintainerselon la convention de Misskey (nameest le nom d’affichage du compte de contact, ou son nom d’utilisateur s’il n’en a pas ;emailestcontact_email),staffAccountsselon la convention de Pleroma et Akkoma (l’ID d’acteur du compte de contact),thumbnail(urletalt), etnodeDescriptionà partir de la courte descriptionshort_description.
Lorsque le compte de contact est suspendu ou supprimé, le compte n’est pas affiché et seule l’adresse e-mail l’est.
Modifiez-les sur la page Général de l’écran d’administration du client web (« Paramètres du serveur », /admin/settings/general), ou avec la CLI ou l’API cliente.
Serveur d’une seule personne
Section intitulée « Serveur d’une seule personne »Un serveur de son seul opérateur, le chez-soi de l’opérateur dans le fédivers, est un serveur d’une seule personne : activez single_user. Dans le client web,
un administrateur l’active et le désactive avec Serveur d’une seule personne sur la page Inscription des Paramètres du serveur,
qui indique pourquoi le serveur a refusé lorsqu’il y a plus d’un compte local.
my instance set single_user truemy instance set single_user false # back to a community server- Il ne peut être activé que tant qu’exactement un compte local compte. Tout compte local non supprimé compte,
y compris ceux en attente d’approbation, désactivés, programmés pour suppression, suspendus ou limités, puisque chacun pourrait revenir comme
une seconde personne. Un compte dont l’inscription a été rejetée ne compte pas. Avec tout autre nombre,
my instance setéchoue avec le décompte, et l’API d’administration répond422avec le type/api/v1/problems/single-user-requires-one-account. L’acteur de l’instance du serveur n’est pas un compte et ne compte jamais. - Il peut être désactivé à tout moment. L’activer ou le désactiver ne supprime rien et ne change la valeur stockée d’aucun autre paramètre : ce qu’il retient s’applique de nouveau tel quel une fois désactivé. Comme tout paramètre, le changement va dans le journal d’audit.
Tant qu’il est activé :
- L’inscription est fermée.
registration_modese lit commeclosedquelle que soit sa valeur stockée ; la page d’inscription, l’inscription par un fournisseur de connexion etmy admin createne créent donc aucun compte. Se connecter avec un fournisseur de connexion fonctionne toujours. - Seulement le fil d’accueil.
local_timeline_visibilityetfederated_timeline_visibilityse lisent commeoff. Les fils de hashtags et de listes restent. - Ce dont une communauté a besoin est masqué. Les fils local et fédéré et leurs flux, les suggestions de comptes,
les invitations des utilisateurs et des administrateurs, l’examen des inscriptions et les blocages d’inscription répondent
404avec le type/api/v1/problems/single-user-mode. - Pas de nouvelles publications locales. Sur un serveur d’une seule personne, une publication pour les « Voisins » n’atteint que les abonnés ; une nouvelle
publication ne peut donc pas être locale : l’API cliente répond
422et l’omet de ce qu’un compte peut publier. Une visibilité par défaut « Voisins » se lit comme « Abonnés seulement » et ne peut pas être enregistrée, et un salon de chat vocal pour les personnes de ce serveur s’annonce dans une publication pour les abonnés. Les publications déjà locales restent locales. - Le serveur dit ce qu’il est.
single_userdansGET /api/v1/instancevauttrue, avec le mode d’inscription effectif et les fils, et le compte de l’opérateur commesingle_user_account, et NodeInfo répondopenRegistrations: falseavecmetadata.singleUser: true. - La page d’accueil est le profil de l’opérateur. Les personnes qui ne sont pas connectées et ouvrent l’adresse du serveur voient le profil de son unique compte, avec le moyen de se connecter et des liens vers la page À propos, les conditions d’utilisation et la politique de confidentialité que le serveur publie. Le client web masque ce que le serveur ne propose pas, dans sa navigation, ses menus et ses écrans d’administration : les fils local et fédéré, l’inscription, les comptes suggérés, les invitations, l’examen des inscriptions, les blocages d’inscription, la visibilité « Voisins », et les paramètres de l’inscription, des invitations, des fils publics, de la page d’accueil et des comptes suggérés.
La fédération, la modération, la recherche en texte intégral, le programme de soutien, les documents et les écrans d’administration fonctionnent comme sur n’importe quel serveur.
Utilisation
Section intitulée « Utilisation »my instance list # all settings (and whether each is the default) and textsmy instance get registration_modemy instance set registration_mode openmy instance set name "Example Social" # the same name in every localemy instance set description - < description.txt # the value "-" reads standard inputmy instance get namemy instance set name "" # delete the namemy instance history registration_mode # revision history (newest first, -limit sets the count)my instance history descriptionmy instance set -owner admin preview_image ./preview.png # upload the image as media of admin and use it as the preview imagemy instance set preview_image 0192f3a4-7b1c-7d2e-9f00-1a2b3c4d5e6f # give the ID of media that is already uploadedmy instance set preview_image_alt "A blue bird mascot"my instance set preview_image "" # back to the bundled default imagemy instance set contact_account admin # the contact accountmy instance set contact_email admin@example.commy instance set -owner admin thumbnail ./thumbnail.png # the thumbnailmy instance set thumbnail_alt "A town by the sea"- Écrivez les options avant la clé et la valeur.
- Avec
-owner <username>, la valeur depreview_imageou dethumbnailest lue comme le chemin d’un fichier image et téléversée comme média de ce compte local. Le worker traite l’image avant son utilisation. Une image paysage de 1200x630 est recommandée. - Une modification enregistre une révision (
instance_*_revisions) et met à jour la valeur courante (instance_settings/instance_texts) dans une seule transaction. Une modification depuis la CLI est enregistrée sans acteur (BYvautclidans l’historique). - Définir de nouveau la même valeur ajoute quand même une révision.
- Codes de sortie : 0 en cas de succès, 1 pour une valeur rejetée ou une erreur de base de données (rien ne change), 2 pour des arguments incorrects.
Modifier le sens de la fédération
Section intitulée « Modifier le sens de la fédération »- Le restreindre conserve les relations d’abonnement, les publications importées et les enregistrements de livraison, et n’envoie aucun
UndoniReject. Le flux s’arrête simplement, et revenir àboth(ou à un autre mode) le reprend tel qu’il était. - Les publications et réactions faites pendant la restriction ne sont pas livrées rétroactivement lorsque vous élargissez de nouveau.
- Côté distant, les abonnés des utilisateurs locaux ne reçoivent rien tant que le mode est
inbound, et les abonnements des utilisateurs locaux ne sont pas mis à jour tant qu’il estoutboundouoff. - Les suppressions (de publications ou de comptes) effectuées pendant que le mode est
offne sont pas envoyées. Eninboundetoutbound, le retrait de ce qui avait déjà été envoyé (Deleteet similaires) va aux destinataires d’origine et aux abonnés de l’époque. - Les modifications sont enregistrées dans
instance_setting_revisionset dans le journal d’audit (target_kind = setting).
Pour couper aussi les relations, utilisez la CLI my admin federation sever.
my admin federation sever -direction in # end follows of local users by remote accountsmy admin federation sever -direction out # end follows of remote accounts by local usersmy admin federation sever -direction both- Elle met fin aux abonnements en attente et actifs entre comptes locaux et distants comme des terminaisons par modération
(
follow_terminations,reason = moderation). Un changement de mode ne l’appelle jamais automatiquement. Reject(in) ouUndo(out) n’est envoyé au côté distant que si le mode courant envoie ce sens. Dans un mode qui ne le fait pas (commeoff), l’abonnement se termine du côté local uniquement et le côté distant n’en est pas informé.- On peut l’exécuter à répétition sans risque. Elle affiche sur la sortie standard le nombre d’abonnements auxquels elle a mis fin.
Écrans d’administration et API cliente
Section intitulée « Écrans d’administration et API cliente »Chaque paramètre que la CLI peut changer peut aussi l’être sur les écrans d’administration du client web et avec l’API cliente. Les deux exigent
la permission de rôle manage_settings (seul le rôle intégré admin l’a). Comme avec la CLI, un changement est conservé comme révision
et enregistré par clé dans le journal d’audit (setting_changed, la cible est le paramètre et l’acteur est cet utilisateur). Consultez le
journal d’audit sur l’écran de modération (« Journal d’audit », /moderation/audit-log).
-
Client web (« Paramètres du serveur »,
/admin/settings) : l’écran liste une page par sujet, en groupes. Chaque page a un formulaire et un bouton d’enregistrement, et l’enregistrement n’envoie que ce que vous avez changé sur cette page ; les paramètres des autres pages restent tels quels. Un choix dont chaque option change beaucoup dit ce que fait chacune sous le choix, avant que vous enregistriez, et un nombre indique ses bornes lorsqu’il est refusé.Page Sections et paramètres Général ( /admin/settings/general)Nom et descriptions ( name,short_description,description) ; Langue (default_locale, choisie parmi les langues de l’application) ; Contact (contact_account,contact_email) ; Images (thumbnailet le textethumbnail_alt,preview_imageet le textepreview_image_alt)Icône et logo ( /admin/settings/branding)L’icône, le logo et le logo pour les fonds sombres (Logo et icône) Inscription ( /admin/settings/registration)Qui peut s’inscrire ( registration_mode, chaque mode avec ce qu’il fait) ; Serveur d’une seule personne (single_user) ; Invitations des membres (invite_creators,member_invite_max_active,member_invite_max_uses,member_invite_max_lifetime_secondsen heures) ; Fournisseurs de connexion uniquement (login_providers_only, qui demande d’abord confirmation, avec combien d’utilisateurs actifs ne pourraient plus se connecter et si vous en faites partie) ; Applications (user_app_registration,dynamic_client_registration,oauth_metadata_document_clients,oauth_client_rate_limits). Sur un serveur d’une seule personne, les sections de l’inscription et des invitations des membres indiquent que personne d’autre ne s’inscritPublications et fonctionnalités ( /admin/settings/content)Publications ( max_status_length,require_media_description) ; Fils (local_timeline_visibility,federated_timeline_visibility) ; Cartes de lien (link_cards,link_cards_ignore_robots_txt) ; Brouillons et publications programmées (max_drafts,max_scheduled_posts,max_scheduled_posts_per_day,scheduled_post_min_lead_minutes,scheduled_post_max_lead_days) ; Articles (article_authoring,max_article_bytes,max_article_images) ; Événements (event_creators,event_records_retention_days) ; Page d’accueil et suggestions (public_counts,landing_fediverse_explanation,landing_features,featured_accounts)Chat vocal ( /admin/settings/voice)Qui peut ouvrir des salons ( voice_room_starters) ; Salons (voice_public_summary,voice_participants_retention_days)Suppression des publications ( /admin/settings/auto-delete)Valeur par défaut pour les nouveaux comptes (les paramètres auto_delete_default_*) ; Maximum pour tout le monde (auto_delete_max_age_days,auto_delete_grace_days, les paramètresauto_delete_max_allow_*,auto_delete_max_kept_pins). Enregistrer un maximum qui est activé ou raccourci demande d’abord confirmation (Un maximum pour la conservation des publications)Fédération ( /admin/settings/federation)Sens ( federation_mode) ; Serveurs (federation_scope: enregistrerallowlistaffiche d’abord les abonnements que la bascule mettrait fin et demande confirmation, voir fédérer uniquement avec des serveurs autorisés) ; Récupérations signées (authorized_fetch) ; Médias d’autres serveurs (remote_media_policy,remote_media_cache_ttl_secondsen minutes,remote_media_cache_max_bytesen MiB) ; Publications d’autres serveurs (remote_status_retention_days,remote_status_max_retention_days,relay_status_retention_days) ; Serveurs modérés (domain_actions_visibility,domain_actions_rationale_visibility)Recherche et robots d’exploration ( /admin/settings/discovery)Moteurs de recherche ( search_indexing,indexable_default) ; Contact de sécurité (security_contact) ; IA (ai_usage) ; Recherche en texte intégral (search_visibilities)Examen externe ( /admin/settings/hooks)Une section pour chaque hook de décision : son mode ( enforcen’est proposé que lorsqu’il n’est pasoff), ce qu’il fait lorsque son plugin échoue, et ses autres paramètres ; Enregistrements des décisions (hook_decisions_retention_days). Voir Hooks de décisionContestations et enregistrements ( /admin/settings/records)Contestations ( appeal_window_days) ; Conservation des enregistrements (session_origins_retention_days,registration_origins_retention_days,reports_retention_days,moderation_actions_retention_days,audit_log_retention_days)Sur la page Général, une image est téléversée à l’enregistrement, et devient alors la miniature ou l’image d’aperçu de lien. Qui peut voir les coûts d’exploitation, les revenus et la liste des soutiens se définit sur les écrans « Coûts et revenus » et « Soutiens ». Les paramètres de traduction ont un écran à part, ci-dessous.
-
Client web (« Traduction »,
/admin/translation) : les fournisseurs de ce serveur, leur ordre et ce que chacun peut recevoir, la traduction du navigateur, les limites mensuelles et la durée de conservation des traductions, avec les caractères envoyés ce mois-ci et le taux de réussite du cache. Chaque processus du serveur ajoute son nombre de réussites du cache au taux au plus une fois par minute, si bien que les dernières requêtes peuvent mettre une minute à apparaître, et un processus qui s’arrête peut laisser sa dernière minute non comptée. Mettez à jour votre politique de confidentialité (modèle) avant d’activer un fournisseur côté serveur : le texte envoyé à un fournisseur ne peut pas être rappelé. Les clés d’API des fournisseurs et l’adresse d’un plugin de traduction se trouvent dans la configuration du déploiement ; aucun paramètre ni aucune réponse de l’API cliente ne les contient. -
Limites de traduction. Ce qui compte, ce sont les caractères envoyés, en points de code : les marqueurs qui remplacent les mentions, les liens et autres ne comptent pas, ni une traduction que le serveur conserve déjà, une publication déjà dans la langue du lecteur, ou la traduction du navigateur. Chaque appel à un fournisseur compte, même un appel qui échoue, puisque le fournisseur peut avoir reçu le texte ; le nombre peut donc différer de ce qu’un fournisseur facture. Au-delà d’une limite, la requête est refusée avec un
429et aucun fournisseur n’est appelé ; le client web utilise alors la traduction du navigateur du lecteur, lorsque vous l’autorisez et que le navigateur peut traduire la publication. Les mois sont en UTC. -
API cliente :
GET /api/v1/admin/settingsrenvoie chaque paramètre avec sa valeur actuelle, sa valeur par défaut, s’il est défini, et son type et ses valeurs acceptées (choix ou plage).PATCH /api/v1/admin/settingschange des paramètres ensemble avec{"values": {"<key>": "<value>", ...}}. Toutes les valeurs sont des chaînes, normalisées et stockées comme avec la CLI. Si une seule clé est inconnue ou qu’une valeur est invalide, la réponse est un 422 qui nomme la clé et rien ne change. Les clés modifiées sont enregistrées comme révisions et dans le journal d’audit dans la même transaction. -
Les invitations, qui fonctionnent dans les modes
open,approvaletinvite, sont créées sur l’écran de modération (« Invitations »,/moderation/invites, permissionmanage_invites; voir codes d’invitation), et par les membres comme l’autoriseinvite_creators(invitations des membres).
Les règles de l’instance apparaissent dans rules de GET /api/v1/instance, et les signalements les citent par ID.
- Une règle comporte une phrase d’une ligne (jusqu’à 300 caractères) et un complément facultatif (jusqu’à 1 000 caractères). Comme pour les textes,
l’administrateur les écrit dans la langue qu’il souhaite et toutes les langues voient la même valeur (
dir="auto"etlang=""). Il peut y avoir au plus 100 règles actives. - Chaque modification (une phrase révisée, un réordonnancement) est conservée comme une révision (
instance_rule_revisions), et l’ID d’une règle ne change pas. - Une règle retirée disparaît de la liste des règles actives. Elle ne peut pas être rétablie, mais les signalements peuvent toujours y faire référence.
my instance rule create -hint "No harassment" "Be kind" # add at the end of the active rulesmy instance rule edit <rule> "Always be kind" # change the sentence; the supplement changes only with -hintmy instance rule move <rule> 1 # move to position 1 and renumber the active rules 1, 2, ...my instance rule retire <rule> # retire itmy instance rule list # active rules (-all includes retired ones)- L’API d’administration est
/api/v1/admin/rules(lister, ajouter, obtenir, réviser, déplacer, retirer) et exige la permission de rôlemanage_rules. - Sur l’écran d’administration du client web (« Règles »,
/admin/rules,manage_rules), la liste affiche les règles en vigueur dans l’ordre, et « Monter » et « Descendre » les réordonnent ; le filtre au-dessus de la liste affiche à la place les règles retirées. « Ajouter une règle » ouvre une page avec une phrase et un complément. Choisissez la phrase d’une règle pour ouvrir sa page, où vous la modifiez et la retirez (après une boîte de dialogue de confirmation). Chaque modification est enregistrée dans le journal d’audit (rule_added,rule_revised,rule_moved,rule_retired). - Les codes de sortie sont les mêmes que pour les paramètres (0 en cas de succès, 1 pour une valeur rejetée ou une erreur de base de données, 2 pour des arguments incorrects).
Domaines de cartes de lien
Section intitulée « Domaines de cartes de lien »Les cartes de lien des publications (link_cards) proviennent d’un robot d’exploration : le serveur récupère la page liée et son image. Une règle
arrête ce robot sur un domaine et ses sous-domaines, et ne touche à rien d’autre concernant le domaine. Elle a l’un de deux
modes. Une règle est le choix de l’opérateur, et elle s’applique en plus de ce que les sites liés eux-mêmes refusent (aperçus de liens).
| Mode | Ce qu’il récupère | Cartes qu’il a déjà |
|---|---|---|
Arrêter la récupération (no_fetch) |
Rien du domaine, ni pages ni images, même lorsqu’une redirection y mène | Masquées |
Arrêter les images seulement (no_images) |
Les pages, mais aucune image du domaine | Affichées sans leur image |
- Une règle ne porte que sur les cartes de lien. Le domaine reste fédéré, et les médias de ses publications sont récupérés comme d’habitude : pour couper un serveur, utilisez une action de domaine, qui arrête aussi ses cartes de lien. Une règle n’est ni listée avec les actions de domaine ni exportée avec elles.
- Une règle couvre le domaine et ses sous-domaines, et une image est vérifiée par rapport aux hôtes de la page et de l’image. Toute règle qui couvre un hôte s’applique ; une règle sur un sous-domaine n’assouplit donc pas la règle de son parent. Un domaine s’écrit et se normalise comme pour une action de domaine : un nom d’hôte sans schéma ni port, dans n’importe quelle graphie d’un domaine internationalisé.
- Un changement prend effet aussitôt, aussi sur les cartes que le serveur a déjà, et les images proxifiées de ces cartes cessent d’être servies tant que les images sont arrêtées.
- Retirer une règle ramène les cartes que le serveur a déjà telles qu’elles étaient. Un lien qui a été ignoré obtient sa carte la prochaine fois qu’une publication en a besoin ; rien n’est récupéré de nouveau en masse. Une carte récupérée de nouveau alors que les images étaient arrêtées reste sans image jusqu’à sa prochaine récupération.
- Sur l’écran d’administration du client web (« Domaines de cartes de lien »,
/admin/link-card-domains,manage_settings), « Ajouter une règle » définit une règle avec son mode et une note, et refuse un domaine qui a déjà une règle, avec un lien vers cette règle. La liste affiche les règles par domaine, 40 à la fois avec « Afficher plus » ; choisir un domaine ouvre la page de sa règle, où vous changez son mode et sa note, et la retirez (après une boîte de dialogue de confirmation). - L’API d’administration est
/api/v1/admin/link_card_domains(lister, définir ; unDELETEavec le domaine le retire) et exige la permission de rôlemanage_settings. Un serveur conserve au plus 1 000 règles, chacune avec une note de 5 000 caractères au plus. - Chaque changement est enregistré dans le journal d’audit (
link_card_domain_fetch_stopped,link_card_domain_images_stopped,link_card_domain_rule_removed).
Le thème de tout le serveur est un ensemble de surcharges des jetons de conception du client web, avec une valeur claire et une valeur sombre pour chaque couleur. Il s’applique au client web de chaque spectateur et aux écrans que le serveur rend (connexion, inscription, conditions, etc.). Il n’y a pas de CSS personnalisé.
-
Vous pouvez surcharger ces jetons de conception ; l’espacement, les tailles des composants, les graisses de la typographie, les ombres et les couleurs des graphiques de données restent fixes :
Jetons Type Surcharge color-surface,color-surface-raised,color-surface-raised-hover,color-surface-raised-pressed,color-surface-hover,color-surface-pressed,color-text,color-muted-text,color-accent,color-on-accent,color-accent-text,color-quote-barcouleur #rrggbbpour le clair et pour le sombrefont-sans-override,font-mono-overridefamille de polices Noms de familles, séparés par des virgules (30 au plus), sans famille générique comme sans-serif; mettez entre guillemets un nom contenant un mot qui commence par un chiffre, comme"M PLUS 1p"text-tagline,text-headline,text-heading,text-title,text-reading,text-body,text-captionlongueur 0ou rem / px, de 0,625rem à 3remtext-*--line-heightdes mêmes septnombre 1 à 2,5 radius-control,radius-overlaylongueur 0 à 2rem duration-spindurée ms / s, 0 à 1000ms -
Le client web dessine le texte avec ses propres polices : Noto Color Emoji pour les émojis, Noto Sans pour le latin, le grec et le cyrillique, et Noto Sans CJK dans les glyphes de la langue du texte pour le reste. Les polices de
font-sans-override(texte) etfont-mono-override(code) viennent juste après la police d’émojis, et les polices du client web dessinent les caractères qui manquent aux vôtres. Un thème ne peut pas remplacer ces polices. -
Vous enregistrez un ensemble comme brouillon, le prévisualisez, puis le publiez ; le thème en vigueur ne change pas tant que vous ne publiez pas. Chaque enregistrement remplace tout le brouillon, et chaque publication est une nouvelle révision. Restaurer publie de nouveau l’ensemble qui était en vigueur avant l’actuel, et laisse le brouillon tel quel.
-
Dans le client web, Administration > Thème affiche le brouillon et le thème en vigueur. Modifier le brouillon affiche chaque couleur pour le clair et le sombre avec le contraste de chaque paire qu’elle forme, et n’enregistre pas une paire sous son minimum. Aperçu affiche le brouillon sur chaque écran de l’onglet de votre navigateur jusqu’à ce que vous appuyiez de nouveau dessus ; personne d’autre ne le voit. Publier et Restaurer le thème précédent se trouvent sur le même écran. L’icône et le logo se trouvent dans Paramètres du serveur > Icône et logo.
-
Lorsque vous enregistrez et lorsque vous publiez, le serveur vérifie la forme et la plage des valeurs et le contraste de chaque paire de jetons de couleur (les jetons que vous ne surchargez pas utilisent leurs valeurs par défaut ; WCAG 2.2 AA en clair comme en sombre). Si une vérification échoue, rien n’est enregistré ni publié.
-
Une surcharge d’un jeton qu’une nouvelle version renomme ou retire, ou dont la valeur ne convient plus au jeton, ne fait jamais échouer une mise à niveau. Elle reste dans l’ensemble enregistré mais ne s’applique plus : l’API d’administration la liste sous
stale_tokens,my instance theme getla nomme, et le prochain enregistrement du brouillon l’abandonne. -
La feuille de style de la révision publiée est servie à
/theme/{revision ID}.css(immutable, mise en cache longtemps). La coquille HTML a un cache partagé (60 secondes plus 300 secondes de revalidation) ; il faut donc quelques minutes après la publication pour que tout le monde l’obtienne. Une page déjà ouverte garde l’ancien aspect jusqu’à son rechargement. -
<meta name="theme-color">(clair et sombre) dans la coquille ettheme_color/background_color(clair) du Web App Manifest prennent la valeur ducolor-surfacedu thème. La version HTML de chaque e-mail que le serveur envoie à partir de là utilise les couleurs du thème publié, claires et sombres ; un brouillon n’atteint jamais l’e-mail. -
Publier un ensemble sans jetons réinitialise le thème à la valeur par défaut, et la feuille de style n’est plus chargée.
-
Vous pouvez le modifier avec l’API cliente et avec la CLI. L’API cliente exige la permission de rôle
manage_settings:GET /api/v1/admin/themelit le brouillon et l’ensemble en vigueur,PUT /api/v1/admin/theme/draftenregistre le brouillon,GET /api/v1/admin/theme/draft/stylesheetrenvoie la feuille de style du brouillon pour l’aperçu, etPOST /api/v1/admin/theme/publishetPOST /api/v1/admin/theme/restorepublient. Les publications sont enregistrées dans le journal d’audit (setting_changed, cibletheme).
my instance theme get > theme.json # print the draft as the same JSON as the admin API (-published: the set in effect)my instance theme set < theme.json # save the whole draft (if a check fails, it prints why and changes nothing)my instance theme publish # publish the draftmy instance theme restore # publish again the set in effect before the current oneecho '{"tokens":[]}' | my instance theme set && my instance theme publish # back to the default{ "tokens": [ { "token": "color-accent", "light": "#ff8a80", "dark": "#ff8a80" }, { "token": "radius-control", "value": "0.25rem" } ]}Logo et icône
Section intitulée « Logo et icône »Outre la miniature et l’image d’aperçu, l’instance peut avoir sa propre icône, son logo et son logo sombre, chacun téléversé sous forme d’un SVG. Tant qu’aucun n’est défini, les images mycroblog intégrées sont utilisées, et en effacer un ramène l’image intégrée.
| Image | Forme | Où elle apparaît |
|---|---|---|
icon |
Carrée (à 1 % près) | Le favicon, l’icône d’écran d’accueil d’iOS (apple-touch-icon), les icônes de l’application installée (Web App Manifest), la carte du serveur sur la page d’accueil et à côté de son nom dans le panneau latéral du client web, et partout où un client montre le serveur sous forme d’image carrée |
logo |
De 1 à 8 fois plus large que haut | L’en-tête du client web et le haut des pages de connexion, d’inscription et de consentement à la place du logotype intégré et du nom du serveur (le logo doit contenir le nom, qui est son texte alternatif), la version HTML de chaque e-mail, et l’image d’aperçu de lien lorsque preview_image n’est pas défini |
logo_dark |
Comme logo |
Les fonds sombres ; sans lui, logo y est utilisé aussi |
- Le serveur assainit le SVG. Il le lit comme du XML et écrit un nouveau document à partir des seuls éléments autorisés (formes, groupes,
defs,symbol,use, dégradés,clipPath,mask,pattern,style,title,desc) et attributs (géométrie, transformations, attributs de présentation,id,class,style). Les scripts,foreignObject, les images intégrées, les liens, les animations, les filtres (ombres et flous), les gestionnaires d’événements, les références à tout ce qui est hors du fichier et les URLdata:sont retirés, et la réponse liste ce qui a été retiré. Seul le SVG assaini est stocké. - Un SVG est refusé (rien n’est enregistré) lorsqu’il n’est pas du XML bien formé en UTF-8, a un
DOCTYPEou des déclarations d’entités, n’a pas deviewBox, dépasse 256 KiB (128 KiB après assainissement), a plus de 5 000 éléments, est imbriqué sur plus de 32 niveaux, a plus de 200 élémentsuse, a une forme erronée pour son type, contient dutext(convertissez d’abord le texte en contours dans votre éditeur), ou a du CSS qui pourrait charger quelque chose (@import,@font-face,url()autre queurl(#id), échappements).@media (prefers-color-scheme: dark)dans un<style>est autorisé, afin qu’une icône puisse changer en mode sombre. - Certains endroits n’acceptent pas le SVG (l’écran d’accueil d’iOS, les favicons de Safari plus anciens, les aperçus de liens, les e-mails). Pour eux, le client qui téléverse le
SVG dessine aussi des versions PNG à partir du SVG assaini et les envoie avec lui : 32, 48, 180, 192 et 512 px et une icône « maskable » de 512 px
pour
icon; un logo d’e-mail de 96 px de haut et une image d’aperçu de lien de 1200 × 630 pourlogo; un logo d’e-mail de 96 px de haut pourlogo_dark. Le serveur vérifie que chacun est un PNG de la bonne taille (1 MiB au plus ; l’icône de 180 px, l’icône maskable et l’aperçu de lien doivent être opaques) et l’écrit de nouveau sans métadonnées. Si un fichier est incorrect, rien n’est enregistré. Les versions opaques de l’icône sont dessinées sur une couleur de fond,#rrggbb, qui est par défaut lecolor-surfaceclair du thème. Le serveur ne vérifie pas que les versions PNG montrent la même image que le SVG. - Les fichiers sont stockés dans le stockage de blobs sous
instance/brand/<revision>/et servis àhttps://<host>/brand/<revision>/<version>.svg|.pngavecCache-Control: public, max-age=31536000, immutable, puisque le contenu d’une révision ne change jamais. Un SVG est servi avecContent-Security-Policy: default-src 'none'; style-src 'unsafe-inline'; sandboxetX-Content-Type-Options: nosniff, de sorte que même ouvert seul il n’exécute rien et ne charge rien. Les fichiers des révisions antérieures restent, afin que les e-mails déjà envoyés conservent leur logo. - Avec une icône définie, la coquille HTML lie ses favicons PNG, son SVG et son
apple-touch-iconde 180 px, le Web App Manifest liste ses icônes de 512 px, 192 px, maskable et SVG dans cet ordre (les autres serveurs du fédivers prennent la première comme icône de ce serveur), et/apple-touch-icon.pngrenvoie la version de 180 px. L’ETag de la coquille change avec les images, et le cache partagé de la coquille dure quelques minutes comme avec le thème. Une application installée prend une nouvelle icône sur Android lorsque Chrome vérifie ensuite le manifeste ; sur les ordinateurs, l’application garde son ancienne icône jusqu’à ce qu’elle soit installée de nouveau. GET /api/v1/instancerenvoieicon,logoetlogo_darkavec l’URL du SVG, l’URL et la taille de chaque version PNG, et la révision ; chacun est omis tant que l’image intégrée est utilisée.- Définissez-les dans le client web sous Paramètres du serveur > Icône et logo (
/admin/settings/branding, permission de rôlemanage_settings). Choisissez un fichier SVG pour l’icône, le logo ou le logo pour les fonds sombres : le serveur le vérifie aussitôt, et le formulaire le montre tel que le serveur le conserverait, avec la liste de ce que le serveur a retiré. Si le serveur refuse le fichier, la raison s’affiche dessous avec la façon de la corriger. Pour l’icône, définissez là aussi la couleur de fond de ses versions opaques. Enregistrer dessine les versions PNG dans le navigateur et envoie chaque image choisie avec elles ; Utiliser l’image intégrée ramène une image à l’image intégrée lorsque vous enregistrez. Le client web conserve les images qu’il a affichées pour un usage hors ligne. - L’API cliente fait de même, avec la permission de rôle
manage_settings:POST /api/v1/admin/instance/brand/sanitizevérifie un SVG et renvoie le SVG assaini avec les versions PNG à dessiner (il n’enregistre rien),PUT /api/v1/admin/instance/brand/{icon|logo|logo_dark}enregistre le SVG avec chaque version PNG (multipart/form-data, une partie par version),DELETEsur le même chemin en efface un, etGET /api/v1/admin/instance/brandrenvoie les images actuelles avec la couleur de fond de l’icône. Chaque changement est conservé comme révision (instance_brand_revisions) et enregistré dans le journal d’audit (setting_changed, ciblebrand_icon,brand_logooubrand_logo_dark). - La CLI ne peut pas les définir, puisque les versions PNG sont dessinées par le client, mais elle peut les afficher et effacer une image cassée :
my instance brand show # each image with its revision, when and by whom it was set, and the URL of its SVGmy instance brand clear icon # back to the built-in icon (also logo, logo_dark)Émojis personnalisés
Section intitulée « Émojis personnalisés »Les émojis personnalisés locaux sont affichés comme des images lorsque quelqu’un écrit :shortcode: dans le corps ou l’avertissement de contenu d’une publication, ou dans le
nom d’affichage, la bio ou les champs du profil. Ils parviennent aussi à Mastodon, Misskey, GoToSocial et Akkoma par la balise Emoji des
Notes et des acteurs que vous envoyez.
- Un shortcode compte de 2 à 30 lettres, chiffres ou
_. Il est sensible à la casse et ne peut pas être modifié après l’enregistrement de l’émoji. Des alias (jusqu’à 10) et une catégorie (jusqu’à 64 caractères) servent à la recherche et au regroupement dans le sélecteur d’émojis. - L’image est PNG, GIF ou WebP, de
custom_emoji_max_bytesau plus (256 KiB par défaut) et de 1 024 px au plus de chaque côté. Le serveur fabrique des dérivés qui tiennent dans des cases de 64, 128 et 256 px et ne conserve pas l’original. Un APNG devient une image fixe de sa première image. GoToSocial ne récupère par défaut pas les émojis de plus de 100 KiB ; de petites images sont donc recommandées. - Un émoji désactivé n’apparaît nulle part (publications, profils, fédération, sélecteur), et
:shortcode:s’affiche de nouveau comme du texte. Un émoji configuré pour être masqué du sélecteur manque seulement au sélecteur et peut toujours être utilisé en l’écrivant. Un émoji venu d’un autre serveur ne peut qu’être désactivé ou copié comme un émoji de ce serveur. - Copier récupère l’image de l’émoji d’un autre serveur sous les mêmes limites que le proxy de médias (les images des domaines avec
reject_mediane sont pas récupérées), exécute les mêmes vérifications que ci-dessus, et l’enregistre comme un nouvel émoji local. Le shortcode est celui de l’original ou celui que vous donnez. L’image est réduite à la case de 256 px, et une image qui ne peut pas être récupérée ou qui échoue aux vérifications ne laisse rien derrière elle. - La suppression ne peut pas être annulée. Les émojis des publications passées redeviennent aussi du texte, et enregistrer de nouveau le même shortcode crée un émoji différent. Les images que des serveurs fédérés ont copiées ne peuvent pas être supprimées.
- L’écran d’administration (« Émojis personnalisés »,
/admin/custom-emojis), l’API cliente (/api/v1/admin/custom_emojis) et la CLI font les mêmes choses. Sur l’écran, « Enregistrer un émoji » ouvre le formulaire d’enregistrement (/admin/custom-emojis/new), qui avertit d’une image de plus de 100 KiB, et choisir un émoji dans la liste ouvre sa page (/admin/custom-emojis/{id}), où vous l’activez ou le désactivez, remplacez son image, changez sa catégorie, ses alias et sa visibilité dans le sélecteur, le supprimez après avoir saisi son shortcode, ou en copiez un d’un autre serveur. L’écran d’administration et l’API cliente exigent la permission de rôlemanage_custom_emojis(seul le rôle intégréadminl’a). L’enregistrement, la copie, le remplacement de l’image, la modification des paramètres et des alias, l’activation et la désactivation, et la suppression sont enregistrés dans le journal d’audit (ciblecustom_emoji) quelle que soit la façon dont ils sont faits (une opération depuis la CLI est enregistrée comme une opération de la CLI).
my admin emoji create -shortcode blobcat -category Cats -alias neko blobcat.png # register onemy admin emoji list -local # list local emoji, newest firstmy admin emoji update -category Animals -alias cat -alias neko <emoji id> # change the category and aliases (aliases are replaced; -no-aliases removes them)my admin emoji update -hidden <emoji id> # hide it from the picker (-hidden=false restores it)my admin emoji replace-image <emoji id> blobcat2.png # replace the imagemy admin emoji disable <emoji id> # disable it (remote emoji too)my admin emoji enable <emoji id> # enable it againmy admin emoji list -remote -domain mastodon.example # list emoji of another servermy admin emoji copy [-shortcode <name>] <emoji id> # copy a remote emoji to localmy admin emoji delete <emoji id> # delete itmy admin emoji requests list [-state pending|approved|rejected|withdrawn|lapsed|all] # list creation requests (pending by default)my admin emoji requests approve <request id> # approve a requestmy admin emoji requests reject [-reason <text>] <request id> # reject a request (the requester sees the reason)- Un utilisateur avec la permission de rôle
create_custom_emojis(une fonction utilisateur) peut demander la création d’un émoji depuis « Émojis personnalisés » dans les paramètres (/settings/custom-emojis), modifier les alias, la catégorie et la visibilité dans le sélecteur des émojis qu’il a créés, et les supprimer ; la page indique combien de demandes il lui reste ce mois-ci. Remplacer une image est aussi une demande, faite avec l’API cliente (POST /api/v1/custom_emoji_requests,kindimage) ; la page des paramètres ne la propose pas. Une demande n’apparaît nulle part (sélecteur, publications, réactions, fédération) tant que quelqu’un avecmanage_custom_emojisne l’a pas approuvée. Approuvez-la ou rejetez-la sur la page « Demandes » de « Émojis personnalisés » de l’écran d’administration (/admin/custom-emojis/requests), avec l’API cliente (/api/v1/admin/custom_emoji_requests), ou avec la CLI ci-dessus. Les personnes avecmanage_custom_emojissont notifiées d’une demande (admin_custom_emoji_request), et le demandeur est notifié de l’approbation ou du rejet. La demande, le retrait, l’approbation et le rejet sont enregistrés dans le journal d’audit (ciblecustom_emoji_request). - Une demande de création en attente réserve son shortcode. Une demande ou un enregistrement avec le même shortcode n’est pas possible tant que celle en attente n’est pas rejetée ou retirée. L’image d’un émoji approuvé est copiée comme un téléversement de l’acteur de l’instance, de sorte qu’elle subsiste même si le compte du demandeur est supprimé.
- Un créateur ne peut modifier ses émojis que tant qu’il détient
create_custom_emojis. Les émojis restent si le rôle est retiré. Les administrateurs peuvent modifier et supprimer chaque émoji quel que soit le créateur. - Lorsque le rôle provient d’une formule de soutien, le nombre d’émojis qu’un utilisateur peut créer chaque mois est limité par la limite mensuelle d’émojis de la formule. Elle compte les demandes de création que l’utilisateur a soumises dans le mois calendaire en cours (UTC) qui sont approuvées ou en attente ; les demandes rejetées et retirées ne comptent pas, et supprimer un émoji ne libère pas de place. Une demande compte dans le mois où elle a été soumise, même si elle est approuvée le suivant. Le compte se réinitialise à 00:00 UTC le premier jour de chaque mois, et la page des paramètres indique à l’utilisateur quand, dans son propre fuseau horaire. Remplacer l’image d’un émoji, et les émojis que les administrateurs enregistrent, ne comptent pas. Un rôle qu’un administrateur a attribué à la main, et un serveur où les soutiens sont désactivés, n’ont aucune limite.
Pour les LLM et les agents de programmation :llms.txt,llms-full.txt, llms-small.txt