summaryrefslogtreecommitdiff
path: root/doc/sr/weechat_user.sr.adoc
diff options
context:
space:
mode:
authorSébastien Helleu <flashcode@flashtux.org>2021-12-05 14:42:58 +0100
committerSébastien Helleu <flashcode@flashtux.org>2021-12-05 20:59:19 +0100
commit66384544b551e5bf61de786590a8dfa7efed53d7 (patch)
treed45ce320a853da909c3172ba6a08ed29ce25e354 /doc/sr/weechat_user.sr.adoc
parentc88428fb416fa1f0477e4a9f2542d06db239a749 (diff)
downloadweechat-66384544b551e5bf61de786590a8dfa7efed53d7.zip
doc: move section "IRC" at top level after "Configuration" (user's guide)
Diffstat (limited to 'doc/sr/weechat_user.sr.adoc')
-rw-r--r--doc/sr/weechat_user.sr.adoc332
1 files changed, 166 insertions, 166 deletions
diff --git a/doc/sr/weechat_user.sr.adoc b/doc/sr/weechat_user.sr.adoc
index 82eeafb4b..df9e6fe7d 100644
--- a/doc/sr/weechat_user.sr.adoc
+++ b/doc/sr/weechat_user.sr.adoc
@@ -213,7 +213,7 @@ $ make install
Компајлира <<scripts_plugins,Guile додатак>> (Scheme).
| ENABLE_IRC | `ON`, `OFF` | ON |
- Компајлира <<irc_plugin,IRC додатак>>.
+ Компајлира <<irc,IRC додатак>>.
| ENABLE_JAVASCRIPT | `ON`, `OFF` | OFF |
Компајлира <<scripts_plugins,JavaScript додатак>>.
@@ -2605,160 +2605,15 @@ include::includes/autogen_user_options.sr.adoc[tag=sec_options]
include::includes/autogen_user_options.sr.adoc[tag=weechat_options]
-[[plugins]]
-== Додаци
-
-Додатак је динамичка библиотека коју учитава програм WeeChat, написана на језику C и компајлирана. На GNU/Linux систему, фајл има „.so” екстензију, а „.dll” на систему Windows.
-
-Додаци се аутоматски учитавају током покретања програма WeeChat, а могу да се учитавају или уклањају из меморије док се програм WeeChat извршава.
-
-Важно је да се направи разлика између _додатка_ и _скрипте_: _додатак_ је бинарни фајл који се компајлира и учитава командом `/plugin`, док је _скрипта_ текст фајл који се учитава додатком као што је _python_ командом `/python`.
-
-За учитавање/уклањање из меморије можете користити команду `/plugin`, или да прикажете листу свих учитаних додатака.
-
-Када се додатак уклони из меморије, програм WeeChat уклања:
-
-* бафере
-* конфигурационе опције (опције се уписују у фајлове)
-* све куке: команде, модификатори, процес, итд.
-* инфо и инфолисте
-* hdata
-* ставке траке
-
-Примери учитавања, уклањања из меморије или приказа листе додатака:
-
-----
-/plugin load irc
-/plugin unload irc
-/plugin list
-----
-
-Ово су подразумевани додаци:
-
-[width="100%", cols="1,5", options="header"]
-|===
-| Додатак | Опис
-| alias | Дефиниција алијаса за команде.
-| buflist | Ставка траке са листом бафера.
-| charset | Декодирање/кодирање у скуп карактера за бафере.
-| exec | Извршавање спољних команди из програма WeeChat.
-| fifo | FIFO пајп који се користи за удаљено слање команди програму WeeChat.
-| fset | Брзо постављање опција програма WeeChat и опција додатака.
-| irc | IRC чет протокол.
-| logger | Логовање бафера у фајлове.
-| relay | Релеј података преко мреже.
-| script | Управљач скриптама.
-| python | Python API .
-| perl | Perl API скриптовања.
-| ruby | Ruby API скриптовања.
-| lua | Lua API скриптовања.
-| tcl | Tcl API скриптовања.
-| guile | Guile (scheme) API скриптовања.
-| javascript | JavaScript API скриптовања.
-| php | PHP API скриптовања.
-| spell | Провера правописа за командну линију.
-| trigger | Замена текста и извршавање команди приликом догађаја које окида програм WeeChat/додаци.
-| typing | Приказује кориснике који тренутно пишу поруке.
-| xfer | Пренос фајлова и директни разговор.
-|===
-
-За више информација о развоју додатака или скрипти (помоћу API), молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтно упутство за API додатака] или link:weechat_scripting.sr.html[WeeChat водич за скриптовање].
-
-[[exec_plugin]]
-=== Exec
-
-Команда `/exec` вам омогућава да извршите спољне команде из програма WeeChat и да локално прикажете њихов излаз, или да га пошаљете у бафер.
-
-[[exec_commands]]
-==== Команде
-
-include::includes/autogen_user_commands.sr.adoc[tag=exec_commands]
-
-[[exec_options]]
-==== Опције
-
-Одељци у фајлу _exec.conf_:
-
-[width="100%", cols="3m,6m,16", options="header"]
-|===
-| Одељак | Команда за контролу | Опис
-| command | /set exec.command.* | Опције за команде.
-| color | /set exec.color.* | Боје.
-|===
-
-Опције:
-
-include::includes/autogen_user_options.sr.adoc[tag=exec_options]
-
-[[fifo_plugin]]
-=== Fifo
-
-Програм WeeChat можете даљински да контролишете слањем команди или текста у FIFO пајп (ако је укључена опција „fifo.file.enabled”, што је подразумевано).
-
-FIFO пајп се налази у WeeChat директоријуму за време извршавања (runtime) и подразумевано се зове _weechat_fifo_12345_ (где је _12345_ id процеса програма WeeChat).
-
-Синтакса за FIFO пајп команде/текст је једно од следећих:
-
-....
- plugin.buffer *овде иде текст или команда
- *овде иде текст или команда
-....
-
-Неки примери:
-
-* Измена надимка на IRC серверу libera на „newnick”:
-
-----
-$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
-----
-
-* Слање поруке на #weechat IRC канал:
-
-----
-$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
-----
-
-* Слање поруке у текући бафер:
-
-----
-$ echo '*здраво!' >/run/user/1000/weechat/weechat_fifo_12345
-----
-
-* Слање две команде за уклањање из меморије/поновно учитавање Python скрипти (морате да их раздвојите са „\n”):
-
-----
-$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
-----
-
-[[fifo_commands]]
-==== Команде
-
-include::includes/autogen_user_commands.sr.adoc[tag=fifo_commands]
-
-[[fifo_options]]
-==== Опције
-
-Одељци у фајлу _fifo.conf_:
-
-[width="100%", cols="3m,6m,16", options="header"]
-|===
-| Одељак | Команда за контролу | Опис
-| file | /set fifo.file.* | Контрола FIFO пајпа.
-|===
-
-Опције:
-
-include::includes/autogen_user_options.sr.adoc[tag=fifo_options]
-
-[[irc_plugin]]
-=== IRC
+[[irc]]
+== IRC
IRC додатак је дизајниран за чет са другим људима преко IRC протокола.
Подржава више сервера и нуди све подржане IRC команде, укључујући DCC чет и пренос фајлова (преко xfer додатка, погледајте <<xfer_plugin,Xfer додатак>>).
[[irc_command_line_options]]
-==== Опције командне линије
+=== Опције командне линије
URL за један или више IRC сервера може да се зада на следећи начин:
@@ -2773,10 +2628,10 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
----
[[irc_servers]]
-==== Сервери
+=== Сервери
[[irc_servers_add]]
-===== Додавање сервера
+==== Додавање сервера
Подразумевано није дефинисан ниједан сервер. Командом <<command_irc_server,/server>>
можете додати произвољан број сервера.
@@ -2816,7 +2671,7 @@ $ weechat irc://alice@irc.libera.chat/#weechat,#weechat-fr
`/set irc.server.libera.command_delay 5`.
[[irc_servers_options]]
-===== Опције сервера
+==== Опције сервера
Опције сервера се називају `irc.server.<сервер>.<опција>` где је `<сервер>` интерно
име сервера, а `<опција>` је име опције. +
@@ -2888,7 +2743,7 @@ irc.server.libera.username string null -> "alice"
----
[[irc_ssl_certificates]]
-===== SSL сертификати
+==== SSL сертификати
Када се са IRC серверима успоставља веза преко SSL, програм WeeChat подразумевано проверава да ли се вези потпуно верује.
@@ -2913,7 +2768,7 @@ irc.server.xxx.ssl_verify::
Опција „ssl_verify” је подразумевано укључена, тако да је верификација стриктна и може да не успе, чак и када је била OK у верзијама пре 0.3.1.
[[irc_connect_oftc_with_certificate]]
-====== Први пример: повезивање на oftc и провера сертификата
+===== Први пример: повезивање на oftc и провера сертификата
* Увоз сертификата у командном окружењу:
@@ -2935,7 +2790,7 @@ $ wget -O ~/.config/weechat/ssl/CAs.pem https://www.spi-inc.org/ca/spi-cacert.cr
----
[[irc_connect_oftc_with_certfp]]
-====== Други пример: повезивање са oftc употребом CertFP
+===== Други пример: повезивање са oftc употребом CertFP
* Креирајте сертификат у командном окружењу:
@@ -2959,7 +2814,7 @@ $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick
За више информација, погледајте https://www.oftc.net/NickServ/CertFP
[[irc_sasl_authentication]]
-===== SASL аутентификација
+==== SASL аутентификација
Програм WeeChat подржава SASL аутентификацију, употребом различитих механизама:
@@ -2980,7 +2835,7 @@ $ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick
* _sasl_key_: фајл са ECC приватним кључем (за механизам _ecdsa-nist256p-challenge_)
[[irc_sasl_ecdsa_nist256p_challenge]]
-====== SASL ECDSA-NIST256P-CHALLENGE
+===== SASL ECDSA-NIST256P-CHALLENGE
Да бисте могли да се аутентификујете ECDSA-NIST256P-CHALLENGE механизмом, морате да генеришете приватни кључ (није потребна лозинка за успостављање везе).
@@ -3022,7 +2877,7 @@ $ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem
----
[[irc_servers_connection]]
-===== Повезивање
+==== Повезивање
Командом <<command_irc_connect,/connect>> можете да се повежете са сервером:
@@ -3053,7 +2908,7 @@ $ openssl ec -noout -text -conv_form compressed -in ~/.config/weechat/ecdsa.pem
----
[[irc_tor_sasl]]
-===== Повезивање преко TOR и SASL
+==== Повезивање преко TOR и SASL
Неки сервери подржавају и везе са TOR (https://www.torproject.org/), мрежом виртуелних тунела који омогућавају људима и групама да унапреде своју приватност и безбедност на Интернету.
@@ -3096,7 +2951,7 @@ $ sudo apt-get install tor
----
[[irc_channels]]
-==== Канали
+=== Канали
Каналима приступате командом <<command_irc_join,/join>>:
@@ -3131,7 +2986,7 @@ $ sudo apt-get install tor
Помоћ у вези формата потражите помоћу `/help irc.server.libera.autojoin`.
[[irc_private_messages]]
-==== Приватне поруке
+=== Приватне поруке
Командом <<command_irc_query,/query>> можете да шаљете приватне поруке и
она отвара посебан бафер:
@@ -3153,7 +3008,7 @@ $ sudo apt-get install tor
----
[[irc_smart_filter_join_part_quit]]
-==== Паметни филтер за join/part/quit поруке
+=== Паметни филтер за join/part/quit поруке
За филтрирање join/part/quit порука када надимак на каналу ништа није рекао у последњих X минута, можете употребити паметни филтер.
@@ -3186,7 +3041,7 @@ $ sudo apt-get install tor
Ако надимак није ништа рекао у последњих 5 минута, његове join и/или part/quit поруке ће бити скривене на каналу.
[[irc_ctcp_replies]]
-==== CTCP одговори
+=== CTCP одговори
CTCP одговори могу да се прилагоде, или неки CTCP упити могу да се блокирају (да се не пошаље одговор).
@@ -3255,7 +3110,7 @@ CTCP може да се прилагоди само за један сервер
|===
[[irc_target_buffer]]
-==== Циљни бафер за IRC поруке
+=== Циљни бафер за IRC поруке
Могуће је прилагођавање циљног бафера за IRC поруке (бафер који се користи за приказ порука) опцијама `+irc.msgbuffer.*+`.
@@ -3383,12 +3238,12 @@ weechat::
----
[[irc_commands]]
-==== Команде
+=== Команде
include::includes/autogen_user_commands.sr.adoc[tag=irc_commands]
[[irc_options]]
-==== Опције
+=== Опције
Одељци у фајлу _irc.conf_:
@@ -3410,6 +3265,151 @@ include::includes/autogen_user_commands.sr.adoc[tag=irc_commands]
include::includes/autogen_user_options.sr.adoc[tag=irc_options]
+[[plugins]]
+== Додаци
+
+Додатак је динамичка библиотека коју учитава програм WeeChat, написана на језику C и компајлирана. На GNU/Linux систему, фајл има „.so” екстензију, а „.dll” на систему Windows.
+
+Додаци се аутоматски учитавају током покретања програма WeeChat, а могу да се учитавају или уклањају из меморије док се програм WeeChat извршава.
+
+Важно је да се направи разлика између _додатка_ и _скрипте_: _додатак_ је бинарни фајл који се компајлира и учитава командом `/plugin`, док је _скрипта_ текст фајл који се учитава додатком као што је _python_ командом `/python`.
+
+За учитавање/уклањање из меморије можете користити команду `/plugin`, или да прикажете листу свих учитаних додатака.
+
+Када се додатак уклони из меморије, програм WeeChat уклања:
+
+* бафере
+* конфигурационе опције (опције се уписују у фајлове)
+* све куке: команде, модификатори, процес, итд.
+* инфо и инфолисте
+* hdata
+* ставке траке
+
+Примери учитавања, уклањања из меморије или приказа листе додатака:
+
+----
+/plugin load irc
+/plugin unload irc
+/plugin list
+----
+
+Ово су подразумевани додаци:
+
+[width="100%", cols="1,5", options="header"]
+|===
+| Додатак | Опис
+| alias | Дефиниција алијаса за команде.
+| buflist | Ставка траке са листом бафера.
+| charset | Декодирање/кодирање у скуп карактера за бафере.
+| exec | Извршавање спољних команди из програма WeeChat.
+| fifo | FIFO пајп који се користи за удаљено слање команди програму WeeChat.
+| fset | Брзо постављање опција програма WeeChat и опција додатака.
+| irc | IRC чет протокол.
+| logger | Логовање бафера у фајлове.
+| relay | Релеј података преко мреже.
+| script | Управљач скриптама.
+| python | Python API .
+| perl | Perl API скриптовања.
+| ruby | Ruby API скриптовања.
+| lua | Lua API скриптовања.
+| tcl | Tcl API скриптовања.
+| guile | Guile (scheme) API скриптовања.
+| javascript | JavaScript API скриптовања.
+| php | PHP API скриптовања.
+| spell | Провера правописа за командну линију.
+| trigger | Замена текста и извршавање команди приликом догађаја које окида програм WeeChat/додаци.
+| typing | Приказује кориснике који тренутно пишу поруке.
+| xfer | Пренос фајлова и директни разговор.
+|===
+
+За више информација о развоју додатака или скрипти (помоћу API), молимо вас да прочитате link:weechat_plugin_api.sr.html[WeeChat референтно упутство за API додатака] или link:weechat_scripting.sr.html[WeeChat водич за скриптовање].
+
+[[exec_plugin]]
+=== Exec
+
+Команда `/exec` вам омогућава да извршите спољне команде из програма WeeChat и да локално прикажете њихов излаз, или да га пошаљете у бафер.
+
+[[exec_commands]]
+==== Команде
+
+include::includes/autogen_user_commands.sr.adoc[tag=exec_commands]
+
+[[exec_options]]
+==== Опције
+
+Одељци у фајлу _exec.conf_:
+
+[width="100%", cols="3m,6m,16", options="header"]
+|===
+| Одељак | Команда за контролу | Опис
+| command | /set exec.command.* | Опције за команде.
+| color | /set exec.color.* | Боје.
+|===
+
+Опције:
+
+include::includes/autogen_user_options.sr.adoc[tag=exec_options]
+
+[[fifo_plugin]]
+=== Fifo
+
+Програм WeeChat можете даљински да контролишете слањем команди или текста у FIFO пајп (ако је укључена опција „fifo.file.enabled”, што је подразумевано).
+
+FIFO пајп се налази у WeeChat директоријуму за време извршавања (runtime) и подразумевано се зове _weechat_fifo_12345_ (где је _12345_ id процеса програма WeeChat).
+
+Синтакса за FIFO пајп команде/текст је једно од следећих:
+
+....
+ plugin.buffer *овде иде текст или команда
+ *овде иде текст или команда
+....
+
+Неки примери:
+
+* Измена надимка на IRC серверу libera на „newnick”:
+
+----
+$ echo 'irc.server.libera */nick newnick' >/run/user/1000/weechat/weechat_fifo_12345
+----
+
+* Слање поруке на #weechat IRC канал:
+
+----
+$ echo 'irc.libera.#weechat *hello!' >/run/user/1000/weechat/weechat_fifo_12345
+----
+
+* Слање поруке у текући бафер:
+
+----
+$ echo '*здраво!' >/run/user/1000/weechat/weechat_fifo_12345
+----
+
+* Слање две команде за уклањање из меморије/поновно учитавање Python скрипти (морате да их раздвојите са „\n”):
+
+----
+$ printf '%b' '*/python unload\n*/python autoload\n' >/run/user/1000/weechat/weechat_fifo_12345
+----
+
+[[fifo_commands]]
+==== Команде
+
+include::includes/autogen_user_commands.sr.adoc[tag=fifo_commands]
+
+[[fifo_options]]
+==== Опције
+
+Одељци у фајлу _fifo.conf_:
+
+[width="100%", cols="3m,6m,16", options="header"]
+|===
+| Одељак | Команда за контролу | Опис
+| file | /set fifo.file.* | Контрола FIFO пајпа.
+|===
+
+Опције:
+
+include::includes/autogen_user_options.sr.adoc[tag=fifo_options]
+
[[logger_plugin]]
=== Logger