Przejdź do treści
Dialova

Dokumentacja IRC · Początkujący

Polecenie TOPIC: odczyt lub zmiana tematu kanału

TOPIC odczytuje lub zmienia temat kanału. Temat pomaga zrozumieć jego charakter i zasady; nie jest prywatną wiadomością ani ustawieniem całej strony internetowej.

Zespół Dialovy · Sprawdzono

Składnia i parametry #

Składnia protokołu, bez ukośnika używanego w kliencie
TOPIC <kanal> [:<nowy-temat>]
ParametrZnaczenie
kanałKanał, którego dotyczy polecenie.
nowy-tematBrak parametru odczytuje temat; pusty ostatni parametr usuwa go; podany tekst zastępuje temat.

Przykład z objaśnieniem #

Wymiana IRC: C = klient, S = serwer
C: TOPIC #atelier
S: :irc.example 332 Alice #atelier :Rozmawiamy o tworzeniu
C: TOPIC #atelier :Witajcie, przedstawcie swoje projekty
S: :Alice!alice@cloak.example TOPIC #atelier :Witajcie, przedstawcie swoje projekty

Nicki, hosty i teksty w przykładzie są fikcyjne. Klient może prezentować odpowiedzi czytelniej niż w surowych wiadomościach protokołu.

Możliwe odpowiedzi i błędy #

OdpowiedźZnaczenie
332 / 331Bieżący temat albo brak tematu.
333Autor i data, czasem przekazywane dodatkowo zależnie od serwera.
TOPICNowy temat rozsyłany klientom.
BłądTypowa przyczyna
403Kanał nie istnieje.
442Nie należysz do kanału.
482Zmiana wymaga uprawnień, których nie masz.

Uprawnienia, zgodność i środki ostrożności #

Przy trybie ochrony tematu tekst mogą zmieniać tylko uprawnieni użytkownicy. Limit długości może być ogłaszany jako TOPICLEN w ISUPPORT.

Nie umieszczaj tajnych danych w temacie: może pojawiać się na listach, w logach i innych klientach. Link w TOPIC nadal trzeba sprawdzić przed otwarciem.

Częste pytania #

Jak usunąć temat? W protokole wyślij TOPIC #atelier : z pustym ostatnim parametrem; interfejs może oferować osobne pole.

Czy data tematu jest zawsze wyświetlana? Nie. Dodatkowa odpowiedź lub rozszerzony widok zależą od serwera i klienta.

Źródła i weryfikacja

Przykłady używają fikcyjnych nicków i domen, z wyjątkiem wyraźnie udokumentowanych punktów połączenia. Rozszerzenia i ustawienia właściwe danej sieci są zaznaczone w tekście.