Słownik

Jak dodać tekst alternatywny na Mastodonie w aplikacji webowej i przez API

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •7 min czytania
Jak dodać tekst alternatywny na Mastodonie w aplikacji webowej i przez APIJak dodać tekst alternatywny na Mastodonie w aplikacji webowej i przez API

TL;DR, szybka odpowiedź

7 min czytania

Mastodon nazywa tekst alternatywny opisem multimediów (media description): to pole zwykłego tekstu przy każdym załączniku, które czytniki ekranu odczytują na głos i które pojawia się, gdy multimedia się nie załadują. W aplikacji webowej ustawiasz je przyciskiem ALT lub Edit przy załączonym pliku. W API to parametr description w POST /api/v2/media. Każdy serwer ma własny limit, publikowany jako description_limit w /api/v2/instance: kod Mastodona ustawiał 1 500 znaków do wersji 4.5 i 10 000 od wersji 4.6. Aplikacja webowa ostrzega przed publikacją multimediów bez opisu, a to ustawienie jest domyślnie włączone.

Czym jest tekst alternatywny na Mastodonie?

Pisanie tekstu alternatywnego na Mastodonie to uzupełnianie opisu multimediów, który ma każdy załącznik w poście: pola zwykłego tekstu odczytywanego przez czytniki ekranu zamiast obrazu, wideo lub dźwięku. Przewodnik Mastodona po publikowaniu mówi, że te opisy "will be shown when the media fails to load for any reason, or when accessed by screen readers and other assistive technology."

Opis należy do załącznika, a nie do tekstu posta. Gdy dołączasz plik, Mastodon przesyła go jako osobny obiekt załącznika i na tym obiekcie zapisuje opis, obok punktu ostrości. Na mastodon.social post może mieć do 4 załączników, więc post z czterema zdjęciami zawiera cztery osobne opisy.

Dokumentacja API definiuje to pole w jednym zdaniu: "A plain-text description of the media, for accessibility purposes." Zwykły tekst oznacza, że w opisie nie ma linków, wzmianek ani formatowania.

Fotograf ogląda zdjęcie na laptopie tuż przed napisaniem jego opisu.

Jak dodać tekst alternatywny do obrazu na Mastodonie?

W aplikacji webowej Mastodona tekst alternatywny dodasz, klikając przycisk ALT lub Edit przy załączonym obrazie, wpisując opis w oknie "Add alt text" i klikając Done przed publikacją. Kroki w Mastodonie 4.7:

  1. Otwórz edytor i dołącz obraz, wideo lub plik audio.
  2. Spójrz na miniaturę. W jej rogu jest przycisk ALT, który pokazuje ikonę ostrzeżenia, dopóki plik nie ma opisu.
  3. Kliknij ALT albo Edit w górnym rogu. Oba otwierają to samo okno.
  4. Wpisz opis w polu tekstowym, w którym przy obrazach widnieje "Describe this for people with visual impairments", a przy audio i wideo "Describe this for people with hearing impairments".
  5. Jeśli obraz zawiera tekst, kliknij "Add text from image", aby wypełnić pole tekstem odczytanym przez Mastodona z obrazu, a potem go popraw.
  6. Kliknij Done. Ikona ostrzeżenia zniknie z przycisku ALT.
  7. Powtórz to dla każdego załącznika, a następnie kliknij Post.

W tym samym oknie ustawisz punkt ostrości, czyli miejsce, które Mastodon zachowuje w kadrze przy przycinaniu miniatury podglądu. Zewnętrzne aplikacje Mastodona umieszczają pole opisu w różnych miejscach, ale wszystkie zapisują to samo pole description w załączniku.

Jak długi może być tekst alternatywny na Mastodonie?

Tekst alternatywny na Mastodonie może mieć tyle znaków, ile wynosi description_limit twojego serwera, a kod Mastodona ustawiał tę wartość na 1 500 znaków do wersji 4.5 i na 10 000 znaków od wersji 4.6. Każdy serwer działa na własnej wersji Mastodona, więc limit zależy od serwera, z którego publikujesz, a nie od Mastodona jako całości.

Wersja MastodonaLimit opisu w kodzieGdzie go zobaczysz
4.2 do 4.31 500 znakówNiepublikowany w API
4.4 do 4.51 500 znakówdescription_limit w /api/v2/instance
4.6 i nowsze10 000 znakówdescription_limit w /api/v2/instance

Limit znajduje się w MediaAttachment::MAX_DESCRIPTION_LENGTH w kodzie źródłowym Mastodona, a serwer odrzuca dłuższy opis od własnych użytkowników. Dokumentacja encji Instance nadal pokazuje 1 500 w przykładowej odpowiedzi, natomiast mastodon.social, działający na kompilacji nightly 4.8, zgłaszał 10 000 w dniu 9 października 2026 roku. W Mastodonie 4.6 i nowszych licznik znaków w edytorze webowym dochodzi do 10 000.

Długie opisy są dozwolone, ale nie wymagane. Opisz, co widać na obrazie i jaki tekst się na nim znajduje, i na tym poprzestań. Tekst posta ma własny limit, opisany w artykule o limicie znaków na Mastodonie, a opis się do niego nie wlicza.

Jak sprawdzić limit tekstu alternatywnego na swoim serwerze?

Limit sprawdzisz, odczytując configuration.media_attachments.description_limit z odpowiedzi GET /api/v2/instance, co nie wymaga logowania. Dokumentacja encji Instance opisuje to pole jako "The maximum size of a description, in characters," i podaje, że dodano je w Mastodonie 4.4.0.

Otwórz https://your.server/api/v2/instance w przeglądarce i wyszukaj w JSON-ie description_limit. Serwer w wersji 4.3 lub starszej nie zwraca tego pola, ale nadal egzekwuje w kodzie 1 500 znaków. W tym samym bloku są limity rozmiaru obrazów i wideo oraz obsługiwane typy plików, więc jedno żądanie odpowiada zarówno na pytanie „jak długi może być mój opis”, jak i „czy ten plik się prześle”.

Jak wysłać tekst alternatywny przez API Mastodona?

Tekst alternatywny wysyłasz przez API Mastodona jako pole formularza description w POST /api/v2/media, czyli w wywołaniu, które przesyła plik przed dołączeniem go do posta. Oto wszystkie miejsca, w których pojawia się to pole:

WywołanieCo robi z opisem
POST /api/v2/mediaUstawia opis podczas przesyłania pliku
PUT /api/v1/media/:idZmienia go "before it is attached to a status and posted"
PUT /api/v1/statuses/:idZmienia go po publikacji przez media_attributes[][], tablicę, która "includes id, description, and focus"

Wywołanie przesyłające zwraca załącznik z id, które podajesz w media_ids[] przy tworzeniu statusu. Małe obrazy wracają z kodem HTTP 200 i są od razu gotowe. Wideo, wideo w stylu GIF i audio wracają z kodem 202 i kończą przetwarzanie w tle, więc klient czeka na jego koniec przed publikacją. Jeśli planujesz przez API, zasada 5 minut dla scheduled_at na Mastodonie określa, jak blisko bieżącej chwili można ustawić post w kolejce, a multimedia i ich opisy dołącza się do zaplanowanego posta w ten sam sposób.

Osoba z wadą wzroku pracuje przy komputerze, jeden z czytelników polegających na opisach obrazów.

Dlaczego kultura Mastodona oczekuje tekstu alternatywnego?

Kultura Mastodona oczekuje tekstu alternatywnego, bo samo oprogramowanie prosi o niego na każdym kroku: edytor oznacza multimedia bez opisu, okno potwierdzenia przerywa publikację, a czytelnicy widzą, które obrazy mają opis. Te ustawienia domyślne kształtują to, co użytkownicy uważają za normę.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Sygnały, które spotyka użytkownik Mastodona:

  • Ostrzeżenie ALT. Załącznik bez opisu ma w edytorze ikonę ostrzeżenia na przycisku ALT.
  • Kontrola przy publikacji. Kliknięcie Post przy multimediach bez opisu otwiera okno "Add alt text?" z komunikatem "Your post contains media without alt text. Adding descriptions helps make your content accessible to more people." Wybierasz "Add alt text" albo "Post anyway".
  • Ustawienie domyślne. Kontrolą steruje opcja "Warn me before posting media without alt text" w Preferences, a następnie Appearance, i jest ona włączona na każdym nowym koncie.
  • Plakietka ALT. Obrazy z opisem mają na osi czasu plakietkę ALT, a jej kliknięcie otwiera opis, więc czytelnicy od razu widzą, kto go pominął.
  • Dokumentacja. Przewodnik po publikowaniu nazywa opisy opcjonalnymi, ale stwierdza, że "it is a good idea to add media descriptions that briefly describe what is in contained in the media."

W efekcie powstała sieć, w której zdjęcie bez opisu rzuca się w oczy. Dla osób przychodzących z sieci, które chowają pole tekstu alternatywnego głębiej, to główna zmiana, a pozostałe różnice opisuje porównanie Mastodon vs Bluesky. Szersze nawyki, takie jak opisywanie obrazów, dodawanie napisów do wideo i dbanie o czytelny kontrast, obowiązują w każdej sieci i omawia je artykuł o dostępności w mediach społecznościowych.

Co się dzieje, gdy publikujesz multimedia bez opisu
Dołączasz plik
Ikona ostrzeżenia na ALT
Klikasz Post
Okno "Add alt text?"
Add alt text lub Post anyway
Mastodon zachęca na każdym kroku, ale ostateczny wybór zostawia tobie.

Jak dodać tekst alternatywny do zaplanowanych postów na Mastodonie?

Narzędzie do planowania dodaje tekst alternatywny, przesyłając każdy obraz na twój serwer z opisem w polu description, a potem dołączając przesłane pliki do posta w chwili publikacji. W AdaptlyPost służy do tego przycisk „Dodaj tekst alternatywny” przy każdym obrazie w edytorze, który otwiera okno z informacją „Opis zdjęcia dla osób korzystających z czytników ekranu”.

Narzędzie do planowania postów na Mastodonie publikuje na dowolnym serwerze Mastodona: wpisujesz adres serwera, na przykład mastodon.social, i tam się logujesz. Każdy post może mieć do 4 obrazów, każdy z własnym tekstem alternatywnym, a przy poście wideo AdaptlyPost czeka, aż serwer skończy przetwarzać plik, i dopiero wtedy publikuje. Edytor i API AdaptlyPost przyjmują do 1 000 znaków na opis, co mieści się w każdym limicie z powyższej tabeli. Uwaga przy polu tekstu alternatywnego w edytorze informuje, że opis trafia na X, Bluesky, Mastodona, LinkedIna, Facebooka, Instagrama i Threads, więc jeden opis obrazu dociera do każdej sieci w poście, która go przyjmuje.

Najczęściej zadawane pytania

Jak dodać tekst alternatywny na Mastodonie?

Dołącz plik w edytorze, kliknij przycisk ALT lub Edit na miniaturze, wpisz opis i kliknij Done. Ikona ostrzeżenia na przycisku ALT znika, gdy plik ma już opis. Powtórz to dla każdego załącznika, zanim klikniesz Post.

Jaki jest limit znaków tekstu alternatywnego na Mastodonie?

Limit ustala każdy serwer jako description_limit w /api/v2/instance. Kod Mastodona ustawiał 1 500 znaków do wersji 4.5 i 10 000 od wersji 4.6, więc wartość zależy od wersji twojego serwera. mastodon.social zgłaszał 10 000 w dniu 9 października 2026 roku.

Czy tekst alternatywny na Mastodonie jest wymagany?

Nie. Mastodon przyjmuje posty bez opisów multimediów, a przewodnik po publikowaniu nazywa je opcjonalnymi. Aplikacja webowa pokazuje okno "Add alt text?" przed publikacją multimediów bez opisu, a to ostrzeżenie jest domyślnie włączone w Preferences, a następnie Appearance.

Czy można edytować tekst alternatywny na Mastodonie po publikacji?

Tak, przez API. PUT /api/v1/statuses/:id przyjmuje media_attributes[][] z identyfikatorem załącznika, opisem i punktem ostrości, więc klient obsługujący edycję może zmienić opis w opublikowanym poście. Przed publikacją PUT /api/v1/media/:id zmienia go w przesłanym, jeszcze niedołączonym pliku.

Co oznacza plakietka ALT na obrazach na Mastodonie?

Plakietka ALT oznacza, że autor napisał opis tego załącznika. Jej kliknięcie otwiera tekst opisu. Obrazy bez opisu nie mają plakietki.

Czy AdaptlyPost wysyła tekst alternatywny na Mastodona?

Tak. AdaptlyPost wysyła tekst alternatywny napisany dla każdego obrazu na twój serwer Mastodona razem z przesyłanym plikiem, do 4 obrazów na post. Każdy opis może mieć do 1 000 znaków w edytorze i API, co mieści się zarówno w limicie 1 500, jak i 10 000 z kodu Mastodona.

Czy tekst alternatywny wlicza się do limitu znaków na Mastodonie?

Opis nie wlicza się do limitu znaków posta. Tekst posta i każdy opis multimediów mają osobne limity. Limit opisu ustala twój serwer jako description_limit.

Jak wyłączyć ostrzeżenie o tekście alternatywnym na Mastodonie?

Otwórz Preferences, a następnie Appearance, i wyłącz opcję "Warn me before posting media without alt text". Jest ona domyślnie włączona na każdym nowym koncie. Po jej wyłączeniu Mastodon publikuje multimedia bez opisu, nie pokazując okna "Add alt text?".

Czy tekst alternatywny na Mastodonie może zawierać linki lub hashtagi?

Nie jako działające linki czy hashtagi. API definiuje opis jako "A plain-text description of the media, for accessibility purposes." Zwykły tekst oznacza brak linków, wzmianek i formatowania w opisie.

Jak dodać tekst alternatywny do wideo lub pliku audio na Mastodonie?

Dołącz plik, kliknij ALT lub Edit na miniaturze, wpisz opis i kliknij Done. W polu tekstowym dla audio i wideo widnieje "Describe this for people with hearing impairments". Przez API przesyłanie wideo i audio zwraca kod 202 i kończy przetwarzanie w tle, więc klient czeka przed publikacją.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Więcej naszych treści w Google

Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

AdaptlyPost

AdaptlyPost

Planowanie treści na wszystkich platformach

Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Powiązane hasła ze słownika

Powiązane artykuły