// TRANSLATION MISSING
A list of scripts is available in WeeChat with `/script` or on
-https://weechat.org/scripts/[this page ^↗^,window=_blank].
+https://weechat.org/scripts/[this page ^↗^^].
[[more_doc]]
== Další dokumentace
// TRANSLATION MISSING
You can now use WeeChat and read
-https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+https://weechat.org/doc/[FAQ/documentation ^↗^^]
for any other questions.
Ať máte radost z použití WeeChatu!
WeeChat ist sehr speicherschonend und besticht durch innovative Funktionen.
Weitere Infomationen über Weechat
-https://weechat.org/about/features/[features page ^↗^,window=_blank].
+https://weechat.org/about/features/[features page ^↗^^].
[[compilation_install]]
== Kompilierung / Installation
=== Ich habe gehört es gibt verschiedene GUIs für WeeChat. Wie kann ich diese kompilieren bzw. nutzen?
Einige Remote-GUIs sind verfügbar, siehe
-https://weechat.org/about/interfaces/[remote interfaces page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[remote interfaces page ^↗^^].
[[compile_git]]
=== Ich kann WeeChat nach Cloning des git Repository nicht kompilieren - weshalb?
WeeChat muss mit CMake kompiliert werden.
-Bitte folgen Sie link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank]
+Bitte folgen Sie link:weechat_user.en.html#source_package[build instructions ^↗^^]
und stellen Sie sicher, dass alle erforderlichen Abhängigkeiten installiert sind.
Wenn Sie weiterhin Probleme haben, melden Sie diese bitte den Entwicklern.
[[compile_macos]]
=== Wie installiere ich WeeChat auf macOS?
-Wir empfehlen, dass zur Installation https://brew.sh/[Homebrew ^↗^,window=_blank] genutzt wird.
+Wir empfehlen, dass zur Installation https://brew.sh/[Homebrew ^↗^^] genutzt wird.
Hilfe erhält man mittels:
----
Um Hilfe zu erhalten, nutze den `/help` Befehl.
Jeder Befehl besitzt einen Hilfstext, den man sich durch `/help Befehlsname` anzeigen lassen kann.
-Die link:weechat_user.de.html#key_bindings[Standard Tastenbelegung ^↗^,window=_blank] sowie
-link:weechat_user.de.html#commands_and_options[Befehle und Optionen ^↗^,window=_blank] sind im
-link:weechat_user.de.html[Benutzerhandbuch ^↗^,window=_blank] aufgeführt.
+Die link:weechat_user.de.html#key_bindings[Standard Tastenbelegung ^↗^^] sowie
+link:weechat_user.de.html#commands_and_options[Befehle und Optionen ^↗^^] sind im
+link:weechat_user.de.html[Benutzerhandbuch ^↗^^] aufgeführt.
Neuen Anwendern wird empfohlen,
-die link:weechat_quickstart.de.html[Quickstart Anleitung ^↗^,window=_blank] zu lesen.
+die link:weechat_quickstart.de.html[Quickstart Anleitung ^↗^^] zu lesen.
[[display]]
== Anzeige
("`defutf8 on`" in der Datei ~/.screenrc oder `screen -U` beim Starten von
screen).
* Überprüfe die Option
- link:weechat_user.de.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
+ link:weechat_user.de.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^^]
(diese Option kann schwerwiegenden Darstellungsfehler verursachen, wenn man die Option aktiviert hat).
[NOTE]
verwendeten Distributionen noch nicht verfügbar).
Es gibt folgende Übergangslösung, um das Problem mit der _wcwidth_ zu umgehen:
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank].
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^^].
-Siehe https://github.com/weechat/weechat/issues/79[bug report ^↗^,window=_blank]
+Siehe https://github.com/weechat/weechat/issues/79[bug report ^↗^^]
für weitere Informationen.
[[bars_background]]
[[buffers_list]]
=== Wie kann ich eine Liste mit den Buffern z.B. auf der linken Seite anzeigen lassen?
-Diese Erweiterung, link:weechat_user.de.html#buflist[buflist ^↗^,window=_blank],
+Diese Erweiterung, link:weechat_user.de.html#buflist[buflist ^↗^^],
wird standardmäßig geladen und aktiviert.
Um die maximale Breite der buflist-Spalte zu reduzieren, nutze folgende Option:
Die Buflist-Erweiterung bietet viele Optionen, zum individualisieren. Bitte lesen Sie dazu die Hilfe von jeder Option.
-Es gibt zusätzlich die https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^,window=_blank]
+Es gibt zusätzlich die https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^^]
mit Beispielen für die erweiterte buflist Konfiguration.
[[customize_prefix]]
Weitere hotlist Eigenschaften können mit Hilfe der Optionen __weechat.look.hotlist_*__
verändert werden.
-Siehe link:weechat_user.de.html#screen_layout[Benutzerhandbuch / Screen layout ^↗^,window=_blank]
+Siehe link:weechat_user.de.html#screen_layout[Benutzerhandbuch / Screen layout ^↗^^]
für weitere Informationen zur Hotlist.
[[input_bar_size]]
Sie können eine beliebige Farbnummer in den Optionen verwenden (optional: Sie können Farbaliase,
mit dem Befehl `/color`, erstellen.
-Bitte lese link:weechat_user.de.html#colors[Benutzerhandbuch / Farben ^↗^,window=_blank]
+Bitte lese link:weechat_user.de.html#colors[Benutzerhandbuch / Farben ^↗^^]
für weitere Informationen die das Farbmanagement betreffen.
[[search_text]]
Um zu Highlight-Nachrichten zu springen:
kbd:[Alt+p] für vorherige, kbd:[Alt+n] für die nächste Nachricht.
-siehe link:weechat_user.de.html#key_bindings[Benutzerhandbuch / Standard Tastenbelegung ^↗^,window=_blank]
+siehe link:weechat_user.de.html#key_bindings[Benutzerhandbuch / Standard Tastenbelegung ^↗^^]
für weitere Informationen zu dieser Funktion.
[[terminal_focus]]
----
Eine Auflistung der Standardtastenbelegung findet man in
-link:weechat_user.de.html#key_bindings[Benutzerhandbuch / Standard Tastenbelegung ^↗^,window=_blank].
+link:weechat_user.de.html#key_bindings[Benutzerhandbuch / Standard Tastenbelegung ^↗^^].
Um zu Buffern zu wechseln die an Position ≥ 100 sind kann ein Trigger definiert
werden um dann z.B. mit einem Kurzbefehl `/123` zum Buffer #123 zu springen:
[[filter_irc_join_part_quit]]
=== Wie kann ich join/part/quit und andere unerwünschte Nachrichten in IRC-Kanälen filtern?
-siehe link:weechat_user.de.html#irc_smart_filter[User's guide / IRC smart filter ^↗^,window=_blank].
+siehe link:weechat_user.de.html#irc_smart_filter[User's guide / IRC smart filter ^↗^^].
[[filter_irc_join_channel_messages]]
=== Wie kann ich die Server-Nachrichten filtern, wenn ich einen IRC Kanal betrete?
[[disable_highlights_for_specific_nicks]]
=== Wie kann ich Highlights (Hervorhebungen) von bestimmten Nicks deaktivieren?
-Dafür sollte link:weechat_user.de.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
+Dafür sollte link:weechat_user.de.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^^]
die Buffer-Eigenschaft genutzt werden, um das maximale Hotlist-Level für einige Nicks pro Puffer festzulegen,
oder pro Gruppe von Buffern (wie IRC-Server).
es möglich ist, wie z.B. bei Passwörtern: siehe `/help secure` und nutze `/help`
bei der entsprechenden Option (falls man geschützte Daten nutzen kann, wird es
im Hilfstext erwähnt).
-Siehe auch link:weechat_user.de.html#secured_data[Benutzerhandbuch / sensible Daten ^↗^,window=_blank].
+Siehe auch link:weechat_user.de.html#secured_data[Benutzerhandbuch / sensible Daten ^↗^^].
Beispiel:
Einige andere Dateien enthalten möglicherweise vertrauliche Informationen wie
Kennwörter (sofern sie nicht mit dem Befehl `/secure` in _sec.conf_ gesichert werden).
-Siehe link:weechat_user.de.html#files_and_directories[Benutzerhandbuch / Dateien und Verzeichnisse ^↗^,window=_blank]
+Siehe link:weechat_user.de.html#files_and_directories[Benutzerhandbuch / Dateien und Verzeichnisse ^↗^^]
für weitere Informationen über Konfigurationsdateien.
[[development]]
[[bug_task_patch]]
=== Was kann ich machen, falls ich einen Fehler gefunden habe, mich nach neuen Funktionen erkundigen oder Patches einsenden möchte?
-siehe https://weechat.org/about/support/[this page ^↗^,window=_blank].
+siehe https://weechat.org/about/support/[this page ^↗^^].
[[gdb_error_threads]]
=== Wenn man WeeChat in gdb startet, kann ein Thread-Fehler auftreten. Was beudeutet das?
Es gibt einiges zu tun - z.B. testen, programmieren, dokumentieren, ...
Bitte kontaktieren Sie uns per IRC oder Mail, siehe
-https://weechat.org/about/support/[support page ^↗^,window=_blank].
+https://weechat.org/about/support/[support page ^↗^^].
[[donate]]
=== Kann ich Geld oder anderes an die WeeChat Entwickler spenden?
Sie können uns Geld spenden, um die Entwicklung zu unterstützen.
-Details dazu, unter https://weechat.org/donate/[donation page ^↗^,window=_blank].
+Details dazu, unter https://weechat.org/donate/[donation page ^↗^^].
----
Eine Liste von Skripten ist in WeeChat mittels `/script` oder auf
-https://weechat.org/scripts/[this page ^↗^,window=_blank] verfügbar.
+https://weechat.org/scripts/[this page ^↗^^] verfügbar.
[[more_doc]]
== Weitere Dokumentation
WeeChat kann nun verwendet werden und lesen Sie
-https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+https://weechat.org/doc/[FAQ/documentation ^↗^^]
falls Sie weitere Fragen haben.
Viel Spass mit WeeChat!
Diese Anleitung beschreibt den WeeChat Chat Client und ist Teil von WeeChat.
Die neueste Version dieses Dokuments finden Sie unter
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== Einleitung
dafür gibt es explizit eine API Funktion, andernfalls kann WeeChat abstürzen. +
Wenn etwas in einem Hintergrundprozess ausgeführt werden soll, kann die Funktion
`+hook_process+` genutzt werden. Siehe Beispiele im Kapitel <<hook_process,Hintergrundprozesse>>
-und die Dokumentation für die Funktion `+hook_process+` in link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank] (Englisch).
+und die Dokumentation für die Funktion `+hook_process+` in link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^^] (Englisch).
[[languages_specificities]]
=== Besonderheiten der einzelnen Skriptsprachen
WeeChat definiert ein `weechat` Module welches mittels `import weechat`
importiert werden muss. +
Ein Python-Stub für die WeeChat-API ist im Repository verfügbar:
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^,window=_blank].
+https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]]
===== Funktionen
Es wird empfohlen den Modifier `+irc_in2_yyy+` zu nutzen, da die empfangene Zeichenkette
immer UTF-8 gültig ist. +
siehe Funktion `+hook_modifier+` in der
- link:weechat_plugin_api.en.html#_hook_modifier[WeeChat Anleitung für API Erweiterung ^↗^,window=_blank].
+ link:weechat_plugin_api.en.html#_hook_modifier[WeeChat Anleitung für API Erweiterung ^↗^^].
| hook_signal
| xxx,irc_out_yyy +
Es wird empfohlen das Signal `+xxx,irc_out1_yyy+` zu nutzen, da die empfangene Zeichenkette
immer UTF-8 gültig ist. +
siehe Funktion `+hook_signal+` in der
- link:weechat_plugin_api.en.html#_hook_signal[WeeChat Anleitung für API Erweiterung ^↗^,window=_blank].
+ link:weechat_plugin_api.en.html#_hook_signal[WeeChat Anleitung für API Erweiterung ^↗^^].
| hook_process +
hook_process_hashtable
und Sie erhält es als Wert eines Arguments in einer Callback-Funktion zurück, wenn
der Wert des Arguments NULL ist. Um zu sehen, welche Funktionen Nullwerte akzeptieren
und Nullwerte in Rückrufen übergeben, schauen Sie sich die Python-Prototypen an
-link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^].
[[language_guile]]
==== Guile (Scheme)
Die Skripten API ist nahezu identisch mit der API der C Erweiterung.
Um einen Überblick über alle API Funktionen (Prototyp, Argumente,
Rückgabe werte, Beispiele) zu erhalten werfen Sie einen Blick in
-die link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^↗^,window=_blank] (Englisch).
+die link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^↗^^] (Englisch).
Es ist wichtig das man zwischen einer _Erweiterung_ und einem _Skript_
unterscheidet: Eine _Erweiterung_ ist eine Binärdatei die kompiliert wurde
und mittels `/plugin` geladen wird. Ein _Skript_ ist eine Textdatei welche
== Skript API
Um weiterführende Informationen zu den API Funktionen zu erhalten
-lesen Sie bitte link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^↗^,window=_blank] (Englisch).
+lesen Sie bitte link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^↗^^] (Englisch).
[[script_api_functions]]
=== Funktionen
Dieses Kapitel beinhaltet einige Aufgaben mit Lösungsbeispielen.
Die Skript API wird dabei nur sehr oberflächlich besprochen.Um eine vollständige
Übersicht aller Befehle zu erhalten nutzen Sie bitte die
-link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^↗^,window=_blank] (Englisch).
+link:weechat_plugin_api.en.html[WeeChat Plugin API Reference ^↗^^] (Englisch).
[[buffers]]
=== Buffer
[TIP]
Alle verfügbaren Informationen über WeeChat findet man unter
-https://weechat.org/dev/info/[this page ^↗^,window=_blank].
+https://weechat.org/dev/info/[this page ^↗^^].
Beispiel eines URL Transfers, mit zusätzliche Optionen: Es wird das neuste
WeeChat Entwicklerpaket in die Datei _/tmp/weechat-devel.tar.gz_ gesichert:
Für weitere Informationen zum URL Transfer und verfügbare Optionen, siehe Funktionen
`+hook_process+` und `+hook_process_hashtable+` in
-link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank] (Englisch).
+link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^^] (Englisch).
[[config_options]]
=== Konfiguration / Optionen
Diese Anleitung beschreibt den WeeChat Chat Client und ist Teil von WeeChat.
Die neueste Version dieses Dokuments finden Sie unter
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== Einleitung
* klein, schnell und schlank
* den eigenen, persönlichen, Bedürfnissen anpassbar und durch Erweiterungen und Skripten in der Funktionalität erweiterbar
* IRC RFCs konform
- https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^,window=_blank] und
- https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^,window=_blank]
+ https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] und
+ https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
* IRC proxy und relay für remote Schnittstellen
* Betriebssystemunabhängig (GNU/Linux, *BSD, macOS, Windows und weitere)
* 100% GPL, freie Software
Die Liste aller Funktionen finden Sie unter
-https://weechat.org/about/features/[this page ^↗^,window=_blank].
+https://weechat.org/about/features/[this page ^↗^^].
[[prerequisites]]
=== Vorbereitung
* Debian/Ubuntu (oder Debian kompatible Distribution):
`apt-get install weechat-curses weechat-plugins` +
Für neueste Versionen und nächtliche Builds:
- https://weechat.org/download/debian/[Debian repositories ^↗^,window=_blank]
+ https://weechat.org/download/debian/[Debian repositories ^↗^^]
* Fedora Core: `dnf install weechat`
* FreeBSD: `pkg install weechat`
* Gentoo: `emerge weechat`
`rpm -i /path/to/weechat-x.y.z-1.i386.rpm`
* openSUSE: `zypper in weechat`
* Sourcemage: `cast weechat`
-* macOS (mittels https://brew.sh/[Homebrew ^↗^,window=_blank]): `brew install weechat`
+* macOS (mittels https://brew.sh/[Homebrew ^↗^^]): `brew install weechat`
(für Hilfe siehe: `brew info weechat`)
zusätzliche Pakete können bzw. sollten installiert werden. Zum Beispiel: weechat-plugins.
=== Container
Container mit WeeChat können direkt erstellt oder installiert werden von
-https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^,window=_blank]. +
+https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^^]. +
Weitere Informationen finden Sie in der README in dem
-https://github.com/weechat/weechat-container[weechat-container ^↗^,window=_blank]
+https://github.com/weechat/weechat-container[weechat-container ^↗^^]
Repositorium.
[[source_package]]
WeeChat muss mit CMake erstellt werden.
[NOTE]
-Unter macOS kann https://brew.sh/[Homebrew ^↗^,window=_blank] verwendet werden:
+Unter macOS kann https://brew.sh/[Homebrew ^↗^^] verwendet werden:
`brew install --build-from-source weechat`.
[[dependencies]]
| zlib1g-dev |
| Logger-Erweitertung: Kompression von rotierenden Protokolldateien (gzip). +
- Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://zlib.net/[zlib ^↗^,window=_blank] (weechat protocol). +
+ Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). +
Script-Erweiterung: Lesen der Repository-Indexdatei (gzip).
| libzstd-dev | ≥ 0.8.1
| Logger-Erweiterung: Kompression von rotierenden Protokolldateien. +
- Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] (weechat protocol).
+ Relay-Erweiterung: Kompression von Nachrichten (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol).
|===
[NOTE]
befinden, z.B. _/var/lib/systemd/coredump_ und es muss der `coredumpctl` Befehl genutzt
werden um die Datei zu lesen. +
Weitere Informationen finden Sie hier
-https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^,window=_blank].
+https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
Beispiel: _weechat_ ist in _/usr/bin/_ installiert und die _core_ Datei befindet sich
in _/home/user/_. Nun wird gdb mit folgendem Befehl aufgerufen:
==== XDG directories
WeeChat verwendet standardmäßig XDG-Verzeichnisse
-(gemäß https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^,window=_blank]). +
+(gemäß https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^^]). +
Ein einzelnes Home-Verzeichnis für alle Dateien kann durch die CMake-Option `WEECHAT_HOME`,
die Umgebungsvariable `WEECHAT_HOME` oder die Befehlszeilenoption `-d` / `--dir` erzwungen werden.
Wenn ein einzelnes WeeChat-Ausgangsverzeichnis nicht erzwungen wird, werden XDG-Verzeichnisse wie folgt
==== Versionshinweise
Nach einem Upgrade wird *dringend empfohlen* die,
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[Versionshinweise ^↗^,window=_blank]
+https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[Versionshinweise ^↗^^]
zu lesen, denn dort sind wichtige Informationen zu Änderungen enthalten und ob
eventuell ein manuelles Eingreifen erforderlich sein könnte.
==== Fehlersuche
Sollten Probleme bei der Zeichensatzdarstellung auftreten dann werfen Sie bitte
-einen Blick in die link:weechat_faq.de.html#charset[WeeChat FAQ / Charset ^↗^,window=_blank].
+einen Blick in die link:weechat_faq.de.html#charset[WeeChat FAQ / Charset ^↗^^].
[[charset_commands]]
==== Befehle
erreicht ist, findet eine automatische Rotation der Protokolldatei statt.
Die rotierenden Protokolldateien können mit gzip kompromiert werden oder mit
-https://facebook.github.io/zstd/[zstd ^↗^,window=_blank].
+https://facebook.github.io/zstd/[zstd ^↗^^].
[NOTE]
Da die Komprimierung einer Datei einige Zeit in Anspruch nehmen kann, wird diese Aktion
[NOTE]
Sollten Probleme bei der Mausunterstützung auftreten, dann sollte Bitte die
-link:weechat_faq.de.html#mouse[WeeChat FAQ / Mausunterstützung ^↗^,window=_blank].
+link:weechat_faq.de.html#mouse[WeeChat FAQ / Mausunterstützung ^↗^^].
[[mouse_bind_events]]
==== Befehle einem Maus-Ereignis zuweisen
angelegt werden.
Um zum Beispiel eine TLS verschlüsselte Verbindung zu
-https://libera.chat/[libera.chat ^↗^,window=_blank] herzustellen:
+https://libera.chat/[libera.chat ^↗^^] herzustellen:
----
/server add libera irc.libera.chat/6697 -tls
----
Weitere Informationen finden Sie unter
-https://www.oftc.net/NickServ/CertFP/[this page ^↗^,window=_blank].
+https://www.oftc.net/NickServ/CertFP/[this page ^↗^^].
[[irc_sasl_authentication]]
==== SASL Authentifizierung
[[irc_tor_sasl]]
==== Connect with Tor and SASL
-Einige Server unterstützen eine Verbindungen mittels https://www.torproject.org/[Tor ^↗^,window=_blank],
+Einige Server unterstützen eine Verbindungen mittels https://www.torproject.org/[Tor ^↗^^],
dies ist ein Netzwerk mit virtueller Tunneln, durch welchen Personen und Gruppen ihre
Privatsphäre und Sicherheit im Internet verbessern können.
[[irc_ircv3_support]]
=== IRCv3 support
-WeeChat unterstützt folgende https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
+WeeChat unterstützt folgende https://ircv3.net/irc/[IRCv3 extensions ^↗^^]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
(siehe Option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Mehrere Tabellen mit Auflistung verschiedener IRC-Clients, einschließlich WeeChat, sind verfügbar
-auf https://ircv3.net/software/clients[this page ^↗^,window=_blank].
+auf https://ircv3.net/software/clients[this page ^↗^^].
[[irc_ircv3_account_notify]]
==== account-notify
-Spezifikation: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^^]
Diese Funktion ermöglicht es dem Server, Nachrichten zu senden, wenn Benutzer sich auf dem
Server identifizieren oder diese zurück ziehen. +
[[irc_ircv3_account_tag]]
==== account-tag
-Spezifikation: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^^]
Diese Fähigkeit ermöglicht es dem Server, einen Account als Nachrichten-Tag an Befehle zu hängen,
die an den Client gesendet werden. +
[[irc_ircv3_away_notify]]
==== away-notify
-Spezifikation: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^^]
Diese Funktion ermöglicht es dem Server, Abwesenheits-Benachrichtigungen für Benutzer zu versenden,
die die selben Kanälen besuchen, wie Sie.
[[irc_ircv3_batch]]
==== batch
-Spezifikation: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/batch[batch ^↗^^]
Diese Funktion ermöglicht es dem Server, Batch-Ereignisse (Gruppe von mehreren
Nachrichten, die zusammengehören) zu senden.
[[irc_ircv3_cap_notify]]
==== cap-notify
-Spezifikation: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^^]
Diese Fähigkeit ermöglicht es dem Server, neue oder entfernte Fähigkeiten anzubieten, über die
der Server verfügt (mittels der Befehle `CAP NEW` und `CAP DEL`).
[[irc_ircv3_chghost]]
==== chghost
-Spezifikation: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/chghost[chghost ^↗^^]
Diese Funktion ermöglicht es dem Server, Nachrichten zu senden, wenn Benutzer den Namen oder den Host ändern. +
Wenn die Option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
[[irc_ircv3_draft_multiline]]
==== draft/multiline
-Spezifikation: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/multiline[multiline ^↗^^]
Diese Funktion ermöglicht es dem Client und dem Server, Nachrichten über mehrere Zeilen zu senden.
Es wird dazu die Fähigkeit <<irc_ircv3_batch,batch>> genutzt, die ebenfalls aktiviert sein muss.
[[irc_ircv3_echo_message]]
==== echo-message
-Spezifikation: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^^]
Diese Funktion zwingt den Server, PRIVMSG-, NOTICE- und TAGMSG-Nachrichten zurück an
WeeChat zu senden.
[[irc_ircv3_extended_join]]
==== extended-join
-Spezifikation: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^^]
Diese Funktion ermöglicht es dem Server, sowohl Account und den Realnamen des Users zu senden,
wenn diese einen Kanal betreten. +
[[irc_ircv3_invite_notify]]
==== invite-notify
-Spezifikation: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^^]
Diese Funktion ermöglicht es dem Server, Einladungsnachrichten zu senden, wenn Benutzer zu
Kanälen eingeladen werden.
[[irc_ircv3_message_tags]]
==== message-tags
-Spezifikation: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^^]
Diese Funktion ermöglicht das Hinzufügen von Metadaten zu Nachrichten. +
Diese Tags können mit dem Befehl `/debug tags` angezeigt werden.
[[irc_ircv3_monitor]]
==== monitor
-Spezifikation: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/monitor[monitor ^↗^^]
Diese Funktion ermöglicht es dem Server, Benachrichtigungen zu senden, wenn Clients
Online/Offline gehen. +
[[irc_ircv3_multi_prefix]]
==== multi-prefix
-Spezifikation: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^^]
Diese Fähigkeit ermöglicht es dem Server, alle Benutzermodi auf einmal zu senden, wenn
die Befehle <<command_irc_names,/names>> und <<command_irc_whois,/whois>> genutzt werden. +
[[irc_ircv3_sasl]]
==== SASL
-Spezifikation: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^^]
Siehe das entsprechende Kapitel <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
==== server-time
-Spezifikation: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/server-time[server-time ^↗^^]
Diese Fähigkeit ermöglicht es dem Server, die Zeit für Nachrichten als Nachrichten-Tag zu senden. +
Wenn die Zeit in einer Nachricht empfangen wird, verwendet WeeChat diese, um die Nachricht anzuzeigen
[[irc_ircv3_setname]]
==== setname
-Spezifikation: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/setname[setname ^↗^^]
Mit dieser Funktion können Sie Ihren richtigen Namen ändern, indem Sie den
<<command_irc_setname,/setname>> Befehl nutzen.
[[irc_ircv3_typing]]
==== typing
-Spezifikation: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/client-tags/typing[typing ^↗^^]
Siehe das entsprechende Kapitel <<typing_notifications,Typing notifications>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
-Spezifikation: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^^]
Diese Funktion ermöglicht es dem Server, Hostnamen bei <<command_irc_names,/names>> zu senden.
[[irc_ircv3_whox]]
==== WHOX
-Spezifikation: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
+Spezifikation: https://ircv3.net/specs/extensions/whox[WHOX ^↗^^]
Mit dieser Funktion können Sie zusätzliche Felder in der WHO-Antwort anfordern
(mit dem Befehl <<command_irc_who,/who>>). +
wie folgt überprüfen werden <<command_irc_cap,/cap>>). +
Unter der Haube wird das Typing-Client-Tag folgendermaßen verwendet
-https://ircv3.net/specs/client-tags/typing[this specification ^↗^,window=_blank].
+https://ircv3.net/specs/client-tags/typing[this specification ^↗^^].
[[typing_activation]]
=== Aktivierung
* _irc_: IRC Proxy: um mittels einem oder mehreren IRC-Clients eine Verbindung zu
IRC Servern zu unterhalten.
* _weechat_: Protokoll, das von Remote-Schnittstellen zur Anzeige und Interaktion verwendet wird
- WeeChat, siehe https://weechat.org/about/interfaces/[this page ^↗^,window=_blank].
+ WeeChat, siehe https://weechat.org/about/interfaces/[this page ^↗^^].
[[relay_password]]
=== Passwort
Ein Einmal-Passwort kann mit folgenden Anwendungen erstellt werden, zum Beispiel:
* FreeOTP:
- https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^,window=_blank]
- (https://freeotp.github.io/[website ^↗^,window=_blank])
+ https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^^],
+ https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^^]
+ (https://freeotp.github.io/[website ^↗^^])
* Google Authenticator:
- https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^,window=_blank]
+ https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^^],
+ https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^^]
Die geheime TOTP Zeichenkette muss in WeeChat und der Anwendung gesetzt werden, welches
für die Erstellung des Einmal-Passwort zuständig ist.
externe Oberfläche senden.
Sie können eine Verbindung mit einer Remote-Schnittstelle herstellen, siehe
-https://weechat.org/about/interfaces/[this page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[this page ^↗^^].
[IMPORTANT]
Eine WeeChat Instanz kann sich NICHT mit einer anderen WeeChat Instanz über
[[relay_websocket]]
=== WebSocket
-Das WebSocket Protokoll (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^,window=_blank])
+Das WebSocket Protokoll (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^^])
wird nun in der Relay Erweiterung unterstützt.
Der WebSocket Handshake wird automatisch erkannt und der Socket ist sofort
Um Trigger nutzen zu können ist es von Vorteil zu wissen wie signals,
modifiers, ... in WeeChat überhaupt funktionieren. Deshalb sollte man überlegen,
-ob man nicht folgende Anleitung lesen sollte link:weechat_plugin_api.en.html#hooks[Anleitung für API Erweiterung / Hooks ^↗^,window=_blank] (Englisch).
+ob man nicht folgende Anleitung lesen sollte link:weechat_plugin_api.en.html#hooks[Anleitung für API Erweiterung / Hooks ^↗^^] (Englisch).
[[trigger_default]]
=== standardmäßige Trigger
| hook | `+signal+`, `+hsignal+`, `+modifier+`, `+line+`, `+print+`, `+command+`,
`+command_run+`, `+timer+`, `+config+`, `+focus+`, `+info+`, `+info_hashtable+`
| Der hook welcher durch Trigger genutzt werden soll. Für weitere Informationen siehe
- link:weechat_plugin_api.en.html#hooks[Anleitung für API Erweiterung / Hooks ^↗^,window=_blank] (Englisch).
+ link:weechat_plugin_api.en.html#hooks[Anleitung für API Erweiterung / Hooks ^↗^^] (Englisch).
| arguments | string
| Argumente welche der Hook nutzen soll. Dies ist davon abhängig welcher Hook-Typ genutzt wird.
| `+*,irc_in_privmsg+` +
`+*,irc_in_privmsg;*,irc_in_notice+` +
`+signal_sigwinch+`
-| link:weechat_plugin_api.en.html#_hook_signal[hook_signal ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_signal[hook_signal ^↗^^] +
(Englisch)
| hsignal
2. Signalname (Priorität erlaubt) +
3. ...
| `+nicklist_nick_added+`
-| link:weechat_plugin_api.en.html#_hook_hsignal[hook_hsignal ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_hsignal[hook_hsignal ^↗^^] +
(Englisch)
| modifier
3. ...
| `+weechat_print+` +
`+5000\|input_text_display;5000\|history_add+`
-| link:weechat_plugin_api.en.html#_hook_modifier[hook_modifier ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_modifier[hook_modifier ^↗^^] +
(Englisch)
| line
`+*;irc.libera.*+` +
`+*;irc.libera.#weechat+` +
`+formatted;irc.libera.#weechat;irc_notice+`
-| link:weechat_plugin_api.en.html#_hook_line[hook_line ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_line[hook_line ^↗^^] +
(Englisch)
| print
`+irc.libera.#weechat+` +
`+irc.libera.#weechat;irc_notice+` +
`+*;;;1+`
-| link:weechat_plugin_api.en.html#_hook_print[hook_print ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_print[hook_print ^↗^^] +
(Englisch)
| command
| `+test+` +
`+5000\|test+` +
`+test;test command;arg1 arg2;arg1: description 1${\n}arg2: description 2+`
-| link:weechat_plugin_api.en.html#_hook_command[hook_command ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_command[hook_command ^↗^^] +
(Englisch)
| command_run
2. Befehl (Priorität erlaubt) +
3. ...
| `+/cmd arguments+`
-| link:weechat_plugin_api.en.html#_hook_command_run[hook_command_run ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_command_run[hook_command_run ^↗^^] +
(Englisch)
| timer
3. max. Anzahl an Aufrufen (Standardwert: 0, was "unendlich" bedeutet)
| `+3600000+` +
`+60000;0;5+`
-| link:weechat_plugin_api.en.html#_hook_timer[hook_timer ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_timer[hook_timer ^↗^^] +
(Englisch)
| config
2. Name der Option (Priorität erlaubt) +
3. ...
| `+weechat.look.*+`
-| link:weechat_plugin_api.en.html#_hook_config[hook_config ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_config[hook_config ^↗^^] +
(Englisch)
| focus
2. area Name (Priorität erlaubt) +
3. ...
| `+buffer_nicklist+`
-| link:weechat_plugin_api.en.html#_hook_focus[hook_focus ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_focus[hook_focus ^↗^^] +
(Englisch)
| info
2. info name (Priorität erlaubt) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.en.html#_hook_info[hook_info ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_info[hook_info ^↗^^] +
(Englisch)
| info_hashtable
2. info name (Priorität erlaubt) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.en.html#_hook_info_hashtable[hook_info_hashtable ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_info_hashtable[hook_info_hashtable ^↗^^] +
(Englisch)
|===
|===
Um mehr über Erweiterungen- und Skriptenprogrammierung (mittels API) zu erfahren,
-sollten Sie die link:weechat_plugin_api.en.html[Anleitung für API Erweiterung ^↗^,window=_blank] (Englisch) oder
-link:weechat_scripting.de.html[WeeChat scripting guide ^↗^,window=_blank] lesen.
+sollten Sie die link:weechat_plugin_api.en.html[Anleitung für API Erweiterung ^↗^^] (Englisch) oder
+link:weechat_scripting.de.html[WeeChat scripting guide ^↗^^] lesen.
[[scripts]]
=== Skripten
Mit jeder dieser Erweiterungen können Skripten geladen, ausgeführt und entfernt werden.
Sollten wir Ihr Interesse geweckt haben selber Skripten für WeeChat zu programmieren, dann lesen Sie
-bitte die link:weechat_scripting.de.html[WeeChat scripting Guide ^↗^,window=_blank].
+bitte die link:weechat_scripting.de.html[WeeChat scripting Guide ^↗^^].
[[script_manager]]
==== Skriptmanager
Der Skriptmanager (Befehl <<command_script_script,/script>>) wird benutzt um
Skripte jeder Sprache zu starten/beenden, sowie Skripte aus dem WeeChat
Skriptrepositorium zu installieren/entfernen, diese sind aufgelistet auf
-https://weechat.org/scripts/[this page ^↗^,window=_blank].
+https://weechat.org/scripts/[this page ^↗^^].
Aus Datenschutzgründen ist das Herunterladen von Skripten standardmäßig deaktiviert. +
Um es zu aktivieren, geben Sie diesen Befehl ein:
** _#weechat-fi_ (finnisch)
Weitere Möglichkeiten der Unterstützung finden Sie unter
-https://weechat.org/about/support/[this page ^↗^,window=_blank].
+https://weechat.org/about/support/[this page ^↗^^].
This manual documents WeeChat chat client, it is part of WeeChat.
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== Introduction
== Repositories
WeeChat repositories are on GitHub organization
-https://github.com/weechat[weechat ^↗^,window=_blank].
+https://github.com/weechat[weechat ^↗^^].
List of repositories:
the _official_ scripts submitted on weechat.org
weechat.org::
- source of https://weechat.org/[WeeChat website ^↗^,window=_blank]
+ source of https://weechat.org/[WeeChat website ^↗^^]
weercd::
IRC testing server
| docinfo.html | Asciidoctor style.
| XX/ | Documentation for language XX (languages: en, fr, de, it, ...).
| weechat.1.XX.adoc | Man page (`man weechat`).
-| weechat_dev.XX.adoc | link:weechat_dev.en.html[Developer's guide ^↗^,window=_blank] (this document).
-| weechat_faq.XX.adoc | link:weechat_faq.en.html[FAQ ^↗^,window=_blank].
-| weechat_plugin_api.XX.adoc | link:weechat_plugin_api.en.html[Plugin API reference ^↗^,window=_blank].
-| weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide ^↗^,window=_blank].
-| weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.en.html[Relay protocol ^↗^,window=_blank] (for remote interfaces).
-| weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide ^↗^,window=_blank].
-| weechat_user.XX.adoc | link:weechat_user.en.html[User's guide ^↗^,window=_blank].
+| weechat_dev.XX.adoc | link:weechat_dev.en.html[Developer's guide ^↗^^] (this document).
+| weechat_faq.XX.adoc | link:weechat_faq.en.html[FAQ ^↗^^].
+| weechat_plugin_api.XX.adoc | link:weechat_plugin_api.en.html[Plugin API reference ^↗^^].
+| weechat_quickstart.XX.adoc | link:weechat_quickstart.en.html[Quickstart guide ^↗^^].
+| weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.en.html[Relay protocol ^↗^^] (for remote interfaces).
+| weechat_scripting.XX.adoc | link:weechat_scripting.en.html[Scripting guide ^↗^^].
+| weechat_user.XX.adoc | link:weechat_user.en.html[User's guide ^↗^^].
| includes/ | Files included in documentation.
| cmdline_options.XX.adoc | Command-line options (file included in man pages and user's guide).
| man.XX.adoc | Part of man pages: plugin options, files and copyright.
[[coding_python_style]]
=== Python style
-See https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank].
+See https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^^].
[[core_internals]]
== Core internals
[[git_repository]]
=== Git repository
-Git repository is on https://github.com/weechat/weechat[GitHub ^↗^,window=_blank].
+Git repository is on https://github.com/weechat/weechat[GitHub ^↗^^].
Any patch for bug or new feature must be done on master branch, preferred way
is a GitHub pull request. A patch can also be sent by e-mail
Then you can edit .po files (if you can translate in a language).
When done, you *have* to check your file with
-https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank]:
+https://github.com/flashcode/msgcheck[msgcheck ^↗^^]:
----
$ msgcheck.py xx.po
Because WeeChat is very light and brings innovating features.
More info on the WeeChat
-https://weechat.org/about/features/[features page ^↗^,window=_blank].
+https://weechat.org/about/features/[features page ^↗^^].
[[compilation_install]]
== Compilation / install
=== I've heard about many GUIs for WeeChat. How can I compile/use them?
Some remote GUIs are available, see the
-https://weechat.org/about/interfaces/[remote interfaces page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[remote interfaces page ^↗^^].
[[compile_git]]
=== I can't compile WeeChat after cloning git repository, why?
WeeChat must be compiled with CMake.
-Please follow link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank]
+Please follow link:weechat_user.en.html#source_package[build instructions ^↗^^]
and ensure all required dependencies are installed.
If you still have issues, please report them to the developers.
[[compile_macos]]
=== How can I install WeeChat on macOS?
-It is recommended to use https://brew.sh/[Homebrew ^↗^,window=_blank],
+It is recommended to use https://brew.sh/[Homebrew ^↗^^],
you can get help with:
----
=== I've launched WeeChat, but I'm lost, what can I do?
For help you can type `/help`. For help about a command, type `/help command`.
-link:weechat_user.en.html#key_bindings[Keys ^↗^,window=_blank] and
-link:weechat_user.en.html#commands_and_options[commands ^↗^,window=_blank]
+link:weechat_user.en.html#key_bindings[Keys ^↗^^] and
+link:weechat_user.en.html#commands_and_options[commands ^↗^^]
are listed in documentation.
It's recommended for new users to read the
-link:weechat_quickstart.en.html[Quickstart guide ^↗^,window=_blank].
+link:weechat_quickstart.en.html[Quickstart guide ^↗^^].
[[display]]
== Display
** If you are using screen, check that it is run with UTF-8 mode
("`defutf8 on`" in ~/.screenrc or `screen -U` to run screen).
* Check that option
- link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
+ link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^^]
is off (this option may cause display bugs).
[NOTE]
in glibc 2.22 (maybe not yet available in your distribution).
There is a workaround to use the fixed _wcwidth_ function:
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank]
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^^]
-See this https://github.com/weechat/weechat/issues/79[bug report ^↗^,window=_blank]
+See this https://github.com/weechat/weechat/issues/79[bug report ^↗^^]
for more information.
[[bars_background]]
[[buffers_list]]
=== How to display the buffers list on the left side?
-The plugin link:weechat_user.en.html#buflist[buflist ^↗^,window=_blank]
+The plugin link:weechat_user.en.html#buflist[buflist ^↗^^]
is loaded and enabled by default.
To limit size of bar:
The buflist plugin provides lot of options that you can customize, please read
the help on each option.
-There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^,window=_blank]
+There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^^]
with examples of advanced buflist configuration.
[[customize_prefix]]
(buffers) and __weechat.color.status_count_*__ (counters). +
Other hotlist options can be changed with the options __weechat.look.hotlist_*__.
-See link:weechat_user.en.html#screen_layout[User's guide / Screen layout ^↗^,window=_blank]
+See link:weechat_user.en.html#screen_layout[User's guide / Screen layout ^↗^^]
for more info about the hotlist.
[[input_bar_size]]
You can use any color number in options (optional: you can add color aliases
with command `/color`).
-Please read the link:weechat_user.en.html#colors[User's guide / Colors ^↗^,window=_blank]
+Please read the link:weechat_user.en.html#colors[User's guide / Colors ^↗^^]
for more information about colors management.
[[search_text]]
The default key is kbd:[Ctrl+r] (command is: `+/input search_text_here+`).
And jump to highlights: kbd:[Alt+p] / kbd:[Alt+n].
-See link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^,window=_blank]
+See link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^^]
for more info about this feature.
[[terminal_focus]]
----
List of default keys is in
-link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^,window=_blank].
+link:weechat_user.en.html#key_bindings[User's guide / Key bindings ^↗^^].
To jump to buffers with number ≥ 100, you could define a trigger and then use
commands like `/123` to jump to buffer #123:
[[filter_irc_join_part_quit]]
=== How can I filter join/part/quit and other annoying messages on IRC channels?
-See link:weechat_user.en.html#irc_smart_filter[User's guide / IRC smart filter ^↗^,window=_blank].
+See link:weechat_user.en.html#irc_smart_filter[User's guide / IRC smart filter ^↗^^].
[[filter_irc_join_channel_messages]]
=== How can I filter some messages displayed when I join an IRC channel?
=== How can I disable highlights for specific nicks?
You can use the
-link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
+link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^^]
buffer property to set the max hotlist level for some nicks, per buffer,
or per group of buffers (like IRC servers).
Define a passphrase and use secured data wherever you can for sensitive data
like passwords: see `/help secure` and `/help` on options
(if you can use secured data, it is written in the help).
-See also link:weechat_user.en.html#secured_data[User's guide / Secured data ^↗^,window=_blank].
+See also link:weechat_user.en.html#secured_data[User's guide / Secured data ^↗^^].
For example:
Some other files may contain sensitive info like passwords (if they are not
stored in _sec.conf_ with the `/secure` command).
-See the link:weechat_user.en.html#files_and_directories[User's guide / Files and directories ^↗^,window=_blank]
+See the link:weechat_user.en.html#files_and_directories[User's guide / Files and directories ^↗^^]
for more information about configuration files.
[[development]]
[[bug_task_patch]]
=== How should I report bugs, ask for new features or send patches?
-See https://weechat.org/about/support/[this page ^↗^,window=_blank].
+See https://weechat.org/about/support/[this page ^↗^^].
[[gdb_error_threads]]
=== When I run WeeChat under gdb, there is an error about threads, what can I do?
There are many tasks to do (testing, code, documentation, etc.)
Please contact us via IRC or mail, look at
-https://weechat.org/about/support/[support page ^↗^,window=_blank].
+https://weechat.org/about/support/[support page ^↗^^].
[[donate]]
=== Can I give money or other things to WeeChat developers?
You can give us money to help development.
-Details on https://weechat.org/donate/[donation page ^↗^,window=_blank].
+Details on https://weechat.org/donate/[donation page ^↗^^].
This manual documents WeeChat chat client, it is part of WeeChat.
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== Introduction
Register the script.
For more information, see the
-link:weechat_scripting.en.html#register_function[WeeChat scripting guide ^↗^,window=_blank].
+link:weechat_scripting.en.html#register_function[WeeChat scripting guide ^↗^^].
Script (Python):
This function is a C conversion of Python class "shlex" (file: Lib/shlex.py in
Python repository), see
-https://docs.python.org/3/library/shlex.html[this page ^↗^,window=_blank].
+https://docs.python.org/3/library/shlex.html[this page ^↗^^].
Prototype:
exception for the following chars, that have a specific behavior in WeeChat:
* U+0009 (Tabulation): value of option
- link:weechat_user.en.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^,window=_blank]
+ link:weechat_user.en.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^^]
* U+0001 (1) to U+001F (31), except U+0009 (Tabulation): 1
* U+00AD (173, soft hyphen): -1
* U+200B (8203, zero width space): -1
[NOTE]
In Ruby, the 3 callbacks + data (6 strings) must be given in an array of 6
strings (due to a Ruby limitation of 15 arguments by function), see the
-link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide ^↗^,window=_blank]
+link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide ^↗^^]
for more info _(fixed in version 0.4.1)_.
==== config_search_option
* _tags_: comma separated list of tags (NULL means no tags)
* _message_: message to display
-See the link:weechat_user.en.html#lines_tags[WeeChat user's guide / Lines tags ^↗^,window=_blank]
+See the link:weechat_user.en.html#lines_tags[WeeChat user's guide / Lines tags ^↗^^]
for a list of commonly used tags in WeeChat.
C example:
[TIP]
If you want to retrieve infos about WeeChat (like current stable version,
latest git commit, etc.), you can use URLs on
-https://weechat.org/dev/info/[this page ^↗^,window=_blank].
+https://weechat.org/dev/info/[this page ^↗^^].
[NOTE]
Buffer size for sending data to callback is 64KB (there are 2 buffers: one for
| -
| Any string.
| String with IRC tag value escaped,
- see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^,window=_blank].
+ see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^^].
| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value | 3.3
| -
| Any string.
| String with IRC tag value unescaped,
- see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^,window=_blank].
+ see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^^].
| [[hook_modifier_color_decode_ansi]] color_decode_ansi | 1.0
| "1" to keep colors, "0" to remove colors
** _inactive_: bar is displayed in inactive windows only
** _nicklist_: bar is displayed in windows with nicklist
** evaluated expression: see the
- link:weechat_user.en.html#bar_conditions[WeeChat user's guide / Bar conditions ^↗^,window=_blank]
+ link:weechat_user.en.html#bar_conditions[WeeChat user's guide / Bar conditions ^↗^^]
* _position_: _top_, _bottom_, _left_ or _right_
* _filling_top_bottom_:
** _horizontal_: items are filled horizontally (space after each item)
With WeeChat ≥ 2.9, in Ruby, the 4 colors (color_fg, color_delim, color_bg,
color_bg_inactive) must be given in an array of 4 strings (due to a Ruby
limitation of 15 arguments by function), see the
-link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide ^↗^,window=_blank]
+link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide ^↗^^]
for more info.
==== bar_set
----
[NOTE]
-See the link:weechat_scripting.en.html#irc_message_parse[WeeChat scripting guide / Parse message ^↗^,window=_blank]
+See the link:weechat_scripting.en.html#irc_message_parse[WeeChat scripting guide / Parse message ^↗^^]
for more info about "irc_message_parse" output.
Script (Python):
* _search_: expression to evaluate, default pointer in expression is the name of
hdata (and this pointer changes for each element in list); for help on
expression, see the
- link:weechat_user.en.html#command_weechat_eval[WeeChat user's guide / Command /eval ^↗^,window=_blank]
+ link:weechat_user.en.html#command_weechat_eval[WeeChat user's guide / Command /eval ^↗^^]
* _pointers_: hashtable for call to function
<<_string_eval_expression,string_eval_expression>>
* _extra_vars_: hashtable for call to function
See `/help script` for more info.
A list of scripts is available in WeeChat with `/script` or on
-https://weechat.org/scripts/[this page ^↗^,window=_blank].
+https://weechat.org/scripts/[this page ^↗^^].
[[more_doc]]
== More documentation
You can now use WeeChat and read
-https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+https://weechat.org/doc/[FAQ/documentation ^↗^^]
for any other questions.
Enjoy using WeeChat!
if compression is enabled, messages from _relay_ to client are compressed
to save bandwidth; allowed values are:
*** _off_: no compression (default if option is not given)
-*** _zlib_: compress with https://zlib.net/[zlib ^↗^,window=_blank] _(WeeChat ≥ 0.3.7)_
-*** _zstd_: compress with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]:
+*** _zlib_: compress with https://zlib.net/[zlib ^↗^^] _(WeeChat ≥ 0.3.7)_
+*** _zstd_: compress with https://facebook.github.io/zstd/[Zstandard ^↗^^]:
better compression and much faster than _zlib_ for both compression and decompression
_(WeeChat ≥ 3.5)_
in the password hash algorithm)
* _compression_: compression type:
** _off_: messages are not compressed
-** _zlib_: messages are compressed with https://zlib.net/[zlib ^↗^,window=_blank]
-** _zstd_: messages are compressed with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]
+** _zlib_: messages are compressed with https://zlib.net/[zlib ^↗^^]
+** _zstd_: messages are compressed with https://facebook.github.io/zstd/[Zstandard ^↗^^]
[TIP]
With WeeChat ≤ 2.8, the command _handshake_ is not implemented, WeeChat silently
(including this field)
* _compression_ (byte): flag:
** _0x00_: following data is not compressed
-** _0x01_: following data is compressed with https://zlib.net/[zlib ^↗^,window=_blank]
-** _0x02_: following data is compressed with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]
+** _0x01_: following data is compressed with https://zlib.net/[zlib ^↗^^]
+** _0x02_: following data is compressed with https://facebook.github.io/zstd/[Zstandard ^↗^^]
* _id_ (string, 4 bytes + content): identifier sent by client (before command name); it can be
empty (string with zero length and no content) if no identifier was given in
command
=== Compression
If flag _compression_ is equal to 0x01 or 0x02, then *all* data after is compressed
-with https://zlib.net/[zlib ^↗^,window=_blank] or
-https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank],
+with https://zlib.net/[zlib ^↗^^] or
+https://facebook.github.io/zstd/[Zstandard ^↗^^],
and therefore must be uncompressed before being processed.
[[message_identifier]]
This manual documents WeeChat chat client, it is part of WeeChat.
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== Introduction
If something must be run in background, the function `+hook_process+` can be used.
See example in the chapter <<hook_process,Run a background process>>
and the documentation on the function `+hook_process+` in the
-link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^^].
[[languages_specificities]]
=== Languages specificities
WeeChat defines a `weechat` module which must be imported with `import weechat`. +
A Python stub for WeeChat API is available in the repository:
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^,window=_blank].
+https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]]
===== Functions
It is recommended to use modifier `+irc_in2_yyy+` instead, the string received
is always UTF-8 valid. +
See function `+hook_modifier+` in the
- link:weechat_plugin_api.en.html#_hook_modifier[WeeChat plugin API reference ^↗^,window=_blank].
+ link:weechat_plugin_api.en.html#_hook_modifier[WeeChat plugin API reference ^↗^^].
| hook_signal
| xxx,irc_out_yyy +
It is recommended to use signal `+xxx,irc_out1_yyy+` instead, the string received
is always UTF-8 valid. +
See function `+hook_signal+` in the
- link:weechat_plugin_api.en.html#_hook_signal[WeeChat plugin API reference ^↗^,window=_blank].
+ link:weechat_plugin_api.en.html#_hook_signal[WeeChat plugin API reference ^↗^^].
| hook_process +
hook_process_hashtable
will get it as the value of an argument in a callback function if the argument
value is null. To see which functions accept null values and passes null values
to callbacks, look at the Python prototypes in the
-link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^].
[[language_guile]]
==== Guile (Scheme)
== Differences with C API
Script API is almost the same as C plugin API.
-You can look at link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank]
+You can look at link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^]
for detail about each function in API: prototype, arguments, return values, examples.
It's important to make difference between a _plugin_ and a _script_: a
== Script API
For more information about functions in API, please read the
-link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^].
[[script_api_functions]]
=== Functions
This chapter shows some common tasks, with examples.
Only partial things in API are used here, for full reference, see the
-link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^].
[[buffers]]
=== Buffers
[TIP]
All infos available about WeeChat are on
-https://weechat.org/dev/info/[this page ^↗^,window=_blank].
+https://weechat.org/dev/info/[this page ^↗^^].
Example of URL transfer with an option: download latest WeeChat development
package in file _/tmp/weechat-devel.tar.gz_:
For more information about URL transfer and available options, see functions
`+hook_process+` and `+hook_process_hashtable+` in
-link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.en.html#_hook_process[WeeChat plugin API reference ^↗^^].
[[config_options]]
=== Config / options
This manual documents WeeChat chat client, it is part of WeeChat.
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== Introduction
* small, fast and light
* customizable and extensible with plugins and scripts
* compliant with IRC RFCs
- https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^,window=_blank] and
- https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^,window=_blank]
+ https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] and
+ https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
* IRC proxy and relay for remote interfaces
* multi-platform (GNU/Linux, *BSD, macOS, Windows and other)
* 100% GPL, free software
The list of all features can be found on
-https://weechat.org/about/features/[this page ^↗^,window=_blank].
+https://weechat.org/about/features/[this page ^↗^^].
[[prerequisites]]
=== Prerequisites
* Debian/Ubuntu (or any Debian compatible distribution):
`apt-get install weechat-curses weechat-plugins` +
For latest versions and nightly builds:
- https://weechat.org/download/debian/[Debian repositories ^↗^,window=_blank]
+ https://weechat.org/download/debian/[Debian repositories ^↗^^]
* Fedora Core: `dnf install weechat`
* FreeBSD: `pkg install weechat`
* Gentoo: `emerge weechat`
`rpm -i /path/to/weechat-x.y.z-1.i386.rpm`
* openSUSE: `zypper in weechat`
* Sourcemage: `cast weechat`
-* macOS (with https://brew.sh/[Homebrew ^↗^,window=_blank]): `brew install weechat`
+* macOS (with https://brew.sh/[Homebrew ^↗^^]): `brew install weechat`
(for help: `brew info weechat`)
Some additional packages may be useful, like weechat-plugins.
=== Containers
Containers with WeeChat can be built or installed directly from the
-https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^,window=_blank]. +
+https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^^]. +
For more information, see the README in the
-https://github.com/weechat/weechat-container[weechat-container ^↗^,window=_blank]
+https://github.com/weechat/weechat-container[weechat-container ^↗^^]
repository.
[[source_package]]
WeeChat must be built with CMake.
[NOTE]
-On macOS, you can use https://brew.sh/[Homebrew ^↗^,window=_blank]:
+On macOS, you can use https://brew.sh/[Homebrew ^↗^^]:
`brew install --build-from-source weechat`.
[[dependencies]]
| zlib1g-dev |
| Logger plugin: compression of rotated log files (gzip). +
- Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^,window=_blank] (weechat protocol). +
+ Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). +
Script plugin: read of repository index file (gzip).
| libzstd-dev | ≥ 0.8.1
| Logger plugin: compression of rotated log files. +
- Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] (weechat protocol).
+ Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol).
|===
[NOTE]
On some systems like Archlinux, core dumps could be in another directory like
_/var/lib/systemd/coredump_ and you must use the command `coredumpctl` to read it. +
For more information, see this
-https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^,window=_blank].
+https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
For example if _weechat_ is installed in _/usr/bin/_ and _core_ file is
in _/home/user/_, then run gdb with this command:
==== XDG directories
WeeChat uses XDG directories by default (according to the
-https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^,window=_blank]). +
+https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^^]). +
A single home directory for all files can be forced by CMake option `WEECHAT_HOME`,
the environment variable `WEECHAT_HOME` or the command-line option `-d` / `--dir`.
==== Release notes
After an upgrade, it is *strongly recommended* to read the
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^,window=_blank]
+https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^^]
which contain important information about breaking changes and some
manual actions that could be required.
==== Troubleshooting
For any problem with charsets, please look at
-link:weechat_faq.en.html#charset[WeeChat FAQ / Charset ^↗^,window=_blank].
+link:weechat_faq.en.html#charset[WeeChat FAQ / Charset ^↗^^].
[[charset_commands]]
==== Commands
there is automatic rotation of log file.
The rotated log files can be compressed with gzip or
-https://facebook.github.io/zstd/[zstd ^↗^,window=_blank].
+https://facebook.github.io/zstd/[zstd ^↗^^].
[NOTE]
As the compression of a file can take some time, it is performed in background.
[NOTE]
For any problem with mouse, please look at
-link:weechat_faq.en.html#mouse[WeeChat FAQ / Mouse ^↗^,window=_blank].
+link:weechat_faq.en.html#mouse[WeeChat FAQ / Mouse ^↗^^].
[[mouse_bind_events]]
==== Bind mouse events to commands
By default no servers are defined. You can add as many servers as you want with
the <<command_irc_server,/server>> command.
-For example to connect to https://libera.chat/[libera.chat ^↗^,window=_blank]
+For example to connect to https://libera.chat/[libera.chat ^↗^^]
with TLS (encrypted trafic):
----
----
For more information, please look at
-https://www.oftc.net/NickServ/CertFP/[this page ^↗^,window=_blank].
+https://www.oftc.net/NickServ/CertFP/[this page ^↗^^].
[[irc_sasl_authentication]]
==== SASL authentication
[[irc_tor_sasl]]
==== Connect with Tor and SASL
-Some servers support connections with https://www.torproject.org/[Tor ^↗^,window=_blank],
+Some servers support connections with https://www.torproject.org/[Tor ^↗^^],
a network of virtual tunnels that allows people and groups to improve their
privacy and security on the Internet.
[[irc_ircv3_support]]
=== IRCv3 support
-WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
+WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^^]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
(see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Tables with comparison of different IRC clients, including WeeChat, are available
-on https://ircv3.net/software/clients[this page ^↗^,window=_blank].
+on https://ircv3.net/software/clients[this page ^↗^^].
[[irc_ircv3_account_notify]]
==== account-notify
-Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^^]
This capability allows the server to send messages when users identify or
unidentify on the server. +
[[irc_ircv3_account_tag]]
==== account-tag
-Specification: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^^]
This capability allows the server to send account as message tag to commands
sent to the client. +
[[irc_ircv3_away_notify]]
==== away-notify
-Specification: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^^]
This capability allows the server to send away notifications for users present
on the same channels as you.
[[irc_ircv3_batch]]
==== batch
-Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^^]
This capability allows the server to send batched events (grouping of several
messages that are related).
[[irc_ircv3_cap_notify]]
==== cap-notify
-Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^^]
This capability allows the server to advertise on new or removed capabilities
on the server (via `CAP NEW` and `CAP DEL` commands).
[[irc_ircv3_chghost]]
==== chghost
-Specification: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/chghost[chghost ^↗^^]
This capability allows the server to send messages when users change name or host. +
When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
[[irc_ircv3_draft_multiline]]
==== draft/multiline
-Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^^]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
[[irc_ircv3_echo_message]]
==== echo-message
-Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^^]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
[[irc_ircv3_extended_join]]
==== extended-join
-Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^^]
This capability allows the server to send account and real name when users
join channels. +
[[irc_ircv3_invite_notify]]
==== invite-notify
-Specification: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^^]
This capability allows the server to send invite messages when users are
invited to channels.
[[irc_ircv3_message_tags]]
==== message-tags
-Specification: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^^]
This capability allows to add metadata in messages. +
These tags can be displayed using the command `/debug tags`.
[[irc_ircv3_monitor]]
==== monitor
-Specification: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/monitor[monitor ^↗^^]
This capability allows the server to send notifications when clients become
online/offline. +
[[irc_ircv3_multi_prefix]]
==== multi-prefix
-Specification: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^^]
This capability allows the server to send all user modes at once in
<<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. +
[[irc_ircv3_sasl]]
==== SASL
-Specification: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^^]
See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
==== server-time
-Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^^]
This capability allows the server to send time for messages as message tag. +
When the time is received in a message, WeeChat uses it to display the message
[[irc_ircv3_setname]]
==== setname
-Specification: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/setname[setname ^↗^^]
This capability lets you change your real name by using the
<<command_irc_setname,/setname>> command.
[[irc_ircv3_typing]]
==== typing
-Specification: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/client-tags/typing[typing ^↗^^]
See the dedicated chapter <<typing_notifications,Typing notifications>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
-Specification: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^^]
This capability allows the server to send hostnames in <<command_irc_names,/names>>
responses.
[[irc_ircv3_whox]]
==== WHOX
-Specification: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/whox[WHOX ^↗^^]
This capability lets you request additional fields in the WHO response
(via the <<command_irc_who,/who>> command). +
It is used by IRC plugin on channel and private buffers, when the "message-tags"
capability is enabled (you can check with <<command_irc_cap,/cap>> command). +
Under the hood, typing client tag is used, following
-https://ircv3.net/specs/client-tags/typing[this specification ^↗^,window=_blank].
+https://ircv3.net/specs/client-tags/typing[this specification ^↗^^].
[[typing_activation]]
=== Activation
* _irc_: IRC proxy: used to share connections to IRC servers with one or many
other IRC clients
* _weechat_: protocol used by remote interfaces to display and interact with
- WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^,window=_blank].
+ WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^^].
[[relay_password]]
=== Password
One-time passwords can be generated with applications, for example:
* FreeOTP:
- https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^,window=_blank]
- (https://freeotp.github.io/[website ^↗^,window=_blank])
+ https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^^],
+ https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^^]
+ (https://freeotp.github.io/[website ^↗^^])
* Google Authenticator:
- https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^,window=_blank]
+ https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^^],
+ https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^^]
The TOTP secret must be set in WeeChat and the application used to generate
one-time passwords.
The Relay plugin can send data to remote interface using WeeChat protocol.
You can connect with a remote interface, see
-https://weechat.org/about/interfaces/[this page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[this page ^↗^^].
[IMPORTANT]
WeeChat itself can NOT connect to another WeeChat with this protocol.
[[relay_websocket]]
=== WebSocket
-WebSocket protocol (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^,window=_blank])
+WebSocket protocol (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^^])
is supported in Relay plugin for all protocols.
The WebSocket handshake is automatically detected and socket becomes ready for
Using triggers require you to know how the signals, modifiers, ... are working.
So you might consider reading the
-link:weechat_plugin_api.en.html#hooks[WeeChat plugin API reference / Hooks ^↗^,window=_blank].
+link:weechat_plugin_api.en.html#hooks[WeeChat plugin API reference / Hooks ^↗^^].
[[trigger_default]]
=== Default triggers
| hook | `+signal+`, `+hsignal+`, `+modifier+`, `+line+`, `+print+`, `+command+`,
`+command_run+`, `+timer+`, `+config+`, `+focus+`, `+info+`, `+info_hashtable+`
| The hook used in trigger. For more information, see
- link:weechat_plugin_api.en.html#hooks[WeeChat plugin API reference / Hooks ^↗^,window=_blank].
+ link:weechat_plugin_api.en.html#hooks[WeeChat plugin API reference / Hooks ^↗^^].
| arguments | string
| The arguments for the hook, it depends on the hook type used.
| `+*,irc_in_privmsg+` +
`+*,irc_in_privmsg;*,irc_in_notice+` +
`+signal_sigwinch+`
-| link:weechat_plugin_api.en.html#_hook_signal[hook_signal ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_signal[hook_signal ^↗^^]
| hsignal
| 1. signal name (priority allowed) (required) +
2. signal name (priority allowed) +
3. ...
| `+nicklist_nick_added+`
-| link:weechat_plugin_api.en.html#_hook_hsignal[hook_hsignal ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_hsignal[hook_hsignal ^↗^^]
| modifier
| 1. modifier name (priority allowed) (required) +
3. ...
| `+weechat_print+` +
`+5000\|input_text_display;5000\|history_add+`
-| link:weechat_plugin_api.en.html#_hook_modifier[hook_modifier ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_modifier[hook_modifier ^↗^^]
| line
| 1. buffer type +
`+*;irc.libera.*+` +
`+*;irc.libera.#weechat+` +
`+formatted;irc.libera.#weechat;irc_notice+`
-| link:weechat_plugin_api.en.html#_hook_line[hook_line ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_line[hook_line ^↗^^]
| print
| 1. buffer name +
`+irc.libera.#weechat+` +
`+irc.libera.#weechat;irc_notice+` +
`+*;;;1+`
-| link:weechat_plugin_api.en.html#_hook_print[hook_print ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_print[hook_print ^↗^^]
| command
| 1. command name (priority allowed) (required) +
| `+test+` +
`+5000\|test+` +
`+test;test command;arg1 arg2;arg1: description 1${\n}arg2: description 2+`
-| link:weechat_plugin_api.en.html#_hook_command[hook_command ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_command[hook_command ^↗^^]
| command_run
| 1. command (priority allowed) (required) +
2. command (priority allowed) +
3. ...
| `+/cmd arguments+`
-| link:weechat_plugin_api.en.html#_hook_command_run[hook_command_run ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_command_run[hook_command_run ^↗^^]
| timer
| 1. interval in milliseconds (required) +
3. max number of calls (default: 0, which means "no end")
| `+3600000+` +
`+60000;0;5+`
-| link:weechat_plugin_api.en.html#_hook_timer[hook_timer ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_timer[hook_timer ^↗^^]
| config
| 1. option name (priority allowed) (required) +
2. option name (priority allowed) +
3. ...
| `+weechat.look.*+`
-| link:weechat_plugin_api.en.html#_hook_config[hook_config ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_config[hook_config ^↗^^]
| focus
| 1. area name (priority allowed) (required) +
2. area name (priority allowed) +
3. ...
| `+buffer_nicklist+`
-| link:weechat_plugin_api.en.html#_hook_focus[hook_focus ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_focus[hook_focus ^↗^^]
| info
| 1. info name (priority allowed) (required) +
2. info name (priority allowed) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.en.html#_hook_info[hook_info ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_info[hook_info ^↗^^]
| info_hashtable
| 1. info name (priority allowed) (required) +
2. info name (priority allowed) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.en.html#_hook_info_hashtable[hook_info_hashtable ^↗^,window=_blank]
+| link:weechat_plugin_api.en.html#_hook_info_hashtable[hook_info_hashtable ^↗^^]
|===
[[trigger_conditions]]
|===
To learn more about plugin or script development (through API), please read the
-link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank] or the
-link:weechat_scripting.en.html[WeeChat scripting guide ^↗^,window=_blank].
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^] or the
+link:weechat_scripting.en.html[WeeChat scripting guide ^↗^^].
[[scripts]]
=== Scripts
These plugins can load, execute and unload scripts for these languages.
For more information about how to write scripts, or WeeChat API for
-scripts, please read the link:weechat_scripting.en.html[WeeChat scripting guide ^↗^,window=_blank].
+scripts, please read the link:weechat_scripting.en.html[WeeChat scripting guide ^↗^^].
[[script_manager]]
==== Script manager
The script manager (command <<command_script_script,/script>>) is used to
load/unload scripts of any language, and install/remove scripts of WeeChat
scripts repository, which are visible on
-https://weechat.org/scripts/[this page ^↗^,window=_blank].
+https://weechat.org/scripts/[this page ^↗^^].
For privacy considerations, the download of scripts is disabled by default. +
To enable it, type this command:
** _#weechat-fi_ (Finnish)
For other ways of support, see
-https://weechat.org/about/support/[this page ^↗^,window=_blank].
+https://weechat.org/about/support/[this page ^↗^^].
// TRANSLATION MISSING
More info on the WeeChat
-https://weechat.org/about/features/[features page ^↗^,window=_blank].
+https://weechat.org/about/features/[features page ^↗^^].
[[compilation_install]]
== Compilación / instalación
// TRANSLATION MISSING
Some remote GUIs are available, see the
-https://weechat.org/about/interfaces/[remote interfaces page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[remote interfaces page ^↗^^].
[[compile_git]]
=== No puedo compilar WeeChat después de haber clonado el repositorio git, ¿por qué?
WeeChat must be compiled with CMake.
// TRANSLATION MISSING
-Please follow link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank]
+Please follow link:weechat_user.en.html#source_package[build instructions ^↗^^]
and ensure all required dependencies are installed.
// TRANSLATION MISSING
[[compile_macos]]
=== ¿Cómo puedo instalar WeeChat en macOS?
-Se recomienda utilizar https://brew.sh/[Homebrew ^↗^,window=_blank],
+Se recomienda utilizar https://brew.sh/[Homebrew ^↗^^],
puede obtener ayuda con el comando:
----
=== He lanzado WeeChat, pero estoy perdido, ¿qué puedo hacer?
Para consultar la ayuda, escriba `/help`. Para buscar ayuda con un comando, escriba `/help comando`.
-link:weechat_user.en.html#key_bindings[Las teclas ^↗^,window=_blank] y
-link:weechat_user.en.html#commands_and_options[comandos ^↗^,window=_blank] aparecen listados
+link:weechat_user.en.html#key_bindings[Las teclas ^↗^^] y
+link:weechat_user.en.html#commands_and_options[comandos ^↗^^] aparecen listados
en la documentación.
Se recomienda a las personas recién llegadas leer la
-link:weechat_quickstart.es.html[guía rápida ^↗^,window=_blank].
+link:weechat_quickstart.es.html[guía rápida ^↗^^].
[[display]]
== Visualización
** Si está utilizando el multiplexador screen, compruebe que lo está ejecuando con el modo UTF-8
("`defutf8 on`" en ~/.screenrc o `screen -U` al ejecutar screen).
* Compruebe si la opción
- link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
+ link:weechat_user.en.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^^]
está en off (esta opción puede causar errores a la hora de mostrar el texto).
[NOTE]
en glibc 2.22 (quizás todavía no está disponible en su distribución).
Hay una solución temporal que es utilizar una función de _wcwidth_ sin ese error:
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank].
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^^].
// TRANSLATION MISSING
-See this https://github.com/weechat/weechat/issues/79[bug report ^↗^,window=_blank]
+See this https://github.com/weechat/weechat/issues/79[bug report ^↗^^]
for more information.
[[bars_background]]
[[buffers_list]]
=== ¿Cómo mostrar un listado de los buffers en la parte izquierda?
-El complemento link:weechat_user.en.html#buflist[buflist ^↗^,window=_blank]
+El complemento link:weechat_user.en.html#buflist[buflist ^↗^^]
está cargado y habilitado de manera predeterminada.
Para limitar el tamaño de la barra:
la ayuda de cada opción.
// TRANSLATION MISSING
-There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^,window=_blank]
+There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^^]
with examples of advanced buflist configuration.
[[customize_prefix]]
(buffers) y __weechat.color.status_count_*__ (contadores). +
Otras opciones de la lista rápida o _hotlist_ pueden ser cambiadas con las opciones __weechat.look.hotlist_*__.
-Vea la link:weechat_user.en.html#screen_layout[Guía de usuario / diseño de la pantalla ^↗^,window=_blank] para
+Vea la link:weechat_user.en.html#screen_layout[Guía de usuario / diseño de la pantalla ^↗^^] para
más información sobre este tema.
[[input_bar_size]]
You can use any color number in options (optional: you can add color aliases
with command `/color`).
-Por favor lea la link:weechat_user.en.html#colors[Guía del usuario / Colores ^↗^,window=_blank] para más
+Por favor lea la link:weechat_user.en.html#colors[Guía del usuario / Colores ^↗^^] para más
información sobre la gestión de los colores.
[[search_text]]
La tecla predeterminada es kbd:[Ctrl+r] (el comando es: `+/input texto_a_buscar_aquí+`).
Y para saltar a los textos resaltados: kbd:[Alt+p] / kbd:[Alt+n].
-Vea la link:weechat_user.en.html#key_bindings[Guía del usuario / Atajos de teclado ^↗^,window=_blank]
+Vea la link:weechat_user.en.html#key_bindings[Guía del usuario / Atajos de teclado ^↗^^]
para más información sobre esta funcionalidad.
[[terminal_focus]]
----
Tiene una lista de las teclas predeterminadas en la
-link:weechat_user.en.html#key_bindings[Guía del usuario / Atajos de teclado ^↗^,window=_blank].
+link:weechat_user.en.html#key_bindings[Guía del usuario / Atajos de teclado ^↗^^].
Para saltar a un buffer mayor de 100, podría definir un disparador y después utilizar
comandos como `/123` para saltar al buffer #123:
[[filter_irc_join_part_quit]]
=== How can I filter join/part/quit and other annoying messages on IRC channels?
-See link:weechat_user.en.html#irc_smart_filter[User's guide / IRC smart filter ^↗^,window=_blank].
+See link:weechat_user.en.html#irc_smart_filter[User's guide / IRC smart filter ^↗^^].
[[filter_irc_join_channel_messages]]
=== ¿Cómo puedo filtrar algunos mensajes mostrados cuando me uno a un canal IRC?
// TRANSLATION MISSING
You can use the
-link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
+link:weechat_user.en.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^^]
buffer property to set the max hotlist level for some nicks, per buffer,
or per group of buffers (like IRC servers).
Defina una frase de paso y utilice datos seguros cada vez que pueda para datos sensibles
como contraseñas: vea `/help secure` y `/help` en las opciones
(si puede utilice datos seguros, está escrito en la ayuda).
-Ver también link:weechat_user.en.html#secured_data[Guía del usuario / Datos seguros ^↗^,window=_blank].
+Ver también link:weechat_user.en.html#secured_data[Guía del usuario / Datos seguros ^↗^^].
Por ejemplo:
Algunos otros archivos pueden contener información sensible como contraseñas (si no están
almacenadas en _sec.conf_ con el comando `/secure`).
-Vea la link:weechat_user.en.html#files_and_directories[Guía del usuario / Archivos y directorios ^↗^,window=_blank]
+Vea la link:weechat_user.en.html#files_and_directories[Guía del usuario / Archivos y directorios ^↗^^]
para más información relacionada con los archivos de configuración.
[[development]]
=== ¿Cómo podría informar de errores, pedir nuevas funcionalidades o enviar parches?
// TRANSLATION MISSING
-See https://weechat.org/about/support/[this page ^↗^,window=_blank].
+See https://weechat.org/about/support/[this page ^↗^^].
[[gdb_error_threads]]
=== Cuando ejecuto WeeChat bajo gdb, hay un error con la muestra de las conversaciones, ¿qué puedo hacer?
// TRANSLATION MISSING
Please contact us via IRC or mail, look at
-https://weechat.org/about/support/[support page ^↗^,window=_blank].
+https://weechat.org/about/support/[support page ^↗^^].
[[donate]]
=== ¿Puedo donar dinero u otras cosas a las personas que desarrollan WeeChat?
// TRANSLATION MISSING
You can give us money to help development.
-Details on https://weechat.org/donate/[donation page ^↗^,window=_blank].
+Details on https://weechat.org/donate/[donation page ^↗^^].
// TRANSLATION MISSING
A list of scripts is available in WeeChat with `/script` or on
-https://weechat.org/scripts/[this page ^↗^,window=_blank].
+https://weechat.org/scripts/[this page ^↗^^].
[[more_doc]]
== Más documentación
// TRANSLATION MISSING
You can now use WeeChat and read
-https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+https://weechat.org/doc/[FAQ/documentation ^↗^^]
for any other questions.
¡Disfrute de WeeChat!
partie de WeeChat.
La dernière version de ce document peut être téléchargée sur
-https://weechat.org/doc/[cette page ^↗^,window=_blank].
+https://weechat.org/doc/[cette page ^↗^^].
[[introduction]]
== Introduction
== Dépôts
Les dépôts de WeeChat sont dans l'organisation
-https://github.com/weechat[weechat ^↗^,window=_blank] de GitHub.
+https://github.com/weechat[weechat ^↗^^] de GitHub.
Liste des dépôts :
les scripts _officiels_ soumis sur weechat.org
weechat.org::
- le code source du https://weechat.org/[site de WeeChat ^↗^,window=_blank]
+ le code source du https://weechat.org/[site de WeeChat ^↗^^]
weercd::
serveur de test IRC
| docinfo.html | Style Asciidoctor.
| XX/ | Documentation pour la langue XX (langues : en, fr, de, it, ...).
| weechat.1.XX.adoc | Page de manuel (`man weechat`).
-| weechat_dev.XX.adoc | link:weechat_dev.fr.html[Guide du développeur ^↗^,window=_blank] (ce document).
-| weechat_faq.XX.adoc | link:weechat_faq.fr.html[FAQ ^↗^,window=_blank] (questions fréquemment posées).
-| weechat_plugin_api.XX.adoc | link:weechat_plugin_api.fr.html[Référence API extension ^↗^,window=_blank].
-| weechat_quickstart.XX.adoc | link:weechat_quickstart.fr.html[Guide de démarrage ^↗^,window=_blank].
-| weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.fr.html[Protocole Relay ^↗^,window=_blank] (pour les interfaces distantes).
-| weechat_scripting.XX.adoc | link:weechat_scripting.fr.html[Guide pour scripts ^↗^,window=_blank].
-| weechat_user.XX.adoc | link:weechat_user.fr.html[Guide utilisateur ^↗^,window=_blank].
+| weechat_dev.XX.adoc | link:weechat_dev.fr.html[Guide du développeur ^↗^^] (ce document).
+| weechat_faq.XX.adoc | link:weechat_faq.fr.html[FAQ ^↗^^] (questions fréquemment posées).
+| weechat_plugin_api.XX.adoc | link:weechat_plugin_api.fr.html[Référence API extension ^↗^^].
+| weechat_quickstart.XX.adoc | link:weechat_quickstart.fr.html[Guide de démarrage ^↗^^].
+| weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.fr.html[Protocole Relay ^↗^^] (pour les interfaces distantes).
+| weechat_scripting.XX.adoc | link:weechat_scripting.fr.html[Guide pour scripts ^↗^^].
+| weechat_user.XX.adoc | link:weechat_user.fr.html[Guide utilisateur ^↗^^].
| includes/ | Fichiers inclus dans la documentation.
| cmdline_options.XX.adoc | Options de ligne de commande (fichier inclus dans les pages de manuel et le guide utilisateur).
| man.XX.adoc | Parties des pages de manuel : options d'extension, fichiers et copyright.
[[coding_python_style]]
=== Style Python
-Voir https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank].
+Voir https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^^].
[[core_internals]]
== Intérieur du cœur
[[git_repository]]
=== Dépôt Git
-Le dépôt Git est sur https://github.com/weechat/weechat[GitHub ^↗^,window=_blank].
+Le dépôt Git est sur https://github.com/weechat/weechat[GitHub ^↗^^].
Tout patch pour un bug ou une nouvelle fonctionnalité doit être effectué sur la
branche master, le format préféré étant une "pull request" sur GitHub. Un patch
langue).
Une fois terminé, vous *devez* vérifier votre fichier avec
-https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank] :
+https://github.com/flashcode/msgcheck[msgcheck ^↗^^] :
----
$ msgcheck.py xx.po
Parce que WeeChat est très léger et apporte des fonctionnalités innovantes.
Plus d'infos sur la
-https://weechat.org/about/features/[page des fonctionnalités ^↗^,window=_blank]
+https://weechat.org/about/features/[page des fonctionnalités ^↗^^]
WeeChat.
=== J'ai entendu parler de plusieurs interfaces pour WeeChat. Comment puis-je les compiler/utiliser ?
Des interfaces distantes sont disponibles, voir la
-https://weechat.org/about/interfaces/[page avec les interfaces distantes ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[page avec les interfaces distantes ^↗^^].
[[compile_git]]
=== Je ne peux pas compiler WeeChat après avoir cloné la base git, pourquoi ?
WeeChat doit être compilé avec CMake.
-Merci de suivre les link:weechat_user.en.html#source_package[instructions de construction ^↗^,window=_blank]
+Merci de suivre les link:weechat_user.en.html#source_package[instructions de construction ^↗^^]
et vous assurer que toutes les dépendances obligatoires sont installées.
Si vous avez toujours des problèmes, merci de les remonter aux développeurs.
[[compile_macos]]
=== Comment puis-je installer WeeChat sous macOS ?
-Il est recommandé d'utiliser https://brew.sh/[Homebrew ^↗^,window=_blank],
+Il est recommandé d'utiliser https://brew.sh/[Homebrew ^↗^^],
vous pouvez avoir de l'aide avec :
----
=== J'ai lancé WeeChat, mais je suis perdu, que puis-je faire ?
Pour obtenir de l'aide tapez `/help`. Pour de l'aide sur une commande, tapez
-`/help commande`. Les link:weechat_user.fr.html#key_bindings[touches ^↗^,window=_blank] et
-link:weechat_user.fr.html#commands_and_options[commandes ^↗^,window=_blank] sont listées dans la
+`/help commande`. Les link:weechat_user.fr.html#key_bindings[touches ^↗^^] et
+link:weechat_user.fr.html#commands_and_options[commandes ^↗^^] sont listées dans la
documentation.
Il est recommandé pour les nouveaux utilisateurs de lire le
-link:weechat_quickstart.fr.html[Guide de démarrage rapide ^↗^,window=_blank].
+link:weechat_quickstart.fr.html[Guide de démarrage rapide ^↗^^].
[[display]]
== Affichage
** Si vous utilisez screen, vérifiez qu'il est lancé en mode UTF-8
("`defutf8 on`" dans ~/.screenrc ou `screen -U` pour lancer screen).
* Vérifiez que l'option
- link:weechat_user.fr.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
+ link:weechat_user.fr.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^^]
est désactivée (cette option peut causer des problèmes d'affichage).
[NOTE]
votre distribution).
Il y a un moyen de contournement pour utiliser la fonction _wcwidth_ corrigée :
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank].
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^^].
-Voir ce https://github.com/weechat/weechat/issues/79[rapport de bug ^↗^,window=_blank]
+Voir ce https://github.com/weechat/weechat/issues/79[rapport de bug ^↗^^]
pour plus d'informations.
[[bars_background]]
[[buffers_list]]
=== Comment afficher la liste des tampons sur la gauche ?
-L'extension link:weechat_user.fr.html#buflist[buflist ^↗^,window=_blank]
+L'extension link:weechat_user.fr.html#buflist[buflist ^↗^^]
est chargée et activée par défaut.
Pour limiter la taille de la barre :
L'extension buflist met à disposition beaucoup d'options que vous pouvez changer,
merci de lire l'aide sur chaque option.
-Il y a aussi une https://github.com/weechat/weechat/wiki/buflist[page wiki ^↗^,window=_blank]
+Il y a aussi une https://github.com/weechat/weechat/wiki/buflist[page wiki ^↗^^]
avec des exemples avancés de configuration buflist.
[[customize_prefix]]
Les autres options pour la "hotlist" peuvent être changées via les options
__weechat.look.hotlist_*__.
-Voir le link:weechat_user.fr.html#screen_layout[Guide utilisateur / Organisation de l'écran ^↗^,window=_blank]
+Voir le link:weechat_user.fr.html#screen_layout[Guide utilisateur / Organisation de l'écran ^↗^^]
pour plus d'information sur la "hotlist".
[[input_bar_size]]
Vous pouvez utiliser un numéro de couleur dans les options (facultatif : vous
pouvez ajouter des alias de couleurs avec la commande `/color`).
-Merci de lire le link:weechat_user.fr.html#colors[Guide utilisateur / Couleurs ^↗^,window=_blank]
+Merci de lire le link:weechat_user.fr.html#colors[Guide utilisateur / Couleurs ^↗^^]
pour plus d'information sur la gestion des couleurs.
[[search_text]]
La touche par défaut est kbd:[Ctrl+r] (la commande est : `+/input search_text_here+`).
Et sauter aux highlights : kbd:[Alt+p] / kbd:[Alt+n].
-Voir le link:weechat_user.fr.html#key_bindings[Guide utilisateur / Raccourcis clavier par défaut ^↗^,window=_blank]
+Voir le link:weechat_user.fr.html#key_bindings[Guide utilisateur / Raccourcis clavier par défaut ^↗^^]
pour plus d'information sur cette fonctionnalité.
[[terminal_focus]]
----
La liste des touches par défaut est dans le
-link:weechat_user.fr.html#key_bindings[Guide utilisateur / Raccourcis clavier par défaut ^↗^,window=_blank].
+link:weechat_user.fr.html#key_bindings[Guide utilisateur / Raccourcis clavier par défaut ^↗^^].
Pour sauter vers les tampons ayant un numéro ≥ 100, vous pouvez définir un trigger
et utiliser les commandes comme `/123` pour sauter au tampon n°123 :
[[filter_irc_join_part_quit]]
=== Comment puis-je filtrer les join/part/quit et autres messages gênants sur les canaux IRC ?
-Voir link:weechat_user.fr.html#irc_smart_filter[Guide utilisateur / Filtre intelligent IRC ^↗^,window=_blank].
+Voir link:weechat_user.fr.html#irc_smart_filter[Guide utilisateur / Filtre intelligent IRC ^↗^^].
[[filter_irc_join_channel_messages]]
=== Comment puis-je filtrer certains messages affichés quand je rejoins un canal IRC ?
=== Comment puis-je désactiver le highlight pour des pseudos spécifiques ?
Vous pouvez utiliser la propriété de tampon
-link:weechat_user.fr.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
+link:weechat_user.fr.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^^]
pour définir le niveau maximum de hotlist pour certains pseudos, par tampon,
ou groupe de tampons (comme des serveurs IRC).
où vous le pouvez pour les données sensibles comme les mots de passe : voir
`/help secure` et `/help` sur les options (si vous pouvez utiliser les données
sécurisées, cela est mentionné dans l'aide).
-Voir aussi link:weechat_user.fr.html#secured_data[Guide utilisateur / Données sécurisées ^↗^,window=_blank].
+Voir aussi link:weechat_user.fr.html#secured_data[Guide utilisateur / Données sécurisées ^↗^^].
Par exemple :
des mots de passes (s'ils ne sont pas stockés dans _sec.conf_ avec la commande
`/secure`).
-Voir le link:weechat_user.fr.html#files_and_directories[Guide utilisateur / Fichiers et répertoires ^↗^,window=_blank]
+Voir le link:weechat_user.fr.html#files_and_directories[Guide utilisateur / Fichiers et répertoires ^↗^^]
pour plus d'informations sur les fichiers de configuration.
[[development]]
[[bug_task_patch]]
=== Comment puis-je reporter un bug, demander une nouvelle fonctionnalité ou envoyer un patch ?
-Voir https://weechat.org/about/support/[cette page ^↗^,window=_blank].
+Voir https://weechat.org/about/support/[cette page ^↗^^].
[[gdb_error_threads]]
=== Quand je lance WeeChat sous gdb, il y a une erreur à propos des threads, que puis-je faire ?
Il y a plusieurs choses à faire (test, code, documentation, etc.)
Merci de prendre contact avec nous par IRC ou mail, consultez la
-https://weechat.org/about/support/[page support ^↗^,window=_blank].
+https://weechat.org/about/support/[page support ^↗^^].
[[donate]]
=== Puis-je donner de l'argent ou d'autres choses aux développeurs WeeChat ?
Vous pouvez donner de l'argent pour aider le développement.
-Plus de détails sur https://weechat.org/donate/[la page de dons ^↗^,window=_blank].
+Plus de détails sur https://weechat.org/donate/[la page de dons ^↗^^].
partie de WeeChat.
La dernière version de ce document peut être téléchargée sur
-https://weechat.org/doc/[cette page ^↗^,window=_blank].
+https://weechat.org/doc/[cette page ^↗^^].
[[introduction]]
== Introduction
Enregistrer le script.
Pour plus d'informations, voir le
-link:weechat_scripting.fr.html#register_function[Guide pour scripts WeeChat ^↗^,window=_blank].
+link:weechat_scripting.fr.html#register_function[Guide pour scripts WeeChat ^↗^^].
Script (Python) :
Cette fonction est une conversion en C de la classe Python "shlex" (fichier :
Lib/shlex.py dans le dépôt Python), voir
-https://docs.python.org/3/library/shlex.html[cette page ^↗^,window=_blank].
+https://docs.python.org/3/library/shlex.html[cette page ^↗^^].
Prototype :
spécifique dans WeeChat :
* U+0009 (Tabulation) : valeur de l'option
- link:weechat_user.fr.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^,window=_blank]
+ link:weechat_user.fr.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^^]
* U+0001 (1) to U+001F (31), sauf U+0009 (Tabulation) : 1
* U+00AD (173, trait d'union conditionnel) : -1
* U+200B (8203, espace sans chasse) : -1
En Ruby, les 3 fonctions de rappel + "data" (6 chaînes) doivent être données
dans un tableau de 6 chaînes de caractères (en raison d'une limitation de Ruby
à 15 paramètres par fonction), voir le
-link:++weechat_scripting.fr.html#_ruby++[Guide pour scripts WeeChat ^↗^,window=_blank]
+link:++weechat_scripting.fr.html#_ruby++[Guide pour scripts WeeChat ^↗^^]
pour plus d'infos _(corrigé dans la version 0.4.1)_.
==== config_search_option
étiquette)
* _message_ : message à afficher
-Voir le link:weechat_user.fr.html#lines_tags[Guide utilisateur WeeChat / Étiquettes des lignes ^↗^,window=_blank]
+Voir le link:weechat_user.fr.html#lines_tags[Guide utilisateur WeeChat / Étiquettes des lignes ^↗^^]
pour une liste des étiquettes couramment utilisées dans WeeChat.
Exemple en C :
[TIP]
Si vous souhaitez récupérer des infos à propos de WeeChat (comme la version
stable actuelle, le dernier commit git, etc.), vous pouvez utiliser les URLs
-sur https://weechat.org/dev/info/[cette page ^↗^,window=_blank].
+sur https://weechat.org/dev/info/[cette page ^↗^^].
[NOTE]
La taille du tampon pour l'envoi des données à la fonction de rappel est de
| -
| Toute chaîne.
| Chaîne avec la valeur de l'étiquette IRC échappée,
- voir https://ircv3.net/specs/extensions/message-tags#escaping-values[cette page ^↗^,window=_blank].
+ voir https://ircv3.net/specs/extensions/message-tags#escaping-values[cette page ^↗^^].
| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value | 3.3
| -
| Toute chaîne.
| Chaîne avec la valeur de l'étiquette IRC sans échappements,
- voir https://ircv3.net/specs/extensions/message-tags#escaping-values[cette page ^↗^,window=_blank].
+ voir https://ircv3.net/specs/extensions/message-tags#escaping-values[cette page ^↗^^].
| [[hook_modifier_color_decode_ansi]] color_decode_ansi | 1.0
| "1" pour garder les couleurs, "0" pour les supprimer
** _nicklist_ : la barre est affichée dans les fenêtres possédant une liste des
pseudos
** expression évaluée : voir le
- link:weechat_user.fr.html#bar_conditions[Guide utilisateur WeeChat / Conditions de barres ^↗^,window=_blank]
+ link:weechat_user.fr.html#bar_conditions[Guide utilisateur WeeChat / Conditions de barres ^↗^^]
* _position_ : _top_ (en haut), _bottom_ (en bas), _left_ (à gauche) ou _right_
(à droite)
* _filling_top_bottom_ :
Avec WeeChat ≥ 2.9, en Ruby, les 4 couleurs (color_fg, color_delim, color_bg,
color_bg_inactive) doivent être données dans un tableau de 4 chaînes de caractères
(en raison d'une limitation de Ruby à 15 paramètres par fonction), voir le
-link:++weechat_scripting.fr.html#_ruby++[Guide pour scripts WeeChat ^↗^,window=_blank]
+link:++weechat_scripting.fr.html#_ruby++[Guide pour scripts WeeChat ^↗^^]
pour plus d'infos.
==== bar_set
----
[NOTE]
-Voir le link:weechat_scripting.fr.html#irc_message_parse[Guide pour scripts WeeChat / Analyser un message ^↗^,window=_blank]
+Voir le link:weechat_scripting.fr.html#irc_message_parse[Guide pour scripts WeeChat / Analyser un message ^↗^^]
pour plus d'infos sur la sortie de "irc_message_parse".
Script (Python) :
* _search_ : expression à évaluer, le pointeur par défaut dans l'expression est
le nom du hdata (et ce pointeur change pour chaque élément dans la liste);
pour l'aide sur l'expression, voir le
- link:weechat_user.fr.html#command_weechat_eval[Guide utilisateur WeeChat / Commande /eval ^↗^,window=_blank]
+ link:weechat_user.fr.html#command_weechat_eval[Guide utilisateur WeeChat / Commande /eval ^↗^^]
* _pointers_ : table de hachage pour l'appel à la fonction
<<_string_eval_expression,string_eval_expression>>
* _extra_vars_ : table de hachage pour l'appel à la fonction
Voir `/help script` pour plus d'infos.
Une liste des scripts est disponible avec `/script` ou sur
-https://weechat.org/scripts/[cette page ^↗^,window=_blank].
+https://weechat.org/scripts/[cette page ^↗^^].
[[more_doc]]
== Plus de documentation
Vous pouvez maintenant utiliser WeeChat et lire la
-https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+https://weechat.org/doc/[FAQ/documentation ^↗^^]
pour toute autre question.
Bon WeeChat !
le client sont compressés pour économiser de la bande passante ;
les valeurs autorisées sont :
*** _off_ : pas de compression (par défaut si l'option n'est pas donnée)
-*** _zlib_ : compresser avec https://zlib.net/[zlib ^↗^,window=_blank] _(WeeChat ≥ 0.3.7)_
-*** _zstd_ : compresser avec https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] :
+*** _zlib_ : compresser avec https://zlib.net/[zlib ^↗^^] _(WeeChat ≥ 0.3.7)_
+*** _zstd_ : compresser avec https://facebook.github.io/zstd/[Zstandard ^↗^^] :
meilleure compression et bien plus rapide que _zlib_ pour la compression et
la décompression _(WeeChat ≥ 3.5)_
hachage du mot de passe)
* _compression_ : type de compression :
** _off_ : les messages ne sont pas compressés
-** _zlib_ : les messages sont compressés avec https://zlib.net/[zlib ^↗^,window=_blank]
-** _zstd_ : les messages sont compressés avec https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]
+** _zlib_ : les messages sont compressés avec https://zlib.net/[zlib ^↗^^]
+** _zstd_ : les messages sont compressés avec https://facebook.github.io/zstd/[Zstandard ^↗^^]
[TIP]
Avec WeeChat ≤ 2.8, la commande _handshake_ n'est pas implémentée, WeeChat ignore
(en incluant ce champ)
* _compression_ (octet) : drapeau :
** _0x00_ : les données qui suivent ne sont pas compressées
-** _0x01_ : les données qui suivent sont compressées avec https://zlib.net/[zlib ^↗^,window=_blank]
-** _0x02_ : les données qui suivent sont compressées avec https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]
+** _0x01_ : les données qui suivent sont compressées avec https://zlib.net/[zlib ^↗^^]
+** _0x02_ : les données qui suivent sont compressées avec https://facebook.github.io/zstd/[Zstandard ^↗^^]
* _id_ (chaîne, 4 octets + contenu) : l'identifiant envoyé par le client
(avant le nom de la commande) ; il peut être vide (chaîne avec une longueur
de zéro sans contenu) si l'identifiant n'était pas donné dans la commande
=== Compression
Si le drapeau de _compression_ est égal à 0x01 ou 0x02, alors *toutes* les données
-après sont compressées avec https://zlib.net/[zlib ^↗^,window=_blank] ou
-https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank],
+après sont compressées avec https://zlib.net/[zlib ^↗^^] ou
+https://facebook.github.io/zstd/[Zstandard ^↗^^],
et par conséquent doivent être décompressées avant d'être utilisées.
[[message_identifier]]
partie de WeeChat.
La dernière version de ce document peut être téléchargée sur
-https://weechat.org/doc/[cette page ^↗^,window=_blank].
+https://weechat.org/doc/[cette page ^↗^^].
[[introduction]]
== Introduction
peut être utilisée. Voir l'exemple dans le chapitre
<<hook_process,Lancer un processus en tâche de fond>> et la documentation sur
la fonction `+hook_process+` dans la
-link:weechat_plugin_api.fr.html#_hook_process[Référence API extension WeeChat ^↗^,window=_blank].
+link:weechat_plugin_api.fr.html#_hook_process[Référence API extension WeeChat ^↗^^].
[[languages_specificities]]
=== Spécificités des langages
WeeChat définit un module `weechat` qui doit être importé avec `import weechat`. +
Un "stub" Python pour l'API WeeChat est disponible dans le dépôt :
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^,window=_blank].
+https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]]
===== Fonctions
Il est recommandé d'utiliser plutôt le modificateur `+irc_in2_yyy+`, la chaîne
reçue sera toujours valide UTF-8. +
Voir la fonction `+hook_modifier+` dans la
- link:weechat_plugin_api.fr.html#_hook_modifier[Référence API extension WeeChat ^↗^,window=_blank].
+ link:weechat_plugin_api.fr.html#_hook_modifier[Référence API extension WeeChat ^↗^^].
| hook_signal
| xxx,irc_out_yyy +
Il est recommandé d'utiliser plutôt le signal `+xxx,irc_out1_yyy+`, la chaîne
reçue sera toujours valide UTF-8. +
Voir la fonction `+hook_signal+` dans la
- link:weechat_plugin_api.fr.html#_hook_signal[Référence API extension WeeChat ^↗^,window=_blank].
+ link:weechat_plugin_api.fr.html#_hook_signal[Référence API extension WeeChat ^↗^^].
| hook_process +
hook_process_hashtable
si la valeur du paramètre est "null". Pour voir quelles fonctions acceptent des
valeurs "null" et passent des valeurs "null" aux fonctions de rappel, regardez
les prototypes Python dans la
-link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^,window=_blank].
+link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^^].
[[language_guile]]
==== Guile (Scheme)
== Différences avec l'API C
L'API script est quasiment identique à l'API C.
-Vous pouvez consulter la link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^,window=_blank]
+Vous pouvez consulter la link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^^]
pour le détail de chaque fonction de l'API : prototype, paramètres, valeurs
de retour, exemples.
== API script
Pour plus d'informations sur les fonctions de l'API, merci de consulter la
-link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^,window=_blank].
+link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^^].
[[script_api_functions]]
=== Fonctions
Ce chapitre montre quelques tâches courantes, avec des exemples.
Seule une partie de l'API est utilisée ici, pour une référence complète, voir la
-link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^,window=_blank].
+link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^^].
[[buffers]]
=== Tampons
[TIP]
Toutes les infos disponibles à propos de WeeChat sont sur
-https://weechat.org/dev/info/[cette page ^↗^,window=_blank].
+https://weechat.org/dev/info/[cette page ^↗^^].
Exemple de transfert d'URL avec une option : télécharger le dernier paquet de
développement WeeChat dans le fichier _/tmp/weechat-devel.tar.gz_ :
Pour plus d'information sur le transfert d'URL et les options disponibles, voir
les fonctions `+hook_process+` et `+hook_process_hashtable+` dans la
-link:weechat_plugin_api.fr.html#_hook_process[Référence API extension WeeChat ^↗^,window=_blank].
+link:weechat_plugin_api.fr.html#_hook_process[Référence API extension WeeChat ^↗^^].
[[config_options]]
=== Config / options
partie de WeeChat.
La dernière version de ce document peut être téléchargée sur
-https://weechat.org/doc/[cette page ^↗^,window=_blank].
+https://weechat.org/doc/[cette page ^↗^^].
[[introduction]]
== Introduction
* petit, rapide et léger
* paramétrable et extensible avec des extensions et des scripts
* conforme aux RFCs IRC
- https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^,window=_blank] et
- https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^,window=_blank]
+ https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] et
+ https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
* proxy IRC et relai pour interfaces distantes
* multi plates-formes (GNU/Linux, *BSD, macOS, Windows et d'autres systèmes)
* 100% GPL, logiciel libre
La liste complète des fonctionnalités peut être trouvée sur
-https://weechat.org/[cette page ^↗^,window=_blank].
+https://weechat.org/[cette page ^↗^^].
[[prerequisites]]
=== Prérequis
* Debian/Ubuntu (ou toute distribution compatible Debian) :
`apt-get install weechat-curses weechat-plugins` +
Pour les dernières versions et les constructions nocturnes :
- https://weechat.org/download/debian/[dépôts Debian ^↗^,window=_blank]
+ https://weechat.org/download/debian/[dépôts Debian ^↗^^]
* Fedora Core : `dnf install weechat`
* FreeBSD : `pkg install weechat`
* Gentoo : `emerge weechat`
`rpm -i /path/to/weechat-x.y.z-1.i386.rpm`
* openSUSE : `zypper in weechat`
* Sourcemage : `cast weechat`
-* macOS (avec https://brew.sh/[Homebrew ^↗^,window=_blank]) : `brew install weechat`
+* macOS (avec https://brew.sh/[Homebrew ^↗^^]) : `brew install weechat`
(pour l'aide : `brew info weechat`)
Des paquets additionnels peuvent être utiles également, comme weechat-plugins.
=== Conteneurs
Des conteneurs avec WeeChat peuvent être construits ou installés directement
-depuis le https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^,window=_blank]. +
+depuis le https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^^]. +
Pour plus d'informations, voire le README dans le dépôt
-https://github.com/weechat/weechat-container[weechat-container ^↗^,window=_blank].
+https://github.com/weechat/weechat-container[weechat-container ^↗^^].
[[source_package]]
=== Paquet source
WeeChat doit être construit avec CMake.
[NOTE]
-Sous macOS, vous pouvez utiliser https://brew.sh/[Homebrew ^↗^,window=_blank] :
+Sous macOS, vous pouvez utiliser https://brew.sh/[Homebrew ^↗^^] :
`brew install --build-from-source weechat`.
[[dependencies]]
| zlib1g-dev |
| Extension Logger : compression des fichiers de log qui tournent (gzip). +
- Extention Relay : compression des messages (WeeChat -> client) avec https://zlib.net/[zlib ^↗^,window=_blank] (protocole weechat). +
+ Extention Relay : compression des messages (WeeChat -> client) avec https://zlib.net/[zlib ^↗^^] (protocole weechat). +
Extension Script : lecture du fichier d'index du dépôt (gzip).
| libzstd-dev | ≥ 0.8.1
| Extension Logger : compression des fichiers de log qui tournent. +
- Extension Relay : compression des messages (WeeChat -> client) avec https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] (protocole weechat).
+ Extension Relay : compression des messages (WeeChat -> client) avec https://facebook.github.io/zstd/[Zstandard ^↗^^] (protocole weechat).
|===
[NOTE]
autre répertoire tel que _/var/lib/systemd/coredump_ et vous devez utiliser la
commande `coredumpctl` pour le lire. +
Pour plus d'informations, voir cette
-https://wiki.archlinux.org/title/Core_dump[page wiki ^↗^,window=_blank].
+https://wiki.archlinux.org/title/Core_dump[page wiki ^↗^^].
Par exemple si _weechat_ est installé dans _/usr/bin/_ et que le fichier
_core_ se trouve dans _/home/user/_, alors il faut lancer gdb avec cette commande :
==== XDG directories
WeeChat utilise les répertoires XDG par défaut (selon la
-https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[spécification "XDG Base Directory" ^↗^,window=_blank]). +
+https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[spécification "XDG Base Directory" ^↗^^]). +
Un répertoire de base unique pour tous les fichiers peut être forcé par
l'option CMake `WEECHAT_HOME`, la variable d'environnement `WEECHAT_HOME` ou
l'option de ligne de commande `-d` / `--dir`.
==== Notes de version
Après une mise à jour, il est *fortement recommandé* de lire les
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[notes de version ^↗^,window=_blank]
+https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[notes de version ^↗^^]
qui contiennent des informations importantes sur les changements majeurs et
quelques actions manuelles qui pourraient être nécessaires.
==== En cas de problème
Pour tout problème avec les jeux de caractères, merci de consulter la
-link:weechat_faq.fr.html#charset[FAQ WeeChat / Accents ^↗^,window=_blank].
+link:weechat_faq.fr.html#charset[FAQ WeeChat / Accents ^↗^^].
[[charset_commands]]
==== Commandes
lorsqu'elle est atteinte, il y a une rotation automatique du fichier de log.
Les fichiers de logs qui ont tourné peuvent être compressés avec gzip ou
-https://facebook.github.io/zstd/[zstd ^↗^,window=_blank].
+https://facebook.github.io/zstd/[zstd ^↗^^].
[NOTE]
La compression du fichier pouvant prendre du temps, elle est exécutée en tâche
[NOTE]
Pour tout problème avec la souris, merci de consulter la
-link:weechat_faq.fr.html#mouse[FAQ WeeChat / Souris ^↗^,window=_blank].
+link:weechat_faq.fr.html#mouse[FAQ WeeChat / Souris ^↗^^].
[[mouse_bind_events]]
==== Associer des évènements souris à des commandes
Par défaut aucun serveur n'est défini. Vous pouvez ajouter autant de serveurs
que vous le souhaitez avec la commande <<command_irc_server,/server>>.
-Par exemple pour vous connecter à https://libera.chat/[libera.chat ^↗^,window=_blank] avec TLS
+Par exemple pour vous connecter à https://libera.chat/[libera.chat ^↗^^] avec TLS
(communications chiffrées) :
----
----
Pour plus d'informations, merci de consulter
-https://www.oftc.net/NickServ/CertFP/[cette page ^↗^,window=_blank].
+https://www.oftc.net/NickServ/CertFP/[cette page ^↗^^].
[[irc_sasl_authentication]]
==== Authentification avec SASL
==== Connexion avec Tor et SASL
Quelques serveurs acceptent les connexions avec
-https://www.torproject.org/[Tor ^↗^,window=_blank], un réseau de tunnels virtuels
+https://www.torproject.org/[Tor ^↗^^], un réseau de tunnels virtuels
qui permet aux personnes et groupes d'améliorer leur vie privée et sécurité
sur Internet.
[[irc_ircv3_support]]
=== Support IRCv3
-WeeChat supporte les https://ircv3.net/irc/[extensions IRCv3 ^↗^,window=_blank] suivantes :
+WeeChat supporte les https://ircv3.net/irc/[extensions IRCv3 ^↗^^] suivantes :
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
<<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Des tableaux avec une comparaison des différents clients IRC, incluant WeeChat,
-sont disponibles sur https://ircv3.net/software/clients[cette page ^↗^,window=_blank].
+sont disponibles sur https://ircv3.net/software/clients[cette page ^↗^^].
[[irc_ircv3_account_notify]]
==== account-notify
-Spécification : https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^^]
Cette capacité autorise le serveur à envoyer des messages lorsque les utilisateurs
s'identifient ou perdent l'identification sur le serveur. +
[[irc_ircv3_account_tag]]
==== account-tag
-Spécification : https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^^]
Cette capacité autorise le serveur à envoyer le compte comme étiquette de message
dans les commandes envoyées au client. +
[[irc_ircv3_away_notify]]
==== away-notify
-Spécification : https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^^]
Cette capacité autorise le serveur à envoyer des notifications d'absence pour
les utilisateurs qui sont sur les mêmes canaux que vous.
[[irc_ircv3_batch]]
==== batch
-Spécification : https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/batch[batch ^↗^^]
Cette capacité autorise le serveur à envoyer des évènements "batch" (regroupement
de plusieurs messages qui sont liés).
[[irc_ircv3_cap_notify]]
==== cap-notify
-Spécification : https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^^]
Cette capacité autorise le serveur à avertir des nouvelles capacités ou celles
supprimées sur le serveur (via les commandes `CAP NEW` et `CAP DEL`).
[[irc_ircv3_chghost]]
==== chghost
-Spécification : https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/chghost[chghost ^↗^^]
Cette capacité autorise le serveur à envoyer des messages lorsque les utilisateurs
changent de nom ou d'hôte. +
[[irc_ircv3_draft_multiline]]
==== draft/multiline
-Spécification : https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/multiline[multiline ^↗^^]
Cette capacité autorise le client et le serveur à envoyer des messages avec
plusieurs lignes, en utilisant la capacité <<irc_ircv3_batch,batch>>, qui doit
[[irc_ircv3_echo_message]]
==== echo-message
-Spécification : https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^^]
Cette capacité oblige le serveur à renvoyer les messages PRIVMSG, NOTICE et TAGMSG
à WeeChat.
[[irc_ircv3_extended_join]]
==== extended-join
-Spécification : https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^^]
Cette capacité autorise le serveur à envoyer le compte et nom réel lorsque les
utilisateurs rejoignent les canaux. +
[[irc_ircv3_invite_notify]]
==== invite-notify
-Spécification : https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^^]
Cette capacité autorise le serveur à envoyer des messages d'invitation lorsque
les utilisateurs sont invités sur des canaux.
[[irc_ircv3_message_tags]]
==== message-tags
-Spécification : https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^^]
Cette capacité autorise l'envoi de méta-données dans les messages. +
Ces étiquettes peuvent être affichées avec la commande `/debug tags`.
[[irc_ircv3_monitor]]
==== monitor
-Spécification : https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/monitor[monitor ^↗^^]
Cette capacité autorise le serveur à envoyer des notifications lorsque les clients
se connectent ou se déconnectent. +
[[irc_ircv3_multi_prefix]]
==== multi-prefix
-Spécification : https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^^]
Cette capacité autorise le serveur à envoyer tous les modes utilisateur d'un coup
dans les réponses à <<command_irc_names,/names>> et <<command_irc_whois,/whois>>. +
[[irc_ircv3_sasl]]
==== SASL
-Spécification : https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^^]
Voir le chapitre dédié <<irc_sasl_authentication,Authentification avec SASL>>.
[[irc_ircv3_server_time]]
==== server-time
-Spécification : https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/server-time[server-time ^↗^^]
Cette capacité autorise le serveur à envoyer l'heure pour les messages sous forme
d'étiquette de message. +
[[irc_ircv3_setname]]
==== setname
-Spécification : https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/setname[setname ^↗^^]
Cette capacité vous permet de changer votre nom réel en utilisant la commande
<<command_irc_setname,/setname>>.
[[irc_ircv3_typing]]
==== typing
-Spécification : https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/client-tags/typing[typing ^↗^^]
Voir le chapitre dédié <<typing_notifications,Notifications de saisie>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
-Spécification : https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^^]
Cette capacité autorise le serveur à envoyer les noms d'hôtes dans les réponses à
<<command_irc_names,/names>>.
[[irc_ircv3_whox]]
==== WHOX
-Spécification : https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
+Spécification : https://ircv3.net/specs/extensions/whox[WHOX ^↗^^]
Cette capacité vous permet de demander des champs additionnels dans la réponse
WHO (via la commande <<command_irc_who,/who>>). +
lorsque la capacité "message-tags" est activée (vous pouvez vérifier avec la
commande <<command_irc_cap,/cap>>). +
Sous le capot, l'étiquette client typing est utilisée, en suivant
-https://ircv3.net/specs/client-tags/typing[cette spécification ^↗^,window=_blank].
+https://ircv3.net/specs/client-tags/typing[cette spécification ^↗^^].
[[typing_activation]]
=== Activation
* _irc_ : proxy IRC : utilisé pour partager la connexions aux serveurs IRC avec
un ou plusieurs autres clients IRC
* _weechat_ : protocole utilisé par les interfaces distantes pour afficher et
- interagir avec WeeChat, voir https://weechat.org/about/interfaces/[cette page ^↗^,window=_blank].
+ interagir avec WeeChat, voir https://weechat.org/about/interfaces/[cette page ^↗^^].
[[relay_password]]
=== Mot de passe
par exemple :
* FreeOTP :
- https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^,window=_blank]
- (https://freeotp.github.io/[site web ^↗^,window=_blank])
+ https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^^],
+ https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^^]
+ (https://freeotp.github.io/[site web ^↗^^])
* Google Authenticator :
- https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^,window=_blank]
+ https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^^],
+ https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^^]
Le « secret » TOTP doit être défini dans WeeChat et dans l'application utilisée
pour générer les mots de passe à usage unique.
utilisant le protocole WeeChat.
Vous pouvez vous connecter avec une interface distante, voir
-https://weechat.org/about/interfaces/[cette page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[cette page ^↗^^].
[IMPORTANT]
WeeChat lui-même ne peut PAS se connecter sur un autre WeeChat avec ce
=== WebSocket
Le protocole WebSocket
-(https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^,window=_blank])
+(https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^^])
est supporté dans l'extension Relay pour tous les protocoles.
La poignée de main ("handshake") WebSocket est automatiquement détectée et le
Utiliser les triggers nécessite de connaître le fonctionnement des signaux,
modificateurs, etc. Il peut être utile de lire la
-link:weechat_plugin_api.fr.html#hooks[Référence API extension WeeChat / Hooks ^↗^,window=_blank].
+link:weechat_plugin_api.fr.html#hooks[Référence API extension WeeChat / Hooks ^↗^^].
[[trigger_default]]
=== Triggers par défaut
| hook | `+signal+`, `+hsignal+`, `+modifier+`, `+line+`, `+print+`, `+command+`,
`+command_run+`, `+timer+`, `+config+`, `+focus+`, `+info+`, `+info_hashtable+`
| Le "hook" utilisé dans le trigger. Pour plus d'information, voir la
- link:weechat_plugin_api.fr.html#hooks[Référence API extension WeeChat / Hooks ^↗^,window=_blank].
+ link:weechat_plugin_api.fr.html#hooks[Référence API extension WeeChat / Hooks ^↗^^].
| arguments | chaîne
| Les paramètres pour le "hook", ils dépendent du type de hook utilisé.
| `+*,irc_in_privmsg+` +
`+*,irc_in_privmsg;*,irc_in_notice+` +
`+signal_sigwinch+`
-| link:weechat_plugin_api.fr.html#_hook_signal[hook_signal ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_signal[hook_signal ^↗^^]
| hsignal
| 1. nom de signal (priorité autorisée) (obligatoire) +
2. nom de signal (priorité autorisée) +
3. ...
| `+nicklist_nick_added+`
-| link:weechat_plugin_api.fr.html#_hook_hsignal[hook_hsignal ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_hsignal[hook_hsignal ^↗^^]
| modifier
| 1. nom de modificateur (priorité autorisée) (obligatoire) +
3. ...
| `+weechat_print+` +
`+5000\|input_text_display;5000\|history_add+`
-| link:weechat_plugin_api.fr.html#_hook_modifier[hook_modifier ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_modifier[hook_modifier ^↗^^]
| line
| 1. type de tampon +
`+*;irc.libera.*+` +
`+*;irc.libera.#weechat+` +
`+formatted;irc.libera.#weechat;irc_notice+`
-| link:weechat_plugin_api.fr.html#_hook_line[hook_line ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_line[hook_line ^↗^^]
| print
| 1. nom de tampon +
`+irc.libera.#weechat+` +
`+irc.libera.#weechat;irc_notice+` +
`+*;;;1+`
-| link:weechat_plugin_api.fr.html#_hook_print[hook_print ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_print[hook_print ^↗^^]
| command
| 1. nom de commande (priorité autorisée) (obligatoire) +
| `+test+` +
`+5000\|test+` +
`+test;commande de test;arg1 arg2;arg1: description 1${\n}arg2: description 2+`
-| link:weechat_plugin_api.fr.html#_hook_command[hook_command ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_command[hook_command ^↗^^]
| command_run
| 1. commande (priorité autorisée) (obligatoire) +
2. commande (priorité autorisée) +
3. ...
| `+/cmd paramètres+`
-| link:weechat_plugin_api.fr.html#_hook_command_run[hook_command_run ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_command_run[hook_command_run ^↗^^]
| timer
| 1. intervalle, en millisecondes (obligatoire) +
3. nombre maximum d'appels (par défaut : 0, qui signifie "sans fin")
| `+3600000+` +
`+60000;0;5+`
-| link:weechat_plugin_api.fr.html#_hook_timer[hook_timer ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_timer[hook_timer ^↗^^]
| config
| 1. nom d'option (priorité autorisée) (obligatoire) +
2. nom d'option (priorité autorisée) +
3. ...
| `+weechat.look.*+`
-| link:weechat_plugin_api.fr.html#_hook_config[hook_config ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_config[hook_config ^↗^^]
| focus
| 1. nom d'aire (priorité autorisée) (obligatoire) +
2. nom d'aire (priorité autorisée) +
3. ...
| `+buffer_nicklist+`
-| link:weechat_plugin_api.fr.html#_hook_focus[hook_focus ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_focus[hook_focus ^↗^^]
| info
| 1. nom de l'info (priorité autorisée) (obligatoire) +
2. nom de l'info (priorité autorisée) +
3. ...
| `+mon_info+`
-| link:weechat_plugin_api.fr.html#_hook_info[hook_info ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_info[hook_info ^↗^^]
| info_hashtable
| 1. nom de l'info (priorité autorisée) (obligatoire) +
2. nom de l'info (priorité autorisée) +
3. ...
| `+mon_info+`
-| link:weechat_plugin_api.fr.html#_hook_info_hashtable[hook_info_hashtable ^↗^,window=_blank]
+| link:weechat_plugin_api.fr.html#_hook_info_hashtable[hook_info_hashtable ^↗^^]
|===
[[trigger_conditions]]
Pour en apprendre plus sur le développement d'extension ou de script (via
l'API), merci de consulter la
-link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^,window=_blank] ou le
-link:weechat_scripting.fr.html[Guide pour scripts WeeChat ^↗^,window=_blank].
+link:weechat_plugin_api.fr.html[Référence API extension WeeChat ^↗^^] ou le
+link:weechat_scripting.fr.html[Guide pour scripts WeeChat ^↗^^].
[[scripts]]
=== Scripts
Pour plus d'informations sur comment écrire des scripts, ou sur l'API
WeeChat pour les scripts, merci de lire le
-link:weechat_scripting.fr.html[Guide pour scripts WeeChat ^↗^,window=_blank].
+link:weechat_scripting.fr.html[Guide pour scripts WeeChat ^↗^^].
[[script_manager]]
==== Gestionnaire de scripts
Le gestionnaire de scripts (commands <<command_script_script,/script>>) est
utilisé pour charger/décharger des scripts pour n'importe quel langage, et
installer/supprimer des scripts du dépôt WeeChat, qui sont visibles sur
-https://weechat.org/scripts/[cette page ^↗^,window=_blank].
+https://weechat.org/scripts/[cette page ^↗^^].
Pour des considérations de confidentialité, le téléchargement des scripts est
désactivé par défaut. +
** _#weechat-fi_ (Finnois)
Pour les autres formes de support, voir
-https://weechat.org/about/support/[cette page ^↗^,window=_blank].
+https://weechat.org/about/support/[cette page ^↗^^].
// TRANSLATION MISSING
More info on the WeeChat
-https://weechat.org/about/features/[features page ^↗^,window=_blank].
+https://weechat.org/about/features/[features page ^↗^^].
[[compilation_install]]
== Compilazione / installazione
// TRANSLATION MISSING
Some remote GUIs are available, see the
-https://weechat.org/about/interfaces/[remote interfaces page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[remote interfaces page ^↗^^].
[[compile_git]]
=== Non è possibile compilare WeeChat dopo aver clonato il repository git, perché?
WeeChat must be compiled with CMake.
// TRANSLATION MISSING
-Please follow link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank]
+Please follow link:weechat_user.en.html#source_package[build instructions ^↗^^]
and ensure all required dependencies are installed.
// TRANSLATION MISSING
=== How can I install WeeChat on macOS?
// TRANSLATION MISSING
-It is recommended to use https://brew.sh/[Homebrew ^↗^,window=_blank],
+It is recommended to use https://brew.sh/[Homebrew ^↗^^],
you can get help with:
----
// TRANSLATION MISSING
Per l'aiuto digitare `/help`. Per l'aiuto su un comando, digitare `/help comando`.
-link:weechat_user.it.html#key_bindings[Keys ^↗^,window=_blank] and
-link:weechat_user.it.html#commands_and_options[commands ^↗^,window=_blank] are listed
+link:weechat_user.it.html#key_bindings[Keys ^↗^^] and
+link:weechat_user.it.html#commands_and_options[commands ^↗^^] are listed
in documentation.
// TRANSLATION MISSING
It's recommended for new users to read the
-link:weechat_quickstart.it.html[Quickstart guide ^↗^,window=_blank].
+link:weechat_quickstart.it.html[Quickstart guide ^↗^^].
[[display]]
== Visualizzare
screen)
// TRANSLATION MISSING
* check that option
- link:weechat_user.it.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
+ link:weechat_user.it.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^^]
is off (this option may cause display bugs)
[NOTE]
in glibc 2.22 (maybe not yet available in your distribution).
There is a workaround to use the fixed _wcwidth_ function:
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank].
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^^].
-See this https://github.com/weechat/weechat/issues/79[bug report ^↗^,window=_blank]
+See this https://github.com/weechat/weechat/issues/79[bug report ^↗^^]
for more information.
[[bars_background]]
[[buffers_list]]
=== Come si può visualizzare la lista dei buffer sulla sinistra?
-The plugin link:weechat_user.it.html#buflist[buflist ^↗^,window=_blank]
+The plugin link:weechat_user.it.html#buflist[buflist ^↗^^]
is loaded and enabled by default.
To limit size of bar:
The buflist plugin provides lot of options that you can customize, please read
the help on each option.
-There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^,window=_blank]
+There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^^]
with examples of advanced buflist configuration.
[[customize_prefix]]
(buffers) and __weechat.color.status_count_*__ (counters). +
Other hotlist options can be changed with the options __weechat.look.hotlist_*__.
-See link:weechat_user.it.html#screen_layout[User's guide / Screen layout ^↗^,window=_blank]
+See link:weechat_user.it.html#screen_layout[User's guide / Screen layout ^↗^^]
for more info about the hotlist.
[[input_bar_size]]
with command `/color`).
// TRANSLATION MISSING
-Please read the link:weechat_user.it.html#colors[User's guide / Colors ^↗^,window=_blank]
+Please read the link:weechat_user.it.html#colors[User's guide / Colors ^↗^^]
for more information about colors management.
[[search_text]]
E per passare alle notifiche: kbd:[Alt+p] / kbd:[Alt+n].
// TRANSLATION MISSING
-See link:weechat_user.it.html#key_bindings[User's guide / Key bindings ^↗^,window=_blank]
+See link:weechat_user.it.html#key_bindings[User's guide / Key bindings ^↗^^]
for more info about this feature.
// TRANSLATION MISSING
// TRANSLATION MISSING
List of default keys is in
-link:weechat_user.it.html#key_bindings[User's guide / Key bindings ^↗^,window=_blank].
+link:weechat_user.it.html#key_bindings[User's guide / Key bindings ^↗^^].
// TRANSLATION MISSING
To jump to buffers with number ≥ 100, you could define a trigger and then use
[[filter_irc_join_part_quit]]
=== How can I filter join/part/quit and other annoying messages on IRC channels?
-See link:weechat_user.it.html#irc_smart_filter[User's guide / IRC smart filter ^↗^,window=_blank].
+See link:weechat_user.it.html#irc_smart_filter[User's guide / IRC smart filter ^↗^^].
[[filter_irc_join_channel_messages]]
=== Come posso filtrare i messaggi visualizzati all'ingresso su un canale IRC?
// TRANSLATION MISSING
You can use the
-link:weechat_user.it.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
+link:weechat_user.it.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^^]
buffer property to set the max hotlist level for some nicks, per buffer,
or per group of buffers (like IRC servers).
Define a passphrase and use secured data wherever you can for sensitive data
like passwords: see `/help secure` and `/help` on options
(if you can use secured data, it is written in the help).
-See also link:weechat_user.it.html#secured_data[Guida per l’Utente / Secured data ^↗^,window=_blank].
+See also link:weechat_user.it.html#secured_data[Guida per l’Utente / Secured data ^↗^^].
For example:
Some other files may contain sensitive info like passwords (if they are not
stored in _sec.conf_ with the `/secure` command).
-See the link:weechat_user.it.html#files_and_directories[User's guide / Files and directories ^↗^,window=_blank]
+See the link:weechat_user.it.html#files_and_directories[User's guide / Files and directories ^↗^^]
for more information about configuration files.
[[development]]
=== Come posso segnalare bug, richiedere nuove funzionalità o inviare patch?
// TRANSLATION MISSING
-See https://weechat.org/about/support/[this page ^↗^,window=_blank].
+See https://weechat.org/about/support/[this page ^↗^^].
[[gdb_error_threads]]
=== Quando eseguo WeeChat in gdb, c'è un errore riguardo ai thread, cosa posso fare?
// TRANSLATION MISSING
Please contact us via IRC or mail, look at
-https://weechat.org/about/support/[support page ^↗^,window=_blank].
+https://weechat.org/about/support/[support page ^↗^^].
[[donate]]
=== Posso donare denaro o altre cose agli sviluppatori di WeeChat?
// TRANSLATION MISSING
You can give us money to help development.
-Details on https://weechat.org/donate/[donation page ^↗^,window=_blank].
+Details on https://weechat.org/donate/[donation page ^↗^^].
// TRANSLATION MISSING
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== Introduzione
Register the script.
For more information, see the
-link:weechat_scripting.it.html#register_function[WeeChat scripting guide ^↗^,window=_blank].
+link:weechat_scripting.it.html#register_function[WeeChat scripting guide ^↗^^].
Script (Python):
// TRANSLATION MISSING
This function is a C conversion of Python class "shlex" (file: Lib/shlex.py in
Python repository), see
-https://docs.python.org/3/library/shlex.html[this page ^↗^,window=_blank].
+https://docs.python.org/3/library/shlex.html[this page ^↗^^].
Prototipo:
// TRANSLATION MISSING
* U+0009 (Tabulation): value of option
- link:weechat_user.it.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^,window=_blank]
+ link:weechat_user.it.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^^]
* U+0001 (1) to U+001F (31), except U+0009 (Tabulation): 1
* U+00AD (173, soft hyphen): -1
* U+200B (8203, zero width space): -1
[NOTE]
In Ruby, the 3 callbacks + data (6 strings) must be given in an array of 6
strings (due to a Ruby limitation of 15 arguments by function), see the
-link:++weechat_scripting.it.html#_ruby++[WeeChat Scripting Guide ^↗^,window=_blank]
+link:++weechat_scripting.it.html#_ruby++[WeeChat Scripting Guide ^↗^^]
for more info _(fixed in version 0.4.1)_.
==== config_search_option
* _message_: messaggio da visualizzare
// TRANSLATION MISSING
-See the link:weechat_user.it.html#lines_tags[WeeChat user's guide / Lines tags ^↗^,window=_blank]
+See the link:weechat_user.it.html#lines_tags[WeeChat user's guide / Lines tags ^↗^^]
for a list of commonly used tags in WeeChat.
Esempio in C:
// TRANSLATION MISSING
If you want to retrieve infos about WeeChat (like current stable version,
latest git commit, etc.), you can use URLs on
-https://weechat.org/dev/info/[this page ^↗^,window=_blank].
+https://weechat.org/dev/info/[this page ^↗^^].
[NOTE]
La dimensione del buffer per l'invio dei dati alla callback è di 64KB (ci sono
| -
| Any string.
| String with IRC tag value escaped,
- see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^,window=_blank].
+ see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^^].
// TRANSLATION MISSING
| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value | 3.3
| -
| Any string.
| String with IRC tag value unescaped,
- see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^,window=_blank].
+ see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^^].
// TRANSLATION MISSING
| [[hook_modifier_color_decode_ansi]] color_decode_ansi | 1.0
** _nicklist_: la barra viene visualizzata nelle finestre con liste nick
// TRANSLATION MISSING
** evaluated expression: see the
- link:weechat_user.it.html#bar_conditions[WeeChat user's guide / Bar conditions ^↗^,window=_blank]
+ link:weechat_user.it.html#bar_conditions[WeeChat user's guide / Bar conditions ^↗^^]
* _position_: _top_, _bottom_, _left_ o _right_
* _filling_top_bottom_:
** _horizontal_: gli elementi sono posizionati in orizzontale
With WeeChat ≥ 2.9, in Ruby, the 4 colors (color_fg, color_delim, color_bg,
color_bg_inactive) must be given in an array of 4 strings (due to a Ruby
limitation of 15 arguments by function), see the
-link:++weechat_scripting.it.html#_ruby++[WeeChat scripting guide ^↗^,window=_blank]
+link:++weechat_scripting.it.html#_ruby++[WeeChat scripting guide ^↗^^]
for more info.
==== bar_set
// TRANSLATION MISSING
[NOTE]
-See the link:weechat_scripting.it.html#irc_message_parse[Guida allo Scripting di WeeChat / Verifica messaggio ^↗^,window=_blank]
+See the link:weechat_scripting.it.html#irc_message_parse[Guida allo Scripting di WeeChat / Verifica messaggio ^↗^^]
for more info about "irc_message_parse" output.
Script (Python):
* _search_: expression to evaluate, default pointer in expression is the name of
hdata (and this pointer changes for each element in list); for help on
expression, see the
- link:weechat_user.it.html#command_weechat_eval[WeeChat user's guide / Command /eval ^↗^,window=_blank]
+ link:weechat_user.it.html#command_weechat_eval[WeeChat user's guide / Command /eval ^↗^^]
// TRANSLATION MISSING
* _pointers_: hashtable for call to function
<<_string_eval_expression,string_eval_expression>>
Vedi `/help script` per più informazioni.
Una lista degli script è disponibile su WeeChat tramite `/script` o su
-https://weechat.org/scripts/[questa pagina ^↗^,window=_blank].
+https://weechat.org/scripts/[questa pagina ^↗^^].
[[more_doc]]
== Ulteriore documentazione
Ora sei in grado di usare WeeChat e leggere
-https://weechat.org/doc/[FAQ/documentazione ^↗^,window=_blank]
+https://weechat.org/doc/[FAQ/documentazione ^↗^^]
per qualsiasi altra domanda.
Buon WeeChat!
// TRANSLATION MISSING
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== Introduzione
If something must be run in background, the function `+hook_process+` can be used.
See example in the chapter <<hook_process,Eseguire un processo in background>>
and the documentation on the function `+hook_process+` in the
-link:weechat_plugin_api.it.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.it.html#_hook_process[WeeChat plugin API reference ^↗^^].
[[languages_specificities]]
=== Specifiche per i linguaggi
WeeChat defines a `weechat` module which must be imported with `import weechat`. +
A Python stub for WeeChat API is available in the repository:
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^,window=_blank].
+https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
// TRANSLATION MISSING
[[python_functions]]
It is recommended to use modifier `+irc_in2_yyy+` instead, the string received
is always UTF-8 valid. +
See function `+hook_modifier+` in the
- link:weechat_plugin_api.it.html#_hook_modifier[WeeChat plugin API reference ^↗^,window=_blank].
+ link:weechat_plugin_api.it.html#_hook_modifier[WeeChat plugin API reference ^↗^^].
| hook_signal
| xxx,irc_out_yyy +
It is recommended to use signal `+xxx,irc_out1_yyy+` instead, the string received
is always UTF-8 valid. +
See function `+hook_signal+` in the
- link:weechat_plugin_api.it.html#_hook_signal[WeeChat plugin API reference ^↗^,window=_blank].
+ link:weechat_plugin_api.it.html#_hook_signal[WeeChat plugin API reference ^↗^^].
| hook_process +
hook_process_hashtable
will get it as the value of an argument in a callback function if the argument
value is null. To see which functions accept null values and passes null values
to callbacks, look at the Python prototypes in the
-link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^].
[[language_guile]]
==== Guile (Scheme)
// TRANSLATION MISSING
Script API is almost the same as C plugin API.
-You can look at link:weechat_plugin_api.it.html[WeeChat plugin API reference ^↗^,window=_blank]
+You can look at link:weechat_plugin_api.it.html[WeeChat plugin API reference ^↗^^]
for detail about each function in API: prototype, arguments, return values, examples.
È importante fare la differenza tra un _plugin_ ed uno _script_:
// TRANSLATION MISSING
For more information about functions in API, please read the
-link:weechat_plugin_api.it.html[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.it.html[WeeChat plugin API reference ^↗^^].
[[script_api_functions]]
=== Funzioni
// TRANSLATION MISSING
This chapter shows some common tasks, with examples.
Only partial things in API are used here, for full reference, see the
-link:weechat_plugin_api.it.html[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.it.html[WeeChat plugin API reference ^↗^^].
[[buffers]]
=== Buffer
[TIP]
// TRANSLATION MISSING
All infos available about WeeChat are on
-https://weechat.org/dev/info/[this page ^↗^,window=_blank].
+https://weechat.org/dev/info/[this page ^↗^^].
Esempio di trasferimento di un URL con un'opzione: scaricare l'ultimo pacchetto
di sviluppo di WeeChat nel file _/tmp/weechat-devel.tar.gz_:
// TRANSLATION MISSING
For more information about URL transfer and available options, see functions
`+hook_process+` and `+hook_process_hashtable+` in
-link:weechat_plugin_api.it.html#_hook_process[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.it.html#_hook_process[WeeChat plugin API reference ^↗^^].
[[config_options]]
=== Configurazione / opzioni
// TRANSLATION MISSING
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== Introduzione
* piccolo, veloce e leggero
* personalizzabile ed estensibile con plugin e script
* conforme alle RFC di IRC
- https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^,window=_blank] e
- https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^,window=_blank]
+ https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] e
+ https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
// TRANSLATION MISSING
* IRC proxy and relay for remote interfaces
* multi-piattaforma (GNU/Linux, *BSD, macOS, Windows ed altre)
// TRANSLATION MISSING
The list of all features can be found on
-https://weechat.org/about/features/[this page ^↗^,window=_blank].
+https://weechat.org/about/features/[this page ^↗^^].
[[prerequisites]]
=== Requisiti
* Debian/Ubuntu (o qualunque distribuzione compatibile):
`apt-get install weechat-curses weechat-plugins` +
For latest versions and nightly builds:
- https://weechat.org/download/debian/[Debian repositories ^↗^,window=_blank]
+ https://weechat.org/download/debian/[Debian repositories ^↗^^]
* Fedora Core: `dnf install weechat`
* FreeBSD: `pkg install weechat`
* Gentoo: `emerge weechat`
* openSUSE: `zypper in weechat`
* Sourcemage: `cast weechat`
// TRANSLATION MISSING
-* macOS (with https://brew.sh/[Homebrew ^↗^,window=_blank]): `brew install weechat`
+* macOS (with https://brew.sh/[Homebrew ^↗^^]): `brew install weechat`
(for help: `brew info weechat`)
Potrebbero risultare utili alcuni pacchetti addizionali, come
// TRANSLATION MISSING
Containers with WeeChat can be built or installed directly from the
-https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^,window=_blank]. +
+https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^^]. +
For more information, see the README in the
-https://github.com/weechat/weechat-container[weechat-container ^↗^,window=_blank]
+https://github.com/weechat/weechat-container[weechat-container ^↗^^]
repository.
[[source_package]]
// TRANSLATION MISSING
[NOTE]
-On macOS, you can use https://brew.sh/[Homebrew ^↗^,window=_blank]:
+On macOS, you can use https://brew.sh/[Homebrew ^↗^^]:
`brew install --build-from-source weechat`.
[[dependencies]]
// TRANSLATION MISSING
| zlib1g-dev |
| Logger plugin: compression of rotated log files (gzip). +
- Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^,window=_blank] (weechat protocol). +
+ Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). +
Script plugin: read of repository index file (gzip).
// TRANSLATION MISSING
| libzstd-dev | ≥ 0.8.1
| Logger plugin: compression of rotated log files. +
- Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] (weechat protocol).
+ Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol).
|===
[NOTE]
On some systems like Archlinux, core dumps could be in another directory like
_/var/lib/systemd/coredump_ and you must use the command `coredumpctl` to read it. +
For more information, see this
-https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^,window=_blank].
+https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
Ad esempio, se _weechat_ è installato in _/usr/bin/_ ed il file _core_
si trova in _/home/user/_, allora eseguire gdb con questo comando:
==== XDG directories
WeeChat uses XDG directories by default (according to the
-https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^,window=_blank]). +
+https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^^]). +
A single home directory for all files can be forced by CMake option `WEECHAT_HOME`,
the environment variable `WEECHAT_HOME` or the command-line option `-d` / `--dir`.
==== Release notes
After an upgrade, it is *strongly recommended* to read the
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^,window=_blank]
+https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^^]
which contain important information about breaking changes and some
manual actions that could be required.
==== Risoluzione problemi
Per qualunque problema con i set caratteri, per favore consultare
-le link:weechat_faq.it.html#charset[Domande Frequenti di WeeChat / Charset ^↗^,window=_blank].
+le link:weechat_faq.it.html#charset[Domande Frequenti di WeeChat / Charset ^↗^^].
[[charset_commands]]
==== Comandi
there is automatic rotation of log file.
The rotated log files can be compressed with gzip or
-https://facebook.github.io/zstd/[zstd ^↗^,window=_blank].
+https://facebook.github.io/zstd/[zstd ^↗^^].
[NOTE]
As the compression of a file can take some time, it is performed in background.
[NOTE]
Per qualunque problema con il mouse, consultare
-link:weechat_faq.it.html#mouse[FAQ di WeeChat / Mouse ^↗^,window=_blank].
+link:weechat_faq.it.html#mouse[FAQ di WeeChat / Mouse ^↗^^].
[[mouse_bind_events]]
==== Associare gli eventi del mouse a comandi
By default no servers are defined. You can add as many servers as you want with
the <<command_irc_server,/server>> command.
-For example to connect to https://libera.chat/[libera.chat ^↗^,window=_blank]
+For example to connect to https://libera.chat/[libera.chat ^↗^^]
with TLS (encrypted trafic):
----
// TRANSLATION MISSING
For more information, please look at
-https://www.oftc.net/NickServ/CertFP/[this page ^↗^,window=_blank].
+https://www.oftc.net/NickServ/CertFP/[this page ^↗^^].
[[irc_sasl_authentication]]
==== Autenticazione SASL
==== Connect with Tor and SASL
// TRANSLATION MISSING
-Some servers support connections with https://www.torproject.org/[Tor ^↗^,window=_blank],
+Some servers support connections with https://www.torproject.org/[Tor ^↗^^],
a network of virtual tunnels that allows people and groups to improve their
privacy and security on the Internet.
[[irc_ircv3_support]]
=== IRCv3 support
-WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
+WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^^]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
(see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Tables with comparison of different IRC clients, including WeeChat, are available
-on https://ircv3.net/software/clients[this page ^↗^,window=_blank].
+on https://ircv3.net/software/clients[this page ^↗^^].
[[irc_ircv3_account_notify]]
==== account-notify
-Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^^]
This capability allows the server to send messages when users identify or
unidentify on the server. +
[[irc_ircv3_account_tag]]
==== account-tag
-Specification: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^^]
This capability allows the server to send account as message tag to commands
sent to the client. +
[[irc_ircv3_away_notify]]
==== away-notify
-Specification: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^^]
This capability allows the server to send away notifications for users present
on the same channels as you.
[[irc_ircv3_batch]]
==== batch
-Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^^]
This capability allows the server to send batched events (grouping of several
messages that are related).
[[irc_ircv3_cap_notify]]
==== cap-notify
-Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^^]
This capability allows the server to advertise on new or removed capabilities
on the server (via `CAP NEW` and `CAP DEL` commands).
[[irc_ircv3_chghost]]
==== chghost
-Specification: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/chghost[chghost ^↗^^]
This capability allows the server to send messages when users change name or host. +
When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
[[irc_ircv3_draft_multiline]]
==== draft/multiline
-Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^^]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
[[irc_ircv3_echo_message]]
==== echo-message
-Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^^]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
[[irc_ircv3_extended_join]]
==== extended-join
-Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^^]
This capability allows the server to send account and real name when users
join channels. +
[[irc_ircv3_invite_notify]]
==== invite-notify
-Specification: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^^]
This capability allows the server to send invite messages when users are
invited to channels.
[[irc_ircv3_message_tags]]
==== message-tags
-Specification: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^^]
This capability allows to add metadata in messages. +
These tags can be displayed using the command `/debug tags`.
[[irc_ircv3_monitor]]
==== monitor
-Specification: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/monitor[monitor ^↗^^]
This capability allows the server to send notifications when clients become
online/offline. +
[[irc_ircv3_multi_prefix]]
==== multi-prefix
-Specification: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^^]
This capability allows the server to send all user modes at once in
<<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. +
[[irc_ircv3_sasl]]
==== SASL
-Specification: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^^]
See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
==== server-time
-Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^^]
This capability allows the server to send time for messages as message tag. +
When the time is received in a message, WeeChat uses it to display the message
[[irc_ircv3_setname]]
==== setname
-Specification: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/setname[setname ^↗^^]
This capability lets you change your real name by using the
<<command_irc_setname,/setname>> command.
[[irc_ircv3_typing]]
==== typing
-Specification: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/client-tags/typing[typing ^↗^^]
See the dedicated chapter <<typing_notifications,Typing notifications>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
-Specification: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^^]
This capability allows the server to send hostnames in <<command_irc_names,/names>>
responses.
[[irc_ircv3_whox]]
==== WHOX
-Specification: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/whox[WHOX ^↗^^]
This capability lets you request additional fields in the WHO response
(via the <<command_irc_who,/who>> command). +
It is used by IRC plugin on channel and private buffers, when the "message-tags"
capability is enabled (you can check with <<command_irc_cap,/cap>> command). +
Under the hood, typing client tag is used, following
-https://ircv3.net/specs/client-tags/typing[this specification ^↗^,window=_blank].
+https://ircv3.net/specs/client-tags/typing[this specification ^↗^^].
[[typing_activation]]
=== Activation
o più client IRC
// TRANSLATION MISSING
* _weechat_: protocol used by remote interfaces to display and interact with
- WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^,window=_blank].
+ WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^^].
// TRANSLATION MISSING
[[relay_password]]
One-time passwords can be generated with applications, for example:
* FreeOTP:
- https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^,window=_blank]
- (https://freeotp.github.io/[website ^↗^,window=_blank])
+ https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^^],
+ https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^^]
+ (https://freeotp.github.io/[website ^↗^^])
* Google Authenticator:
- https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^,window=_blank]
+ https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^^],
+ https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^^]
The TOTP secret must be set in WeeChat and the application used to generate
one-time passwords.
// TRANSLATION MISSING
You can connect with a remote interface, see
-https://weechat.org/about/interfaces/[this page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[this page ^↗^^].
[IMPORTANT]
// TRANSLATION MISSING
[[relay_websocket]]
=== WebSocket
-WebSocket protocol (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^,window=_blank])
+WebSocket protocol (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^^])
is supported in Relay plugin for all protocols.
The WebSocket handshake is automatically detected and socket becomes ready for
Using triggers require you to know how the signals, modifiers, ... are working.
So you might consider reading the
-link:weechat_plugin_api.it.html#hooks[WeeChat plugin API reference / Hooks ^↗^,window=_blank].
+link:weechat_plugin_api.it.html#hooks[WeeChat plugin API reference / Hooks ^↗^^].
[[trigger_default]]
=== Default triggers
| hook | `+signal+`, `+hsignal+`, `+modifier+`, `+line+`, `+print+`, `+command+`,
`+command_run+`, `+timer+`, `+config+`, `+focus+`, `+info+`, `+info_hashtable+`
| The hook used in trigger. For more information, see
- link:weechat_plugin_api.it.html#hooks[WeeChat plugin API reference / Hooks ^↗^,window=_blank].
+ link:weechat_plugin_api.it.html#hooks[WeeChat plugin API reference / Hooks ^↗^^].
| arguments | string
| The arguments for the hook, it depends on the hook type used.
| `+*,irc_in_privmsg+` +
`+*,irc_in_privmsg;*,irc_in_notice+` +
`+signal_sigwinch+`
-| link:weechat_plugin_api.it.html#_hook_signal[hook_signal ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_signal[hook_signal ^↗^^]
| hsignal
| 1. signal name (priority allowed) (required) +
2. signal name (priority allowed) +
3. ...
| `+nicklist_nick_added+`
-| link:weechat_plugin_api.it.html#_hook_hsignal[hook_hsignal ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_hsignal[hook_hsignal ^↗^^]
| modifier
| 1. modifier name (priority allowed) (required) +
3. ...
| `+weechat_print+` +
`+5000\|input_text_display;5000\|history_add+`
-| link:weechat_plugin_api.it.html#_hook_modifier[hook_modifier ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_modifier[hook_modifier ^↗^^]
| line
| 1. buffer type +
`+*;irc.libera.*+` +
`+*;irc.libera.#weechat+` +
`+formatted;irc.libera.#weechat;irc_notice+`
-| link:weechat_plugin_api.it.html#_hook_line[hook_line ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_line[hook_line ^↗^^]
| print
| 1. buffer name +
`+irc.libera.#weechat+` +
`+irc.libera.#weechat;irc_notice+` +
`+*;;;1+`
-| link:weechat_plugin_api.it.html#_hook_print[hook_print ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_print[hook_print ^↗^^]
| command
| 1. command name (priority allowed) (required) +
| `+test+` +
`+5000\|test+` +
`+test;test command;arg1 arg2;arg1: description 1${\n}arg2: description 2+`
-| link:weechat_plugin_api.it.html#_hook_command[hook_command ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_command[hook_command ^↗^^]
| command_run
| 1. command (priority allowed) (required) +
2. command (priority allowed) +
3. ...
| `+/cmd arguments+`
-| link:weechat_plugin_api.it.html#_hook_command_run[hook_command_run ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_command_run[hook_command_run ^↗^^]
| timer
| 1. interval in milliseconds (required) +
3. max number of calls (default: 0, which means "no end")
| `+3600000+` +
`+60000;0;5+`
-| link:weechat_plugin_api.it.html#_hook_timer[hook_timer ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_timer[hook_timer ^↗^^]
| config
| 1. option name (priority allowed) (required) +
2. option name (priority allowed) +
3. ...
| `+weechat.look.*+`
-| link:weechat_plugin_api.it.html#_hook_config[hook_config ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_config[hook_config ^↗^^]
| focus
| 1. area name (priority allowed) (required) +
2. area name (priority allowed) +
3. ...
| `+buffer_nicklist+`
-| link:weechat_plugin_api.it.html#_hook_focus[hook_focus ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_focus[hook_focus ^↗^^]
| info
| 1. info name (priority allowed) (required) +
2. info name (priority allowed) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.it.html#_hook_info[hook_info ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_info[hook_info ^↗^^]
| info_hashtable
| 1. info name (priority allowed) (required) +
2. info name (priority allowed) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.it.html#_hook_info_hashtable[hook_info_hashtable ^↗^,window=_blank]
+| link:weechat_plugin_api.it.html#_hook_info_hashtable[hook_info_hashtable ^↗^^]
|===
[[trigger_conditions]]
|===
Per saperne di più riguardo lo sviluppo di plugin o script (tramite le API), per
-favore consultare link:weechat_plugin_api.it.html[Riferimento API dei Plugin per WeeChat ^↗^,window=_blank]
-oppure link:weechat_scripting.it.html[Guida allo Scripting di WeeChat ^↗^,window=_blank].
+favore consultare link:weechat_plugin_api.it.html[Riferimento API dei Plugin per WeeChat ^↗^^]
+oppure link:weechat_scripting.it.html[Guida allo Scripting di WeeChat ^↗^^].
// TRANSLATION MISSING
[[scripts]]
linguaggi.
Per maggiori informazioni su come scrivere gli script, o le API WeeChat
-per gli script, consultare la link:weechat_scripting.it.html[Guida allo Scripting di WeeChat ^↗^,window=_blank].
+per gli script, consultare la link:weechat_scripting.it.html[Guida allo Scripting di WeeChat ^↗^^].
// TRANSLATION MISSING
[[script_manager]]
The script manager (command <<command_script_script,/script>>) is used to
load/unload scripts of any language, and install/remove scripts of WeeChat
scripts repository, which are visible on
-https://weechat.org/scripts/[this page ^↗^,window=_blank].
+https://weechat.org/scripts/[this page ^↗^^].
// TRANSLATION MISSING
For privacy considerations, the download of scripts is disabled by default. +
// TRANSLATION MISSING
For other ways of support, see
-https://weechat.org/about/support/[this page ^↗^,window=_blank].
+https://weechat.org/about/support/[this page ^↗^^].
// TRANSLATION MISSING
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== はじめに
[[repositories]]
== リポジトリ
-WeeChat リポジトリは GitHub organization の https://github.com/weechat[weechat ^↗^,window=_blank] にあります:
+WeeChat リポジトリは GitHub organization の https://github.com/weechat[weechat ^↗^^] にあります:
リポジトリのリスト:
// TRANSLATION MISSING
weechat.org::
- source of https://weechat.org/[WeeChat website ^↗^,window=_blank]
+ source of https://weechat.org/[WeeChat website ^↗^^]
weercd::
IRC テストサーバ
| docinfo.html | asciidoctor スタイル
| XX/ | 言語コード XX (言語コード: en、fr、de、it、...) 用のディレクトリ
| weechat.1.XX.adoc | man ページ (`man weechat`)
-| weechat_dev.XX.adoc | link:weechat_dev.ja.html[開発者リファレンス ^↗^,window=_blank] (この文書)
-| weechat_faq.XX.adoc | link:weechat_faq.ja.html[FAQ ^↗^,window=_blank]
-| weechat_plugin_api.XX.adoc | link:weechat_plugin_api.ja.html[プラグイン API リファレンス ^↗^,window=_blank]
-| weechat_quickstart.XX.adoc | link:weechat_quickstart.ja.html[クイックスタートガイド ^↗^,window=_blank]
-| weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.ja.html[リレープロトコル ^↗^,window=_blank] (リモートインターフェース用)
-| weechat_scripting.XX.adoc | link:weechat_scripting.ja.html[スクリプト作成ガイド ^↗^,window=_blank]
-| weechat_user.XX.adoc | link:weechat_user.ja.html[ユーザーズガイド ^↗^,window=_blank]
+| weechat_dev.XX.adoc | link:weechat_dev.ja.html[開発者リファレンス ^↗^^] (この文書)
+| weechat_faq.XX.adoc | link:weechat_faq.ja.html[FAQ ^↗^^]
+| weechat_plugin_api.XX.adoc | link:weechat_plugin_api.ja.html[プラグイン API リファレンス ^↗^^]
+| weechat_quickstart.XX.adoc | link:weechat_quickstart.ja.html[クイックスタートガイド ^↗^^]
+| weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.ja.html[リレープロトコル ^↗^^] (リモートインターフェース用)
+| weechat_scripting.XX.adoc | link:weechat_scripting.ja.html[スクリプト作成ガイド ^↗^^]
+| weechat_user.XX.adoc | link:weechat_user.ja.html[ユーザーズガイド ^↗^^]
// TRANSLATION MISSING
| includes/ | Files included in documentation.
// TRANSLATION MISSING
[[coding_python_style]]
=== Python スタイル
-https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank] を参照
+https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^^] を参照
[[core_internals]]
== コアの構造
=== Git リポジトリ
// TRANSLATION MISSING
-Git repository is on https://github.com/weechat/weechat[GitHub ^↗^,window=_blank].
+Git repository is on https://github.com/weechat/weechat[GitHub ^↗^^].
バグや新機能のパッチは必ず master ブランチに対して適用できるものを作成し、GitHub の pull
リクエストを使って提出することを推奨します。パッチは電子メールで送信することも可能です
// TRANSLATION MISSING
When done, you *have* to check your file with
-https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank]:
+https://github.com/flashcode/msgcheck[msgcheck ^↗^^]:
----
$ msgcheck.py xx.po
// TRANSLATION MISSING
More info on the WeeChat
-https://weechat.org/about/features/[features page ^↗^,window=_blank].
+https://weechat.org/about/features/[features page ^↗^^].
[[compilation_install]]
== コンパイル / インストール
// TRANSLATION MISSING
Some remote GUIs are available, see the
-https://weechat.org/about/interfaces/[remote interfaces page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[remote interfaces page ^↗^^].
[[compile_git]]
=== git リポジトリをクローンした後に WeeChat をコンパイルできません。
WeeChat must be compiled with CMake.
// TRANSLATION MISSING
-Please follow link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank]
+Please follow link:weechat_user.en.html#source_package[build instructions ^↗^^]
and ensure all required dependencies are installed.
// TRANSLATION MISSING
[[compile_macos]]
=== どうすれば macOS に WeeChat をインストールできますか?
-https://brew.sh/[Homebrew ^↗^,window=_blank] を使うことをお勧めします、ヘルプを見るには:
+https://brew.sh/[Homebrew ^↗^^] を使うことをお勧めします、ヘルプを見るには:
----
brew info weechat
=== WeeChat を起動しました。でも何をすればいいかわかりません。
ヘルプを見るには、`/help` と入力してください。コマンドに関するヘルプを見るには、`/help command`
-と入力してください。link:weechat_user.ja.html#key_bindings[キー ^↗^,window=_blank]とlink:weechat_user.ja.html#commands_and_options[コマンド ^↗^,window=_blank]は文書中で説明されています。
+と入力してください。link:weechat_user.ja.html#key_bindings[キー ^↗^^]とlink:weechat_user.ja.html#commands_and_options[コマンド ^↗^^]は文書中で説明されています。
-新しいユーザはlink:weechat_quickstart.ja.html[クイックスタートガイド ^↗^,window=_blank]を読むことをお勧めします
+新しいユーザはlink:weechat_quickstart.ja.html[クイックスタートガイド ^↗^^]を読むことをお勧めします
[[display]]
== 表示
rxvt-unicode を推奨)
** screen を使っている場合は、UTF-8 モードで起動されていることを確認
(~/.screenrc に "`defutf8 on`" の記述があるかまたは `screen -U` のようにして起動)。
-* link:weechat_user.ja.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
+* link:weechat_user.ja.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^^]
オプションが off であることを確認してください (このオプションは表示上のバグを引き起こす可能性があります)
[NOTE]
で修正されているはずです (使用中のディストリビューションではまだ提供されていないかもしれません)
次の回避方法を使えば、修正済みの _wcwidth_ 関数を使う事が可能です:
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank].
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^^].
// TRANSLATION MISSING
-See this https://github.com/weechat/weechat/issues/79[bug report ^↗^,window=_blank]
+See this https://github.com/weechat/weechat/issues/79[bug report ^↗^^]
for more information.
[[bars_background]]
=== どうすれば左側にバッファリストを表示できますか。
// TRANSLATION MISSING
-The plugin link:weechat_user.ja.html#buflist[buflist ^↗^,window=_blank]
+The plugin link:weechat_user.ja.html#buflist[buflist ^↗^^]
is loaded and enabled by default.
// TRANSLATION MISSING
The buflist plugin provides lot of options that you can customize, please read
the help on each option.
-There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^,window=_blank]
+There's also a https://github.com/weechat/weechat/wiki/buflist[wiki page ^↗^^]
with examples of advanced buflist configuration.
[[customize_prefix]]
および __weechat.color.status_count_*__ オプション (カウンタ) を設定します。 +
その他のホットリスト関連オプションは __weechat.look.hotlist_*__ オプションを使って変更します。
-ホットリストに関する詳しい情報はlink:weechat_user.ja.html#screen_layout[ユーザーズガイド / 画面レイアウト ^↗^,window=_blank]を参照してください
+ホットリストに関する詳しい情報はlink:weechat_user.ja.html#screen_layout[ユーザーズガイド / 画面レイアウト ^↗^^]を参照してください
[[input_bar_size]]
=== コマンドラインの行数を増やすにはどうすればいいですか。
You can use any color number in options (optional: you can add color aliases
with command `/color`).
-色管理に関するより詳しい情報はlink:weechat_user.ja.html#colors[ユーザーズガイド / 色 ^↗^,window=_blank]を参照してください
+色管理に関するより詳しい情報はlink:weechat_user.ja.html#colors[ユーザーズガイド / 色 ^↗^^]を参照してください
[[search_text]]
=== どうすればバッファ内の文字列を検索できますか (irssi の /lastlog の様に)。
デフォルトのキーは kbd:[Ctrl+r] です (コマンドは: `+/input search_text_here+`)。
ハイライト部分へのジャンプは: kbd:[Alt+p] / kbd:[Alt+n]
-この機能に関するより詳しい情報はlink:weechat_user.ja.html#key_bindings[ユーザーズガイド / デフォルトのキー割り当て ^↗^,window=_blank]を参照してください
+この機能に関するより詳しい情報はlink:weechat_user.ja.html#key_bindings[ユーザーズガイド / デフォルトのキー割り当て ^↗^^]を参照してください
[[terminal_focus]]
=== どうすれば端末にフォーカスが合った時や外れた時にコマンドを実行できますか。
/key bind meta-q /buffer *11
----
-デフォルトキー割り当てのリストはlink:weechat_user.ja.html#key_bindings[ユーザーズガイド / デフォルトのキー割り当て ^↗^,window=_blank]を参照してください
+デフォルトキー割り当てのリストはlink:weechat_user.ja.html#key_bindings[ユーザーズガイド / デフォルトのキー割り当て ^↗^^]を参照してください
番号 100 以上のバッファにジャンプするには、以下のトリガを定義してください。こうすることでコマンド
`/123` でバッファ #123 にジャンプできるようになります:
[[filter_irc_join_part_quit]]
=== How can I filter join/part/quit and other annoying messages on IRC channels?
-See link:weechat_user.ja.html#irc_smart_filter[User's guide / IRC smart filter ^↗^,window=_blank].
+See link:weechat_user.ja.html#irc_smart_filter[User's guide / IRC smart filter ^↗^^].
[[filter_irc_join_channel_messages]]
=== どうすれば IRC チャンネルに参加した際に表示される一部のメッセージをフィルタできますか。
// TRANSLATION MISSING
You can use the
-link:weechat_user.ja.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
+link:weechat_user.ja.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^^]
buffer property to set the max hotlist level for some nicks, per buffer,
or per group of buffers (like IRC servers).
パスフレーズを定義してパスワードなどの保護したいデータの使用時は常にセキュアデータを使います:
`/help secure` およびセキュアデータを使用したいオプションの `/help` を参照してください
(セキュアデータを使うことが可能なオプションのヘルプにはこの点が明記されています)。
-link:weechat_user.ja.html#secured_data[ユーザーズガイド / 暗号化データ ^↗^,window=_blank] を参照してください。
+link:weechat_user.ja.html#secured_data[ユーザーズガイド / 暗号化データ ^↗^^] を参照してください。
例:
Some other files may contain sensitive info like passwords (if they are not
stored in _sec.conf_ with the `/secure` command).
-設定ファイルに関する詳しい情報はlink:weechat_user.ja.html#files_and_directories[ユーザーズガイド / ファイルとディレクトリ ^↗^,window=_blank]を参照してください。
+設定ファイルに関する詳しい情報はlink:weechat_user.ja.html#files_and_directories[ユーザーズガイド / ファイルとディレクトリ ^↗^^]を参照してください。
[[development]]
== 開発
=== どのようにバグ報告、新機能のリクエスト、パッチ送信すればよいですか。
// TRANSLATION MISSING
-See https://weechat.org/about/support/[this page ^↗^,window=_blank].
+See https://weechat.org/about/support/[this page ^↗^^].
[[gdb_error_threads]]
=== gdb で WeeChat を実行する場合、スレッドに関するエラーが発生します。
// TRANSLATION MISSING
Please contact us via IRC or mail, look at
-https://weechat.org/about/support/[support page ^↗^,window=_blank].
+https://weechat.org/about/support/[support page ^↗^^].
[[donate]]
=== WeeChat 開発者にお金か何かを贈りたいのですが。
// TRANSLATION MISSING
You can give us money to help development.
-Details on https://weechat.org/donate/[donation page ^↗^,window=_blank].
+Details on https://weechat.org/donate/[donation page ^↗^^].
// TRANSLATION MISSING
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== はじめに
Register the script.
For more information, see the
-link:weechat_scripting.ja.html#register_function[WeeChat scripting guide ^↗^,window=_blank].
+link:weechat_scripting.ja.html#register_function[WeeChat scripting guide ^↗^^].
スクリプト (Python) での使用例:
// TRANSLATION MISSING
This function is a C conversion of Python class "shlex" (file: Lib/shlex.py in
Python repository), see
-https://docs.python.org/3/library/shlex.html[this page ^↗^,window=_blank].
+https://docs.python.org/3/library/shlex.html[this page ^↗^^].
プロトタイプ:
// TRANSLATION MISSING
* U+0009 (Tabulation): value of option
- link:weechat_user.ja.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^,window=_blank]
+ link:weechat_user.ja.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^^]
* U+0001 (1) to U+001F (31), except U+0009 (Tabulation): 1
* U+00AD (173, soft hyphen): -1
* U+200B (8203, zero width space): -1
[NOTE]
Ruby では、3 組のコールバックとデータ (6 つの文字列変数) を渡す際に必ず 6 つの文字列変数の配列を
1 つ渡してください (これは Ruby が関数に 15 個以上の引数を渡せないことが原因です)、より詳しい内容は
-link:++weechat_scripting.ja.html#_ruby++[WeeChat スクリプト作成ガイド ^↗^,window=_blank]を参照してください
+link:++weechat_scripting.ja.html#_ruby++[WeeChat スクリプト作成ガイド ^↗^^]を参照してください
_(WeeChat バージョン 0.4.1 で修正済み)_。
* _message_: 表示するメッセージ
WeeChat で共通に使われるタグのリストは
-link:weechat_user.ja.html#lines_tags[WeeChat ユーザーズガイド / 行のタグ ^↗^,window=_blank]を参照してください
+link:weechat_user.ja.html#lines_tags[WeeChat ユーザーズガイド / 行のタグ ^↗^^]を参照してください
C 言語での使用例:
// TRANSLATION MISSING
If you want to retrieve infos about WeeChat (like current stable version,
latest git commit, etc.), you can use URLs on
-https://weechat.org/dev/info/[this page ^↗^,window=_blank].
+https://weechat.org/dev/info/[this page ^↗^^].
[NOTE]
コールバックにデータを送信するバッファのサイズは 64KB (バッファは 2
| -
| Any string.
| String with IRC tag value escaped,
- see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^,window=_blank].
+ see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^^].
// TRANSLATION MISSING
| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value | 3.3
| -
| Any string.
| String with IRC tag value unescaped,
- see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^,window=_blank].
+ see https://ircv3.net/specs/extensions/message-tags#escaping-values[this page ^↗^^].
| [[hook_modifier_color_decode_ansi]] color_decode_ansi | 1.0
| 色を保持する場合は "1"、削除する場合は "0"
** _inactive_: 非アクティブウィンドウのみに表示されているバー
** _nicklist_: ニックネームリストを持つウィンドウに表示されているバー
** 評価された式:
- link:weechat_user.ja.html#bar_conditions[WeeChat ユーザーズガイド / バー状態 ^↗^,window=_blank]を参照してください
+ link:weechat_user.ja.html#bar_conditions[WeeChat ユーザーズガイド / バー状態 ^↗^^]を参照してください
* _position_: _top_、_bottom_、_left_、_right_
* _filling_top_bottom_:
** _horizontal_: 要素は水平方向に詰め込まれている (各要素の後に間隔)
With WeeChat ≥ 2.9, in Ruby, the 4 colors (color_fg, color_delim, color_bg,
color_bg_inactive) must be given in an array of 4 strings (due to a Ruby
limitation of 15 arguments by function), see the
-link:++weechat_scripting.ja.html#_ruby++[WeeChat scripting guide ^↗^,window=_blank]
+link:++weechat_scripting.ja.html#_ruby++[WeeChat scripting guide ^↗^^]
for more info.
==== bar_set
[NOTE]
"irc_message_parse" の出力に関するより詳しい情報は
-link:weechat_scripting.ja.html#irc_message_parse[WeeChat スクリプト作成ガイド / メッセージの構文解析 ^↗^,window=_blank]を参照してください。
+link:weechat_scripting.ja.html#irc_message_parse[WeeChat スクリプト作成ガイド / メッセージの構文解析 ^↗^^]を参照してください。
スクリプト (Python) での使用例:
* _pointer_: WeeChat および plugin オブジェクトへのポインタ
* _search_: 評価する式、式中のデフォルトポインタは hdata の名前
(デフォルトポインタはリストに含まれる各要素で置換されます); 式に関する詳細は
- link:weechat_user.ja.html#command_weechat_eval[WeeChat ユーザーズガイド / WeeChat コマンド / eval ^↗^,window=_blank] を参照してください
+ link:weechat_user.ja.html#command_weechat_eval[WeeChat ユーザーズガイド / WeeChat コマンド / eval ^↗^^] を参照してください
* _pointers_: 関数に渡されるハッシュテーブル
<<_string_eval_expression,string_eval_expression>>
* _extra_vars_: 関数に渡されるハッシュテーブル
// TRANSLATION MISSING
A list of scripts is available in WeeChat with `/script` or on
-https://weechat.org/scripts/[this page ^↗^,window=_blank].
+https://weechat.org/scripts/[this page ^↗^^].
[[more_doc]]
== 詳しいドキュメント情報
// TRANSLATION MISSING
You can now use WeeChat and read
-https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+https://weechat.org/doc/[FAQ/documentation ^↗^^]
for any other questions.
WeeChat をお楽しみください!
if compression is enabled, messages from _relay_ to client are compressed
to save bandwidth; allowed values are:
*** _off_: no compression (default if option is not given)
-*** _zlib_: compress with https://zlib.net/[zlib ^↗^,window=_blank] _(WeeChat ≥ 0.3.7)_
-*** _zstd_: compress with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]: better
+*** _zlib_: compress with https://zlib.net/[zlib ^↗^^] _(WeeChat ≥ 0.3.7)_
+*** _zstd_: compress with https://facebook.github.io/zstd/[Zstandard ^↗^^]: better
compression and much faster than _zlib_ for both compression and decompression
_(WeeChat ≥ 3.5)_
in the password hash algorithm)
* _compression_: compression type:
** _off_: messages are not compressed
-** _zlib_: messages are compressed with https://zlib.net/[zlib ^↗^,window=_blank]
-** _zstd_: messages are compressed with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]
+** _zlib_: messages are compressed with https://zlib.net/[zlib ^↗^^]
+** _zstd_: messages are compressed with https://facebook.github.io/zstd/[Zstandard ^↗^^]
[TIP]
With WeeChat ≤ 2.8, the command _handshake_ is not implemented, WeeChat silently
(このフィールドを含む)
* _compression_ (バイト型): フラグ:
** _0x00_: これ以降のデータは圧縮されていません
-** _0x01_: これ以降のデータは https://zlib.net/[zlib ^↗^,window=_blank] で圧縮されています
-** _0x02_: これ以降のデータは https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] で圧縮されています
+** _0x01_: これ以降のデータは https://zlib.net/[zlib ^↗^^] で圧縮されています
+** _0x02_: これ以降のデータは https://facebook.github.io/zstd/[Zstandard ^↗^^] で圧縮されています
* _id_ (文字列型、4 バイト + 内容): クライアントが送信した識別子 (コマンド名の前につけられる);
コマンドに識別子が含まれない場合は空文字列でも可
(内容を含まない長さゼロの文字列)
// TRANSLATION MISSING
If flag _compression_ is equal to 0x01 or 0x02, then *all* data after is compressed
-with https://zlib.net/[zlib ^↗^,window=_blank] or
-https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank],
+with https://zlib.net/[zlib ^↗^^] or
+https://facebook.github.io/zstd/[Zstandard ^↗^^],
and therefore must be uncompressed before being processed.
[[message_identifier]]
// TRANSLATION MISSING
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== イントロダクション
されています。これが必要な場合には専用 API 関数を使ってください。 +
どうしてもバックグラウンド実行を避けられない場合には `+hook_process+`
関数を使ってください。<<hook_process,バックグラウンドプロセスの実行>>の例および
-link:weechat_plugin_api.ja.html#_hook_process[WeeChat プラグイン API リファレンス ^↗^,window=_blank]内の
+link:weechat_plugin_api.ja.html#_hook_process[WeeChat プラグイン API リファレンス ^↗^^]内の
`+hook_process+` 関数の文書を参照してください。
[[languages_specificities]]
WeeChat defines a `weechat` module which must be imported with `import weechat`. +
A Python stub for WeeChat API is available in the repository:
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^,window=_blank].
+https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
// TRANSLATION MISSING
[[python_functions]]
It is recommended to use modifier `+irc_in2_yyy+` instead, the string received
is always UTF-8 valid. +
See function `+hook_modifier+` in the
- link:weechat_plugin_api.ja.html#_hook_modifier[WeeChat plugin API reference ^↗^,window=_blank].
+ link:weechat_plugin_api.ja.html#_hook_modifier[WeeChat plugin API reference ^↗^^].
| hook_signal
| xxx,irc_out_yyy +
It is recommended to use signal `+xxx,irc_out1_yyy+` instead, the string received
is always UTF-8 valid. +
See function `+hook_signal+` in the
- link:weechat_plugin_api.ja.html#_hook_signal[WeeChat plugin API reference ^↗^,window=_blank].
+ link:weechat_plugin_api.ja.html#_hook_signal[WeeChat plugin API reference ^↗^^].
| hook_process +
hook_process_hashtable
will get it as the value of an argument in a callback function if the argument
value is null. To see which functions accept null values and passes null values
to callbacks, look at the Python prototypes in the
-link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^,window=_blank].
+link:weechat_plugin_api.en.html[WeeChat plugin API reference ^↗^^].
[[language_guile]]
==== Guile (Scheme)
スクリプト API は C 言語プラグイン API とほぼ同じです。API
に含まれる各関数の詳細 (プロトタイプ、引数、戻り値、例) については
-link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス ^↗^,window=_blank]を参照してください。
+link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス ^↗^^]を参照してください。
_プラグイン_ と _スクリプト_ の違いを理解することは重要です:
_プラグイン_ とはコンパイル済みバイナリファイルで `/plugin` コマンドを使ってロードします、これに対して
== スクリプト API
API に含まれる関数の詳しい情報は
-link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス ^↗^,window=_blank]を参照してください。
+link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス ^↗^^]を参照してください。
[[script_api_functions]]
=== 関数
この章ではいくつかの良くあるタスクを例を交えて紹介します。ここでは
API の一部の機能を使っています。完全なリファレンスは
-link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス ^↗^,window=_blank]を参照してください。
+link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス ^↗^^]を参照してください。
[[buffers]]
=== バッファ
[TIP]
// TRANSLATION MISSING
All infos available about WeeChat are on
-https://weechat.org/dev/info/[this page ^↗^,window=_blank].
+https://weechat.org/dev/info/[this page ^↗^^].
オプション有りの URL 転送の例: 最新の WeeChat 開発パッケージをファイル
_/tmp/weechat-devel.tar.gz_ にダウンロード:
----
URL 転送に関するより詳しい情報と利用可能なオプションは
-link:weechat_plugin_api.ja.html#_hook_process[WeeChat プラグイン API リファレンス ^↗^,window=_blank]の
+link:weechat_plugin_api.ja.html#_hook_process[WeeChat プラグイン API リファレンス ^↗^^]の
`+hook_process+` と `+hook_process_hashtable+` を参照してください。
[[config_options]]
// TRANSLATION MISSING
Latest version of this document can be found on
-https://weechat.org/doc/[this page ^↗^,window=_blank].
+https://weechat.org/doc/[this page ^↗^^].
[[introduction]]
== イントロダクション
* コンパクト、高速、軽量
* プラグインとスクリプトでカスタマイズや拡張が可能
* IRC の RFC に準拠
- https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^,window=_blank]、
- https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^,window=_blank]、
- https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^,window=_blank]、
- https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^,window=_blank]、
- https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^,window=_blank]、
- https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^,window=_blank]。
+ https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^^]、
+ https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^^]、
+ https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^^]、
+ https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^]、
+ https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^]、
+ https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]。
* リモートインターフェース用の IRC プロキシとリレー
* マルチプラットフォーム (GNU/Linux、*BSD、macOS、Windows 等)
* 完全な GPL、フリーソフトウェア
// TRANSLATION MISSING
The list of all features can be found on
-https://weechat.org/about/features/[this page ^↗^,window=_blank].
+https://weechat.org/about/features/[this page ^↗^^].
[[prerequisites]]
=== 事前に必要なもの
* Debian/Ubuntu (または Debian 互換ディストリビューション):
`apt-get install weechat-curses weechat-plugins` +
For latest versions and nightly builds:
- https://weechat.org/download/debian/[Debian repositories ^↗^,window=_blank]
+ https://weechat.org/download/debian/[Debian repositories ^↗^^]
* Fedora Core: `dnf install weechat`
* FreeBSD: `pkg install weechat`
* Gentoo: `emerge weechat`
* openSUSE: `zypper in weechat`
* Sourcemage: `cast weechat`
// TRANSLATION MISSING
-* macOS (with https://brew.sh/[Homebrew ^↗^,window=_blank]): `brew install weechat`
+* macOS (with https://brew.sh/[Homebrew ^↗^^]): `brew install weechat`
(for help: `brew info weechat`)
例えば weechat-plugins 等の追加パッケージを使うとさらに便利になるかもしれません。
// TRANSLATION MISSING
Containers with WeeChat can be built or installed directly from the
-https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^,window=_blank]. +
+https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^^]. +
For more information, see the README in the
-https://github.com/weechat/weechat-container[weechat-container ^↗^,window=_blank]
+https://github.com/weechat/weechat-container[weechat-container ^↗^^]
repository.
[[source_package]]
WeeChat must be built with CMake.
[NOTE]
-macOS では https://brew.sh/[Homebrew ^↗^,window=_blank] を使ってください:
+macOS では https://brew.sh/[Homebrew ^↗^^] を使ってください:
`brew install --build-from-source weechat`。
[[dependencies]]
// TRANSLATION MISSING
| zlib1g-dev |
| Logger plugin: compression of rotated log files (gzip). +
- Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^,window=_blank] (weechat protocol). +
+ Relay plugin: compression of messages (WeeChat -> client) with https://zlib.net/[zlib ^↗^^] (weechat protocol). +
Script plugin: read of repository index file (gzip).
// TRANSLATION MISSING
| libzstd-dev | ≥ 0.8.1
| Logger plugin: compression of rotated log files. +
- Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] (weechat protocol).
+ Relay plugin: compression of messages (WeeChat -> client) with https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat protocol).
|===
[NOTE]
On some systems like Archlinux, core dumps could be in another directory like
_/var/lib/systemd/coredump_ and you must use the command `coredumpctl` to read it. +
For more information, see this
-https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^,window=_blank].
+https://wiki.archlinux.org/title/Core_dump[wiki page ^↗^^].
例えば、_weechat_ が _/usr/bin/_ にインストールされ、_core_ ファイルが
_/home/user/_ にある場合、以下のコマンドで gdb を起動してください:
==== XDG directories
WeeChat uses XDG directories by default (according to the
-https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^,window=_blank]). +
+https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^^]). +
A single home directory for all files can be forced by CMake option `WEECHAT_HOME`,
the environment variable `WEECHAT_HOME` or the command-line option `-d` / `--dir`.
==== Release notes
After an upgrade, it is *strongly recommended* to read the
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^,window=_blank]
+https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[release notes ^↗^^]
which contain important information about breaking changes and some
manual actions that could be required.
[[charset_troubleshooting]]
==== トラブルシューティング
-文字コードに関する問題があれば、link:weechat_faq.ja.html#charset[WeeChat FAQ (よくある質問) / いくつかの文字が見えません。どうすれば良いですか。 ^↗^,window=_blank]を参照してください。
+文字コードに関する問題があれば、link:weechat_faq.ja.html#charset[WeeChat FAQ (よくある質問) / いくつかの文字が見えません。どうすれば良いですか。 ^↗^^]を参照してください。
[[charset_commands]]
==== コマンド
there is automatic rotation of log file.
The rotated log files can be compressed with gzip or
-https://facebook.github.io/zstd/[zstd ^↗^,window=_blank].
+https://facebook.github.io/zstd/[zstd ^↗^^].
[NOTE]
As the compression of a file can take some time, it is performed in background.
(一部の端末、例えば iTerm などでは kbd:[Shift] の代わりに kbd:[Alt] を使ってください)。
[NOTE]
-マウスに関するトラブルがあれば link:weechat_faq.ja.html#mouse[WeeChat FAQ (よくある質問) / マウス ^↗^,window=_blank]を参照してください。
+マウスに関するトラブルがあれば link:weechat_faq.ja.html#mouse[WeeChat FAQ (よくある質問) / マウス ^↗^^]を参照してください。
[[mouse_bind_events]]
==== コマンドに対してマウスイベントを割り当てる
By default no servers are defined. You can add as many servers as you want with
the <<command_irc_server,/server>> command.
-For example to connect to https://libera.chat/[libera.chat ^↗^,window=_blank]
+For example to connect to https://libera.chat/[libera.chat ^↗^^]
with TLS (encrypted trafic):
----
// TRANSLATION MISSING
For more information, please look at
-https://www.oftc.net/NickServ/CertFP/[this page ^↗^,window=_blank].
+https://www.oftc.net/NickServ/CertFP/[this page ^↗^^].
[[irc_sasl_authentication]]
==== SASL 認証
==== Connect with Tor and SASL
// TRANSLATION MISSING
-Some servers support connections with https://www.torproject.org/[Tor ^↗^,window=_blank],
+Some servers support connections with https://www.torproject.org/[Tor ^↗^^],
a network of virtual tunnels that allows people and groups to improve their
privacy and security on the Internet.
[[irc_ircv3_support]]
=== IRCv3 support
-WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^,window=_blank]:
+WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions ^↗^^]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
(see option <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Tables with comparison of different IRC clients, including WeeChat, are available
-on https://ircv3.net/software/clients[this page ^↗^,window=_blank].
+on https://ircv3.net/software/clients[this page ^↗^^].
[[irc_ircv3_account_notify]]
==== account-notify
-Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^^]
This capability allows the server to send messages when users identify or
unidentify on the server. +
[[irc_ircv3_account_tag]]
==== account-tag
-Specification: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^^]
This capability allows the server to send account as message tag to commands
sent to the client. +
[[irc_ircv3_away_notify]]
==== away-notify
-Specification: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^^]
This capability allows the server to send away notifications for users present
on the same channels as you.
[[irc_ircv3_batch]]
==== batch
-Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^^]
This capability allows the server to send batched events (grouping of several
messages that are related).
[[irc_ircv3_cap_notify]]
==== cap-notify
-Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^^]
This capability allows the server to advertise on new or removed capabilities
on the server (via `CAP NEW` and `CAP DEL` commands).
[[irc_ircv3_chghost]]
==== chghost
-Specification: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/chghost[chghost ^↗^^]
This capability allows the server to send messages when users change name or host. +
When the option <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
[[irc_ircv3_draft_multiline]]
==== draft/multiline
-Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^^]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
[[irc_ircv3_echo_message]]
==== echo-message
-Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^^]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
[[irc_ircv3_extended_join]]
==== extended-join
-Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^^]
This capability allows the server to send account and real name when users
join channels. +
[[irc_ircv3_invite_notify]]
==== invite-notify
-Specification: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^^]
This capability allows the server to send invite messages when users are
invited to channels.
[[irc_ircv3_message_tags]]
==== message-tags
-Specification: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^^]
This capability allows to add metadata in messages. +
These tags can be displayed using the command `/debug tags`.
[[irc_ircv3_monitor]]
==== monitor
-Specification: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/monitor[monitor ^↗^^]
This capability allows the server to send notifications when clients become
online/offline. +
[[irc_ircv3_multi_prefix]]
==== multi-prefix
-Specification: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^^]
This capability allows the server to send all user modes at once in
<<command_irc_names,/names>> and <<command_irc_whois,/whois>> responses. +
[[irc_ircv3_sasl]]
==== SASL
-Specification: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^^]
See the dedicated chapter <<irc_sasl_authentication,SASL authentication>>.
[[irc_ircv3_server_time]]
==== server-time
-Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/server-time[server-time ^↗^^]
This capability allows the server to send time for messages as message tag. +
When the time is received in a message, WeeChat uses it to display the message
[[irc_ircv3_setname]]
==== setname
-Specification: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/setname[setname ^↗^^]
This capability lets you change your real name by using the
<<command_irc_setname,/setname>> command.
[[irc_ircv3_typing]]
==== typing
-Specification: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/client-tags/typing[typing ^↗^^]
See the dedicated chapter <<typing_notifications,Typing notifications>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
-Specification: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^^]
This capability allows the server to send hostnames in <<command_irc_names,/names>>
responses.
[[irc_ircv3_whox]]
==== WHOX
-Specification: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/whox[WHOX ^↗^^]
This capability lets you request additional fields in the WHO response
(via the <<command_irc_who,/who>> command). +
It is used by IRC plugin on channel and private buffers, when the "message-tags"
capability is enabled (you can check with <<command_irc_cap,/cap>> command). +
Under the hood, typing client tag is used, following
-https://ircv3.net/specs/client-tags/typing[this specification ^↗^,window=_blank].
+https://ircv3.net/specs/client-tags/typing[this specification ^↗^^].
[[typing_activation]]
=== Activation
クライアントで共有するために用います。
// TRANSLATION MISSING
* _weechat_: protocol used by remote interfaces to display and interact with
- WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^,window=_blank].
+ WeeChat, see https://weechat.org/about/interfaces/[this page ^↗^^].
[[relay_password]]
=== パスワード
ワンタイムパスワードは以下のようなアプリケーションを使って生成します:
* FreeOTP:
- https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^,window=_blank]
- (https://freeotp.github.io/[website ^↗^,window=_blank])
+ https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^^],
+ https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^^]
+ (https://freeotp.github.io/[website ^↗^^])
* Google Authenticator:
- https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^,window=_blank]
+ https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^^],
+ https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^^]
TOTP の secret を WeeChat
とワンタイムパスワードを生成するアプリケーション内部に設定しなければいけません。
// TRANSLATION MISSING
You can connect with a remote interface, see
-https://weechat.org/about/interfaces/[this page ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[this page ^↗^^].
[IMPORTANT]
このプロトコルを使った場合 WeeChat から他の WeeChat に接続することはできません。
=== WebSocket
Relay プラグインはすべてのプロトコルに対して WebSocket プロトコル
-(https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^,window=_blank]) をサポートします。
+(https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^^]) をサポートします。
WebSocket ハンドシェイクは自動的に検知され、ハンドシェイク中に必要なヘッダが見つかり
origin が許可されていれば WebSocket 用のソケットが準備されます (オプション
トリガを使うにはシグナル、修飾子、...
がどのように動いているかを知らなければいけません。これを知るには
-link:weechat_plugin_api.ja.html#hooks[WeeChat プラグイン API リファレンス / フック ^↗^,window=_blank]を読むことをお勧めします。
+link:weechat_plugin_api.ja.html#hooks[WeeChat プラグイン API リファレンス / フック ^↗^^]を読むことをお勧めします。
[[trigger_default]]
=== デフォルトトリガ
| hook | `+signal+`、`+hsignal+`、`+modifier+`、`+line+`, `+print+`、`+command+`、
`+command_run+`、`+timer+`、`+config+`、`+focus+`、`+info+`、`+info_hashtable+`
| トリガの中で使われるフック。より詳しい情報は
- link:weechat_plugin_api.ja.html#hooks[WeeChat プラグイン API リファレンス / フック ^↗^,window=_blank]を参照してください。
+ link:weechat_plugin_api.ja.html#hooks[WeeChat プラグイン API リファレンス / フック ^↗^^]を参照してください。
| arguments | 文字列
| フックに対する引数、指定したフックの型に依存します。
| `+*,irc_in_privmsg+` +
`+*,irc_in_privmsg;*,irc_in_notice+` +
`+signal_sigwinch+`
-| link:weechat_plugin_api.ja.html#_hook_signal[hook_signal ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_signal[hook_signal ^↗^^]
| hsignal
| 1. シグナル名 (優先度の指定も可) (必須) +
2. シグナル名 (優先度の指定も可) +
3. ...
| `+nicklist_nick_added+`
-| link:weechat_plugin_api.ja.html#_hook_hsignal[hook_hsignal ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_hsignal[hook_hsignal ^↗^^]
| modifier
| 1. 修飾子名 (優先度の指定も可) (必須) +
3. ...
| `+weechat_print+` +
`+5000\|input_text_display;5000\|history_add+`
-| link:weechat_plugin_api.ja.html#_hook_modifier[hook_modifier ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_modifier[hook_modifier ^↗^^]
| line
| 1. バッファ型 +
`+*;irc.libera.*+` +
`+*;irc.libera.#weechat+` +
`+formatted;irc.libera.#weechat;irc_notice+`
-| link:weechat_plugin_api.ja.html#_hook_line[hook_line ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_line[hook_line ^↗^^]
| print
| 1. バッファ名 +
`+irc.libera.#weechat+` +
`+irc.libera.#weechat;irc_notice+` +
`+*;;;1+`
-| link:weechat_plugin_api.ja.html#_hook_print[hook_print ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_print[hook_print ^↗^^]
// TRANSLATION MISSING
| command
| `+test+` +
`+5000\|test+` +
`+test;test command;arg1 arg2;arg1: description 1${\n}arg2: description 2+`
-| link:weechat_plugin_api.ja.html#_hook_command[hook_command ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_command[hook_command ^↗^^]
| command_run
| 1. コマンド (優先度の指定も可) (必須) +
2. コマンド (優先度の指定も可) +
3. ...
| `+/cmd arguments+`
-| link:weechat_plugin_api.ja.html#_hook_command_run[hook_command_run ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_command_run[hook_command_run ^↗^^]
| timer
| 1. インターバルするミリ秒数 (必須) +
3. 呼び出し回数の最大値 (デフォルト: 0、「無限に」呼び出すことを意味します)
| `+3600000+` +
`+60000;0;5+`
-| link:weechat_plugin_api.ja.html#_hook_timer[hook_timer ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_timer[hook_timer ^↗^^]
| config
| 1. オプション名 (優先度の指定も可) (必須) +
2. オプション名 (優先度の指定も可) +
3. ...
| `+weechat.look.*+`
-| link:weechat_plugin_api.ja.html#_hook_config[hook_config ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_config[hook_config ^↗^^]
| focus
| 1. エリア名 (優先度の指定も可) (必須) +
2. エリア名 (優先度の指定も可) +
3. ...
| `+buffer_nicklist+`
-| link:weechat_plugin_api.ja.html#_hook_focus[hook_focus ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_focus[hook_focus ^↗^^]
| info
| 1. インフォ名 (優先度の指定も可) (必須) +
2. インフォ名 (優先度の指定も可) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.ja.html#_hook_info[hook_info ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_info[hook_info ^↗^^]
| info_hashtable
| 1. インフォ名 (優先度の指定も可) (必須) +
2. インフォ名 (優先度の指定も可) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.ja.html#_hook_info_hashtable[hook_info_hashtable ^↗^,window=_blank]
+| link:weechat_plugin_api.ja.html#_hook_info_hashtable[hook_info_hashtable ^↗^^]
|===
[[trigger_conditions]]
|===
API を使ったプラグインやスクリプトの開発についてより詳しく学ぶには
-link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス ^↗^,window=_blank]または
-link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド ^↗^,window=_blank]を参照してください。
+link:weechat_plugin_api.ja.html[WeeChat プラグイン API リファレンス ^↗^^]または
+link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド ^↗^^]を参照してください。
[[scripts]]
=== スクリプト
(scheme)、JavaScript、PHP。これらのプラグインでそれぞれの言語で書かれたスクリプトのロード、実行、アンロードができます。
スクリプトの書き方やスクリプト用の WeeChat API についての詳しい情報は
-link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド ^↗^,window=_blank]を参照してください。
+link:weechat_scripting.ja.html[WeeChat スクリプト作成ガイド ^↗^^]を参照してください。
// TRANSLATION MISSING
[[script_manager]]
The script manager (command <<command_script_script,/script>>) is used to
load/unload scripts of any language, and install/remove scripts of WeeChat
scripts repository, which are visible on
-https://weechat.org/scripts/[this page ^↗^,window=_blank].
+https://weechat.org/scripts/[this page ^↗^^].
// TRANSLATION MISSING
For privacy considerations, the download of scripts is disabled by default. +
// TRANSLATION MISSING
For other ways of support, see
-https://weechat.org/about/support/[this page ^↗^,window=_blank].
+https://weechat.org/about/support/[this page ^↗^^].
Ponieważ WeeChat jest bardzo lekki i posiada innowacyjne funkcje.
Więcej informacji na temat WeeChat można znaleźć na
-https://weechat.org/about/features/[tej stronie ^↗^,window=_blank].
+https://weechat.org/about/features/[tej stronie ^↗^^].
[[compilation_install]]
== Kompilacja / instalacja
=== Słyszałem o wielu GUI dla WeeChat. Jak mogę je skompilować/użyć?
Kilka zdalnych GUI jest dostępnych, zajrzyj na stronę poświęconą
-https://weechat.org/about/interfaces/[zdalnym interfejsom ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[zdalnym interfejsom ^↗^^].
[[compile_git]]
=== Nie mogę skompilować WeeChat po sklonowaniu repozytorium git, dlaczego?
WeeChat must be compiled with CMake.
// TRANSLATION MISSING
-Please follow link:weechat_user.en.html#source_package[build instructions ^↗^,window=_blank]
+Please follow link:weechat_user.en.html#source_package[build instructions ^↗^^]
and ensure all required dependencies are installed.
// TRANSLATION MISSING
[[compile_macos]]
=== Jak zainstalować WeeChat na macOS?
-Zaleca się użycie https://brew.sh/[Homebrew ^↗^,window=_blank], pomoc uzyskasz za pomocą komendy:
+Zaleca się użycie https://brew.sh/[Homebrew ^↗^^], pomoc uzyskasz za pomocą komendy:
----
brew info weechat
=== Uruchomiłem WeeChat, ale czuję się zagubiony, co robić?
Dla pomocy wpisz `/help`. Aby uzyskać pomoc dla komendy wpisz `/help komenda`.
-link:weechat_user.pl.html#key_bindings[Keys ^↗^,window=_blank] i
-link:weechat_user.pl.html#commands_and_options[commands ^↗^,window=_blank] są opisane w dokumentacji.
+link:weechat_user.pl.html#key_bindings[Keys ^↗^^] i
+link:weechat_user.pl.html#commands_and_options[commands ^↗^^] są opisane w dokumentacji.
Nowym użytkowniką zaleca się przeczytanie dokumentu
-link:weechat_quickstart.pl.html[Szybki start ^↗^,window=_blank].
+link:weechat_quickstart.pl.html[Szybki start ^↗^^].
[[display]]
== Wyświetlanie
** jeśli korzystasz ze screena, sprawdź czy jest uruchomiony z trybem UTF-8
("`defutf8 on`" w ~/.screenrc lub `screen -U` uruchamiając screena)
* sprawdź czy opcja
- link:weechat_user.pl.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank]
+ link:weechat_user.pl.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^^]
jest wyłączona (ta opcja może powodować błędy wyświetlania)
[NOTE]
naprawiony w glibc 2.22 (może jeszcze nie być dostępny w twojej dystrybucji).
Istnieje sposób na obejście błędu funkcji _wcwidth_:
-https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank].
+https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^^].
-Więcej informacji można znaleźć w tym https://github.com/weechat/weechat/issues/79[zgłoszonym błędzie ^↗^,window=_blank].
+Więcej informacji można znaleźć w tym https://github.com/weechat/weechat/issues/79[zgłoszonym błędzie ^↗^^].
[[bars_background]]
=== Paski jak tytuł i status nie są filtrowane, kolor tła zatrzymuje się po tekście, czemu?
[[buffers_list]]
=== Jak wyświetlić listę z buforami po lewej stronie?
-Wtyczka link:weechat_user.pl.html#buflist[buflist ^↗^,window=_blank]
+Wtyczka link:weechat_user.pl.html#buflist[buflist ^↗^^]
jest domyślnie włączona i załadowana.
Ograniczenie rozmiaru bufora z listą kanałów:
Wtyczka buflist posiada wiele opcji, które można personalizować, zapoznaj się
z opisem dla każdej z nich.
-Jest też dostępna https://github.com/weechat/weechat/wiki/buflist[strona wiki ^↗^,window=_blank]
+Jest też dostępna https://github.com/weechat/weechat/wiki/buflist[strona wiki ^↗^^]
z przykładami zaawansowanej konfiguracji listy buforów.
[[customize_prefix]]
Pozostałe opcje hotlist można zmienić za pomocą opcji __weechat.look.hotlist_*__.
Więcej informacji na temat hotlity można znaleźć w
-link:weechat_user.pl.html#screen_layout[Poradniku użytkownika / Układ ekranu ^↗^,window=_blank].
+link:weechat_user.pl.html#screen_layout[Poradniku użytkownika / Układ ekranu ^↗^^].
[[input_bar_size]]
=== Jak używać linii poleceń z więcej niż jednym wierszem?
dla kolorów za pomocą polecenia `/color`).
Więcej informacji o zarządzaniu kolorami można znaleźć w
-link:weechat_user.pl.html#colors[Poradniku użytkownika / Kolory ^↗^,window=_blank].
+link:weechat_user.pl.html#colors[Poradniku użytkownika / Kolory ^↗^^].
[[search_text]]
=== Jak mogę wyszukać tekst w buforze (jak za pomocą /lastlog w irssi)?
Poruszanie się między podświetleniami: kbd:[Alt+p] / kbd:[Alt+n].
Więcej informacji o skrótach klawiszowych można znaleźć w
-link:weechat_user.pl.html#key_bindings[Poradniku użytkownika / Domyślne skróty klawiszowe ^↗^,window=_blank].
+link:weechat_user.pl.html#key_bindings[Poradniku użytkownika / Domyślne skróty klawiszowe ^↗^^].
[[terminal_focus]]
=== Jak mogę wykonywać komendy, kiedy terminal stanie się/przestanie być aktywny?
----
Listę domyślnych skrótów klawiszowych można znależć w
-link:weechat_user.pl.html#key_bindings[Poradniku uzytkownika / Domyślne skróty klawiszowe ^↗^,window=_blank].
+link:weechat_user.pl.html#key_bindings[Poradniku uzytkownika / Domyślne skróty klawiszowe ^↗^^].
Aby przesjść do bufora o numerze ≥ 100, możesz zdefiniować trigger i następnie użyć
komendy w stylu `/123` żeby przejść do bufora #123:
[[filter_irc_join_part_quit]]
=== How can I filter join/part/quit and other annoying messages on IRC channels?
-See link:weechat_user.pl.html#irc_smart_filter[User's guide / IRC smart filter ^↗^,window=_blank].
+See link:weechat_user.pl.html#irc_smart_filter[User's guide / IRC smart filter ^↗^^].
[[filter_irc_join_channel_messages]]
=== Jak mogę filtrować wyświetlane wiadomości podczas wejścia na kanał IRC?
=== Jak mogę wyłączyć podświetlenia dla konkretnych nicków?
Możesz użyć właściwości bufora
-link:weechat_user.pl.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank],
+link:weechat_user.pl.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^^],
do ustawienia maksymalnego poziomu hotlisty dla niektórych nicków, dla buforów
lub grup buforów (jak serwery IRC).
Zdefiniuj hasło i używaj bezpiecznych danych wszędzie gdzie możesz dla danych wrażliwych
jak hasła: zobacz `/help secure` oraz `/help` na opcjach
(czy możesz użyć bezpiecznych danych, jest to zaznaczone w pomocy).
-Zobacz również link:weechat_user.pl.html#secured_data[Poradniku użytkownika / Zabezpieczone dane ^↗^,window=_blank].
+Zobacz również link:weechat_user.pl.html#secured_data[Poradniku użytkownika / Zabezpieczone dane ^↗^^].
Na przykład:
Niektóre inne pliki mogą zawierać poufne informacje jak hasła (jeśli nie są przetrzymywane
w _sec.conf_ za pomocą komendy `/secure`).
-Przejrzyj link:weechat_user.pl.html#files_and_directories[Poradnik użytkownika / Pliki i foldery ^↗^,window=_blank],
+Przejrzyj link:weechat_user.pl.html#files_and_directories[Poradnik użytkownika / Pliki i foldery ^↗^^],
gdzie znajdziesz więcej informacji o plikach konfiguracyjnych.
[[development]]
[[bug_task_patch]]
=== Jak zgłaszać błędy, prosić o nowe możliwości lub wysyłać patche?
-Zobacz https://weechat.org/about/support/[tą strone ^↗^,window=_blank].
+Zobacz https://weechat.org/about/support/[tą strone ^↗^^].
[[gdb_error_threads]]
=== Kiedy uruchamiam WeeChat pod gdb dostaję komunikat o wątkach, co mogę z tym zrobić?
Jest wiele zadań do zrobienia (testowanie, kod, dokumentacja, ...)
Proszę odezwij się do nas na IRCu albo mailem, zobacz na
-https://weechat.org/about/support/[stronę wsparcia ^↗^,window=_blank].
+https://weechat.org/about/support/[stronę wsparcia ^↗^^].
[[donate]]
=== Czy mogę dać pieniądze albo inne rzeczy deweloperom WeeChat?
Możesz dać nam pieniądze na pomoc w rozwoju.
-Szczegóły można znaleźć na https://weechat.org/donate/[stronie dotacji ^↗^,window=_blank].
+Szczegóły można znaleźć na https://weechat.org/donate/[stronie dotacji ^↗^^].
Więcej informacji można uzyskać wykonując komendę `/help script`.
Listę skryptów możesz zobaczyć w WeeChat za pomocą polecenia `/script`
-lub https://weechat.org/scripts/[na tej stronie ^↗^,window=_blank].
+lub https://weechat.org/scripts/[na tej stronie ^↗^^].
[[more_doc]]
== Więcej dokumentacji
Możesz teraz zacząć używać WeeChat i przeczytać
-https://weechat.org/doc/[FAQ/dokomentacje ^↗^,window=_blank]
+https://weechat.org/doc/[FAQ/dokomentacje ^↗^^]
w razie dalszych pytań.
Miłej pracy z WeeChat!
Ten dokument opisuje klienta rozmów WeeChat, który jest częścią WeeChat.
Najnowszą wersję dokumentacji można znaleźć
-https://weechat.org/doc/[tutaj ^↗^,window=_blank].
+https://weechat.org/doc/[tutaj ^↗^^].
[[introduction]]
== Wprowadzenie
Jeśli coś musi zostać wykonane w tle, można użyć funkcji `+hook_process+`.
Zobacz przykład w rozdziale <<hook_process,Wykonanie procesu w tle>> oraz
dokumentację do funkcji `+hook_process+` w
-link:weechat_plugin_api.en.html#_hook_process[Opisu API wtyczek WeeChat ^↗^,window=_blank] (Angielski).
+link:weechat_plugin_api.en.html#_hook_process[Opisu API wtyczek WeeChat ^↗^^] (Angielski).
[[languages_specificities]]
=== Specyfika języków
WeeChat definiuje moduł `weechat`, który należy zaimportowac poprzez `import weechat`. +
Szkielet API WeeChat dla języka Python dostępny jest w repozytorium:
-https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^,window=_blank].
+https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]]
===== Funkcje
Zalecane jest używanie w zamian modyfikatora `+irc_in2_yyy+`, otrzymany ciąg
jest zawsze poprawnym UTF-8. +
Zobacz funkcję `+hook_modifier+` w
- link:weechat_plugin_api.en.html#_hook_modifier[Opiie API wtyczek WeeChat ^↗^,window=_blank].
+ link:weechat_plugin_api.en.html#_hook_modifier[Opiie API wtyczek WeeChat ^↗^^].
| hook_signal
| xxx,irc_out_yyy +
Zaleca się użycie w zamian sygnału `+xxx,irc_out1_yyy+`,otrzymany ciąg jest
zawsze poprawnym UTF-8. +
Zobacz funkcję `+hook_signal+` w
- link:weechat_plugin_api.en.html#_hook_modifier[Opiie API wtyczek WeeChat ^↗^,window=_blank].
+ link:weechat_plugin_api.en.html#_hook_modifier[Opiie API wtyczek WeeChat ^↗^^].
| hook_process +
hook_process_hashtable
tą wartość w funkcji callback jeśli wartość argumentu to null. Aby zobaczyć które
funlcje akceptują wartości null i przekazują ja do callbacków przejrzyj prototypy
języka Python w
-link:weechat_plugin_api.en.html[Opisie API wtyczek WeeChat ^↗^,window=_blank].
+link:weechat_plugin_api.en.html[Opisie API wtyczek WeeChat ^↗^^].
[[language_guile]]
==== Guile (Scheme)
== Różnice pomiędzy API dla C
API skryptów jest prawie takie same jak API dla wtyczek pisanych w C.
-Możesz zajrzeć do link:weechat_plugin_api.en.html[Opisu API wtyczek WeeChat ^↗^,window=_blank] (Angielski)
+Możesz zajrzeć do link:weechat_plugin_api.en.html[Opisu API wtyczek WeeChat ^↗^^] (Angielski)
po więcej informacji na temat każdej z funkcji API: prototyp, argumenty,
zwracane wartości, przykłady.
== API skryptów
Więcej informacji o funkcjach w API, znajdziesz w
-link:weechat_plugin_api.en.html[Opisu API wtyczek WeeChat ^↗^,window=_blank] (Angielski).
+link:weechat_plugin_api.en.html[Opisu API wtyczek WeeChat ^↗^^] (Angielski).
[[script_api_functions]]
=== Fukcje
Ten rozdział przedstawia część częstych zadań z przykładami.
Użyto tu tylko część rzeczy dostępnych w API, dokładne informacje można znaleźć
-w link:weechat_plugin_api.en.html[Opisu API wtyczek WeeChat ^↗^,window=_blank] (Angielski).
+w link:weechat_plugin_api.en.html[Opisu API wtyczek WeeChat ^↗^^] (Angielski).
[[buffers]]
=== Bufory
[TIP]
Wszystkie dostępne informacje można znaleźć na
-https://weechat.org/dev/info/[tej stronie ^↗^,window=_blank].
+https://weechat.org/dev/info/[tej stronie ^↗^^].
Przykładowy transfer URL z opcją: pobranie najnowszej wersji rozwojowej WeeChat
do pliku _/tmp/weechat-devel.tar.gz_:
Więcej informacji o transferach URL i dostępnych opcjach dla funkcji
`+hook_process+` oraz `+hook_process_hashtable+` można znaleźć w
-link:weechat_plugin_api.en.html#_hook_process[Opisu API wtyczek WeeChat ^↗^,window=_blank] (Angielski).
+link:weechat_plugin_api.en.html#_hook_process[Opisu API wtyczek WeeChat ^↗^^] (Angielski).
[[config_options]]
=== Konfiguracja / opcje
Ten dokument opisuje klienta rozmów WeeChat, będącego częścią WeeChat.
Najnowszą wersję tego dokumentu można znaleźć na
-https://weechat.org/doc/[tej stronie ^↗^,window=_blank].
+https://weechat.org/doc/[tej stronie ^↗^^].
[[introduction]]
== Wprowadzenie
* mały, szybki i lekki
* konfigurowalny i rozszerzalny dzięki wtyczką i skryptom
* zgodny z RFC dla IRC
- https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^,window=_blank] i
- https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^,window=_blank]
+ https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] i
+ https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^]
* proxy IRC i pośrednik dla zdalnych interfejsów
* wielo-platformowy (GNU/Linux, *BSD, macOS, Windows i inne)
* 100% GPL, darmowe oprogramowanie
Listę wszystkich cech i możliwości można znaleźć na
-https://weechat.org/about/features/[tej stronie ^↗^,window=_blank].
+https://weechat.org/about/features/[tej stronie ^↗^^].
[[prerequisites]]
=== Wymagania
* Debiana/Ubuntu (lub dowolna kompatybilna):
`apt-get install weechat-curses weechat-plugins` +
Najnowsze wersje i nocne buildy można znaleźć na stonie:
- https://weechat.org/download/debian/[Repozytoria Debiana ^↗^,window=_blank]
+ https://weechat.org/download/debian/[Repozytoria Debiana ^↗^^]
* Fedora Core: `dnf install weechat`
* FreeBSD: `pkg install weechat`
* Gentoo: `emerge weechat`
`rpm -i /path/to/weechat-x.y.z-1.i386.rpm`
* openSUSE: `zypper in weechat`
* Sourcemage: `cast weechat`
-* macOS (za pomocą https://brew.sh/[Homebrew ^↗^,window=_blank]): `brew install weechat`
+* macOS (za pomocą https://brew.sh/[Homebrew ^↗^^]): `brew install weechat`
(w razie problemów: `brew info weechat`)
Niektóre dodatkowe pakiety mogą okazać się przydatne, jak weechat-plugins.
=== Kontenery
Kontenery z WeeChat mogą być zbudowane lub zainstalowane bezpośrednio
-z https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^,window=_blank]. +
+z https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^^]. +
Więcej informacji można znaleźć w pliku README w repozytorium
-https://github.com/weechat/weechat-container[weechat-container ^↗^,window=_blank].
+https://github.com/weechat/weechat-container[weechat-container ^↗^^].
[[source_package]]
=== Pakiety źródłowe
WeeChat must be built with CMake.
[NOTE]
-Na macOS możesz użyć https://brew.sh/[Homebrew ^↗^,window=_blank]:
+Na macOS możesz użyć https://brew.sh/[Homebrew ^↗^^]:
`brew install --build-from-source weechat`.
[[dependencies]]
| zlib1g-dev |
| Wtyczka logger: kompresja rotowanych plików z logami (gzip). +
- Wtyczka relay: kompresja wiadomości (WeeChat -> klient) za pomocą https://zlib.net/[zlib ^↗^,window=_blank] (protokół weechat). +
+ Wtyczka relay: kompresja wiadomości (WeeChat -> klient) za pomocą https://zlib.net/[zlib ^↗^^] (protokół weechat). +
Wtyczka script: odczyt repozytorium ze skryptami (gzip).
| libzstd-dev | ≥ 0.8.1
| Wtyczka logger: kompresja rotowanych plików z logami. +
- Wtyczka Relay: kompresja wiadomości (WeeChat -> klient) za pomocą https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] (protokół weechat).
+ Wtyczka Relay: kompresja wiadomości (WeeChat -> klient) za pomocą https://facebook.github.io/zstd/[Zstandard ^↗^^] (protokół weechat).
|===
[NOTE]
Na niektórych systemach jak Archlinux pliki te mogą znajdować się w innym katalogu
jak _/var/lib/systemd/coredump_ i należy użyć komendy `coredumpctl` do ich odczytania. +
Więcej informacji można znaleźć na tej
-https://wiki.archlinux.org/title/Core_dump[stronie wiki ^↗^,window=_blank].
+https://wiki.archlinux.org/title/Core_dump[stronie wiki ^↗^^].
Na przykład jeśli _weechat_ jest zainstalowany w _/usr/bin/_ i plik _core_
znajduje się w _/home/user/_, uruchom gdb za pomocą tej komendy:
==== Katalogi XDG
WeeChat domyślnie używa katalogów XDG (zgodnie ze specyfikacją:
-https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^,window=_blank]). +
+https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^^]). +
Pojedynczy katalog może zostać wymuszony przez opcję CMake `WEECHAT_HOME`,
zmienną środowiskową `WEECHAT_HOME` lub parametr z linii polecań `-d` / `--dir`.
==== Informacje o wydaniu
Po aktualizacji *zaleca się* przeczytanie
-https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[informacji o wydaniu ^↗^,window=_blank],
+https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[informacji o wydaniu ^↗^^],
które zawierają ważne informacje o przełomowych zmianach i do zrobienia jakie mogą
być wymagane.
==== Rozwiązywanie problemów
W razie jakichś problemów z kodowaniem, zajrzyj do
-link:weechat_faq.pl.html#charset[WeeChat FAQ / Charset ^↗^,window=_blank].
+link:weechat_faq.pl.html#charset[WeeChat FAQ / Charset ^↗^^].
[[charset_commands]]
==== Komendy
którego nastąpi automatyczne zrotowanie pliku z logiem.
Zrotowany plik z logami może być skompresowany za pomocą gzip lub
-https://facebook.github.io/zstd/[zstd ^↗^,window=_blank].
+https://facebook.github.io/zstd/[zstd ^↗^^].
[NOTE]
Jako że kompresowanie pliku może zająć chwilę jest wykonywane w tle.
[NOTE]
W razie jakichkolwiek problemów z obsługą myszy, zajrzyj do
-link:weechat_faq.pl.html#mouse[WeeChat FAQ / Obsługa myszy ^↗^,window=_blank].
+link:weechat_faq.pl.html#mouse[WeeChat FAQ / Obsługa myszy ^↗^^].
[[mouse_bind_events]]
==== Przypisanie zdarzeń myszy do komend
Domyślnie nie są zdefiniowane żadne serwery. Możesz dodać ich tyle ile chcesz
za pomocą polecenia <<command_irc_server,/server>>.
-Na przykład w celu połączenia się do https://libera.chat/[libera.chat ^↗^,window=_blank]
+Na przykład w celu połączenia się do https://libera.chat/[libera.chat ^↗^^]
używając TLS (szyfrowane połączenie):
----
----
Więcej informacji można znaleźć odwiedzając
-https://www.oftc.net/NickServ/CertFP/[tą stronę ^↗^,window=_blank].
+https://www.oftc.net/NickServ/CertFP/[tą stronę ^↗^^].
[[irc_sasl_authentication]]
==== Uwierzytelnianie SASL
[[irc_tor_sasl]]
==== Połączenie za pomocą Tora i SASL
-Niekróre serwery wspierają połączenia z sieci https://www.torproject.org/[Tor ^↗^,window=_blank],
+Niekróre serwery wspierają połączenia z sieci https://www.torproject.org/[Tor ^↗^^],
sieci wirtualnych tuneli, które umożliwają poprawienie swojej prywatności
i bezpieczeństwa w Internecie.
[[irc_ircv3_support]]
=== Wsparcie dla IRCv3
-WeeChat wspiera następujące https://ircv3.net/irc/[rozszerzenia IRCv3 ^↗^,window=_blank]:
+WeeChat wspiera następujące https://ircv3.net/irc/[rozszerzenia IRCv3 ^↗^^]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
(opcja <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Tabele z porównaniem różnych klientów IRC, także WeeChat, można znaleźć na
-https://ircv3.net/software/clients[tej stronie ^↗^,window=_blank].
+https://ircv3.net/software/clients[tej stronie ^↗^^].
[[irc_ircv3_account_notify]]
==== account-notify
-Specyfikacja: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^^]
Ta właściwość pozwala serwerowi na wysyłanie wiadomości po tym jak użytkownik
zostanie zidentyfikwany lub niezidentyfikowany na serwerze. +
[[irc_ircv3_account_tag]]
==== account-tag
-Specyfikacja: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^^]
Ta właściwość pozwala serwerowi na wysyłanie komend konta jako tagów wiadomości
do komend wysyłanych do klienta. +
[[irc_ircv3_away_notify]]
==== away-notify
-Specyfikacja: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^^]
Ta właściwość pozwala serwerowi na wysyłanie powiadomień o nieobecności do
użytkowników znajdujących się na tych samych kanałach co ty.
[[irc_ircv3_batch]]
==== batch
-Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/batch[batch ^↗^^]
This capability allows the server to send batched events (grouping of several
messages that are related).
[[irc_ircv3_cap_notify]]
==== cap-notify
-Specyfikacja: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^^]
Ta właściwość pozwala serwerowi na ogłaszanie nowych lub usuniętych możliwości
na serwerze (za pomocą komend `CAP NEW` i `CAP DEL`i).
[[irc_ircv3_chghost]]
==== chghost
-Specyfikacja: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/chghost[chghost ^↗^^]
Ta właściwośc pozwala serwerowi na wysyłanie wiadomości, kiedy użytkownik zmienia
nazwę lub hosta. Kiedy opcja <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
[[irc_ircv3_draft_multiline]]
==== draft/multiline
-Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/multiline[multiline ^↗^^]
This capability allows the client and server to send messages with multiple lines,
using the <<irc_ircv3_batch,batch>> capability, that must be enabled as well.
[[irc_ircv3_echo_message]]
==== echo-message
-Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
+Specification: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^^]
This capability forces the server to send PRIVMSG, NOTICE and TAGMSG messages
back to WeeChat.
[[irc_ircv3_extended_join]]
==== extended-join
-Specyfikacja: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^^]
Ta właściwość pozwala serwerowi na wysyłanie konta i prawdziwej nazwy,
kiedy użytkownicy wchodzą na kanały. +
[[irc_ircv3_invite_notify]]
==== invite-notify
-Specyfikacja: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^^]
Ta właściwość pozwala serwerowi na wysyłanie wiadomości zaproszeń, kiedy
użytkownicy są zapraszani na kanały.
[[irc_ircv3_message_tags]]
==== message-tags
-Specyfikacja: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^^]
Ta właściwość pozwala dodawać metdane do wiadomości. +
Tagi te mogą być wyświetlone za pomocą komendy `/debug tags`.
[[irc_ircv3_monitor]]
==== monitor
-Specyfikacja: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/monitor[monitor ^↗^^]
Ta właściwość pozwala serwerowi na wysyłanie powiadomień kiedy klient
stanie się online lub offline. +
[[irc_ircv3_multi_prefix]]
==== multi-prefix
-Specyfikacja: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^^]
Ta właściwość pozwala serwerowi na wysyłanie wszystkich trybów użytkownika
na raz w odpowiedziach na <<command_irc_names,/names>> i <<command_irc_whois,/whois>>. +
[[irc_ircv3_sasl]]
==== SASL
-Specyfikacja: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^^]
Zobacz dedykowany rozdział <<irc_sasl_authentication,autentykacja SASL>>.
[[irc_ircv3_server_time]]
==== server-time
-Specyfikacja: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/server-time[server-time ^↗^^]
Ta właściwość pozwala serwerowi na wysyłanie czasu dla wiadomości w tagach. +
Po otrzymaniu czasu w wiadomości WeeChat używa go do jej wyświetlenia
[[irc_ircv3_setname]]
==== setname
-Specyfikacja: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/setname[setname ^↗^^]
Ta właściwość pozwala zmienić prawdziwą nazwę za pomocą komendy
<<command_irc_setname,/setname>>.
[[irc_ircv3_typing]]
==== typing
-Specyfikacja: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/client-tags/typing[typing ^↗^^]
Zobacz dedykowany rozdział <<typing_notifications,Powiadomienia o pisaniu>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
-Specyfikacja: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^^]
Ta właściwość pozwala serwerowi na wysyłanie nazwy kostów w odpowiedzi na
komendę <<command_irc_names,/names>>.
[[irc_ircv3_whox]]
==== WHOX
-Specyfikacja: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
+Specyfikacja: https://ircv3.net/specs/extensions/whox[WHOX ^↗^^]
Ta właściwość pozwala na zarządanie dodatkowych pól w odpowiedzi na WHO
(przez komendę <<command_irc_who,/who>>). +
serwer posiada włączoną opcję "message-tags" (możesz to sprawdzić komendą
<<command_irc_cap,/cap>>). +
Pod spodem użyty jest tag klienta, zgodnie z
-https://ircv3.net/specs/client-tags/typing[tą specyfikacją ^↗^,window=_blank].
+https://ircv3.net/specs/client-tags/typing[tą specyfikacją ^↗^^].
[[typing_activation]]
=== Aktywacja
* _irc_: pośrednik IRC: używany do dzielenia połączeń z serwerami IRC z jednym
lub wieloma klientami IRC
* _weechat_: protokół używany przez zdalne interfejsy do wyświetlania i interakcji
- z WeeChat, zobacz https://weechat.org/about/interfaces/[tą stronę ^↗^,window=_blank].
+ z WeeChat, zobacz https://weechat.org/about/interfaces/[tą stronę ^↗^^].
[[relay_password]]
=== Hasło
Hasła jednorazowe mogą być generowane między innymi za pomocą:
* FreeOTP:
- https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^,window=_blank]
- (https://freeotp.github.io/[website ^↗^,window=_blank])
+ https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^^],
+ https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^^]
+ (https://freeotp.github.io/[website ^↗^^])
* Google Authenticator:
- https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^,window=_blank]
+ https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^^],
+ https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^^]
Ten sam sekret TOTP musi być utawiony w WeeChat i aplikacji używanej do generowania haseł.
WeeChat.
Możesz się łączyć za pomocą zdalnych interfejsów, więcej na
-https://weechat.org/about/interfaces/[tej stronie ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[tej stronie ^↗^^].
[IMPORTANT]
WeeChat NIE MOŻE się połączyć z innym WeeChat za pomocą tego protokołu.
[[relay_websocket]]
=== WebSocket
-Protokół WebSocket (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^,window=_blank])
+Protokół WebSocket (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^^])
jest wspierany dla wszystkich protokołów.
Żądanie WebSocket jest automatycznie wykrywane i socket staje się gotowy do
Używanie triggerów wymaga znajomości jak działają sygnały, modyfikatory, ... .
Warto rozważyć przeczytanie
-link:weechat_plugin_api.en.html#hooks[Opisu Api wtyczek WeeChat / Hooks ^↗^,window=_blank] (Angielski).
+link:weechat_plugin_api.en.html#hooks[Opisu Api wtyczek WeeChat / Hooks ^↗^^] (Angielski).
[[trigger_default]]
=== Domyślne triggery
| hook | `+signal+`, `+hsignal+`, `+modifier+`, `+line+`, `+print+`, `+command+`,
`+command_run+`, `+timer+`, `+config+`, `+focus+`, `+info+`, `+info_hashtable+`
| Zdarzenia używane przez trigger. Więcej informacji można znaleźć w
- link:weechat_plugin_api.en.html#hooks[WeeChat Plugin API Reference / Hooks ^↗^,window=_blank] (Angielski).
+ link:weechat_plugin_api.en.html#hooks[WeeChat Plugin API Reference / Hooks ^↗^^] (Angielski).
| arguments | string
| Argumenty dla zdarzenia, zależą od jego typu.
| `+*,irc_in_privmsg+` +
`+*,irc_in_privmsg;*,irc_in_notice+` +
`+signal_sigwinch+`
-| link:weechat_plugin_api.en.html#_hook_signal[hook_signal ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_signal[hook_signal ^↗^^] +
(Angielski)
| hsignal
2. nazwa sygnału (dozwolony priorytet) +
3. ...
| `+nicklist_nick_added+`
-| link:weechat_plugin_api.en.html#_hook_hsignal[hook_hsignal ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_hsignal[hook_hsignal ^↗^^] +
(Angielski)
| modifier
3. ...
| `+weechat_print+` +
`+5000\|input_text_display;5000\|history_add+`
-| link:weechat_plugin_api.en.html#_hook_modifier[hook_modifier ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_modifier[hook_modifier ^↗^^] +
(Angielski)
| line
`+*;irc.libera.*+` +
`+*;irc.libera.#weechat+` +
`+formatted;irc.libera.#weechat;irc_notice+`
-| link:weechat_plugin_api.en.html#_hook_line[hook_line ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_line[hook_line ^↗^^] +
(Angielski)
| print
`+irc.libera.#weechat+` +
`+irc.libera.#weechat;irc_notice+` +
`+*;;;1+`
-| link:weechat_plugin_api.en.html#_hook_print[hook_print ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_print[hook_print ^↗^^] +
(Angielski)
| command
| `+test+` +
`+5000\|test+` +
`+test;test command;arg1 arg2;arg1: description 1${\n}arg2: description 2+`
-| link:weechat_plugin_api.en.html#_hook_command[hook_command ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_command[hook_command ^↗^^] +
(Angielski)
| command_run
2. komenda (dozwolony priorytet) +
3. ...
| `+/cmd argumenty+`
-| link:weechat_plugin_api.en.html#_hook_command_run[hook_command_run ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_command_run[hook_command_run ^↗^^] +
(Angielski)
| timer
3. maksymalna ilość wywołań (domyślnie: 0, co oznacza "brak końca")
| `+3600000+` +
`+60000;0;5+`
-| link:weechat_plugin_api.en.html#_hook_timer[hook_timer ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_timer[hook_timer ^↗^^] +
(Angielski)
| config
2. nazwa opcji (dozwolony priorytet) +
3. ...
| `+weechat.look.*+`
-| link:weechat_plugin_api.en.html#_hook_config[hook_config ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_config[hook_config ^↗^^] +
(Angielski)
| focus
2. nazwa obszaru (dozwolony priorytet) +
3. ...
| `+buffer_nicklist+`
-| link:weechat_plugin_api.en.html#_hook_focus[hook_focus ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_focus[hook_focus ^↗^^] +
(Angielski)
| info
2. info name (dozwolony priorytet) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.en.html#_hook_info[hook_info ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_info[hook_info ^↗^^] +
(Angielski)
| info_hashtable
2. info name (dozwolony priorytet) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.en.html#_hook_info_hashtable[hook_info_hashtable ^↗^,window=_blank] +
+| link:weechat_plugin_api.en.html#_hook_info_hashtable[hook_info_hashtable ^↗^^] +
(Angielski)
|===
|===
Więcej informacji o wtyczkach i tworzeniu skryptów (przez API), można znaleźć w
-link:weechat_plugin_api.en.html[Opisie API wtyczek ^↗^,window=_blank] (Angielski) i
-link:weechat_scripting.pl.html[Poradniku pisania skryptów ^↗^,window=_blank].
+link:weechat_plugin_api.en.html[Opisie API wtyczek ^↗^^] (Angielski) i
+link:weechat_scripting.pl.html[Poradniku pisania skryptów ^↗^^].
[[scripts]]
=== Skryptowe
Wtyczki te potrafią ładować, wykonywać i wyładowywać skrypty w tych językach.
Więcej informacji o tym jak pisać skrypty lub o API WeeChat dla skryptów można
-znaleźć w link:weechat_scripting.pl.html[Poradniku pisania skryptów ^↗^,window=_blank].
+znaleźć w link:weechat_scripting.pl.html[Poradniku pisania skryptów ^↗^^].
[[script_manager]]
==== Manager skryptów
Manager skryptów (komenda <<command_script_script,/script>>) jest używany
do ładowania/wyładowania skryptów w dowolnym języku, oraz do
instalowania/usuwania skryptów z repozytorium skryptów WeeChat, które można
-znależć na https://weechat.org/scripts/[tej stronie ^↗^,window=_blank].
+znależć na https://weechat.org/scripts/[tej stronie ^↗^^].
W trosce o prywatność pobieranie skryptów jest domyślnie wyłąćzone. +
Żeby je włączyć, wpisz poniższe polecenie:
** _#weechat-fi_ (Fiński)
Inne opcje uzyskania wsparcia można znaleźć na
-https://weechat.org/about/support/[tej stronie ^↗^,window=_blank].
+https://weechat.org/about/support/[tej stronie ^↗^^].
// TRANSLATION MISSING
A list of scripts is available in WeeChat with `/script` or on
-https://weechat.org/scripts/[this page ^↗^,window=_blank].
+https://weechat.org/scripts/[this page ^↗^^].
[[more_doc]]
== Документация для дальнейшего чтения
// TRANSLATION MISSING
You can now use WeeChat and read
-https://weechat.org/doc/[FAQ/documentation ^↗^,window=_blank]
+https://weechat.org/doc/[FAQ/documentation ^↗^^]
for any other questions.
Приятной работы с WeeChat!
Ово упутство описује WeeChat чет клијент и део је програма WeeChat.
Последња верзија овог документа може да се пронађе на
-https://weechat.org/doc/[овој страници ^↗^,window=_blank].
+https://weechat.org/doc/[овој страници ^↗^^].
[[introduction]]
== Увод
== Репозиторијуми
WeeChat репозиторијуми се налазе на GitHub организацији
-https://github.com/weechat[weechat ^↗^,window=_blank].
+https://github.com/weechat[weechat ^↗^^].
Листа репозиторијума:
_званичне_ скрипте које су предате на weechat.org
weechat.org::
- изворни кôд https://weechat.org/[WeeChat вебсајта ^↗^,window=_blank]
+ изворни кôд https://weechat.org/[WeeChat вебсајта ^↗^^]
weercd::
IRC сервер за тестирање
| docinfo.html | Asciidoctor стил.
| XX/ | Документација за језик XX (језици: en, fr, de, it, ...).
| weechat.1.XX.adoc | Man страница(`man weechat`).
-| weechat_dev.XX.adoc | link:weechat_dev.sr.html[Водич за програмере ^↗^,window=_blank] (овај документ).
-| weechat_faq.XX.adoc | link:weechat_faq.sr.html[ЧПП ^↗^,window=_blank].
-| weechat_plugin_api.XX.adoc | link:weechat_plugin_api.sr.html[Референца за API додатака ^↗^,window=_blank].
-| weechat_quickstart.XX.adoc | link:weechat_quickstart.sr.html[Водич за брзи почетак ^↗^,window=_blank].
-| weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.sr.html[Релеј протокол ^↗^,window=_blank] (за удаљене интерфејсе).
-| weechat_scripting.XX.adoc | link:weechat_scripting.sr.html[Водич за скриптовање ^↗^,window=_blank].
-| weechat_user.XX.adoc | link:weechat_user.sr.html[Корисничко упутство ^↗^,window=_blank].
+| weechat_dev.XX.adoc | link:weechat_dev.sr.html[Водич за програмере ^↗^^] (овај документ).
+| weechat_faq.XX.adoc | link:weechat_faq.sr.html[ЧПП ^↗^^].
+| weechat_plugin_api.XX.adoc | link:weechat_plugin_api.sr.html[Референца за API додатака ^↗^^].
+| weechat_quickstart.XX.adoc | link:weechat_quickstart.sr.html[Водич за брзи почетак ^↗^^].
+| weechat_relay_protocol.XX.adoc | link:weechat_relay_protocol.sr.html[Релеј протокол ^↗^^] (за удаљене интерфејсе).
+| weechat_scripting.XX.adoc | link:weechat_scripting.sr.html[Водич за скриптовање ^↗^^].
+| weechat_user.XX.adoc | link:weechat_user.sr.html[Корисничко упутство ^↗^^].
| includes/ | Фајлови укључени у документацију.
| cmdline_options.XX.adoc | Опције командне линије (фајл се укључује у man странице и корисничко упутство).
| man.XX.adoc | Део man страница: опције додатака, фајлови и ауторска права.
[[coding_python_style]]
=== Python стил
-Погледајте https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^,window=_blank].
+Погледајте https://www.python.org/dev/peps/pep-0008/[PEP 8 ^↗^^].
[[core_internals]]
== Интерне ствари језгра
[[git_repository]]
=== Git репозиторијум
-Гит репозиторијум се налази на https://github.com/weechat/weechat[GitHub ^↗^,window=_blank].
+Гит репозиторијум се налази на https://github.com/weechat/weechat[GitHub ^↗^^].
Било каква закрпа бага или нова могућност мора да да се уради над мастер граном, пожељно је преко GitHub pull захтева. Закрпа такође може да се пошаље и имејлом (направљена са `git diff` или `git format-patch`).
Затим можете да уређујте .po фајлове (ако можете да преводите на језик).
Када завршите, *морате* да проверите свој фајл са
-https://github.com/flashcode/msgcheck[msgcheck ^↗^,window=_blank]:
+https://github.com/flashcode/msgcheck[msgcheck ^↗^^]:
----
$ msgcheck.py xx.po
Јер WeeChat уопште не оптерећује систем и доноси иновативне могућности.
Више информација у вези са WeeChat је на
-https://weechat.org/about/features/[страници са могућностима ^↗^,window=_blank].
+https://weechat.org/about/features/[страници са могућностима ^↗^^].
[[compilation_install]]
== Компајлирање / инсталација
=== Чуо сам о многим ГКИ за WeeChat. Како да их компајлирам/користим?
Доступни су неки удаљени ГКИ, погледајте
-https://weechat.org/about/interfaces/[страницу са удаљеним ГКИ ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[страницу са удаљеним ГКИ ^↗^^].
[[compile_git]]
=== Након клонирања git репозиторијума не могу да компајлирам програм WeeChat, зашто?
WeeChat мора да се компајлира са CMake.
-Молимо да пратите link:weechat_user.en.html#source_package[инструкције за изградњу ^↗^,window=_blank]
+Молимо да пратите link:weechat_user.en.html#source_package[инструкције за изградњу ^↗^^]
и обезбедите да су све неопходне зависности инсталиране.
Ако и даље имате проблема, молимо вас да их пријавите програмерима.
[[compile_macos]]
=== Како да инсталирам програм WeeChat на macOS систем?
-Препоручује се употребите https://brew.sh/[Homebrew ^↗^,window=_blank], помоћ можете добити са:
+Препоручује се употребите https://brew.sh/[Homebrew ^↗^^], помоћ можете добити са:
----
brew info weechat
[[lost]]
=== Покренуо сам програм WeeChat, али не знам шта даље?
-За помоћ можете да откуцате `/help`. За помоћ у вези команде, откуцајте `/help команда`. link:weechat_user.sr.html#key_bindings[Тастери ^↗^,window=_blank] и link:weechat_user.sr.html#commands_and_options[команде ^↗^,window=_blank] су наведени у документацији.
+За помоћ можете да откуцате `/help`. За помоћ у вези команде, откуцајте `/help команда`. link:weechat_user.sr.html#key_bindings[Тастери ^↗^^] и link:weechat_user.sr.html#commands_and_options[команде ^↗^^] су наведени у документацији.
-Препоручује се да нови корисници прочитају link:weechat_quickstart.sr.html[Водич за брзи почетак ^↗^,window=_blank].
+Препоручује се да нови корисници прочитају link:weechat_quickstart.sr.html[Водич за брзи почетак ^↗^^].
[[display]]
== Приказ
* Ако користите UTF-8 локале:
** Проверите да ли ваш терминал подржава UTF-8 (препоручени терминал за UTF-8 је rxvt-unicode).
** Ако користите screen, проверите да се извршава у UTF-8 режиму („`defutf8 on`” у ~/.screenrc или покрените screen са `screen -U`).
-* Проверите да је опција link:weechat_user.sr.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^,window=_blank] искључена (ова опција може да изазове багове у приказу).
+* Проверите да је опција link:weechat_user.sr.html#option_weechat.look.eat_newline_glitch[_weechat.look.eat_newline_glitch_ ^↗^^] искључена (ова опција може да изазове багове у приказу).
[NOTE]
За програм WeeChat се препоручује UTF-8 локале. Ако користите ISO или неки други локале, молимо вас да проверите ли су *сва* ваша подешавања (терминал, screen, ...) ISO, а *не* UTF-8.
Узрок овом проблему може бити libc баг у функцији _wcwidth_, који би требало да је исправљен у glibc 2.22 (можда још увек није доступна у вашој дистрибуцији).
-Постоји решење да се користи исправљена _wcwidth_ функција: https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^,window=_blank].
+Постоји решење да се користи исправљена _wcwidth_ функција: https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat[https://blog.nytsoi.net/2015/05/04/emoji-support-for-weechat ^↗^^].
-За више информација, погледајте овај https://github.com/weechat/weechat/issues/79[извештај о багу ^↗^,window=_blank].
+За више информација, погледајте овај https://github.com/weechat/weechat/issues/79[извештај о багу ^↗^^].
[[bars_background]]
=== Траке као што су насловна и статусна нису испуњене, боја позадине се прекида након текста, зашто?
[[buffers_list]]
=== Како да се са леве стране прикаже листа бафера?
-Додатак link:weechat_user.sr.html#buflist[buflist ^↗^,window=_blank]
+Додатак link:weechat_user.sr.html#buflist[buflist ^↗^^]
је подразумевано учитан и укључен.
Ако желите да ограничите величину траке:
Додатак buflist обезбеђује доста опција које можете да прилагодите својим потребама, молимо вас да прочитате помоћ у вези сваке опције.
-Такође постоји и https://github.com/weechat/weechat/wiki/buflist[вики страница ^↗^,window=_blank]
+Такође постоји и https://github.com/weechat/weechat/wiki/buflist[вики страница ^↗^^]
са примерима напредне конфигурације додатка buflist.
[[customize_prefix]]
Ове боје могу да се промене опцијама __weechat.color.status_data_*__ (бафери) и __weechat.color.status_count_*__ (бројачи). +
Остале опције вруће листе могу да се промене опцијама __weechat.look.hotlist_*__.
-За више информација у вези вруће листе, погледајте link:weechat_user.sr.html#screen_layout[Корисничко упутство / Распоред екрана ^↗^,window=_blank].
+За више информација у вези вруће листе, погледајте link:weechat_user.sr.html#screen_layout[Корисничко упутство / Распоред екрана ^↗^^].
[[input_bar_size]]
=== Како се користи командна линија са више од једне линије?
У опцијама можете да користите било који број боје (није обавезно: командом `/color` можете да додате
алијасе боја).
-За више информација у вези управљања бојама, молимо вас да прочитате link:weechat_user.sr.html#colors[Корисничко упутство / Боје ^↗^,window=_blank].
+За више информација у вези управљања бојама, молимо вас да прочитате link:weechat_user.sr.html#colors[Корисничко упутство / Боје ^↗^^].
[[search_text]]
=== Како могу да претражујем текст у баферу (као /lastlog у програму irssi)?
Подразумевани тастер је kbd:[Ctrl+r] (команда је: `+/input овде_текст_претраге+`). И скок на истицања: kbd:[Alt+p] / kbd:[Alt+n].
-За више о овој могућности, погледајте link:weechat_user.sr.html#key_bindings[Корисничко упутство / Тастерске пречице ^↗^,window=_blank].
+За више о овој могућности, погледајте link:weechat_user.sr.html#key_bindings[Корисничко упутство / Тастерске пречице ^↗^^].
[[terminal_focus]]
=== Како могу да извршим команде када терминал добије/изгуби фокус?
/key bind meta-q /buffer *11
----
-Листа подразумеваних тастера је у link:weechat_user.sr.html#key_bindings[Корисничко упутство / Тастерске пречице ^↗^,window=_blank].
+Листа подразумеваних тастера је у link:weechat_user.sr.html#key_bindings[Корисничко упутство / Тастерске пречице ^↗^^].
Ако желите да скочите на бафере са бројем ≥ 100, можете да дефинишете окидач па да онда користите команде као што је `/123` за скок на бафер #123:
[[filter_irc_join_part_quit]]
=== Како на IRC каналима могу да филтрирам join/part/quit и остале досадне поруке?
-Погледајте link:weechat_user.sr.html#irc_smart_filter[Корисничко упутство / IRC паметни филтер ^↗^,window=_blank].
+Погледајте link:weechat_user.sr.html#irc_smart_filter[Корисничко упутство / IRC паметни филтер ^↗^^].
[[filter_irc_join_channel_messages]]
=== Како да филтрирам неке поруке које се приказују када приступим IRC каналу?
=== Како могу да искључим истицање за одређене надимке?
Бафер особину
-link:weechat_user.sr.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^,window=_blank]
+link:weechat_user.sr.html#max_hotlist_level_nicks[hotlist_max_level_nicks_add ^↗^^]
можете користити да за неке надимке подесите максимални ниво вруће листе, по баферу, или по
групи бафера (као на пример IRC сервери).
/set weechat.plugin.autoload "*,!xfer"
----
-Дефинишите тајну реченицу и где год можете користите обезбеђене податке за осетљиве ствари као што су лозинке: погледајте `/help secure` и `/help` за опције (ако можете да користите обезбеђене податке, написано је у помоћи). Погледајте такође link:weechat_user.sr.html#secured_data[Корисничко упутство / Обезбеђени подаци ^↗^,window=_blank].
+Дефинишите тајну реченицу и где год можете користите обезбеђене податке за осетљиве ствари као што су лозинке: погледајте `/help secure` и `/help` за опције (ако можете да користите обезбеђене податке, написано је у помоћи). Погледајте такође link:weechat_user.sr.html#secured_data[Корисничко упутство / Обезбеђени подаци ^↗^^].
На пример:
И неки други фајлови могу да садрже осетљиве осетљиве информације као што су лозинке (у случају да нису сачуване у _sec.conf_ командом `/secure`).
-Погледајте link:weechat_user.sr.html#files_and_directories[Корисничко упутство / Фајлови и директоријуми ^↗^,window=_blank] за више информација о конфигурационим фајловима.
+Погледајте link:weechat_user.sr.html#files_and_directories[Корисничко упутство / Фајлови и директоријуми ^↗^^] за више информација о конфигурационим фајловима.
[[development]]
== Развој
[[bug_task_patch]]
=== Како би требало да пријавим багове, тражим нове могућности, или пошаљем закрпе?
-Погледајте https://weechat.org/about/support/[ови страницу ^↗^,window=_blank].
+Погледајте https://weechat.org/about/support/[ови страницу ^↗^^].
[[gdb_error_threads]]
=== Када програм WeeChat покренем под gdb, појави се грешка везана за нити, шта могу да урадим?
Постоји много задатака који могу да се ураде (тестирање, програмирање, документација, итд.)
Молимо вас да нас контактирате преко IRC или мејла, погледајте
-https://weechat.org/about/support/[страницу подршке ^↗^,window=_blank].
+https://weechat.org/about/support/[страницу подршке ^↗^^].
[[donate]]
=== Могу ли програмерима програма WeeChat да дам новац или нешто друго?
Можете нам послати новац и помогнете развој програма.
-Детаљи се налазе на https://weechat.org/donate/[страници донација ^↗^,window=_blank].
+Детаљи се налазе на https://weechat.org/donate/[страници донација ^↗^^].
Ово упутство описује WeeChat чет клијент и део је програма WeeChat.
Последња верзија овог документа се налази на
-https://weechat.org/doc/[овој страници ^↗^,window=_blank].
+https://weechat.org/doc/[овој страници ^↗^^].
[[introduction]]
== Увод
Регистрација скрипте.
-За више информација, погледајте link:weechat_plugin_api.sr.html[WeeChat водич за скриптовање ^↗^,window=_blank].
+За више информација, погледајте link:weechat_plugin_api.sr.html[WeeChat водич за скриптовање ^↗^^].
Скрипта (Python):
Ова функција је C конверзија Python класе "shlex" (фајл: Lib/shlex.py у
Python репозиторијуму), погледајте
-https://docs.python.org/3/library/shlex.html[ову страницу ^↗^,window=_blank].
+https://docs.python.org/3/library/shlex.html[ову страницу ^↗^^].
Прототип:
изузетак следећих карактера који у програму WeeChat имају посебну улогу:
* U+0009 (Табулатор): вредност опције
- link:weechat_user.sr.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^,window=_blank]
+ link:weechat_user.sr.html#option_weechat.look.tab_width[weechat.look.tab_width ^↗^^]
* U+0001 (1) до U+001F (31), осим U+0009 (Табулатор): 1
* U+00AD (173, мека цртица): -1
* U+200B (8203, размак нулте ширине): -1
----
[NOTE]
-У језику Ruby, 3 функције повратног позива + подаци (6 стрингова) морају да се наведу у низу од 6 стрингова (услед Ruby ограничења од 15 аргумената по функцији), за више информација, погледајте link:++weechat_scripting.sr.html#_ruby++[WeeChat водич за скриптовање ^↗^,window=_blank] _(исправљено у верзији 0.4.1)_.
+У језику Ruby, 3 функције повратног позива + подаци (6 стрингова) морају да се наведу у низу од 6 стрингова (услед Ruby ограничења од 15 аргумената по функцији), за више информација, погледајте link:++weechat_scripting.sr.html#_ruby++[WeeChat водич за скриптовање ^↗^^] _(исправљено у верзији 0.4.1)_.
==== config_search_option
* _tags_: листа ознака раздвојених запетама (NULL значи да нема ознака)
* _message_: порука која треба да се прикаже
-За листу ознака које се уобичјаено користе у програму WeeChat, погледајте link:weechat_user.sr.html#lines_tags[Корисничко упутство / Ознаке линија ^↗^,window=_blank].
+За листу ознака које се уобичјаено користе у програму WeeChat, погледајте link:weechat_user.sr.html#lines_tags[Корисничко упутство / Ознаке линија ^↗^^].
C пример:
[TIP]
Ако желите да добијете информације у вези са WeeChat (као што је текућа стабилна верзија,
последњи гит комит, итд.), можете да употребите URL адресе на
-https://weechat.org/dev/info/[овој страници ^↗^,window=_blank].
+https://weechat.org/dev/info/[овој страници ^↗^^].
[NOTE]
Величина бафера за слање података је 64KB (постоји 2 бафера: један за stdout и једна за stderr). Ако је излаз из дете процеса (stdout или stderr) дужи од 64KB, функција повратног позива ће се позивати више пута.
| -
| Било који стринг.
| Стринг са означеном вредности IRC ознаке,
- погледајте https://ircv3.net/specs/extensions/message-tags#escaping-values[ову страницу ^↗^,window=_blank].
+ погледајте https://ircv3.net/specs/extensions/message-tags#escaping-values[ову страницу ^↗^^].
| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value | 3.3
| -
| Било који стринг.
| Стринг са неозначеном вредности IRC ознаке,
- погледајте https://ircv3.net/specs/extensions/message-tags#escaping-values[ову страницу ^↗^,window=_blank].
+ погледајте https://ircv3.net/specs/extensions/message-tags#escaping-values[ову страницу ^↗^^].
| [[hook_modifier_color_decode_ansi]] color_decode_ansi | 1.0
| "1" да се боје задрже, "0" да се боје уклоне
** _active_: трака се приказује само у активном прозору
** _inactive_: трака се приказује само у неактивним прозорима
** _nicklist_: трака се приказује у прозорима са листом надимака
-** израчунати услови: погледајте link:weechat_user.sr.html#bar_conditions[WeeChat Корисничко упутство / Услови трака ^↗^,window=_blank].
+** израчунати услови: погледајте link:weechat_user.sr.html#bar_conditions[WeeChat Корисничко упутство / Услови трака ^↗^^].
* _position_: _top_, _bottom_, _left_ или _right_
* _filling_top_bottom_:
** _horizontal_: ставке се попуњавају хоризонтално (размак након сваке ставке)
----
[NOTE]
-У програму WeeChat верзије ≥ 2.9, у језику Ruby, 4 боје (color_fg, color_delim, color_bg, color_bg_inactive) морају да се наведу у низу од 4 стринга (услед ограничења језика Ruby од 15 аргумената по функцији), за више информација погледајте link:++weechat_scripting.sr.html#_ruby++[WeeChat водич за скриптовање ^↗^,window=_blank].
+У програму WeeChat верзије ≥ 2.9, у језику Ruby, 4 боје (color_fg, color_delim, color_bg, color_bg_inactive) морају да се наведу у низу од 4 стринга (услед ограничења језика Ruby од 15 аргумената по функцији), за више информација погледајте link:++weechat_scripting.sr.html#_ruby++[WeeChat водич за скриптовање ^↗^^].
==== bar_set
----
[NOTE]
-Погледајте link:weechat_scripting.sr.html#irc_message_parse[WeeChat водич за скриптовање / Парсирање поруке ^↗^,window=_blank] за више информација у вези излаза „irc_message_parse”.
+Погледајте link:weechat_scripting.sr.html#irc_message_parse[WeeChat водич за скриптовање / Парсирање поруке ^↗^^] за више информација у вези излаза „irc_message_parse”.
Скрипта (Python):
* _hdata_: показивач на hdata
* _pointer_: показивач на објекат програма WeeChat/додатка
-* _search_: израз који се израчунава, подразумевани показивач у изразу је име hdata (и овај показивач се мења за сваки елемент у листи); за помоћ у вези израза, погледајте link:weechat_user.sr.html#command_weechat_eval[WeeChat корисничко упутство / Команда /eval ^↗^,window=_blank]
+* _search_: израз који се израчунава, подразумевани показивач у изразу је име hdata (и овај показивач се мења за сваки елемент у листи); за помоћ у вези израза, погледајте link:weechat_user.sr.html#command_weechat_eval[WeeChat корисничко упутство / Команда /eval ^↗^^]
* _pointers_: хеш табела за позив функције <<_string_eval_expression,string_eval_expression>>
* _extra_vars_: хеш табела за позив функције <<_string_eval_expression,string_eval_expression>>
* _options_: хеш табела за позив функције <<_string_eval_expression,string_eval_expression>>
За више детаља погледајте `/help script`.
Листа скрипти је доступна у WeeChat са `/script` или на
-https://weechat.org/scripts/[овој страници ^↗^,window=_blank].
+https://weechat.org/scripts/[овој страници ^↗^^].
[[more_doc]]
== Још документације
Сада можете почети да користите WeeChat и ако имате било каквих питања
прочитате
-https://weechat.org/doc/[ЧПП/документацију ^↗^,window=_blank].
+https://weechat.org/doc/[ЧПП/документацију ^↗^^].
Уживајте у коришћењу програма WeeChat!
ако је компресија укључена, поруке од _релеја_ ка клијетну се компресују
у циљу штедње пропусног опсега; дозвољене су следеће вредности:
*** _off_: без компресије (подразумевано ако се опција не наведе)
-*** _zlib_: компресија са https://zlib.net/[zlib ^↗^,window=_blank] _(WeeChat ≥ 0.3.7)_
-*** _zstd_: компресија са https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]: боља
+*** _zlib_: компресија са https://zlib.net/[zlib ^↗^^] _(WeeChat ≥ 0.3.7)_
+*** _zstd_: компресија са https://facebook.github.io/zstd/[Zstandard ^↗^^]: боља
компресија, као и много бржа компресија и декомпресија у односу на _zlib_
_(WeeChat ≥ 3.5)_
* _nonce_: бафер бајтова који не могу да се предвиде, послат као хексадецимална вредност, којом се спречавају replay напади; ако је _password_hash_algo_ хеш алгоритам, клијент мора да израчуна хеш лозинке над овим нонсом, спојено са клијентовим нонсом и корисничком лозинком (_релеј_ нонс + _клијент_ нонс је со која се користи у алгоритму хеширања лозинке)
* _compression_: тип компресије:
** _off_: поруке се не компресују
-** _zlib_: поруке су компресоване са https://zlib.net/[zlib ^↗^,window=_blank]
-** _zstd_: поруке су компресоване са https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]
+** _zlib_: поруке су компресоване са https://zlib.net/[zlib ^↗^^]
+** _zstd_: поруке су компресоване са https://facebook.github.io/zstd/[Zstandard ^↗^^]
[TIP]
У програму WeeChat верзије ≤ 2.8, команда _handshake_ није имплементирана, програм WeeChat једноставно игнорише ову команду, чак и ако се пошаље пре _init_ команде. +
* _дужина_ (неозначени цео број, 4 бајта): број бајтова у целој поруци (заједно са овим пољем)
* _компресија_ (бајт): заставица:
** _0x00_: подаци који следе нису компресовани
-** _0x01_: подаци који следе су компресовани са https://zlib.net/[zlib ^↗^,window=_blank]
-** _0x02_: подаци који следе су компресовани са https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank]
+** _0x01_: подаци који следе су компресовани са https://zlib.net/[zlib ^↗^^]
+** _0x02_: подаци који следе су компресовани са https://facebook.github.io/zstd/[Zstandard ^↗^^]
* _id_ (стринг, 4 бајта + садржај): идентификатор који послао клијент (пре имена команде); може бити и празан (стринг дужине нула и без садржаја) ако у команди није био наведен идентификатор
* _тип_ (3 карактера): тип: 3 слова (погледајте табелу испод)
* _објект_: објекат (погледајте табелу испод)
=== Компресија
Ако заставица _compression_ има вредност 0x01 или 0x02, онда се *сви* подаци након ње
-компресују са https://zlib.net/[zlib ^↗^,window=_blank] или https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank],
+компресују са https://zlib.net/[zlib ^↗^^] или https://facebook.github.io/zstd/[Zstandard ^↗^^],
па стога морају бити некомпресовани пре обраде.
[[message_identifier]]
Ово упутство описује WeeChat чет клијент и део је програма WeeChat.
Последња верзија овог документа се налази на
-https://weechat.org/doc/[овој страници ^↗^,window=_blank].
+https://weechat.org/doc/[овој страници ^↗^^].
[[introduction]]
== Увод
[IMPORTANT]
Скрипта *НИКАДА* не сме да се рачва или да креира нити без употребе одговарајуће API функције, то може да сруши програм WeeChat. +
-Ако нешто мора да се извршава у позадини, употребите функцију `+hook_process+`. Погледајте пример у поглављу <<hook_process,Покретање процеса у позадини>> као и документацију функције `+hook_process+` у link:weechat_plugin_api.sr.html#_hook_process[WeeChat референтном приручнику API додатака ^↗^,window=_blank].
+Ако нешто мора да се извршава у позадини, употребите функцију `+hook_process+`. Погледајте пример у поглављу <<hook_process,Покретање процеса у позадини>> као и документацију функције `+hook_process+` у link:weechat_plugin_api.sr.html#_hook_process[WeeChat референтном приручнику API додатака ^↗^^].
[[languages_specificities]]
=== Језичке специфичности
===== Модул
Програм WeeChat дефинише `weechat` модул који мора да се увезе командом `import weechat`. +
-Python стаб за WeeChat API је соступан у репозиторијуму: https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^,window=_blank].
+Python стаб за WeeChat API је соступан у репозиторијуму: https://raw.githubusercontent.com/weechat/weechat/master/src/plugins/python/weechat.pyi[weechat.pyi ^↗^^].
[[python_functions]]
===== Функције
Препоручује се да се уместо ње користи модификатор `+irc_in2_yyy+`, примљени
стринг је увек валидан UTF-8. +
Погледајте функцију `+hook_modifier+` у
- link:weechat_plugin_api.sr.html#_hook_modifier[WeeChat референтном приручнику API додатака ^↗^,window=_blank].
+ link:weechat_plugin_api.sr.html#_hook_modifier[WeeChat референтном приручнику API додатака ^↗^^].
| hook_signal
| xxx,irc_out_yyy +
Препоручује се да се уместо њега користи сигнал `+xxx,irc_out1_yyy+`, стринг који
се прима је увек валидан UTF-8. +
Погледајте функцију `+hook_signal+` у
- link:weechat_plugin_api.sr.html#_hook_signal[WeeChat референтном приручнику API додатака ^↗^,window=_blank].
+ link:weechat_plugin_api.sr.html#_hook_signal[WeeChat референтном приручнику API додатака ^↗^^].
| hook_process +
hook_process_hashtable
вретиће вам се као вредност аргумента у функцији повратног позива ако је вредност
аргумента null. Да бисте видели које функције прихватају null вредности и
прослеђују null вредности функцијама повратног позива, погледајте Python прототипе
-у link:weechat_plugin_api.en.html[API референтном приручнику WeeChat додатака ^↗^,window=_blank].
+у link:weechat_plugin_api.en.html[API референтном приручнику WeeChat додатака ^↗^^].
[[language_guile]]
==== Guile (Scheme)
[[script_api]]
== API скриптовања
-За више информација о функцијама које постоје у API, молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтни приручник API додатака ^↗^,window=_blank].
+За више информација о функцијама које постоје у API, молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтни приручник API додатака ^↗^^].
[[script_api_functions]]
=== Функције
[[common_tasks]]
== Уобичајени задаци
-Ово поглавље приказује неке уобичајене задатке, уз примере. Овде се користе само делимичне ствари из API, за потпуно упутство, погледајте link:weechat_plugin_api.sr.html[WeeChat референтни приручник API додатака ^↗^,window=_blank].
+Ово поглавље приказује неке уобичајене задатке, уз примере. Овде се користе само делимичне ствари из API, за потпуно упутство, погледајте link:weechat_plugin_api.sr.html[WeeChat референтни приручник API додатака ^↗^^].
[[buffers]]
=== Бафери
[TIP]
Све информације у вези програма WeeChat се налазе на
-https://weechat.org/dev/info/[овој страници ^↗^,window=_blank].
+https://weechat.org/dev/info/[овој страници ^↗^^].
Пример URL преноса са опцијом: преузимање најновијег WeeChat развојног пакета у фајл _/tmp/weechat-devel.tar.gz_:
30 * 1000, "my_process_cb", "")
----
-За више информација у вези URL преноса, као и за доступне опције, погледајте функције `+hook_process+` и `+hook_process_hashtable+` у link:weechat_plugin_api.sr.html#_hook_process[WeeChat референтни приручник API додатака ^↗^,window=_blank].
+За више информација у вези URL преноса, као и за доступне опције, погледајте функције `+hook_process+` и `+hook_process_hashtable+` у link:weechat_plugin_api.sr.html#_hook_process[WeeChat референтни приручник API додатака ^↗^^].
[[config_options]]
=== Конфигурација / опције
Ово упутство описује WeeChat чет клијент и део је програма WeeChat.
Последња верзија овог документа се налази на
-https://weechat.org/doc/[овој страници ^↗^,window=_blank].
+https://weechat.org/doc/[овој страници ^↗^^].
[[introduction]]
== Увод
* мали је, брз и не оптерећује систем
* прилагођавање и проширивање помоћу додатака и скрипти
* сагласност са IRC RFC документима
- https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^,window=_blank],
- https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^,window=_blank] и
- https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^,window=_blank],
+ https://datatracker.ietf.org/doc/html/rfc1459[1459 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2810[2810 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2811[2811 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2812[2812 ^↗^^],
+ https://datatracker.ietf.org/doc/html/rfc2813[2813 ^↗^^] и
+ https://datatracker.ietf.org/doc/html/rfc7194[7194 ^↗^^],
* IRC прокси и релеј за удаљене интерфејсе
* подржавање различитих платформи (GNU/Linux, *BSD, macOS, Windows и остале)
* 100% GPL, слободан софтвер
Листа свих могућности може да се пронађе на
-https://weechat.org/about/features/[овој страници ^↗^,window=_blank].
+https://weechat.org/about/features/[овој страници ^↗^^].
[[prerequisites]]
=== Потребно је да имате
* Cygwin (Windows): изаберите WeeChat пакете у setup.exe
* Debian/Ubuntu (или било која Debian компатибилна дистрибуција): `apt-get install weechat-curses weechat-plugins` +
За најновије верзије и ноћне изградње:
- https://weechat.org/download/debian/[Debian репозиторијуми ^↗^,window=_blank]
+ https://weechat.org/download/debian/[Debian репозиторијуми ^↗^^]
* Fedora Core: `dnf install weechat`
* FreeBSD: `pkg install weechat`
* Gentoo: `emerge weechat`
* Mandriva/RedHat (или било која RPM компатибилна дистрибуција): `rpm -i /путања//до/weechat-x.y.z-1.i386.rpm`
* openSUSE: `zypper in weechat`
* Sourcemage: `cast weechat`
-* macOS (са https://brew.sh/[Homebrew ^↗^,window=_blank]): `brew install weechat`
+* macOS (са https://brew.sh/[Homebrew ^↗^^]): `brew install weechat`
(за помоћ: `brew info weechat`)
Још неки пакети вам могу бити од користи, као што је weechat-plugins.
=== Контејнери
Можете да изградите контејнере са WeeChat или да их инсталирате директно са
-https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^,window=_blank]. +
+https://hub.docker.com/r/weechat/weechat[Docker Hub ^↗^^]. +
За више информација, погледајте README фајл у
-https://github.com/weechat/weechat-container[weechat-container ^↗^,window=_blank]
+https://github.com/weechat/weechat-container[weechat-container ^↗^^]
репозиторијуму.
[[source_package]]
WeeChat мора да се изгради са CMake.
[NOTE]
-На macOS можете да употребите https://brew.sh/[Homebrew ^↗^,window=_blank]: `brew install --build-from-source weechat`.
+На macOS можете да употребите https://brew.sh/[Homebrew ^↗^^]: `brew install --build-from-source weechat`.
[[dependencies]]
==== Зависности
| zlib1g-dev |
| Logger додатак: компресија ротирајућих лог фајлова (gzip). +
- Relay додатак: компресија порука (WeeChat -> клијент) са https://zlib.net/[zlib ^↗^,window=_blank] (weechat протокол). +
+ Relay додатак: компресија порука (WeeChat -> клијент) са https://zlib.net/[zlib ^↗^^] (weechat протокол). +
Script додатак: читање индекс фајла репозиторијума (gzip).
| libzstd-dev | ≥ 0.8.1
| Logger додатак: компресија ротирајућих лог фајлова. +
- Relay додатак: компресија порука (WeeChat -> клијент) са https://facebook.github.io/zstd/[Zstandard ^↗^,window=_blank] (weechat протокол).
+ Relay додатак: компресија порука (WeeChat -> клијент) са https://facebook.github.io/zstd/[Zstandard ^↗^^] (weechat протокол).
|===
[NOTE]
[NOTE]
На неким системима као што је Archlinux, core извештаји могу бити у неком другом директоријуму као што је _/var/lib/systemd/coredump_ и морате да употребите команду `coredumpctl` да их прочитате. +
За више информација, погледајте ову
-https://wiki.archlinux.org/title/Core_dump[вики страницу ^↗^,window=_blank].
+https://wiki.archlinux.org/title/Core_dump[вики страницу ^↗^^].
На пример, ако је _weechat_ инсталиран у _/usr/bin/_ а _core_ фајл се налази у _/home/user/_, онда покрените gdb следећом командом:
[[xdg_directories]]
==== XDG директоријуми
-WeeChat подразумевано користи XDG директоријуме (сагласно са https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^,window=_blank]). +
+WeeChat подразумевано користи XDG директоријуме (сагласно са https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html[XDG Base Directory Specification ^↗^^]). +
Један почетни директоријум за све фајлове може да се форсира CMake опцијом `WEECHAT_HOME`, променљивом окружења `WEECHAT_HOME` или опцијом командне линије `-d` / `--dir`.
Када се не форсира један WeeChat почетни директоријум, користе се XDG директоријуми и постављају се овако:
[[restart_release_notes]]
==== Напомене о издању
-Након ажурирања, *снажно се препоручује* да прочитате https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[напомене о издању ^↗^,window=_blank] које садржи важне информације о променама које прекидају раније понашање програма, као и ручне акције које су због тога можда неопходне.
+Након ажурирања, *снажно се препоручује* да прочитате https://weechat.org/files/doc/weechat/ReleaseNotes-devel.html[напомене о издању ^↗^^] које садржи важне информације о променама које прекидају раније понашање програма, као и ручне акције које су због тога можда неопходне.
Морате прочитати све напомене о издању издате између ваше старе (без ње) и ваше нове верзије (укључујући и њу). +
На пример, ако пређете са верзије 3.0 на 3.2, морате да прочитате напомене о издању за верзије 3.1 и 3.2.
==== Решавање проблема
Ако имате било каквих проблема са скуповима карактера, молимо вас да погледате
-link:weechat_faq.sr.html#charset[WeeChat ЧПП / Скуп карактера ^↗^,window=_blank].
+link:weechat_faq.sr.html#charset[WeeChat ЧПП / Скуп карактера ^↗^^].
[[charset_commands]]
==== Команде
врши се аутоматска ротација лог фајла.
Ротирани лог фајлови могу да се компресују помоћу gzip или
-https://facebook.github.io/zstd/[zstd ^↗^,window=_blank].
+https://facebook.github.io/zstd/[zstd ^↗^^].
[NOTE]
Пошто компресија фајла може да потраје, она се обавља у позадини.
[NOTE]
Ако имате било какав проблем са мишем, молимо вас да погледате
-link:weechat_faq.sr.html#mouse[WeeChat ЧПП / Миш ^↗^,window=_blank].
+link:weechat_faq.sr.html#mouse[WeeChat ЧПП / Миш ^↗^^].
[[mouse_bind_events]]
==== Везивање догађаја миша за команде
Подразумевано није дефинисан ниједан сервер. Командом <<command_irc_server,/server>>
можете додати произвољан број сервера.
-На пример, да бисте се повезали на https://libera.chat/[libera.chat ^↗^,window=_blank]
+На пример, да бисте се повезали на https://libera.chat/[libera.chat ^↗^^]
са TLS (шифровани саобраћај):
----
----
За више информација, молимо вас да погледате
-https://www.oftc.net/NickServ/CertFP/[ову страницу ^↗^,window=_blank].
+https://www.oftc.net/NickServ/CertFP/[ову страницу ^↗^^].
[[irc_sasl_authentication]]
==== SASL аутентификација
[[irc_tor_sasl]]
==== Повезивање преко Tor и SASL
-Неки сервери подржавају и везе са https://www.torproject.org/[Tor ^↗^,window=_blank],
+Неки сервери подржавају и везе са https://www.torproject.org/[Tor ^↗^^],
мрежом виртуелних тунела који омогућавају људима и групама да унапреде своју приватност и безбедност на Интернету.
Најпре морате да инсталирате Tor. За Debian (и изведене из њега):
[[irc_ircv3_support]]
=== IRCv3 подршка
-WeeChat подржава следећа https://ircv3.net/irc/[IRCv3 проширења ^↗^,window=_blank]:
+WeeChat подржава следећа https://ircv3.net/irc/[IRCv3 проширења ^↗^^]:
* <<irc_ircv3_account_notify,account-notify>>
* <<irc_ircv3_account_tag,account-tag>>
опцију <<option_irc.server_default.capabilities,irc.server_default.capabilities>>).
Табеле са поређењем различитих IRC клијената, укључујући и WeeChat, налазе се на
-on https://ircv3.net/software/clients[овој страници ^↗^,window=_blank].
+on https://ircv3.net/software/clients[овој страници ^↗^^].
[[irc_ircv3_account_notify]]
==== account-notify
-Спецификација: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/account-notify[account-notify ^↗^^]
Ова могућност оспособљава сервер да шаље поруке када се корисници идентификују на сервер или
када са сервера уклоне своју идентификацију. +
[[irc_ircv3_account_tag]]
==== account-tag
-Спецификација: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/account-tag[account-tag ^↗^^]
Ова могућност оспособљава сервер да шаље налог као ознаку поруке у командама које шаље клијенту. +
WeeChat парсира ову ознаку у чува је у поруци, али се она не користи нити приказује. Може да се
[[irc_ircv3_away_notify]]
==== away-notify
-Спецификација: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/away-notify[away-notify ^↗^^]
Ово могућност оспособљава сервер да шаље обавештења о одсуству за кориснике на истом каналу
на којем се и ви налазите.
[[irc_ircv3_batch]]
==== batch
-Спецификација: https://ircv3.net/specs/extensions/batch[batch ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/batch[batch ^↗^^]
Ова могућност дозвољава да сервер шаље докађаје у пакету (тј. да групише неколико
порука које су у вези).
[[irc_ircv3_cap_notify]]
==== cap-notify
-Спецификација: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand[cap-notify ^↗^^]
Ово могућност оспособљава сервер да објављује нове или уклоњене могућности сервера
(посредством `CAP NEW` и `CAP DEL` команди).
[[irc_ircv3_chghost]]
==== chghost
-Спецификација: https://ircv3.net/specs/extensions/chghost[chghost ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/chghost[chghost ^↗^^]
Ова могућност оспособљава сервер да шаље поруке када корисници промене име или хост. +
Када је опција <<option_irc.look.smart_filter_chghost,irc.look.smart_filter_chghost>>
[[irc_ircv3_draft_multiline]]
==== draft/multiline
-Спецификација: https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/multiline[multiline ^↗^^]
Ова могућност дозвољава да клијент и сервер шаљу поруке у више линија када се користи
<<irc_ircv3_batch,batch>> могућност, која такође мора да буде укључена.
[[irc_ircv3_echo_message]]
==== echo-message
-Спецификација: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/echo-message[echo-message ^↗^^]
Ова могућност форсира да сервер шаље поруке PRIVMSG, NOTICE и TAGMSG назад програму
WeeChat.
[[irc_ircv3_extended_join]]
==== extended-join
-Спецификација: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/extended-join[extended-join ^↗^^]
Ова могућност оспособљава сервер да шаље налог и право име када корисници приступе
каналима. +
[[irc_ircv3_invite_notify]]
==== invite-notify
-Спецификација: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/invite-notify[invite-notify ^↗^^]
Ова могућност оспособљава сервер да шаље позивне поруке када се корисници позову на канале.
[[irc_ircv3_message_tags]]
==== message-tags
-Спецификација: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/message-tags[message-tags ^↗^^]
Ова могућност оспособљава додавање метаподатака у поруке. +
Ове ознаке могу да се прикажу командом `/debug tags`.
[[irc_ircv3_monitor]]
==== monitor
-Спецификација: https://ircv3.net/specs/extensions/monitor[monitor ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/monitor[monitor ^↗^^]
Ова могућност оспособљава сервер да шаље обавештења када клијенти оду
ван мреже/повежу се на мрежу. +
[[irc_ircv3_multi_prefix]]
==== multi-prefix
-Спецификација: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/multi-prefix[multi-prefix ^↗^^]
Ова могућност оспособљава сервер да шаље све корисничке режиме одједном у
<<command_irc_names,/names>> и <<command_irc_whois,/whois>> одговорима. +
[[irc_ircv3_sasl]]
==== SASL
-Спецификација: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/sasl-3.2[SASL 3.2 ^↗^^]
Погледајте посебно поглавље <<irc_sasl_authentication,SASL аутентификација>>.
[[irc_ircv3_server_time]]
==== server-time
-Спецификација: https://ircv3.net/specs/extensions/server-time[server-time ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/server-time[server-time ^↗^^]
Ова могућност оспособљава сервер да шаље време за поруке као ознаку поруке. +
Када се у поруци прими време, WeeChat то користи у приказу поруке (она тада
[[irc_ircv3_setname]]
==== setname
-Спецификација: https://ircv3.net/specs/extensions/setname[setname ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/setname[setname ^↗^^]
Ова могућност вам нуди опцију да промените своје реално име употребом
<<command_irc_setname,/setname>> команде.
[[irc_ircv3_typing]]
==== typing
-Спецификација: https://ircv3.net/specs/client-tags/typing[typing ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/client-tags/typing[typing ^↗^^]
Погледајте посебно поглавље <<typing_notifications,Обавештења о куцању>>.
[[irc_ircv3_userhost_in_names]]
==== userhost-in-names
-Спецификација: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/userhost-in-names[userhost-in-names ^↗^^]
Ова могућност оспособљава сервер да шаље имена хостова у <<command_irc_names,/names>> одговорима.
[[irc_ircv3_whox]]
==== WHOX
-Спецификација: https://ircv3.net/specs/extensions/whox[WHOX ^↗^,window=_blank]
+Спецификација: https://ircv3.net/specs/extensions/whox[WHOX ^↗^^]
Ова могућност вас оспособљава да у WHO одговору захтевате додатна поља
(помоћу команде <<command_irc_who,/who>>). +
Користи га IRC додатак на баферима канала и на приватним баферима када је укључена
„message-tags” могућност (што можете да проверите командом <<command_irc_cap,/cap>>). +
Под хаубом, користи се клијентска ознака о куцању, у складу са
-https://ircv3.net/specs/client-tags/typing[овом спецификацијом ^↗^,window=_blank].
+https://ircv3.net/specs/client-tags/typing[овом спецификацијом ^↗^^].
[[typing_activation]]
=== Активација
* _irc_: IRC прокси: користи се за дељење веза са IRC серверима са једним или више других клијената
* _weechat_: протокол који користе удаљени интерфејси да прикажу и омогуће интеракцију са програмом
- WeeChat, погледајте https://weechat.org/about/interfaces/[ову страницу ^↗^,window=_blank].
+ WeeChat, погледајте https://weechat.org/about/interfaces/[ову страницу ^↗^^].
[[relay_password]]
=== Лозинка
једнократне лозинке могу да се генеришу апликацијама, на пример:
* FreeOTP:
- https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^,window=_blank]
- (https://freeotp.github.io/[вебсајт ^↗^,window=_blank])
-* Google Authenticator: https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^,window=_blank],
- https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^,window=_blank]
+ https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp[Android ^↗^^],
+ https://apps.apple.com/fr/app/freeotp-authenticator/id872559395[iOS ^↗^^]
+ (https://freeotp.github.io/[вебсајт ^↗^^])
+* Google Authenticator: https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2[Android ^↗^^],
+ https://apps.apple.com/fr/app/google-authenticator/id388497605[iOS ^↗^^]
TOTP тајна мора да се постави у програму WeeChat и у апликацији која се користи за генерисање једнократних лозинки.
Релеј додатак може да шаље податке удаљеном интерфејсу користећи WeeChat протокол.
Можете да се повежете са удаљеним интерфејсом, погледајте
-https://weechat.org/about/interfaces/[ову страницу ^↗^,window=_blank].
+https://weechat.org/about/interfaces/[ову страницу ^↗^^].
[IMPORTANT]
Сам програм WeeChat НЕ може да се повеже на други програм WeeChat преко овог протокола.
[[relay_websocket]]
=== ВебСокет
-Релеј додатак подржава ВебСокет протокол (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^,window=_blank])
+Релеј додатак подржава ВебСокет протокол (https://datatracker.ietf.org/doc/html/rfc6455[RFC 6455 ^↗^^])
за све протоколе.
ВебСокет руковање се аутоматски детектује и ако се у руковању пронађу одговарајућа заглавља и ако је порекло дозвољено (погледајте опцију <<option_relay.network.websocket_allowed_origins,relay.network.websocket_allowed_origins>>), сокет постаје спреман за WebSocket.
Окидач је Швајцарски војни нож програма WeeChat: може да ухвати многе ствари (сигнал, модификатор, испис, итд.), измени садржај података, и изврши једну или више команди. Ако желите да спречите покретање окидача у неким околностима, можете употребити услов.
За коришћење окидача је неопходно познавање начина на који функционишу сигнали, модификатори, ... Стога је пожељно да прочитате
-link:weechat_plugin_api.sr.html#hooks[WeeChat референтни приручник API додатака / Куке ^↗^,window=_blank].
+link:weechat_plugin_api.sr.html#hooks[WeeChat референтни приручник API додатака / Куке ^↗^^].
[[trigger_default]]
=== Подразумевани окидачи
| hook | `+signal+`, `+hsignal+`, `+modifier+`, `+line+`, `+print+`, `+command+`,
`+command_run+`, `+timer+`, `+config+`, `+focus+`, `+info+`, `+info_hashtable+`
| Кука која се користи у окидачу. За више информација, погледајте
- link:weechat_plugin_api.sr.html#hooks[WeeChat референтни приручник API додатака / Куке ^↗^,window=_blank].
+ link:weechat_plugin_api.sr.html#hooks[WeeChat референтни приручник API додатака / Куке ^↗^^].
| arguments | стринг
| Аргументи за куку, зависе од врсте куке која се користи.
`+*,irc_in_privmsg+` +
`+*,irc_in_privmsg;*,irc_in_notice+` +
`+signal_sigwinch+` |
-link:weechat_plugin_api.sr.html#_hook_signal[hook_signal ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_signal[hook_signal ^↗^^]
| hsignal
| 1. име сигнала (дозвољава се приоритет) (обавезан) +
2. име сигнала (дозвољава се приоритет) +
3. ... |
`+nicklist_nick_added+` |
-link:weechat_plugin_api.sr.html#_hook_hsignal[hook_hsignal ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_hsignal[hook_hsignal ^↗^^]
| modifier
| 1. име модификатора (дозвољава се приоритет) (обавезан) +
3. ... |
`+weechat_print+` +
`+5000\|input_text_display;5000\|history_add+` |
-link:weechat_plugin_api.sr.html#_hook_modifier[hook_modifier ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_modifier[hook_modifier ^↗^^]
| line
| 1. тип бафера +
`+*;irc.libera.*+` +
`+*;irc.libera.#weechat+` +
`+formatted;irc.libera.#weechat;irc_notice+` |
-link:weechat_plugin_api.sr.html#_hook_line[hook_line ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_line[hook_line ^↗^^]
| print
| 1. име бафера +
`+irc.libera.#weechat+` +
`+irc.libera.#weechat;irc_notice+` +
`+*;;;1+` |
-link:weechat_plugin_api.sr.html#_hook_print[hook_print ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_print[hook_print ^↗^^]
| command
| 1. име команде (дозвољава се приоритет) (обавезан) +
`+test+` +
`+5000\|test+` +
`+test;test command;arg1 arg2;arg1: description 1${\n}arg2: description 2+` |
-link:weechat_plugin_api.sr.html#_hook_command[hook_command ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_command[hook_command ^↗^^]
| command_run
| 1. команда (дозвољава се приоритет) (обавезан) +
2. команда (дозвољава се приоритет) +
3. ... |
`+/cmd arguments+` |
-link:weechat_plugin_api.sr.html#_hook_command_run[hook_command_run ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_command_run[hook_command_run ^↗^^]
| timer
| 1. интервал у милисекундама (обавезан) +
3. макс број позива (подразумевано: 0, што значи „нема краја”) |
`+3600000+` +
`+60000;0;5+` |
-link:weechat_plugin_api.sr.html#_hook_timer[hook_timer ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_timer[hook_timer ^↗^^]
| config
| 1. име опције (дозвољава се приоритет) (обавезан) +
2. име опције (дозвољава се приоритет) +
3. ... |
`+weechat.look.*+` |
-link:weechat_plugin_api.sr.html#_hook_config[hook_config ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_config[hook_config ^↗^^]
| focus
| 1. име површине (дозвољава се приоритет) (обавезан) +
2. име површине (дозвољава се приоритет) +
3. ... |
`+buffer_nicklist+` |
-link:weechat_plugin_api.sr.html#_hook_focus[hook_focus ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_focus[hook_focus ^↗^^]
| info
| 1. инфо име (дозвољава се приоритет) (обавезан) +
2. инфо име (дозвољава се приоритет) +
3. ... |
`+my_info+` |
-link:weechat_plugin_api.sr.html#_hook_info[hook_info ^↗^,window=_blank]
+link:weechat_plugin_api.sr.html#_hook_info[hook_info ^↗^^]
| info_hashtable
| 1. инфо име (дозвољава се приоритет) (обавезан) +
2. инфо име (дозвољава се приоритет) +
3. ...
| `+my_info+`
-| link:weechat_plugin_api.sr.html#_hook_info_hashtable[hook_info_hashtable ^↗^,window=_blank]
+| link:weechat_plugin_api.sr.html#_hook_info_hashtable[hook_info_hashtable ^↗^^]
|===
[[trigger_conditions]]
| xfer | Пренос фајлова и директни разговор.
|===
-За више информација о развоју додатака или скрипти (помоћу API), молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтно упутство за API додатака ^↗^,window=_blank] или link:weechat_scripting.sr.html[WeeChat водич за скриптовање ^↗^,window=_blank].
+За више информација о развоју додатака или скрипти (помоћу API), молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтно упутство за API додатака ^↗^^] или link:weechat_scripting.sr.html[WeeChat водич за скриптовање ^↗^^].
[[scripts]]
=== Скрипте
Програм WeeChat нуди 8 додатака за скриптовање: Python, Perl, Ruby, Lua, Tcl, Guile (scheme), JavaScript и PHP. Ови додаци могу да учитају, изврше и уклоне из меморије скрипте за ове језике.
-За више информација о функцијама које постоје у API, молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat водич за скриптовање ^↗^,window=_blank].
+За више информација о функцијама које постоје у API, молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat водич за скриптовање ^↗^^].
[[script_manager]]
==== Менаџер скрипти
Менаџер скрипти (команда <<command_script_script,/script>>) се користи за
учитавање/уклањање из меморије скрипти на било ком језику, и инсталирање/уклањање скрипти са WeeChat
репозиторијум скрипти, а које можете да видите на
-https://weechat.org/scripts/[овој страници ^↗^,window=_blank].
+https://weechat.org/scripts/[овој страници ^↗^^].
Из разлога приватности, преузимање скрипти је подразумевано искључено. +
Ако желите да га укључите, откуцајте следећу команду:
** _#weechat-fi_ (фински)
За сорале начине подршке, погледајте
-https://weechat.org/about/support/[ову страницу ^↗^,window=_blank].
+https://weechat.org/about/support/[ову страницу ^↗^^].
projects / irc / weechat / weechat.git / commitdiff
