Diese Seite ist eine maschinelle Übersetzung der englischen Seite, die maßgeblich ist. Englische Seite lesen
Die englische Seite hat sich geändert, seit diese Abschnitte übersetzt wurden:
Servereinstellungen
Die Einstellungen, die festlegen, wie dein Server betrieben wird: Registrierungsmodus, Beitragslänge, Standard-Locale, wer die Timelines sehen kann, der Servername, die Beschreibung, die Bedingungen, Regeln, das Design und eigene Emojis.
Konfiguration und Servereinstellungen
Abschnitt betitelt „Konfiguration und Servereinstellungen“| Konfiguration | Servereinstellungen | |
|---|---|---|
| Was | Wie das Deployment aufgebaut ist: Rollen, Adapter, Endpunkte, Hostnamen, Secrets | Wie der Server betrieben wird: Registrierungsmodus, Längenlimit für Beiträge, Standard-Locale, wer die Timelines sehen kann, der Servername, die Beschreibung und die Bedingungen |
| Wo | Umgebungsvariablen MY_* und die Konfigurationsdatei (Konfigurationsreferenz) |
Die Datenbank. Jede Änderung wird als Revision aufbewahrt |
| Ändern | Wirkt, wenn der Prozess neu startet | Wirkt sofort mit my instance set, den Admin-Bildschirmen des Webclients oder der Client-API (Admin-Bildschirme und die Client-API) |
| Wenn nicht gesetzt | Der Standard im Schema (der Server startet nicht, wenn der Schlüssel erforderlich ist) | Der im Code definierte Standard |
- Kein Schlüssel steht in beiden. Keines überschreibt das andere. Du kannst eine Servereinstellung nicht über eine Umgebungsvariable oder die Konfigurationsdatei angeben, und du kannst keinen Konfigurationswert in der Datenbank speichern.
- Ein Wert, der pro Deployment feststeht und die Struktur des Prozesses ändert, ist Konfiguration; ein Wert, der sich ändert, während der Server läuft, ist eine Servereinstellung.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- Die Konfiguration ist wie in der Konfigurationsreferenz beschrieben angegeben (
my config check). - Das Schema ist auf die Datenbank angewendet (
my schema apply; siehe Datenbank).
Schlüssel
Abschnitt betitelt „Schlüssel“Einstellungen (ein Schlüssel, ein Wert)
Abschnitt betitelt „Einstellungen (ein Schlüssel, ein Wert)“| Schlüssel | Typ | Standard | Beschreibung |
|---|---|---|---|
registration_mode |
open / approval / invite / closed |
approval |
Der Registrierungsmodus (Registrierung). Solange eine Schließung des Dienstes angekündigt ist und nachdem er geschlossen ist, und auf einem Ein-Personen-Server, ist der wirksame Wert closed. Der gespeicherte Wert ändert sich nicht, und das Zurücknehmen der Ankündigung oder das Ausschalten von single_user stellt ihn wieder her. GET /instance und NodeInfo zeigen den wirksamen Wert |
max_status_length |
Ganzzahl 1-100000 | 500 |
Die maximale Länge eines Beitrags, in Zeichen |
default_locale |
BCP-47-Sprachtag | en |
Die Standardsprache. Sie ist die anfängliche UI-Sprache neuer Benutzer und der Fallback, wenn kein Katalog zur Einstellung eines Benutzers passt |
local_timeline_visibility |
off / signed_in / everyone |
everyone |
Wer die lokale Timeline sehen kann (GET /api/v1/timelines/local): niemand, angemeldete Benutzer oder alle. off antwortet mit 404 und signed_in antwortet Besuchern, die nicht angemeldet sind, mit 401; in beiden Fällen blendet die Navigation sie aus. Solange der Wert nicht everyone ist, zeigt die Startseite keine Beispielbeiträge. Auf einem Ein-Personen-Server gilt sie als off |
federated_timeline_visibility |
off / signed_in / everyone |
signed_in |
Wer die föderierte Timeline sehen kann (GET /api/v1/timelines/federated). Die Werte bedeuten dasselbe wie bei der lokalen Timeline, und auf einem Ein-Personen-Server gilt sie ebenfalls als off |
preview_image |
Medien-ID (leer = nicht gesetzt) | leer | Das Bild der Link-Vorschau (og:image) für die Seiten ohne eigenes Bild, unter „Link-Vorschauen“ in Einstellungen → Allgemein. Ist es nicht gesetzt, wird das Vorschaubild, dann das Logo, dann das mitgelieferte Bild verwendet (Link-Vorschauen) |
contact_account |
Benutzername eines lokalen Kontos (leer = nicht gesetzt) | leer | Das Konto, über das die Betreiber kontaktiert werden. Siehe Kontakt und Vorschaubild |
contact_email |
E-Mail-Adresse (leer = nicht gesetzt) | leer | Die E-Mail-Adresse, über die die Betreiber kontaktiert werden. Sie ist auch das Reply-To und die Signatur der E-Mails, die der Server sendet |
thumbnail |
Medien-ID (leer = nicht gesetzt) | leer | Ein Bild, das die Instanz repräsentiert (Vorschaubild), auf den Info- und Startseiten und in Link-Vorschauen, wenn preview_image nicht gesetzt ist |
remote_media_policy |
none / avatars / all |
none |
Ob Kopien entfernter Medien behalten werden. none: Der Medien-Proxy leitet jede Anfrage weiter. avatars: Avatare, Header und eigene Emojis werden für remote_media_cache_ttl_seconds im Blob-Speicher zwischengespeichert. all: alle entfernten Medien. Die Gesamtgröße des Caches ist durch die Konfiguration remote_media_cache_max_bytes begrenzt |
remote_media_cache_ttl_seconds |
Ganzzahl 60-31536000 (Sekunden) | 86400 |
Wie lange abgerufene entfernte Medien behalten werden dürfen. Es ist auch das Cache-Control: max-age der Antworten des Medien-Proxys, sodass CDNs und Browser so lange zwischenspeichern |
remote_media_cache_max_bytes |
Ganzzahl ab 1 (Bytes) | 1073741824 |
Das Größenlimit der Kopien entfernter Medien, die der Medien-Proxy behält. Die stündliche Bereinigung löscht die abgelaufenen Kopien, dann die am längsten nicht abgerufenen über diesem Limit |
authorized_fetch |
true / false |
false |
Authorized Fetch (sicherer Modus). Bei true wird ein ActivityPub-GET ohne überprüfbare HTTP-Signatur bei Objekten und Collections mit 401 beantwortet und beim Akteur eines Benutzers mit einem minimalen Dokument, das den Schlüssel trägt. Der Instanz-Akteur liefert immer sein ganzes Dokument, sodass jeder Server den Schlüssel abrufen kann, um eine Signatur zu prüfen |
federation_mode |
off / inbound / outbound / both |
both |
Die Richtung der Föderation. off: keine Föderation. inbound: Du folgst entfernten Konten und liest sie, aber lokale Beiträge, Profile und Reaktionen werden nicht gesendet, und Follows von außen werden abgelehnt (Reject). outbound: Du nimmst Follows von außen an und lieferst lokale Beiträge aus, aber entfernte Beiträge und Reaktionen werden nicht aufgenommen. both: senden und empfangen. Eine Änderung wirkt sofort und braucht die Berechtigung manage_settings |
federation_scope |
open / allowlist |
open |
Mit welchen Servern dieser Server föderiert. open: jeder Server, den keine Domain-Maßnahme sperrt. allowlist: nur die Domains der Allowlist und ihre Subdomains; jeder andere Server wird wie gesperrt behandelt, und ActivityPub-GETs brauchen eine Signatur eines erlaubten Servers, was auch immer authorized_fetch sagt. Das Umschalten auf allowlist beendet die Follows mit den Servern, die es abschneidet, endgültig; siehe nur mit erlaubten Servern föderieren. Eine Änderung wirkt sofort und braucht die Berechtigung manage_settings |
dynamic_client_registration |
true / false |
true |
Dynamische Client-Registrierung (RFC 7591). Solange true, akzeptiert POST /oauth/register die Registrierung öffentlicher Clients ohne Authentifizierung. Bei false lehnt der Endpunkt jede Anfrage mit 403 (access_denied) ab; bereits registrierte Clients funktionieren weiter. Ein periodischer Job löscht dynamisch registrierte Clients, die nicht benutzt werden, gemäß der Konfiguration dynamic_client_unredeemed_retention und dynamic_client_idle_retention. Eine Änderung wirkt sofort und braucht manage_settings |
domain_actions_visibility |
off / signed_in / everyone |
off |
Wer die Liste der Domains mit ergriffenen Maßnahmen sehen kann (GET /api/v1/instance/domain_actions): niemand, angemeldete Benutzer oder alle (Moderation) |
domain_actions_rationale_visibility |
off / signed_in / everyone |
off |
Wer die öffentlichen Kommentare dieser Liste sehen kann. Wer die Liste nicht sehen kann, sieht sie nie |
appeal_window_days |
Ganzzahl 20-365 (Tage) | 180 |
Wie viele Tage nach einer Maßnahme die betroffene Person Einspruch einlegen kann (Moderation). Eine Änderung ändert auch die Frist bereits ergriffener Maßnahmen |
session_origins_retention_days |
Ganzzahl 90-3650 (Tage) | 180 |
Wie viele Tage nach einer Anmeldung die IP-Adresse und der User-Agent der Anmeldung behalten werden (Moderation) |
registration_origins_retention_days |
Ganzzahl 90-3650 (Tage) | 180 |
Wie viele Tage nach der Registrierung die IP-Adresse der Registrierung behalten wird |
reports_retention_days |
Ganzzahl 180-3650 (Tage) | 365 |
Wie viele Tage nach der letzten Erledigung eine Meldung behalten wird. Eine Meldung, auf die eine Maßnahme verweist, wird so lange behalten wie die Maßnahme |
moderation_actions_retention_days |
Ganzzahl 180-3650 (Tage) | 365 |
Wie viele Tage nach dem Ende einer Maßnahme (der Aufhebung, dem Ablauf oder der Prüfung eines Einspruchs, je nachdem, was später ist) Kontomaßnahmen und Einsprüche behalten werden |
audit_log_retention_days |
Ganzzahl 365-3650 (Tage) | 730 |
Wie viele Tage nach der Aufzeichnung eine Zeile des Audit-Logs behalten wird |
remote_status_retention_days |
Ganzzahl 1-3650 (Tage) | 90 |
Wie viele Tage ein entfernter Beitrag nach seiner Veröffentlichung behalten wird, wenn auf dieser Instanz nichts auf ihn verweist (eine lokale Antwort, ein Boost, ein Favorit, ein Lesezeichen, eine Benachrichtigung oder ein Thread mit einem lokalen Beitrag) |
remote_status_max_retention_days |
Ganzzahl 0-3650 (Tage) | 0 |
Die höchste Zahl von Tagen, die ein entfernter Beitrag nach seiner Veröffentlichung behalten wird, auch wenn diese Instanz auf ihn verweist. Lokale Antworten, Boosts, Favoriten und Lesezeichen bleiben und zeigen ihn als gelöscht an. 0 setzt kein Limit |
relay_status_retention_days |
Ganzzahl 1-3650 (Tage) | 7 |
Wie viele Tage ein entfernter Beitrag, den nur ein Relay hereingebracht hat, behalten wird, wenn auf dieser Instanz nichts auf ihn verweist und kein lokales Konto seinem Autor folgt |
oauth_client_rate_limits |
kommagetrennte Paare client_id=requests |
leer | Obergrenzen für die Client-API-Anfragen von OAuth-Clients, um einen Client zu bremsen, der den Server überlastet: die Anfragen, die alle seine Benutzer zusammen in 5 Minuten stellen dürfen. Eine Änderung braucht bis zu einer Minute, um zu wirken |
search_indexing |
allow / deny |
deny |
Ob Suchmaschinen die Instanz indexieren dürfen. Auch bei allow werden nur die Profile von indexable-Konten und public-Beiträge indexiert (Suchmaschinen und KI-Crawler) |
ai_usage |
allow / deny_training / deny |
deny |
Die Erklärung gegenüber KI-Diensten. deny_training verweigert das Training; deny verweigert Training und Nutzung durch KI (KI-Suche, Assistenten, Agenten) |
indexable_default |
true / false |
false |
Der Standard von indexable für neue Konten. Eine Änderung ändert bestehende Konten nicht |
auto_delete_default_enabled |
true / false |
false |
Ob neue Konten mit eingeschalteter automatischer Löschung ihrer alten Beiträge beginnen. Zusammen mit den anderen auto_delete_default_*-Schlüsseln ist es die Richtlinie, die ein neues Konto erhält (automatische Löschung alter Beiträge) |
auto_delete_default_min_age_days |
Ganzzahl 1-3650 (Tage) | 30 |
Wie viele Tage nach ihrer Veröffentlichung die Richtlinie eines neuen Kontos einen Beitrag löscht |
auto_delete_default_keep_pinned, auto_delete_default_keep_bookmarked, auto_delete_default_keep_favourited |
true / false |
true |
Ob die Richtlinie eines neuen Kontos die Beiträge behält, die ihr Autor angeheftet, mit einem Lesezeichen versehen oder favorisiert hat |
auto_delete_default_keep_media, auto_delete_default_keep_polls |
true / false |
false |
Ob die Richtlinie eines neuen Kontos die Beiträge mit Medien oder einer Umfrage behält |
auto_delete_default_keep_articles |
true / false |
true |
Ob die Richtlinie eines neuen Kontos Artikel behält |
auto_delete_default_keep_public, auto_delete_default_keep_local, auto_delete_default_keep_unlisted, auto_delete_default_keep_private |
true / false |
false |
Ob die Richtlinie eines neuen Kontos die Beiträge dieser Sichtbarkeit behält |
auto_delete_default_keep_direct |
true / false |
true |
Ob die Richtlinie eines neuen Kontos Direktbeiträge behält |
auto_delete_default_keep_min_boosts, auto_delete_default_keep_min_favourites |
Ganzzahl 0-1000000 | 0 |
Die Richtlinie eines neuen Kontos behält einen Beitrag, der mindestens so oft geboostet oder favorisiert wurde. 0 setzt keine Schwelle |
auto_delete_max_age_days |
Ganzzahl 0-3650 (Tage) | 0 |
Die höchste Zahl von Tagen nach ihrer Veröffentlichung, die ein lokaler Beitrag behalten wird (Höchstdauer). 0 setzt kein Maximum |
auto_delete_max_allow_pinned |
true / false |
true |
Ob angeheftete Beiträge unter dem Maximum weiterhin behalten werden dürfen |
auto_delete_max_kept_pins |
Ganzzahl 1-5 | 5 |
Wie viele Anheftungen unter dem Maximum Beiträge behalten, die zuletzt angeheftete zuerst. 5, die meisten Anheftungen eines Kontos, behält jeden angehefteten Beitrag |
auto_delete_max_allow_bookmarked, auto_delete_max_allow_favourited, auto_delete_max_allow_media, auto_delete_max_allow_polls |
true / false |
false |
Ob die Beiträge, die der Autor mit einem Lesezeichen versehen oder favorisiert hat oder die Medien oder eine Umfrage enthalten, unter dem Maximum weiterhin behalten werden dürfen |
auto_delete_max_allow_articles |
true / false |
true |
Ob Artikel unter dem Maximum weiterhin behalten werden dürfen |
auto_delete_max_allow_visibilities |
true / false |
false |
Ob Beiträge unter dem Maximum weiterhin aufgrund ihrer Sichtbarkeit behalten werden dürfen |
auto_delete_max_allow_thresholds |
true / false |
false |
Ob Beiträge unter dem Maximum weiterhin aufgrund ihrer Boosts und Favoriten behalten werden dürfen |
auto_delete_grace_days |
Ganzzahl 0-365 (Tage) | 30 |
Wie viele Tage ein Konto, für das das Maximum neu gilt, seine eigenen Einstellungen behält, nachdem es informiert wurde. Eine Änderung verschiebt die Daten der bereits informierten Konten nicht |
search_visibilities |
public / local / public,local |
public |
Welche Beiträge die Volltextsuche eines Servers mit einem Such-Backend abdeckt. Beiträge mit unlisted, private und direct werden nie abgedeckt, und nur Konten mit indexable. Wird eine Sichtbarkeit weggelassen, verschwinden ihre Beiträge aus dem Index. Wird eine hinzugefügt, findet die Suche nur neue Beiträge dieser Art, bis du den Index neu aufbaust. Bei search = none bewirkt es nichts |
security_contact |
https:- oder mailto:-URI (leer = nicht gesetzt) |
leer | Wohin Sicherheitsprobleme dieses Servers gemeldet werden sollen: wie er konfiguriert und betrieben wird sowie seine Konten und Daten. Ist sie gesetzt, liefert der Server /.well-known/security.txt (RFC 9116) aus. Das ist dein Kontakt, nicht der der Software: Leite eine Meldung einer Schwachstelle in der Software selbst an das Projekt weiter, wie seine Sicherheitsrichtlinie es beschreibt |
require_media_description |
true / false |
false |
Ob jede Mediendatei (Bild, Video oder Audio), die an einen lokalen Beitrag angehängt wird, eine Beschreibung braucht. Bei true wird ein Beitrag oder eine Bearbeitung mit einer Datei, deren Beschreibung fehlt oder nur aus Leerraum besteht, mit 422 abgelehnt. Sie wird als limits.require_media_description in GET /api/v1/instance veröffentlicht, und der Webclient macht das Beschreibungsfeld zur Pflicht. Sie ist getrennt von der Einstellung require_media_description pro Benutzer, die nur vor dem Senden prüft |
link_cards |
true / false |
true |
Ob Karten für Links in Beiträgen angezeigt werden. Bei true ruft der Server die verlinkte Seite ab, um eine Karte zu bauen. Bei false hört er auf abzurufen und blendet auch bereits gebaute Karten aus. Um es nur bei manchen Domains zu stoppen, siehe Domains für Link-Karten |
link_cards_ignore_robots_txt |
true / false |
false |
Ob die Abrufe von Link-Karten robots.txt überspringen. Bei false befolgt der Server die robots.txt der verlinkten Websites, sodass eine Website, die my-linkcard oder * verbietet, keine Karte erhält (Link-Vorschauen). /about/crawler sagt verlinkten Websites, welcher er ist. Bei true ruft der Server robots.txt weder ab noch verwendet er sie, und eine verlinkte Website kann diese Abrufe damit nicht mehr ablehnen; der Server nennt sich weiterhin my-linkcard. Schalte es nur ein, wenn zu viele Karten fehlen. Karten, die gebaut wurden, während es eingeschaltet war, werden beim nächsten erneuten Abruf geprüft, nachdem es ausgeschaltet ist. Die Direktiven einer Seite und die Domains für Link-Karten gelten in beiden Fällen |
ux_measurement |
true / false |
false |
Ob der Webclient Stichproben darüber sendet, wie schnell er antwortet, und dieser Server sie aufbewahrt (UX-Messungen). Die Stichproben enthalten weder Konto noch Adresse noch URL. Bei false nimmt der Server keine auf, und ux_measurement in GET /api/v1/instance sagt dem Client, dass er keine senden soll |
ux_measurement_share |
Ganzzahl 1-100 (Prozent) | 10 |
Der Anteil der Browsersitzungen, deren Webclient Stichproben sendet, solange ux_measurement true ist. Jede Sitzung wird einmal ausgelost, wenn der Webclient startet; ein kleiner Server kann mit 100 jede Sitzung messen |
oauth_metadata_document_clients |
true / false |
true |
Ob Clients mit Client ID Metadata Document akzeptiert werden. Bei true ruft der Server bei einer Autorisierungsanfrage, deren client_id eine https-URL ist, die Metadaten unter dieser URL ab und behandelt sie als den Client (ohne vorherige Registrierung). Der Abruf folgt keinen Weiterleitungen, liest höchstens 5 KB und verwendet die Antwort höchstens 24 Stunden lang gemäß ihren Cache-Direktiven wieder. Bei false hört er auf abzurufen und lehnt Autorisierungsanfragen, Token-Austausche und Erneuerungen dieser Clients ab |
finance_visibility |
private / totals / breakdown |
private |
Wie viel der laufenden Kosten (erfasst unter /admin/finance/costs und festgelegt unter /admin/finance/publication) veröffentlicht wird. private: Nichts wird veröffentlicht (GET /api/v1/instance/cost_totals ist 404). totals: nur die Summe pro Zeitraum und Währung. breakdown: die Summen und eine Aufschlüsselung nach Anbieter und Kategorie, allen auf den Informationsseiten (/about und /about/costs) und in der API gezeigt. breakdown verrät, bei welchem Anbieter (zum Beispiel welcher Cloud) du betreibst. Auf jeder Stufe bleiben Postennamen, Notizen und einzelne Zahlungen privat. Zeiträume bis einschließlich dem, der den heutigen Tag (UTC) enthält, werden veröffentlicht |
finance_viewer_item_names |
true / false |
false |
Ob Benutzer mit der Berechtigung view_finance auf dem Finanzbildschirm (/finance, GET /api/v1/finance/cost_totals) die Namen von Kostenposten und die Dienstnamen importierter Kosten sehen. Summen und die Aufschlüsselung nach Anbieter und Kategorie werden immer gezeigt, was auch immer diese Einstellung ist |
finance_viewer_item_memos |
true / false |
false |
Ob Benutzer mit view_finance auf dem Finanzbildschirm die Notizen von Kostenposten sehen. Ist entweder die Einstellung für den Namen oder die für die Notiz true, zeigt jeder Zeitraum Postenzeilen (Anbieter, Kategorie und der Betrag dieses Zeitraums, dazu Name und Notiz, wo aktiviert). Leute mit manage_finance sehen unabhängig davon alles |
finance_viewer_income |
totals / plans |
totals |
Ob Benutzer mit view_finance nur die Einnahmensummen (totals) oder auch die Zahl der Abonnenten pro Plan (plans) sehen. Der Betrag pro Plan und wer gezahlt hat, werden nie gezeigt. Ist income_visibility plans, werden die veröffentlichten Zahlen gezeigt, was auch immer dieser Wert ist. Einnahmen werden auf dem Finanzbildschirm des Webclients (/finance) und in GET /api/v1/finance/income_totals gelesen |
income_visibility |
private / totals / plans |
private |
Wie viel der Supporter-Einnahmen (der Betrag nach den Gebühren des Zahlungsanbieters) veröffentlicht wird. Es wird getrennt von finance_visibility gewählt. private: Nichts wird veröffentlicht (GET /api/v1/instance/income_totals ist 404). totals: nur die Einnahmensumme pro Zeitraum und Währung. plans: auch die aktuelle Zahl der Abonnenten pro Plan, allen gezeigt. Bei einem Plan mit wenigen Abonnenten kann die Zahl Leute raten lassen, wer abonniert. Der Saldo (Einnahmen minus Kosten) wird nur gezeigt, wenn weder dieser Wert noch finance_visibility private ist; sonst würde der Saldo die Seite verraten, die du verborgen hast. Auf jeder Stufe bleiben einzelne Zahlungen, Abonnenten, der Betrag pro Plan sowie Brutto-Beträge und Gebühren privat. Zeiträume bis einschließlich dem, der den heutigen Tag (UTC) enthält, werden veröffentlicht |
funding_meter_visibility |
off / percent / amounts |
off |
Was die Finanzierungsanzeige veröffentlicht: wie weit die Einnahmen dieses Monats (nach den Gebühren des Zahlungsanbieters) das monatliche Ziel decken, gezeigt auf der Info-Seite, auf der Liste der Unterstützer (/about/supporters) und in GET /api/v1/instance (funding_meter). Sie wird zusammen mit dem Ziel unter /admin/finance/publication gesetzt, das nur die Auswahlmöglichkeiten anbietet, die die aktuellen Sichtbarkeiten zulassen, und sagt, warum. off: nichts. percent: nur der Prozentsatz, auf 1 % abgerundet, ob der Monat gedeckt ist und ob geschätzte Kosten im Ziel enthalten sind. Sie lässt sich nur wählen, solange finance_visibility und income_visibility beide private sind. amounts: auch die Einnahmen und das Ziel. Sie lässt sich nur wählen, solange keine von beiden private ist. Solange nur eine von beiden veröffentlicht ist, kann die Anzeige nicht gezeigt werden: Die veröffentlichten Beträge und der Prozentsatz würden die verborgene Seite verraten. Wird eine der Sichtbarkeiten so geändert, dass der gewählte Wert nicht mehr erlaubt ist, schaltet die Anzeige auf off, und diese Änderung wird wie jede andere erfasst und im Audit-Log festgehalten. Der Monat ist der Kalendermonat, der den heutigen Tag (UTC) enthält, und nur Einnahmen in der Währung des Ziels zählen |
funding_meter_target_amount |
Dezimalzahl über null oder leer | leer | Das monatliche Ziel der Finanzierungsanzeige, in der Haupteinheit von funding_meter_target_currency (1650 Yen, 12.50 Dollar), mit nicht mehr Dezimalstellen, als die Währung hat. Leer: Das Ziel sind die Kosten dieses Monats, was voraussetzt, dass sie in einer Währung vorliegen; in einem Monat, dessen Kosten in mehreren Währungen anfallen oder null sind, wird die Anzeige nicht gezeigt |
funding_meter_target_currency |
ISO-4217-Code oder leer | leer | Die Währung von funding_meter_target_amount, etwa JPY. Leer: die Währung der Kosten dieses Monats |
funding_meter_rail |
true / false |
false |
Ob der Webclient die Finanzierungsanzeige neben der Info-Seite auch in der rechten Spalte des breiten Layouts zeigt, solange funding_meter_visibility nicht off ist |
supporter_list_visibility |
off / signed_in / everyone |
off |
Wer die Liste der Unterstützer sehen kann (GET /api/v1/instance/supporters und /about/supporters). off: niemand (die API antwortet mit 404, und /about hat keinen Link). signed_in: nur Leute, die auf diesem Server angemeldet sind (die API antwortet sonst mit 401). everyone: alle. Die Liste zeigt nur die Konten und Pläne aktiver Abonnenten, die sich für die Aufnahme entschieden haben; Beträge, monatliche oder jährliche Abrechnung, Daten und Zahlen werden nie gezeigt. Die Listenseite und die API-Antwort sind immer noindex, noarchive, was auch immer search_indexing ist |
user_app_registration |
true / false |
true |
Ob angemeldete Benutzer ihre eigenen OAuth-Apps (öffentlich oder vertraulich) bei der Client-API registrieren können (POST /api/v1/oauth_apps). Bei false antwortet das Registrieren mit 403. Das Auflisten, Ändern und Löschen registrierter Apps, das erneute Ausstellen von Secrets, das Ausstellen eines Tokens für dich selbst und die Autorisierung durch andere Benutzer funktionieren weiter |
voice_room_starters |
everyone / permitted |
permitted |
Wer Sprachchat-Räume öffnen kann, solange die Konfiguration voice nicht off ist (Konfiguration). everyone: jeder angemeldete lokale Benutzer, der nicht gesperrt oder eingeschränkt ist. permitted: nur die Inhaber der Berechtigung start_voice_rooms, die standardmäßig nur die eingebaute Rolle admin hat und die eine Rolle eines Unterstützungsplans haben kann |
voice_public_summary |
true / false |
false |
Ob die Seite eines Sprachchat-Raums, dessen Sichtbarkeit local ist, ihren Namen, ihre Beschreibung, ihren Host und ob er noch offen ist Besuchern zeigt, die nicht auf diesem Server angemeldet sind, sowie entfernten Benutzern, und in ihrer Link-Vorschau. Die Teilnehmer werden nie gezeigt. Bei false sehen diese Besucher nur, dass der Raum für die lokalen Benutzer dieses Servers ist |
event_creators |
everyone / permitted |
everyone |
Wer Veranstaltungen erstellen kann (Veranstaltungen). everyone: jeder angemeldete lokale Benutzer, der nicht gesperrt oder eingeschränkt ist. permitted: nur die Inhaber der Berechtigung create_events, die standardmäßig nur die eingebaute Rolle admin hat und die eine Rolle eines Unterstützungsplans haben kann |
public_counts |
true / false |
true |
Ob die Startseite (/, abgemeldet) und GET /api/v1/instance/overview zeigen, wie viele Mitglieder der Server hat, wie viele öffentliche Beiträge seine Benutzer an jedem der letzten 7 Tage gemacht haben und wann der Server gestartet ist. Es zählen nur öffentliche Beiträge von Benutzern dieses Servers; die Zahlen werden alle paar Minuten aktualisiert. Bei false lässt die API sie weg |
landing_fediverse_explanation |
true / false |
true |
Ob die Startseite (/, abgemeldet) erklärt, wie das Fediverse funktioniert: dass ein Konto hier Leuten auf anderen Servern folgt und von ihnen gefolgt wird |
landing_features |
true / false |
true |
Ob die Startseite zeigt, was die Software auf diesem Server kann, mit einer Vorschau auf jede Funktion, die eingeschaltet ist (Sprachchat-Räume, Veranstaltungen, Artikel, Suche, Übersetzung, Unterstützer) |
featured_accounts |
Benutzernamen von bis zu 20 lokalen Konten, durch Leerzeichen oder Kommas getrennt (leer = keine) | leer | Die Konten, die die Vorschläge von Leuten zum Folgen zuerst zeigen, in dieser Reihenfolge, vor den Leuten dieses Servers, die kürzlich gepostet haben. Ein Konto, dessen Inhaber „Mein Konto vorschlagen und über einen Teil des Namens auffindbar machen“ ausgeschaltet hat, wird nicht vorgeschlagen. Siehe Vorschläge |
login_providers_only |
true / false |
false |
Ob Registrierung und Anmeldung auf die Login-Anbieter beschränkt sind, solange mindestens einer aktiviert ist: Passwörter und Passkeys melden dann nicht mehr an, und Benutzer ohne verknüpften Anbieter können sich nicht erneut anmelden, sobald ihre Sitzungen enden. Ohne aktivierten Anbieter gilt es nicht. my instance set gibt aus, wie viele aktive Benutzer keine Verknüpfung zu einem aktivierten Anbieter haben. Siehe Anmeldung auf Login-Anbieter beschränken. |
invite_creators |
everyone / permitted |
permitted |
Wer neben dem Personal mit manage_invites eigene Einladungen erstellen kann (Einladungen von Mitgliedern). everyone: jeder angemeldete lokale Benutzer, der nicht gesperrt oder eingeschränkt ist. permitted: nur die Inhaber der Berechtigung create_invites, die standardmäßig nur die eingebaute Rolle admin hat und die eine Rolle eines Unterstützungsplans haben kann. Im Modus approval genehmigt eine nutzbare Einladung den neuen Benutzer sofort, sodass everyone jeden Benutzer die Prüfung überspringen lässt |
member_invite_max_active |
Ganzzahl 0-100 | 5 |
Wie viele nutzbare Einladungen (nicht widerrufen, nicht abgelaufen, nicht aufgebraucht) ein Mitglied gleichzeitig halten darf; 0 lässt Mitglieder keine erstellen. Einladungen des Personals zählen nicht |
member_invite_max_uses |
Ganzzahl 1-1000 | 10 |
Wie viele Leute sich mit einer Einladung registrieren dürfen, die ein Mitglied erstellt |
member_invite_max_lifetime_seconds |
Ganzzahl 3600-31536000 (Sekunden) | 2592000 (30 Tage) |
Wie lange eine Einladung, die ein Mitglied erstellt, höchstens gelten darf. Ein Senken verkürzt bestehende Einladungen nicht |
translation_providers |
kommagetrennte Anbieter-IDs | leer | Die serverseitigen Übersetzungsanbieter, die aktiviert sind, der erste wird zuerst versucht. Ist es leer, wird nichts an einen Anbieter gesendet. Eine ID, für die dieser Server keinen Anbieter hat, bewirkt nichts. Die eingebauten Übersetzungsanbieter haben die IDs libretranslate, deepl, google und aws, und ein Übersetzer-Plugin die ID plugin |
translation_provider_visibilities |
kommagetrennte Paare provider=visibility|visibility |
leer | Was jeder Anbieter erhalten darf. Ein nicht genannter Anbieter erhält public-, local- und unlisted-Beiträge; provider= ohne etwas dahinter erhält keine. private und direct gehen nur an einen Anbieter, der mit ihnen genannt ist, sodass das Erlauben eines Anbieters nicht den nächsten erlaubt |
translation_browser |
Boolean | false |
Ob Lesende die im Browser eingebaute Übersetzung nutzen dürfen, die nichts an diesen Server oder an einen Anbieter sendet. Ist zusätzlich ein serverseitiger Anbieter aktiviert, kommt der Anbieter zuerst, und der Browser übersetzt, was der Server ablehnt: einen Beitrag oder eine Sprache, die kein Anbieter annimmt, ein Monatslimit oder einen Anbieter, der ausfällt |
translation_user_monthly_characters |
Ganzzahl 0-1000000000000 | 50000 |
Wie viele Zeichen die Anfragen eines Benutzers in einem UTC-Monat an Übersetzungsanbieter senden dürfen. Bei 0 wird nichts gesendet. Es gibt keinen Wert für unbegrenzt: Setze eine große Zahl |
translation_server_monthly_characters |
Ganzzahl 0-1000000000000 | 500000 |
Wie viele Zeichen der ganze Server in einem UTC-Monat an Übersetzungsanbieter senden darf. Bei 0 wird nichts gesendet. Es gibt keinen Wert für unbegrenzt: Setze eine große Zahl |
translation_retention_days |
Ganzzahl 1-3650 (Tage) | 30 |
Wie viele Tage eine Übersetzung nach ihrer Erstellung behalten wird. Sie zu lesen verlängert das nicht, und sie verschwindet mit dem Beitrag |
translation_reports_to_server |
Boolean | false |
Ob Moderatoren den Text einer Meldung, die gemeldeten Beiträge und den Kommentar der meldenden Person, an die serverseitigen Anbieter senden dürfen. Jeder Anbieter erhält weiterhin nur die Sichtbarkeiten, die translation_provider_visibilities ihm erlaubt, wer auch immer fragt: Ein gemeldeter Direktbeitrag geht nur an einen Anbieter, dem direct erlaubt ist, und der Kommentar zählt als private. Die Übersetzung des Kommentars wird nie behalten, ebenso wenig die eines gelöschten Beitrags, und die Zeichen zählen nur gegen translation_server_monthly_characters. Bei false erreicht nichts von einer Meldung einen Anbieter |
event_records_retention_days |
Ganzzahl 30-3650 (Tage) | 90 |
Wie viele Tage nach dem Ende oder der Absage einer Veranstaltung behalten wird, wer geantwortet hat, wer genehmigt wurde, wer eingeladen wurde und wer über ihre Terminvorschläge abgestimmt hat. Eine Veranstaltung, deren Datum nie festgelegt wurde, endet mit ihrem letzten Terminvorschlag. Die Veranstaltung selbst (ihre Einstellungen, Orte, Datum und Terminvorschläge sowie die Absage) wird behalten. Die Datensätze einer gemeldeten Veranstaltung werden so lange behalten wie die Meldung, und Sperren gelten wie bei den anderen Datensätzen (Aufbewahrung von Datensätzen) |
voice_participants_retention_days |
Ganzzahl 30-3650 (Tage) | 90 |
Wie viele Tage nach dem Ende eines Sprachchat-Raums die Datensätze behalten werden, wer daran teilgenommen hat: die Teilnahmen, die Sprecher und Zuhörer, die gehobenen Hände, die Einladungen und die Entfernungen. Der Raum selbst (sein Name, seine Beschreibung, seine Hosts und wie er endete) wird behalten. Die Datensätze eines gemeldeten Raums werden so lange behalten wie die Meldung, und Sperren gelten wie bei den anderen Datensätzen |
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 |
Wie weit jeder Entscheidungs-Hook handelt, solange er ein Plugin hat. off geht nur über observe zu enforce. |
hook_inbound_status_on_failure, hook_inbound_follow_on_failure, hook_media_check_on_failure, hook_inbound_actor_on_failure |
pass, retry |
pass |
Was der Hook tut, wenn er durchsetzt und sein Plugin ausfällt (Details). |
hook_inbound_status_unfollowed_direct |
Boolean | false |
Ob inbound.status auch die Direktbeiträge von Autoren sendet, denen kein lokales Konto folgt (Details). Die Informationsseite (/about) nennt es, solange der Hook verwendet wird. |
hook_signup_check_on_failure |
pass, require_approval |
pass |
Was signup.check tut, wenn es durchsetzt und sein Plugin ausfällt. |
hook_signup_check_reject |
Boolean | false |
Ob ein reject von signup.check die Registrierung ablehnt, solange es durchsetzt. Ist es aus, wird die Antwort nur aufgezeichnet, wie bei observe. |
hook_local_status_account_age_days |
Ganzzahl 0-3650 (Tage) | 7 |
local.status prüft die Beiträge und ihre Bearbeitungen von Konten, die jünger sind als dies; 0 prüft jedes Konto. Die Informationsseite (/about) nennt es, solange der Hook verwendet wird. |
hook_local_profile_account_age_days |
Ganzzahl 0-3650 (Tage) | 7 |
local.profile prüft die Profiländerungen von Konten, die jünger sind als dies; 0 prüft jedes Konto. Die Informationsseite (/about) nennt es, solange der Hook verwendet wird. |
hook_decisions_retention_days |
Ganzzahl 30-3650 (Tage) | 90 |
Wie viele Tage die Entscheidungen der Hooks behalten werden. |
single_user |
Boolean | false |
Ob der Server ein Ein-Personen-Server ist. Er lässt sich nur einschalten, solange der Server genau ein lokales Konto hat, und jederzeit ausschalten |
max_drafts |
Ganzzahl 1-10000 | 100 |
Wie viele Entwürfe, die nicht geplant sind, ein Benutzer auf dem Server behalten darf. Ein Senken löscht keinen Entwurf: Ein Benutzer darüber speichert keinen neuen |
max_scheduled_posts |
Ganzzahl 1-10000 | 300 |
Wie viele geplante Beiträge eines Benutzers warten dürfen. Ein Senken bricht keinen Zeitplan ab |
max_scheduled_posts_per_day |
Ganzzahl 1-10000 | 25 |
Wie viele geplante Beiträge eines Benutzers auf einen UTC-Tag warten dürfen |
scheduled_post_min_lead_minutes |
Ganzzahl 1-1440 (Minuten) | 5 |
Wie viele Minuten im Voraus ein Beitrag mindestens geplant werden darf |
scheduled_post_max_lead_days |
Ganzzahl 1-3660 (Tage) | 366 |
Wie viele Tage im Voraus ein Beitrag höchstens geplant werden darf |
article_authoring |
everyone / permission |
everyone |
Wer neue Artikel schreiben darf: jeder lokale Benutzer oder nur die Benutzer, deren Rollen die Berechtigung create_articles haben |
max_article_bytes |
Ganzzahl 1000-100000 (Bytes) | 100000 |
Die höchste Zahl von Bytes des HTML, das der Text eines Artikels ergibt |
max_article_images |
Ganzzahl 0-100 | 20 |
Die höchste Zahl von Bildern aus den eigenen Uploads des Autors im Text eines Artikels, neben seinem Titelbild |
- Werte werden normalisiert, bevor sie gespeichert werden (
TRUEwird zutrue,0750wird zu750,ja_jpwird zuja-JP, Medien-IDs werden kleingeschrieben). Ein ungültiger Wert wird abgelehnt, und nichts wird geschrieben. preview_imageundthumbnailakzeptieren nur das Medium eines Bildes, das existiert (auch eines, das noch verarbeitet wird). Bis die Verarbeitung abgeschlossen ist und anstelle eines Bildes, dessen Verarbeitung fehlgeschlagen ist, fälltpreview_imageauf das Standardbild zurück. Sobald ein Medium in irgendeiner Revision gesetzt wurde, löscht die Bereinigung nicht angehängter Uploads es nicht.contact_accountakzeptiert nur den Benutzernamen eines lokalen Benutzers, der nicht gelöscht ist (kleingeschrieben gespeichert).contact_emailakzeptiert nur eine Adresse der Formalice@example.com.featured_accountsakzeptiert nur die Benutzernamen lokaler Benutzer, die nicht gelöscht sind; ein führendes@wird entfernt, die Namen werden kleingeschrieben, ein wiederholter Name wird einmal behalten, und sie werden durch einzelne Leerzeichen getrennt gespeichert.
Vorschläge von Konten
Abschnitt betitelt „Vorschläge von Konten“Angemeldete Nutzer sehen Vorschläge von Personen, denen sie folgen können (auf der leeren Home-Timeline nach der Registrierung und mit
GET /api/v1/accounts/suggestions). Die Vorschläge sind die Konten aus featured_accounts in ihrer Reihenfolge, dann die
Konten dieses Servers, die in den letzten 30 Tagen einen öffentlichen oder lokalen Beitrag veröffentlicht haben, das zuletzt aktive zuerst. Das
eigene Konto des Nutzers, die Konten, denen der Nutzer folgt, die er sperrt oder stummschaltet oder von denen er gesperrt wird, sowie gesperrte oder
deaktivierte Konten bleiben außen vor.
Neue Konten werden vorgeschlagen und lassen sich in der Kontosuche über einen Teil ihres Namens finden. Ein Nutzer, der in den Profileinstellungen „Mein Konto vorschlagen und über einen Teil des Namens auffindbar machen“ ausschaltet, verlässt beides: Die Suche findet das Konto dann nur über seinen vollständigen Benutzernamen oder für die Personen, die ihm folgen.
Automatische Löschung alter Beiträge
Abschnitt betitelt „Automatische Löschung alter Beiträge“Benutzer können ihre eigenen Beiträge einige Tage nach der Veröffentlichung automatisch löschen lassen (Einstellungen, „Alte Beiträge löschen“).
Die Richtlinie jedes Benutzers gehört ihm: ob sie an ist, nach wie vielen Tagen und welche Beiträge sie behält (angeheftete, mit Lesezeichen versehene und
favorisierte Beiträge, Beiträge mit Medien oder einer Umfrage, Artikel, Beiträge bestimmter Sichtbarkeiten und Beiträge mit mindestens einer bestimmten Zahl von Boosts
oder Favoriten). Einen Beitrag auf diese Weise zu löschen, ist dasselbe, wie wenn sein Autor ihn löscht: Die Server, an die er ging, erhalten ein Delete.
Nur die Beiträge lokaler Konten werden auf diese Weise gelöscht, nie Boosts.
Die Schlüssel auto_delete_default_* sind die Richtlinie, mit der jedes neue lokale Konto beginnt, auf welchem Weg auch immer es erstellt wird
(das Registrierungsformular, ein externer Login-Anbieter, eine Einladung oder my admin). Das Konto erhält sie bei der Erstellung und
besitzt sie dann: Eine spätere Änderung der Schlüssel ändert weder die bestehenden Konten noch die, die einen früheren Wert erhalten haben.
Der Einstellungsbildschirm zeigt die Werte als die eigenen des Benutzers. Sind die Schlüssel nicht gesetzt, beginnt ein neues Konto mit ausgeschalteter automatischer
Löschung, nach 30 Tagen, wobei angeheftete, mit Lesezeichen versehene und favorisierte Beiträge, Artikel und Direktbeiträge behalten werden. Der Standard wird
Leuten außerhalb der Instanz nicht gezeigt. Ist ein Maximum gesetzt, erhält ein neues Konto den auf das Maximum gekürzten Standard, wie
unten beschrieben, sodass es innerhalb davon beginnt.
Eine Höchstdauer für das Aufbewahren von Beiträgen
Abschnitt betitelt „Eine Höchstdauer für das Aufbewahren von Beiträgen“Bei auto_delete_max_age_days über 0 wird kein lokaler Beitrag länger als so viele Tage nach seiner Veröffentlichung aufbewahrt.
Für jedes lokale Konto ohne die Berechtigung keep_posts_longer:
- Die automatische Löschung ist immer eingeschaltet: Ein Nutzer kann sie nicht ausschalten und nicht mehr Tage wählen als die Höchstdauer (weniger ist
in Ordnung). Der Einstellungsbildschirm und
PUT /api/v1/preferences/auto_deleteweisen beides ab. - Nur die Ausnahmen, die die
auto_delete_max_allow_*-Schlüssel erlauben, behalten Beiträge. Standardmäßig tun das nur angeheftete Beiträge, alle von ihnen; beiauto_delete_max_kept_pinsunter 5 behalten nur so viele der neuesten Anheftungen ihre Beiträge. - Nutzer, die die automatische Löschung ausgeschaltet oder nie eingestellt haben, unterliegen ebenfalls der Höchstdauer.
Das Einschalten der Höchstdauer, ihre Senkung oder das Ändern der Ausnahmen schreibt die Einstellungen von niemandem um. Stattdessen findet der Job
content.auto_delete_statuses jede Stunde die Konten, deren eigene Einstellungen Beiträge behalten, die die Höchstdauer nicht behält (weil
die Höchstdauer eingeschaltet oder gesenkt wurde oder das Konto keep_posts_longer verloren hat). Er informiert jedes davon einmal, mit einer
Benachrichtigung und einer E-Mail, die standardmäßig eingeschaltet sind, und sagt, ab wann die Höchstdauer gilt: auto_delete_grace_days nach
der Mitteilung. Bis dahin bleiben die eigenen Einstellungen des Kontos in Kraft; danach richten sich seine Beiträge nach der Höchstdauer. Ein Konto,
das wieder innerhalb der Höchstdauer liegt (sein Nutzer ändert die Einstellungen, es erhält keep_posts_longer, oder die Höchstdauer entfällt oder
steigt), wird nicht mehr festgehalten, und eine spätere Änderung informiert es erneut mit einer neuen Karenzzeit.
Das Einschalten der Höchstdauer informiert innerhalb der Stunde jedes Konto, das betroffen ist. Löschungen behalten ihr Tempo: höchstens 100 Beiträge
eines Kontos pro Stunde, jeder als Delete an die Server gesendet, an die der Beitrag ging, ein Konto mit vielen alten Beiträgen
braucht also Stunden oder Tage, um leer zu werden. Ein Nutzer, der in der Zwischenzeit seine Einstellungen ändert, stoppt den Rest.
keep_posts_longer ist eine Mitgliederberechtigung: Gib sie einer Rolle, damit ihre Inhaber ihre Beiträge so lange behalten können, wie sie wollen,
und die automatische Löschung ausschalten können. Die eingebaute Rolle admin hat sie. Ein Unterstützungsplan kann sie tragen, sodass
das längere Aufbewahren von Beiträgen ein Vorteil des Plans sein kann; wenn das Abo endet, gilt die Höchstdauer nach der Karenzzeit
wieder.
Die Höchstdauer ist öffentlich: GET /api/v1/instance gibt sie in auto_delete_limit zurück, und die Info-Seite zeigt sie, damit Menschen
sie kennen, bevor sie sich registrieren. Änderungen dieser Schlüssel brauchen manage_settings und werden wie jede
andere Einstellung im Audit-Log festgehalten. Im Webclient stehen sie auf der Seite „Beitragslöschung“ der „Servereinstellungen“, die nachfragt, bevor sie eine
Höchstdauer speichert, die eingeschaltet oder verschärft wird.
Entwürfe und geplante Beiträge
Abschnitt betitelt „Entwürfe und geplante Beiträge“Benutzer speichern Entwürfe von Beiträgen auf dem Server, schreiben auf einem anderen Gerät weiter und veröffentlichen sie sofort oder zu einer gewählten
Zeit. Nur ihr Autor liest einen Entwurf; Entwürfe werden nie föderiert, stehen nicht im Export der Daten eines Kontos und verschwinden
mit dem Konto, wenn es gelöscht wird. Die fünf Einstellungen max_drafts und scheduled_post_* oben begrenzen sie; ein Speichern oder
Planen über ein Limit hinaus wird mit einer Meldung abgelehnt, die es nennt.
- Ein geplanter Beitrag wird vom Job
content.publish_scheduled_draftzu seiner Zeit oder kurz danach veröffentlicht, auch wenn die Zeit weiter in der Zukunft liegt als das Verzögerungslimit des Queue-Dienstes: Der Job kommt zurück und wartet erneut. Setze sie mitmy instance set, zum Beispielmy instance set max_scheduled_posts 100. - Der Beitrag wird geprüft, wenn er veröffentlicht wird, nicht nur, wenn er geplant wird: Ein Benutzer, dem eine Moderationsmaßnahme bis dahin das
Posten verwehrt oder dessen Beitrag auf einen Beitrag antwortet oder ihn zitiert, der nicht mehr existiert, erhält keinen Beitrag. Der Entwurf bleibt, und der Benutzer
erhält eine Benachrichtigung, die sagt, warum (
scheduled_status_failed, die Benutzer in ihren Benachrichtigungseinstellungen ausschalten können und die nie per E-Mail gesendet wird). Die automatisierte Prüfung lokaler Beiträge prüft den Beitrag, solange sie verwendet wird, wenn er veröffentlicht wird. - Ein Beitrag erhält als Zeitstempel die Zeit seiner Veröffentlichung, und die automatische Löschung alter Beiträge zählt ab dann.
- Die Mediendateien, die ein Entwurf anhängt, bleiben erhalten, solange der Entwurf es tut; das Löschen des Entwurfs macht sie nicht angehängt, und sie verschwinden mit der Bereinigung nicht angehängter Uploads. Das Titelbild des Entwurfs eines Artikels und die Uploads, die sein Text zeigt, bleiben auf dieselbe Weise erhalten.
- Entwürfe und geplante Beiträge schließen Artikel ein, die wie Beiträge geplant und gezählt werden. Der Entwurf eines Artikels darf seinen Titel entbehren, während sein Autor schreibt; er wird bei der Veröffentlichung wie ein neuer Artikel geprüft, und ein Benutzer, der bis dahin keine neuen Artikel mehr schreiben darf, erhält keinen Artikel.
Artikel
Abschnitt betitelt „Artikel“Ein Artikel ist ein langer Beitrag mit einem Titel, einer Zusammenfassung und einem Titelbild, dessen Text sein Autor in Markdown schreibt. Artikel sind in jeder anderen Hinsicht Beiträge: Sie haben eine Sichtbarkeit, lassen sich bearbeiten, wobei ihr Verlauf erhalten bleibt, boosten, favorisieren, zitieren, beantworten, melden und löschen, und die Moderation wirkt auf sie wie auf Beiträge. Der Server rendert den Text einmal, wenn er geschrieben wird: Rohes HTML darin wird nicht gerendert, und nur die Bilder aus den eigenen Uploads des Autors erscheinen als Bilder; jedes andere Bild wird zu einem Link, sodass Lesende nie Bilder von anderen Websites laden. Timelines, Benachrichtigungen und die Suche zeigen den Titel, die Zusammenfassung und das Titelbild; der Text erscheint dort, wo der Artikel geöffnet wird.
- Standardmäßig darf jeder lokale Benutzer Artikel schreiben. Ist
article_authoringaufpermissiongesetzt, dürfen nur die Benutzer, deren Rollen die Berechtigungcreate_articleshaben, neue schreiben; die bereits geschriebenen Artikel bleiben, und ihre Autoren dürfen sie weiterhin bearbeiten. Eine Moderationsmaßnahme, die einem Konto das Posten verwehrt, verwehrt ihm auch das Schreiben und Bearbeiten von Artikeln. Ein Unterstützungsplan kanncreate_articlesals Vorteil geben. max_article_bytesbegrenzt das HTML eines Textes, nicht das Markdown: Die Server, die Artikel empfangen, zählen das HTML, und 100.000 Bytes, das Höchste, was es sein darf, ist das, was sie vollständig behalten. Ein Text auf Japanisch von etwa 30.000 Zeichen passt.max_article_imagesbegrenzt die Bilder in einem Text. Der Editor zeigt beides an, bevor der Artikel veröffentlicht wird.- Ein Artikel ist nie ein Direktbeitrag und hat keine Umfrage, keine anderen Anhänge als seine Bilder und keine Inhaltswarnung: Ein sensibler Artikel zeigt seinen Titel und seine Zusammenfassung und klappt den Text und das Titelbild ein.
- Die automatische Löschung alter Beiträge behält Artikel, es sei denn, der Benutzer schaltet das aus (
auto_delete_default_keep_articlesfür neue Konten,auto_delete_max_allow_articlesunter einem Maximum). GET /api/v1/instancegibt die Limits inlimits.articlesund die Einstellung zum Verfassen inarticle_authoringzurück. Setze sie mitmy instance set, zum Beispielmy instance set article_authoring permission.
Veranstaltungen
Abschnitt betitelt „Veranstaltungen“Lokale Benutzer planen Veranstaltungen mit einem Datum, einer Zeitzone und bis zu drei Orten: einem Sprachchat-Raum dieses Servers, einem Treffpunkt vor Ort und einem Link. Statt eines Datums kann ein Organisator bis zu 20 Terminvorschläge anbieten: Die Benutzer, die die Veranstaltung sehen, antworten bei jedem mit Ja, Vielleicht oder Nein, und der Organisator oder ein Co-Veranstalter bestätigt dann einen, was das Datum festlegt. Bis dahin antwortet niemand, ob er kommt. Veranstaltungen sind nur für die Benutzer dieses Servers: Sie werden nie föderiert, und entfernte Benutzer und Besucher, die nicht angemeldet sind, sehen keine davon.
- Wer eine erstellen darf, bestimmt
event_creators. Ein Organisator muss außerdem Sprachchat-Räume öffnen können (voice_room_startersund die Konfigurationvoice), um eine Veranstaltung in einem abzuhalten. - Der Sprachchat-Raum einer Veranstaltung öffnet sich zu ihrem Beginn, vom Organisator gehostet, und wartet bis zu 30 Minuten auf den ersten Teilnehmer. Er übernimmt den Titel der Veranstaltung und ihre Sichtbarkeit (jeder lokale Benutzer, Follower, die Leute, denen der Organisator folgt, gegenseitige Follows oder die Eingeladenen). Die Co-Veranstalter, die, die „Ich komme“ oder „Vielleicht“ geantwortet haben, und die Eingeladenen, die nicht geantwortet haben, werden in den Raum eingeladen, sodass sie ihn weiterhin sehen, wenn ein Co-Host ihn übernimmt. Der Raum erzeugt keinen Startbeitrag, und die Startbenachrichtigung der Veranstaltung ist seine einzige Benachrichtigung.
- Ein Raum, der nicht geöffnet werden kann (der Sprachchat ist aus, der Organisator darf keine Räume mehr öffnen oder hostet einen anderen, oder
so viele Räume sind offen, wie die Konfiguration
voice_max_open_roomserlaubt), lässt die Veranstaltung, wie sie ist: Der Organisator wird benachrichtigt, und die Seite der Veranstaltung sagt, dass der Raum nicht geöffnet werden konnte. Der Server prüft das, wenn das Datum gesetzt oder geändert wird, und auch einen Tag vor dem Beginn und benachrichtigt den Organisator, was den Raum geschlossen halten würde. Der Organisator wird auch benachrichtigt, wenn niemand in den Raum kam. Das Absagen der Veranstaltung oder das Entfernen ihres Sprachchat-Raums beendet den Raum und behält die Veranstaltung. - Der Organisator wählt, wer die Veranstaltung sieht: jeder lokale Benutzer, die Follower des Organisators, die Leute, denen der Organisator folgt, gegenseitige Follows oder nur die Eingeladenen. Die Eingeladenen und die, die sie oder ihre Terminvorschläge beantwortet haben, sehen sie immer, und eine Blockierung zwischen einem Benutzer und dem Organisator oder einem Co-Veranstalter verbirgt sie vor diesem Benutzer.
- Die Adresse und der Link einer Veranstaltung werden nur den Teilnehmern gezeigt, die der Organisator oder ein Co-Veranstalter genehmigt hat,
es sei denn, der Organisator zeigt sie allen, die die Veranstaltung sehen. Links müssen
httpoderhttpssein, und der Server öffnet sie nie. - Ein Benutzer, der eine Veranstaltung sieht, kann sie als iCalendar-Datei (
.ics) speichern, um sie zu seinem eigenen Kalender hinzuzufügen. Die Datei nennt nur die Orte, die dieser Benutzer sieht, sodass eine Adresse, die den genehmigten Teilnehmern vorbehalten ist, nie darin erscheint. Es gibt keine Adresse zum Abonnieren des Kalenders. - Ein Benutzer erstellt höchstens 10 Veranstaltungen pro Stunde, und eine Veranstaltung sendet höchstens 100 Einladungen pro Stunde.
- Benutzer können eine Veranstaltung melden, und Moderatoren können eine absagen; das Sperren oder Löschen eines Organisators sagt dessen
noch nicht begonnene Veranstaltungen ab (Moderation). Wer geantwortet hat und wer eingeladen wurde, wird
event_records_retention_daysnach der Veranstaltung behalten, ebenso die Stimmen zu ihren Terminvorschlägen.
Texte (ein Schlüssel, ein Wert)
Abschnitt betitelt „Texte (ein Schlüssel, ein Wert)“| Schlüssel | Limit | Beschreibung |
|---|---|---|
name |
100 Zeichen, eine Zeile (Leerraum allein ist nicht erlaubt) | Der Servername (Anzeigename). Siehe Name und Domain |
short_description |
500 Zeichen | Eine Kurzbeschreibung |
description |
20000 Zeichen | Die Beschreibung |
terms |
100000 Zeichen | Die Nutzungsbedingungen (Markdown) |
privacy_policy |
100000 Zeichen | Die Datenschutzerklärung (Markdown) |
commerce_disclosure |
100000 Zeichen | Die Pflichtangaben des Verkäufers für bezahlte Pläne, etwa die Mitteilung, die japanisches Recht verlangt (Markdown; Unterstützer) |
preview_image_alt |
1500 Zeichen | Der Alternativtext des Bildes preview_image (og:image:alt). Ist er nicht gesetzt, wird „Image of {instance name}“ verwendet |
thumbnail_alt |
1500 Zeichen | Der Alternativtext des Bildes thumbnail |
- Jeder Text hat einen Wert. Ein Administrator schreibt ihn einmal in einer beliebigen Sprache, und Lesende jeder Locale sehen denselben Wert; Lesende anderer Sprachen sind auf maschinelle Übersetzung oder Ähnliches angewiesen. Die Beschriftungen und Beschreibungen der Admin-Felder werden wie jeder andere Bildschirmtext in die Sprache des Betrachters übersetzt; nur der Wert, den ein Administrator schreibt, nicht.
- Der Server kennt die Sprache eines Textes nicht, daher geben der Webclient und die vom Server gerenderten Bildschirme Texte mit
dir="auto"undlang=""(der HTML-Wert für eine unbekannte Sprache) aus, anstatt die Sprache des Bildschirms zu erben. - Das Setzen eines leeren Textes löscht ihn.
- Neben der CLI lassen sich Texte auf den Admin-Bildschirmen des Webclients ändern (Name, Kurzbeschreibung und Beschreibung auf
der Seite „Allgemein“ der „Servereinstellungen“,
/admin/settings/general; die Bedingungen unter/admin/documents/terms, die Datenschutzerklärung unter/admin/documents/privacy-policyund die Pflichtangaben für den Handel unter/admin/documents/commerce-disclosure, jeweils eine Seite von „Bedingungen und Richtlinien“,/admin/documents) und mit der Client-API (GET /api/v1/admin/instance_texts,PUT /api/v1/admin/instance_texts/{key}). Beides braucht die Rollenberechtigungmanage_settings, und Änderungen werden im Audit-Log festgehalten (text_changed).
Bedingungen und Datenschutzerklärung
Abschnitt betitelt „Bedingungen und Datenschutzerklärung“- Schreibe
terms,privacy_policyundcommerce_disclosurein Markdown (CommonMark plus die Tabellen, das Durchgestrichene und die Autolinks von GitHub Flavored Markdown). Ein Zeilenumbruch innerhalb eines Absatzes bleibt ein Zeilenumbruch, und#-Überschriften beginnen eine Ebene unter dem Seitentitel (h2). - Der Server wandelt sie in HTML um und bereinigt es (anonymes
GET /api/v1/instance/documents/{kind}), und die Webclient-Seiten/about/terms,/about/privacyund/about/commercezeigen sie an. Rohes HTML, Bilder und andere Links alshttp,httpsundmailtowerden entfernt. Die Seiten brauchen keine Anmeldung (es sind Webclient-Seiten, sie brauchen also JavaScript)./about/commerceist die URL, die dem Zahlungsanbieter gegeben wird. - Ein Dokument, das du schreibst, wird vom Registrierungsbildschirm, von der Fußzeile jedes vom Server gerenderten Bildschirms und vom Webclient verlinkt (die dritte Spalte, das Menü, die Einstellungen und der Anmeldebildschirm). Ein Dokument, das nicht geschrieben ist, wird nicht verlinkt, und seine API antwortet mit 404.
- Solange die Nutzungsbedingungen oder die Datenschutzerklärung geschrieben sind, listet der Registrierungsbildschirm sie vor der Schaltfläche zum Erstellen mit einem Pflichtkästchen auf, „Ich habe die obigen Dokumente gelesen und stimme ihnen zu“. Der Server weist eine Registrierung ohne dieses ab, auch eine über einen Anmeldeanbieter. Ohne eines der beiden Dokumente verlangt der Bildschirm keine Zustimmung.
Name und Domain
Abschnitt betitelt „Name und Domain“Ein Server hat getrennt eine Domain und einen Namen.
- Die Domain ist die Konfiguration
host(undaccount_domain, die Domain der Handles). Sie lässt sich nicht ändern, solange die Server läuft. Handles (@alice@example.com), URLs, ActivityPub-IDs unddomaininGET /api/v1/instancebleiben die Domain, auch wenn es einen Namen gibt. - Der Name ist der Text
name. Er erscheint überall dort, wo der Server Menschen gegenüber benannt wird: die Seitenleiste und „Über diesen Server“ des Webclients, der Titel des Browser-Tabs, die vom Server gerenderten Bildschirme für Anmeldung, Registrierung, E-Mail-Bestätigung, Kontostatus und Autorisierungszustimmung, E-Mails (Bestätigung der E-Mail-Adresse und Benachrichtigungen an Moderatoren),og:site_namevon Link-Vorschauen,name/short_namedes Web App Manifests,metadata.nodeNamevon NodeInfo undnameinGET /api/v1/instance. - Der Name ist in jeder Locale gleich. Gibt es keinen Namen, wird stattdessen die Domain (
host) angezeigt. - Eine Änderung wirkt ab der nächsten Anfrage, ohne Neustart. Der Tab-Titel und die Seitenleiste eines geöffneten Webclients werden aktualisiert, wenn du auf dem Admin-Bildschirm speicherst.
Kontakt und Vorschaubild
Abschnitt betitelt „Kontakt und Vorschaubild“Der Kontakt der Betreiber (contact_account, contact_email) und das Bild, das der Server repräsentiert (thumbnail
und der Text thumbnail_alt), erscheinen an den folgenden Stellen. Was nicht gesetzt ist, erscheint nicht.
- „Über diesen Server“ des Webclients (
/about). Das Vorschaubild und das Kontaktkonto erscheinen außerdem auf dem ersten Bildschirm (/) für Personen, die nicht angemeldet sind. contact(accountundemail) undthumbnail(url,width,height,alt) inGET /api/v1/instance.metadatain NodeInfo:maintainernach der Misskey-Konvention (nameist der Anzeigename des Kontaktkontos oder sein Benutzername, wenn es keinen hat;emailistcontact_email),staffAccountsnach der Konvention von Pleroma und Akkoma (die Actor-ID des Kontaktkontos),thumbnail(urlundalt) undnodeDescriptionaus der Kurzbeschreibungshort_description.
Ist das Kontaktkonto gesperrt oder gelöscht, wird das Konto nicht angezeigt, sondern nur die E-Mail-Adresse.
Ändere sie auf der Seite „Allgemein“ des Admin-Bildschirms des Webclients („Servereinstellungen“, /admin/settings/general) oder mit der CLI oder der Client-API.
Ein-Personen-Server
Abschnitt betitelt „Ein-Personen-Server“Ein Server, der nur seinem Betreiber gehört, das eigene Zuhause des Betreibers im Fediverse, ist ein Ein-Personen-Server: Schalte single_user ein. Im Webclient
schaltet ein Administrator ihn mit Ein-Personen-Server auf der Seite Registrierung der Servereinstellungen ein und aus,
die sagt, warum der Server ihn abgelehnt hat, wenn er mehr als ein lokales Konto hat.
my instance set single_user truemy instance set single_user false # back to a community server- Er lässt sich nur einschalten, solange genau ein lokales Konto zählt. Jedes lokale Konto, das nicht gelöscht ist, zählt,
auch solche, die auf Genehmigung warten, deaktiviert, zur Löschung vorgesehen, gesperrt oder eingeschränkt sind, da jedes als
zweite Person zurückkommen könnte. Ein Konto, dessen Registrierung abgelehnt wurde, zählt nicht. Bei jeder anderen Zahl
schlägt
my instance setmit der Zahl fehl, und die Admin-API antwortet mit422und dem Typ/api/v1/problems/single-user-requires-one-account. Der Server-Actor des Servers ist kein Konto und zählt nie. - Er lässt sich jederzeit ausschalten. Das Ein- oder Ausschalten löscht nichts und ändert den gespeicherten Wert keiner anderen Einstellung: Was er zurückhält, gilt wieder wie zuvor, sobald er aus ist. Wie jede Einstellung wird die Änderung im Audit-Log festgehalten.
Solange er eingeschaltet ist:
- Die Registrierung ist geschlossen.
registration_modegilt alsclosed, was es auch speichert, die Registrierungsseite, die Registrierung über einen Anmeldeanbieter undmy admin createerstellen also kein Konto. Die Anmeldung mit einem Anmeldeanbieter funktioniert weiterhin. - Nur die Home-Timeline.
local_timeline_visibilityundfederated_timeline_visibilitygelten alsoff. Hashtag- und Listen-Timelines bleiben. - Was eine Community braucht, ist verborgen. Die lokale und die föderierte Timeline und ihre Streams, die Kontovorschläge,
die Einladungen von Nutzer und von Administratoren, die Prüfung von Registrierungen und die Registrierungssperren antworten mit
404und dem Typ/api/v1/problems/single-user-mode. - Keine neuen lokalen Beiträge. Auf einem Server für eine Person erreicht ein Beitrag für „Nachbarn“ nur die Follower, daher kann ein neuer
Beitrag nicht lokal sein: Die Client-API antwortet mit
422und lässt es aus dem weg, was ein Konto veröffentlichen darf. Eine Standard-Sichtbarkeit von „Nachbarn“ gilt als „Nur Follower“ und lässt sich nicht speichern, und ein Sprachchat-Raum für die Personen dieses Servers kündigt sich in einem Beitrag für die Follower an. Beiträge, die bereits lokal sind, bleiben lokal. - Der Server sagt, was er ist.
single_userinGET /api/v1/instanceisttrue, mit dem wirksamen Registrierungsmodus und den Timelines sowie dem Konto des Betreibers alssingle_user_account, und NodeInfo antwortet mitopenRegistrations: falseundmetadata.singleUser: true. - Die Startseite ist das Profil des Betreibers. Personen, die nicht angemeldet sind und die Adresse des Servers öffnen, sehen das Profil seines einen Kontos, mit dem Weg zur Anmeldung und Links zur Info-Seite, den Nutzungsbedingungen und der Datenschutzerklärung, die der Server veröffentlicht. Der Webclient blendet aus, was der Server nicht anbietet, aus Navigation, Menüs und Administrationsbildschirmen: die lokale und die föderierte Timeline, die Registrierung, vorgeschlagene Konten, Einladungen, die Prüfung von Registrierungen, die Registrierungssperren, die Sichtbarkeit „Nachbarn“ und die Einstellungen für Registrierung, Einladungen, die öffentlichen Timelines, die Landingpage und vorgeschlagene Konten.
Föderation, Moderation, die Volltextsuche, das Unterstützerprogramm, die Dokumente und die Admin-Bildschirme funktionieren wie auf jedem Server.
Verwendung
Abschnitt betitelt „Verwendung“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"- Schreibe Flags vor den Schlüssel und den Wert.
- Mit
-owner <username>wird der Wert vonpreview_imageoderthumbnailals Pfad einer Bilddatei gelesen und als Medium dieses lokalen Kontos hochgeladen. Der Worker verarbeitet das Bild, bevor es verwendet wird. Empfohlen wird ein Querformatbild von 1200x630. - Eine Änderung erfasst eine Revision (
instance_*_revisions) und aktualisiert den aktuellen Wert (instance_settings/instance_texts) in einer Transaktion. Eine Änderung über die CLI wird ohne Akteur erfasst (BYistcliim Verlauf). - Das erneute Setzen desselben Wertes fügt trotzdem eine Revision hinzu.
- Exit-Codes: 0 für Erfolg, 1 für einen abgelehnten Wert oder einen Datenbankfehler (nichts ändert sich), 2 für falsche Argumente.
Die Richtung der Föderation ändern
Abschnitt betitelt „Die Richtung der Föderation ändern“- Das Einengen behält Follow-Beziehungen, importierte Beiträge und Zustellungsaufzeichnungen und sendet kein
UndooderReject. Der Fluss stoppt nur, und die Rückkehr zuboth(oder einem anderen Modus) setzt ihn fort, wie er war. - Beiträge und Reaktionen, die während des Einengens entstanden sind, werden nach dem erneuten Erweitern nicht nachträglich zugestellt.
- Auf der entfernten Seite erhalten die Follower lokaler Nutzerr nichts, solange der Modus
inboundist, und die Follows lokaler Nutzerr werden nicht aktualisiert, solange eroutboundoderoffist. - Löschungen (von Beiträgen oder Konten), die im Modus
offerfolgen, werden nicht ausgesendet. Ininboundundoutboundgeht der Widerruf dessen, was bereits ausgesendet wurde (Deleteund Ähnliches), an die ursprünglichen Empfänger und die Follower zu diesem Zeitpunkt. - Änderungen werden in
instance_setting_revisionsund im Audit-Log festgehalten (target_kind = setting).
Um auch die Beziehungen zu trennen, verwende die 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- Es beendet die ausstehenden und aktiven Follows zwischen lokalen und entfernten Konten als Beendigungen durch Moderation
(
follow_terminations,reason = moderation). Ein Moduswechsel ruft es nie automatisch auf. Reject(in) oderUndo(out) wird nur dann an die entfernte Seite gesendet, wenn der aktuelle Modus diese Richtung sendet. In einem Modus, der das nicht tut (etwaoff), endet der Follow nur auf der lokalen Seite, und die entfernte Seite wird nicht informiert.- Es ist gefahrlos wiederholbar. Es gibt die Zahl der beendeten Follows auf der Standardausgabe aus.
Admin-Bildschirme und die Client-API
Abschnitt betitelt „Admin-Bildschirme und die Client-API“Jede Einstellung, die die CLI ändern kann, lässt sich auch auf den Admin-Bildschirmen des Webclients und mit der Client-API ändern. Beide brauchen
die Rollenberechtigung manage_settings (nur die eingebaute Rolle admin hat sie). Wie bei der CLI wird eine Änderung als Revision behalten
und pro Schlüssel im Audit-Log erfasst (setting_changed, das Ziel ist die Einstellung und der Akteur dieser Benutzer). Sieh dir das
Audit-Log auf dem Moderationsbildschirm an („Audit-Log“, /moderation/audit-log).
-
Webclient („Servereinstellungen“,
/admin/settings): Der Bildschirm listet eine Seite pro Thema auf, in Gruppen. Jede Seite hat ein Formular und eine Speichern-Schaltfläche, und das Speichern sendet nur, was du auf dieser Seite geändert hast; Einstellungen auf den anderen Seiten bleiben, wie sie sind. Eine Auswahl, deren Optionen jeweils viel ändern, sagt darunter, was jede einzelne bewirkt, bevor du speicherst, und eine Zahl nennt ihre Grenzen, wenn sie abgelehnt wird.Seite Abschnitte und Einstellungen Allgemein ( /admin/settings/general)Name und Beschreibungen ( name,short_description,description); Sprache (default_locale, aus den Sprachen gewählt, die die App hat); Kontakt (contact_account,contact_email); Bilder (thumbnailund der Textthumbnail_alt,preview_imageund der Textpreview_image_alt)Symbol und Logo ( /admin/settings/branding)Das Symbol, das Logo und das Logo für dunkle Hintergründe (Logo und Symbol) Registrierung ( /admin/settings/registration)Wer sich registrieren kann ( registration_mode, jeder Modus mit dem, was er bewirkt); Ein-Personen-Server (single_user); Einladungen von Mitgliedern (invite_creators,member_invite_max_active,member_invite_max_uses,member_invite_max_lifetime_secondsin Stunden); Nur Login-Anbieter (login_providers_only, das zuerst nachfragt, mit der Zahl der aktiven Benutzer, die sich dann nicht mehr anmelden könnten, und ob du einer davon bist); Apps (user_app_registration,dynamic_client_registration,oauth_metadata_document_clients,oauth_client_rate_limits). Auf einem Ein-Personen-Server sagen die Abschnitte zur Registrierung und zu Einladungen von Mitgliedern, dass sich niemand sonst registriertBeiträge und Funktionen ( /admin/settings/content)Beiträge ( max_status_length,require_media_description); Timelines (local_timeline_visibility,federated_timeline_visibility); Link-Karten (link_cards,link_cards_ignore_robots_txt); Entwürfe und geplante Beiträge (max_drafts,max_scheduled_posts,max_scheduled_posts_per_day,scheduled_post_min_lead_minutes,scheduled_post_max_lead_days); Artikel (article_authoring,max_article_bytes,max_article_images); Veranstaltungen (event_creators,event_records_retention_days); Startseite und Vorschläge (public_counts,landing_fediverse_explanation,landing_features,featured_accounts)Sprachchat ( /admin/settings/voice)Wer Räume öffnen kann ( voice_room_starters); Räume (voice_public_summary,voice_participants_retention_days)Beitragslöschung ( /admin/settings/auto-delete)Standard für neue Konten (die Einstellungen auto_delete_default_*); Maximum für alle (auto_delete_max_age_days,auto_delete_grace_days, die Einstellungenauto_delete_max_allow_*,auto_delete_max_kept_pins). Das Speichern eines Maximums, das eingeschaltet oder verkürzt wird, fragt zuerst nach (Eine Höchstdauer für das Aufbewahren von Beiträgen)Föderation ( /admin/settings/federation)Richtung ( federation_mode); Server (federation_scope: Das Speichern vonallowlistzeigt zuerst die Follows, die der Wechsel beenden würde, und fragt nach, siehe nur mit erlaubten Servern föderieren); Signierte Abrufe (authorized_fetch); Medien von anderen Servern (remote_media_policy,remote_media_cache_ttl_secondsin Minuten,remote_media_cache_max_bytesin MiB); Beiträge von anderen Servern (remote_status_retention_days,remote_status_max_retention_days,relay_status_retention_days); Moderierte Server (domain_actions_visibility,domain_actions_rationale_visibility)Suche und Crawler ( /admin/settings/discovery)Suchmaschinen ( search_indexing,indexable_default); Sicherheitskontakt (security_contact); KI (ai_usage); Volltextsuche (search_visibilities)Externe Prüfung ( /admin/settings/hooks)Ein Abschnitt für jeden Entscheidungs-Hook: sein Modus ( enforcewird erst angeboten, wenn er nichtoffist), was er tut, wenn sein Plugin ausfällt, und seine übrigen Einstellungen; Datensätze der Entscheidungen (hook_decisions_retention_days). Siehe Entscheidungs-HooksEinsprüche und Datensätze ( /admin/settings/records)Einsprüche ( appeal_window_days); Datensätze aufbewahren (session_origins_retention_days,registration_origins_retention_days,reports_retention_days,moderation_actions_retention_days,audit_log_retention_days)Auf der Seite Allgemein wird ein Bild hochgeladen, wenn du speicherst, und wird dann zum Vorschaubild oder zum Bild der Link-Vorschau. Wer die laufenden Kosten, die Einnahmen und die Liste der Unterstützer sehen darf, wird auf den Bildschirmen „Kosten und Einnahmen“ und „Unterstützer“ festgelegt. Die Einstellungen der Übersetzung haben einen eigenen Bildschirm, unten.
-
Webclient („Übersetzung“,
/admin/translation): die Anbieter, die dieser Server hat, ihre Reihenfolge und was jeder erhalten darf, die Übersetzung des Browsers, die Monatslimits und wie lange Übersetzungen behalten werden, mit den in diesem Monat gesendeten Zeichen und der Cache-Trefferquote. Jeder Serverprozess fügt seine Zahl der Cache-Treffer höchstens einmal pro Minute zur Quote hinzu, sodass die letzten Anfragen eine Minute brauchen können, bis sie erscheinen, und ein Prozess, der anhält, seine letzte Minute ungezählt lassen kann. Aktualisiere deine Datenschutzerklärung (Vorlage), bevor du einen serverseitigen Anbieter aktivierst: Text, der an einen Anbieter gesendet wurde, lässt sich nicht zurückrufen. API-Schlüssel von Anbietern und die Adresse eines Übersetzer-Plugins liegen in der Bereitstellungskonfiguration; keine Einstellung und keine Antwort der Client-API enthält sie. -
Übersetzungslimits. Was zählt, sind die gesendeten Zeichen, in Codepoints: Die Marker, die für Erwähnungen, Links und Ähnliches stehen, zählen nicht, ebenso wenig eine Übersetzung, die der Server bereits behält, ein Beitrag, der bereits in der Sprache des Lesenden ist, oder die Übersetzung des Browsers. Jeder Aufruf an einen Anbieter zählt, auch einer, der fehlschlägt, da der Anbieter den Text erhalten haben kann, sodass die Zahl von dem abweichen kann, was ein Anbieter berechnet. Über einem Limit wird die Anfrage mit
429abgelehnt, und kein Anbieter wird aufgerufen; der Webclient nutzt dann die Browser-Übersetzung des Lesenden, wenn du sie erlaubst und der Browser den Beitrag übersetzen kann. Monate gelten in UTC. -
Client-API:
GET /api/v1/admin/settingsgibt jede Einstellung mit ihrem aktuellen Wert, ihrem Standard, ob sie gesetzt ist, und ihrem Typ und den akzeptierten Werten (Auswahl oder Bereich) zurück.PATCH /api/v1/admin/settingsändert Einstellungen gemeinsam mit{"values": {"<key>": "<value>", ...}}. Alle Werte sind Strings, normalisiert und wie bei der CLI gespeichert. Ist ein einzelner Schlüssel unbekannt oder ein Wert ungültig, ist die Antwort ein 422, der den Schlüssel nennt, und nichts ändert sich. Die geänderten Schlüssel werden als Revisionen und im Audit-Log in derselben Transaktion erfasst. -
Einladungen, die in den Modi
open,approvalundinvitefunktionieren, werden auf dem Moderationsbildschirm erstellt („Einladungen“,/moderation/invites, Berechtigungmanage_invites; siehe Einladungscodes) und von Mitgliedern, soweitinvite_creatorses erlaubt (Einladungen von Mitgliedern).
Die Regeln des Servers erscheinen in rules von GET /api/v1/instance, und Meldungen zitieren sie über die ID.
- Eine Regel hat einen einzeiligen Satz (bis zu 300 Zeichen) und eine optionale Ergänzung (bis zu 1.000 Zeichen). Wie bei Texten schreibt der
Administrator sie in einer beliebigen Sprache, und jede Locale sieht denselben Wert (
dir="auto"undlang=""). Es kann höchstens 100 aktive Regeln geben. - Jede Änderung (ein überarbeiteter Satz, eine Umsortierung) wird als Revision aufbewahrt (
instance_rule_revisions), und die ID einer Regel ändert sich nicht. - Eine eingestellte Regel verschwindet aus der Liste der aktiven Regeln. Sie lässt sich nicht zurückholen, aber Meldungen können sich weiterhin auf sie beziehen.
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)- Die Admin-API ist
/api/v1/admin/rules(auflisten, hinzufügen, abrufen, überarbeiten, verschieben, einstellen) und braucht die Rollenberechtigungmanage_rules. - Auf dem Admin-Bildschirm des Webclients („Regeln“,
/admin/rules,manage_rules) zeigt die Liste die geltenden Regeln der Reihe nach, und „Nach oben“ und „Nach unten“ sortieren sie um; der Filter über der Liste zeigt stattdessen die eingestellten Regeln. „Regel hinzufügen“ öffnet eine Seite mit einem Satz und einer Ergänzung. Wähle den Satz einer Regel, um ihre Seite zu öffnen, auf der du sie bearbeitest und einstellst (nach einem Bestätigungsdialog). Jede Änderung wird im Audit-Log festgehalten (rule_added,rule_revised,rule_moved,rule_retired). - Die Exit-Codes sind dieselben wie bei Einstellungen (0 für Erfolg, 1 für einen abgelehnten Wert oder einen Datenbankfehler, 2 für falsche Argumente).
Domains für Link-Karten
Abschnitt betitelt „Domains für Link-Karten“Die Link-Karten von Beiträgen (link_cards) stammen von einem Crawler: Der Server ruft die verlinkte Seite und ihr Bild ab. Eine Regel
stoppt diesen Crawler bei einer Domain und ihren Subdomains und lässt alles andere an der Domain unberührt. Sie hat einen von zwei
Modi. Eine Regel ist die Entscheidung des Betreibers, und sie gilt zusätzlich zu dem, was die verlinkten Websites selbst ablehnen (Link-Vorschauen).
| Modus | Was abgerufen wird | Bereits vorhandene Karten |
|---|---|---|
Abruf stoppen (no_fetch) |
Nichts von der Domain, weder Seiten noch Bilder, auch wenn eine Weiterleitung dorthin führt | Ausgeblendet |
Nur Bilder stoppen (no_images) |
Seiten, aber keine Bilder von der Domain | Ohne ihr Bild angezeigt |
- Eine Regel betrifft nur Link-Karten. Die Domain bleibt föderiert, und die Medien ihrer Beiträge werden wie gewohnt abgerufen: Um einen Server abzutrennen, verwende eine Domain-Aktion, die auch seine Link-Karten stoppt. Eine Regel wird nicht bei den Domain-Aktionen aufgeführt oder mit ihnen exportiert.
- Eine Regel gilt für die Domain und ihre Subdomains, und ein Bild wird gegen die Hosts der Seite und des Bildes geprüft. Jede Regel, die einen Host abdeckt, gilt, eine Regel für eine Subdomain lockert also die Regel für ihre übergeordnete Domain nicht. Eine Domain wird wie bei einer Domain-Aktion geschrieben und normalisiert: ein Hostname ohne Schema oder Port, in beliebiger Schreibweise einer internationalisierten Domain.
- Eine Änderung wirkt sofort, auch auf die Karten, die der Server bereits hat, und die über den Proxy geleiteten Bilder dieser Karten werden nicht mehr ausgeliefert, solange Bilder gestoppt sind.
- Das Entfernen einer Regel bringt die Karten, die der Server bereits hat, so zurück, wie sie waren. Ein Link, der übersprungen wurde, erhält seine Karte, wenn ein Beitrag sie das nächste Mal braucht; nichts wird massenhaft erneut abgerufen. Eine Karte, die erneut abgerufen wurde, während Bilder gestoppt waren, bleibt bis zu ihrem nächsten erneuten Abruf ohne Bild.
- Auf dem Admin-Bildschirm des Webclients („Domains für Link-Karten“,
/admin/link-card-domains,manage_settings) legt „Regel hinzufügen“ eine Regel mit ihrem Modus und einer Notiz fest und lehnt eine Domain ab, die bereits eine Regel hat, mit einem Link zu dieser Regel. Die Liste zeigt die Regeln nach Domain, jeweils 40 mit „Mehr anzeigen“; wähle eine Domain, um die Seite ihrer Regel zu öffnen, auf der du ihren Modus und ihre Notiz änderst und sie entfernst (nach einem Bestätigungsdialog). - Die Admin-API ist
/api/v1/admin/link_card_domains(auflisten, festlegen; einDELETEmit der Domain entfernt sie) und braucht die Rollenberechtigungmanage_settings. Ein Server behält höchstens 1.000 Regeln, jede mit einer Notiz von bis zu 5.000 Zeichen. - Jede Änderung wird im Audit-Log festgehalten (
link_card_domain_fetch_stopped,link_card_domain_images_stopped,link_card_domain_rule_removed).
Das serverweite Design ist ein Satz von Überschreibungen der Design-Tokens des Webclients, mit je einem hellen und einem dunklen Wert für jede Farbe. Es gilt für den Webclient jedes Betrachters und für die Seiten, die der Server selbst rendert (Anmeldung, Registrierung, Nutzungsbedingungen usw.). Es gibt kein eigenes CSS.
-
Diese Design-Tokens kannst du überschreiben; Abstände, Größen der Komponenten, Schriftstärken, Schatten und die Farben der Datendiagramme bleiben fest:
Tokens Art Überschreibung 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-barFarbe #rrggbbfür hell und für dunkelfont-sans-override,font-mono-overrideSchriftfamilie Familiennamen, durch Kommas getrennt (höchstens 30), ohne generische Familie wie sans-serif; setze einen Namen mit einem Wort, das mit einer Ziffer beginnt, in Anführungszeichen, etwa"M PLUS 1p"text-tagline,text-headline,text-heading,text-title,text-reading,text-body,text-captionLänge 0oder rem / px, 0,625rem bis 3remtext-*--line-heightderselben siebenZahl 1 bis 2,5 radius-control,radius-overlayLänge 0 bis 2rem duration-spinDauer ms / s, 0 bis 1000ms -
Der Webclient zeichnet Text mit eigenen Schriften: Noto Color Emoji für Emoji, Noto Sans für lateinische, griechische und kyrillische Schrift und Noto Sans CJK in den Glyphen der Sprache des Textes für den Rest. Die Schriften von
font-sans-override(Text) undfont-mono-override(Code) stehen direkt hinter der Emoji-Schrift, und die Schriften des Webclients zeichnen die Zeichen, die deinen fehlen. Ein Design kann diese Schriften nicht ersetzen. -
Du speicherst einen Satz als Entwurf, siehst ihn in der Vorschau an und veröffentlichst ihn dann; das wirksame Design ändert sich erst mit der Veröffentlichung. Jedes Speichern ersetzt den ganzen Entwurf, und jede Veröffentlichung ist eine neue Revision. Beim Wiederherstellen wird der Satz, der vor dem aktuellen wirksam war, erneut veröffentlicht; der Entwurf bleibt, wie er ist.
-
Im Webclient zeigt Administration > Design den Entwurf und das wirksame Design. „Entwurf bearbeiten“ zeigt jede Farbe für hell und dunkel mit dem Kontrast jedes Paars, das sie bildet, und speichert kein Paar unter seinem Minimum. „Vorschau“ zeigt den Entwurf auf jedem Bildschirm deines Browser-Tabs, bis du es erneut drückst; niemand sonst sieht ihn. „Veröffentlichen“ und „Vorheriges Design wiederherstellen“ befinden sich auf demselben Bildschirm. Das Symbol und das Logo findest du unter Servereinstellungen > Symbol und Logo.
-
Beim Speichern und beim Veröffentlichen prüft der Server Form und Bereich der Werte und den Kontrast jedes Paars von Farb-Tokens (Tokens, die du nicht überschreibst, verwenden ihre Standardwerte; WCAG 2.2 AA in Hell und Dunkel). Schlägt eine Prüfung fehl, wird nichts gespeichert oder veröffentlicht.
-
Die Überschreibung eines Tokens, das eine neue Version umbenennt oder abschafft oder dessen Wert nicht mehr zum Token passt, lässt ein Upgrade nie scheitern. Sie bleibt im gespeicherten Satz, gilt aber nicht mehr: Die Admin-API führt sie unter
stale_tokensauf,my instance theme getnennt sie, und das nächste Speichern des Entwurfs entfernt sie. -
Das Stylesheet der veröffentlichten Revision wird unter
/theme/{revision ID}.cssausgeliefert (immutable, lange im Cache). Die HTML-Hülle hat einen gemeinsamen Cache (60 Sekunden plus 300 Sekunden Revalidierung); es dauert also einige Minuten nach dem Veröffentlichen, bis alle es erhalten. Eine bereits geöffnete Seite behält das alte Aussehen, bis sie neu geladen wird. -
<meta name="theme-color">(hell und dunkel) in der Hülle sowietheme_color/background_color(hell) des Web App Manifest übernehmen den Wert voncolor-surfacedes Designs. Die HTML-Version jeder E-Mail, die der Server von da an sendet, verwendet die Farben des veröffentlichten Designs, hell und dunkel; ein Entwurf gelangt nie in eine E-Mail. -
Wer einen Satz ohne Tokens veröffentlicht, setzt das Design auf den Standard zurück, und das Stylesheet wird nicht mehr geladen.
-
Du kannst es mit der Client-API und mit der CLI ändern. Die Client-API braucht die Rollenberechtigung
manage_settings:GET /api/v1/admin/themeliest den Entwurf und den wirksamen Satz,PUT /api/v1/admin/theme/draftspeichert den Entwurf,GET /api/v1/admin/theme/draft/stylesheetliefert das Stylesheet des Entwurfs für die Vorschau, undPOST /api/v1/admin/theme/publishsowiePOST /api/v1/admin/theme/restoreveröffentlichen. Veröffentlichungen werden im Audit-Log festgehalten (setting_changed, Zieltheme).
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 und Symbol
Abschnitt betitelt „Logo und Symbol“Neben dem Vorschaubild und dem Link-Vorschaubild kann der Server ein eigenes Symbol, ein Logo und ein dunkles Logo haben, jeweils als eine SVG hochgeladen. Bis eines gesetzt ist, werden die eingebauten mycroblog-Bilder verwendet, und das Löschen eines Bildes bringt das eingebaute Bild zurück.
| Bild | Form | Wo es erscheint |
|---|---|---|
icon |
Quadratisch (innerhalb von 1 %) | Das Favicon, das Home-Bildschirm-Symbol von iOS (apple-touch-icon), die Symbole der installierten App (Web App Manifest), die Karte des Servers auf der Landingpage und neben seinem Namen im Seitenbereich des Webclients sowie überall dort, wo ein Client den Server als quadratisches Bild zeigt |
logo |
1- bis 8-mal so breit wie hoch | Die Kopfzeile des Webclients und der obere Teil der Anmelde-, Registrierungs- und Zustimmungsseiten anstelle der eingebauten Wortmarke und des Servernamens (das Logo sollte den Namen enthalten, der sein Alternativtext ist), die HTML-Version jeder E-Mail und das Link-Vorschaubild, wenn preview_image nicht gesetzt ist |
logo_dark |
Wie logo |
Dunkle Hintergründe; ohne es wird dort ebenfalls logo verwendet |
- Der Server bereinigt die SVG. Er liest sie als XML und schreibt ein neues Dokument nur aus den erlaubten Elementen (Formen, Gruppen,
defs,symbol,use, Verläufe,clipPath,mask,pattern,style,title,desc) und Attributen (Geometrie, Transformationen, Darstellungsattribute,id,class,style). Skripte,foreignObject, eingebettete Bilder, Links, Animationen, Filter (Schatten und Unschärfen), Event-Handler, Verweise auf alles außerhalb der Datei unddata:-URLs werden entfernt, und die Antwort listet auf, was entfernt wurde. Nur die bereinigte SVG wird gespeichert. - Eine SVG wird abgelehnt (nichts wird gespeichert), wenn sie kein wohlgeformtes XML in UTF-8 ist, ein
DOCTYPEoder Entity-Deklarationen hat, keinviewBoxhat, über 256 KiB groß ist (128 KiB nach dem Bereinigen), über 5.000 Elemente hat, tiefer als 32 Ebenen verschachtelt ist, über 200use- Elemente hat, die falsche Form für ihre Art hat,textenthält (wandle Text zuerst in deinem Editor in Pfade um) oder CSS hat, das etwas laden könnte (@import,@font-face,url()außerurl(#id), Escapes).@media (prefers-color-scheme: dark)in einem<style>ist erlaubt, ein Symbol kann sich also im Dunkelmodus ändern. - Manche Stellen nehmen keine SVG (der iOS-Home-Bildschirm, ältere Safari-Favicons, Link-Vorschauen, E-Mail). Für sie zeichnet der Client, der die
SVG hochlädt, aus der bereinigten SVG auch PNG-Versionen und sendet sie mit: 32, 48, 180, 192 und 512 px sowie ein maskierbares 512-px-
Symbol für
icon; ein 96 px hohes E-Mail-Logo und ein Link-Vorschaubild von 1200 × 630 fürlogo; ein 96 px hohes E-Mail-Logo fürlogo_dark. Der Server prüft, dass jede ein PNG der richtigen Größe ist (höchstens 1 MiB; das 180-px-Symbol, das maskierbare Symbol und das Link-Vorschaubild müssen deckend sein) und schreibt sie ohne Metadaten neu. Ist eine Datei falsch, wird nichts gespeichert. Die deckenden Versionen des Symbols werden auf eine Hintergrundfarbe gezeichnet,#rrggbb, die standardmäßig das hellecolor-surfacedes Designs ist. Der Server prüft nicht, ob die PNG-Versionen dasselbe Bild zeigen wie die SVG. - Die Dateien werden im Blob-Store unter
instance/brand/<revision>/gespeichert und unterhttps://<host>/brand/<revision>/<version>.svg|.pngmitCache-Control: public, max-age=31536000, immutableausgeliefert, da sich der Inhalt einer Revision nie ändert. Eine SVG wird mitContent-Security-Policy: default-src 'none'; style-src 'unsafe-inline'; sandboxundX-Content-Type-Options: nosniffausgeliefert, sodass sie auch allein geöffnet nichts ausführt und nichts lädt. Die Dateien früherer Revisionen bleiben erhalten, sodass bereits gesendete E-Mails ihr Logo behalten. - Mit gesetztem Symbol verlinkt die HTML-Shell seine PNG-Favicons, seine SVG und sein 180-px-
apple-touch-icon, das Web App Manifest listet seine 512-px-, 192-px-, maskierbaren und SVG-Symbole in dieser Reihenfolge auf (andere Fediverse-Server nehmen das erste als Symbol dieses Servers), und/apple-touch-icon.pnggibt die 180-px-Version zurück. Das ETag der Shell ändert sich mit den Bildern, und der gemeinsame Cache der Shell hält wie beim Design einige Minuten. Eine installierte App übernimmt unter Android ein neues Symbol, wenn Chrome das Manifest das nächste Mal prüft; auf Desktops behält die App ihr altes Symbol, bis sie erneut installiert wird. GET /api/v1/instancegibticon,logoundlogo_darkmit der URL der SVG, der URL und Größe jeder PNG-Version und der Revision zurück; jedes wird weggelassen, solange das eingebaute Bild in Verwendung ist.- Lege sie im Webclient unter Servereinstellungen > Symbol und Logo (
/admin/settings/branding, Rollenberechtigungmanage_settings) fest. Wähle eine SVG- Datei für das Symbol, das Logo oder das Logo für dunkle Hintergründe: Der Server prüft sie sofort, und das Formular zeigt sie so, wie der Server sie behalten würde, mit der Liste dessen, was der Server entfernt hat. Lehnt der Server die Datei ab, steht der Grund darunter, mit dem Weg, ihn zu beheben. Lege für das Symbol dort auch die Hintergrundfarbe seiner deckenden Versionen fest. Speichern zeichnet die PNG- Versionen im Browser und sendet jedes gewählte Bild mit ihnen; Eingebautes Bild verwenden bringt beim Speichern ein Bild zum eingebauten zurück. Der Webclient behält die Bilder, die er angezeigt hat, für die Offline-Nutzung. - Die Client-API tut dasselbe, mit der Rollenberechtigung
manage_settings:POST /api/v1/admin/instance/brand/sanitizeprüft eine SVG und gibt die bereinigte SVG mit den zu zeichnenden PNG-Versionen zurück (sie speichert nichts),PUT /api/v1/admin/instance/brand/{icon|logo|logo_dark}speichert die SVG mit jeder PNG-Version (multipart/form-data, ein Teil pro Version),DELETEauf demselben Pfad löscht eines, undGET /api/v1/admin/instance/brandgibt die aktuellen Bilder mit der Hintergrundfarbe des Symbols zurück. Jede Änderung wird als Revision aufbewahrt (instance_brand_revisions) und im Audit-Log festgehalten (setting_changed, Zielbrand_icon,brand_logooderbrand_logo_dark). - Die CLI kann sie nicht setzen, da die PNG-Versionen vom Client gezeichnet werden, aber sie kann sie anzeigen und ein fehlerhaftes löschen:
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)Eigene Emojis
Abschnitt betitelt „Eigene Emojis“Lokale eigene Emojis werden als Bilder angezeigt, wenn jemand :shortcode: im Text oder in der Inhaltswarnung eines Beitrags oder im
Anzeigenamen, in der Bio oder in den Profilfeldern schreibt. Sie erreichen über das Emoji-Tag der
Notes und Actors, die du sendest, auch Mastodon, Misskey, GoToSocial und Akkoma.
- Ein Shortcode besteht aus 2-30 Buchstaben, Ziffern oder
_. Er unterscheidet Groß- und Kleinschreibung und lässt sich nach der Registrierung des Emojis nicht mehr ändern. Aliasse (bis zu 10) und eine Kategorie (bis zu 64 Zeichen) werden für die Suche und die Gruppierung in der Emoji-Auswahl verwendet. - Das Bild ist PNG, GIF oder WebP, höchstens
custom_emoji_max_bytes(Standard 256 KiB) groß und auf jeder Seite höchstens 1.024 px. Der Server erzeugt Ableitungen, die in Rahmen von 64, 128 und 256 px passen, und behält das Original nicht. Ein APNG wird zu einem Standbild seines ersten Frames. GoToSocial ruft standardmäßig keine Emojis ab, die größer als 100 KiB sind, daher werden kleine Bilder empfohlen. - Ein deaktiviertes Emoji erscheint nirgends (Beiträge, Profile, Föderation, die Auswahl), und
:shortcode:wird wieder als Text angezeigt. Ein Emoji, das in der Auswahl verborgen sein soll, fehlt nur in der Auswahl und lässt sich weiterhin verwenden, indem man es schreibt. Ein Emoji, das von einem anderen Server kam, lässt sich nur deaktivieren oder als Emoji dieses Servers kopieren. - Das Kopieren ruft das Bild des Emojis eines anderen Servers unter denselben Limits wie der Media-Proxy ab (Bilder von Domains mit
reject_mediawerden nicht abgerufen), führt dieselben Prüfungen wie oben aus und registriert es als neues lokales Emoji. Der Shortcode ist der des Originals oder der, den du angibst. Das Bild wird auf den 256-px-Rahmen verkleinert, und ein Bild, das sich nicht abrufen lässt oder die Prüfungen nicht besteht, hinterlässt nichts. - Das Löschen lässt sich nicht rückgängig machen. Auch Emojis in früheren Beiträgen werden wieder zu Text, und das erneute Registrieren desselben Shortcodes ergibt ein anderes Emoji. Bilder, die föderierte Server kopiert haben, lassen sich nicht löschen.
- Der Admin-Bildschirm („Eigenes Emoji“,
/admin/custom-emojis), die Client-API (/api/v1/admin/custom_emojis) und die CLI tun dasselbe. Auf dem Bildschirm öffnet „Emoji registrieren“ das Registrierungsformular (/admin/custom-emojis/new), das vor einem Bild über 100 KiB warnt, und das Auswählen eines Emojis in der Liste öffnet seine Seite (/admin/custom-emojis/{id}), auf der du es aktivierst oder deaktivierst, sein Bild ersetzt, seine Kategorie, Aliasse und Sichtbarkeit in der Auswahl änderst, es nach Eingabe seines Shortcodes löschst oder eines von einem anderen Server kopierst. Der Admin-Bildschirm und die Client-API brauchen die Rollenberechtigungmanage_custom_emojis(nur die eingebauteadminhat sie). Das Registrieren, Kopieren, Ersetzen des Bildes, Ändern von Einstellungen und Aliassen, Aktivieren und Deaktivieren und Löschen werden im Audit-Log festgehalten (Zielcustom_emoji), auf welchem Weg sie auch erfolgen (ein Vorgang über die CLI wird als CLI- Vorgang festgehalten).
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)- Ein Nutzer mit der Rollenberechtigung
create_custom_emojis(eine Nutzerfunktion) kann unter „Eigenes Emoji“ in den Einstellungen (/settings/custom-emojis) die Erstellung eines Emojis beantragen, die Aliasse, die Kategorie und die Sichtbarkeit in der Auswahl der von ihm erstellten Emojis ändern und sie löschen; die Seite zeigt, wie viele Anfragen ihnen in diesem Monat noch bleiben. Auch das Ersetzen eines Bildes ist ein Antrag, gestellt mit der Client-API (POST /api/v1/custom_emoji_requests,kindimage); die Einstellungsseite bietet es nicht an. Ein Antrag erscheint nirgends (Auswahl, Beiträge, Reaktionen, Föderation), bis jemand mitmanage_custom_emojisihn genehmigt. Genehmige oder lehne ihn auf der Seite „Anfragen“ von „Eigenes Emoji“ auf dem Admin-Bildschirm (/admin/custom-emojis/requests), mit der Client-API (/api/v1/admin/custom_emoji_requests) oder mit der obigen CLI ab. Personen mitmanage_custom_emojiswerden über einen Antrag benachrichtigt (admin_custom_emoji_request), und der Antragsteller wird über die Genehmigung oder Ablehnung benachrichtigt. Beantragen, Zurückziehen, Genehmigen und Ablehnen werden im Audit-Log festgehalten (Zielcustom_emoji_request). - Ein ausstehender Antrag auf Erstellung reserviert seinen Shortcode. Ein Antrag oder eine Registrierung mit demselben Shortcode ist nicht möglich, bis der ausstehende abgelehnt oder zurückgezogen wird. Das Bild eines genehmigten Emojis wird als Upload des Server-Actors kopiert, es bleibt also bestehen, auch wenn das Konto des Antragstellers gelöscht wird.
- Ein Ersteller kann seine Emojis nur ändern, solange er
create_custom_emojishält. Die Emojis bleiben, wenn die Rolle entzogen wird. Administratoren können jedes Emoji unabhängig vom Ersteller ändern und löschen. - Stammt die Rolle aus einem Unterstützungsplan, wird die Zahl der Emojis, die ein Nutzer pro Monat erstellen kann, durch das monatliche Emoji-Limit des Plans begrenzt. Es zählt die Anträge auf Erstellung, die der Nutzer im laufenden Kalendermonat (UTC) gestellt hat und die genehmigt oder ausstehend sind; abgelehnte und zurückgezogene Anträge zählen nicht, und das Löschen eines Emojis gibt keinen Platz frei. Ein Antrag zählt in dem Monat, in dem er gestellt wurde, auch wenn er im nächsten genehmigt wird. Die Zählung wird am ersten Tag jedes Monats um 00:00 UTC zurückgesetzt, und die Einstellungsseite zeigt dem Nutzer, wann, in seiner eigenen Zeitzone. Das Ersetzen des Bildes eines Emojis und Emojis, die Administratoren registrieren, zählen nicht. Eine Rolle, die ein Administrator von Hand zugewiesen hat, und ein Server, auf dem Unterstützer deaktiviert sind, haben kein Limit.
Für LLMs und Coding-Agenten:llms.txt,llms-full.txt, llms-small.txt