diff options
author | Sébastien Helleu <flashcode@flashtux.org> | 2021-12-05 14:42:58 +0100 |
---|---|---|
committer | Sébastien Helleu <flashcode@flashtux.org> | 2021-12-05 20:59:19 +0100 |
commit | 66384544b551e5bf61de786590a8dfa7efed53d7 (patch) | |
tree | d45ce320a853da909c3172ba6a08ed29ce25e354 /doc/sr/weechat_user.sr.adoc | |
parent | c88428fb416fa1f0477e4a9f2542d06db239a749 (diff) | |
download | weechat-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.adoc | 332 |
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 |