402 lines
9.8 KiB
Plaintext
402 lines
9.8 KiB
Plaintext
= WeeChat quick start guide
|
|
:author: Sébastien Helleu
|
|
:email: flashcode@flashtux.org
|
|
:lang: cs
|
|
:toc: left
|
|
:sectnums:
|
|
:docinfo1:
|
|
|
|
|
|
[[start]]
|
|
== Spuštění WeeChatu
|
|
|
|
Doporučený terminálový emulátor pro X (ale ne vyžadovaný) je rxvt-unicode:
|
|
má dobrou podporu pro UTF-8, a nemá problémy s výchozím nastavením
|
|
klávesových zkratek.
|
|
|
|
Spustění z Vašeho shellu:
|
|
|
|
----
|
|
$ weechat
|
|
----
|
|
|
|
[[help_options]]
|
|
== On-line nápověda/ volby
|
|
|
|
WeeChat má nápovědů pro všechny příkazy, postě vložte:
|
|
|
|
----
|
|
/help
|
|
----
|
|
|
|
K získání nápovědy pro specifický příkaz napište:
|
|
|
|
----
|
|
/help příkaz
|
|
----
|
|
|
|
K nastavení voleb napište:
|
|
|
|
----
|
|
/set config.section.option value
|
|
----
|
|
|
|
(kde `config` je jméno konfigurace (`weechat` pro jádro, nebo jméno pluginu),
|
|
`section` sekce této konfigurace a `option` jméno volby).
|
|
|
|
WeeChat okamžitě použije novou hodnotu (*nikdy* nebudete potřebovat restart
|
|
WeeChatu po změně konfigurace).
|
|
|
|
Všechna nastavení jsou uložena při ukončení WeeChatu (nebo použitím příkazu
|
|
`/save` k vynucení zapsaní voleb).
|
|
|
|
// TRANSLATION MISSING
|
|
[IMPORTANT]
|
|
It is *not recommended* to edit configuration files by hand because WeeChat
|
|
may write them at any time (for example on `/quit`) and after any change
|
|
you must run the command `/reload` (with the risk of losing other changes
|
|
that were not yet saved with `/save`). +
|
|
You can use the command `/set`, which checks the value and applies immediately
|
|
the changes.
|
|
|
|
// TRANSLATION MISSING
|
|
Help is available for options:
|
|
|
|
----
|
|
/help config.section.option
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
The plugin _fset_ allows you to easily browse options and change them.
|
|
|
|
// TRANSLATION MISSING
|
|
For example to display WeeChat options:
|
|
|
|
----
|
|
/fset weechat.*
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
IRC options:
|
|
|
|
----
|
|
/fset irc.*
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
The `/fset` command has completion on part of option names, so for example if
|
|
you type `/fset hot` and press kbd:[Tab] this is completed as `/fset hotlist`.
|
|
If you press kbd:[Enter], options about the hotlist are displayed.
|
|
|
|
// TRANSLATION MISSING
|
|
For more information about `/fset` command and keys, see `/help fset`.
|
|
|
|
[[core_vs_plugins]]
|
|
== Jádro versus pluginy
|
|
|
|
"Jádro" WeeChatu je použito pouze k zobrazení dat na obrazovce a k interakci
|
|
s uživatelem, což znamená že jádro weechatu je nepoužitelné bez pluginů.
|
|
(pro věrné uživatele: IRC bylo částí jádra ve verzích ≤ 0.2.6).
|
|
|
|
Všechny síťové protokoly jako IRC jsou pooskytovány vlastnímy pluginy.
|
|
|
|
Použijte příkaz `/plugin` k zobrazení nahraných pluginů, pravděpodobně uvidíte
|
|
"irc" a ostatní pluginy v seznamu.
|
|
|
|
[[add_irc_server]]
|
|
== Přidání IRC serveru
|
|
|
|
Můžete přidat irc server příkazem `/server`, například:
|
|
|
|
----
|
|
/server add freenode chat.freenode.net
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
In this command, `freenode` is the internal server name used by WeeChat:
|
|
you'll be able to connect with `/connect freenode` and the server options
|
|
are _irc.server.freenode.xxx_.
|
|
|
|
Jako obvykle je poskytována nápověda pokud se ztratíte:
|
|
|
|
----
|
|
/help server
|
|
----
|
|
|
|
[[irc_server_options]]
|
|
== Nastavení vlastních voleb IRC serveru
|
|
|
|
WeeChat používá bezpečné výchozí volby pro všechny servery, pokud nenastavíte
|
|
specifické hodnoty pro volby serveru,
|
|
Výchozí volby jsou "irc.server_default.*"
|
|
|
|
Pro každou serverovou volbu WeeChat použije její hodnotu pokud je definována
|
|
(není "prázdná"). Jinak WeeChat použije výchozí hodnotu ("irc.server_default.xxx).
|
|
|
|
Například, je zde výchozí přezdívka (založena na vašem un*x loginu), můžete
|
|
ji přepsat pro freenode s následujícím příkazem:
|
|
|
|
----
|
|
/set irc.server.freenode.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
|
|
----
|
|
|
|
Nastavení username a realname:
|
|
|
|
----
|
|
/set irc.server.freenode.username "Mé uživatelské jméno"
|
|
/set irc.server.freenode.realname "Mé skutečné jméno"
|
|
----
|
|
|
|
K zapnutí automatického připojení při spuštění:
|
|
|
|
----
|
|
/set irc.server.freenode.autoconnect on
|
|
----
|
|
|
|
K připojení s SSL:
|
|
|
|
----
|
|
/set irc.server.freenode.addresses "chat.freenode.net/7000"
|
|
/set irc.server.freenode.ssl on
|
|
----
|
|
|
|
Pokud je na serveru podporován SASL, můžete jej použít pro autentizaci (mužete
|
|
být identifikován před připojením kanálů):
|
|
|
|
----
|
|
/set irc.server.freenode.sasl_username "mynick"
|
|
/set irc.server.freenode.sasl_password "xxxxxxx"
|
|
----
|
|
|
|
K spuštění příkazů po připojení k serveru, například k autentizaci s nickserv
|
|
(pouze pokud nepoužíváte autentizaci přes SASL):
|
|
|
|
----
|
|
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
|
|
----
|
|
|
|
[NOTE]
|
|
Více příkazů v volbě _command_ bůže být odděleno pomocí `;` (středník).
|
|
|
|
// TRANSLATION MISSING
|
|
If you want to protect your password in configuration files, you can use
|
|
secured data.
|
|
|
|
// TRANSLATION MISSING
|
|
First setup a passphrase:
|
|
|
|
----
|
|
/secure passphrase this is my secret passphrase
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
Then add a secured data with your freenode password:
|
|
|
|
----
|
|
/secure set freenode_password xxxxxxx
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
Then you can use `+${sec.data.freenode_password}+` instead of your password in
|
|
IRC options mentioned above, for example:
|
|
|
|
----
|
|
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
|
|
----
|
|
|
|
K automatickému připojení některých kanálů při připojování k serveru:
|
|
|
|
----
|
|
/set irc.server.freenode.autojoin "#channel1,#channel2"
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
[TIP]
|
|
You can complete name and value of options with the kbd:[Tab] key
|
|
and kbd:[Shift+Tab] for a partial completion (useful for long words like
|
|
the name of option).
|
|
|
|
K smazání hodnoty serverové volby a k použití výchozí hodnoty místo ní,
|
|
například k požití výchozích přezdívek (irc.server_default.nicks):
|
|
|
|
----
|
|
/unset irc.server.freenode.nicks
|
|
----
|
|
|
|
Ostatní volby: můžete nastavit ostatní volby s následujícím příkazem ("xxx" je
|
|
název volby):
|
|
|
|
----
|
|
/set irc.server.freenode.xxx value
|
|
----
|
|
|
|
[[connect_to_irc_server]]
|
|
== Připojení k IRC serveru a automatické ořipojení kanálů
|
|
|
|
----
|
|
/connect freenode
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
[NOTE]
|
|
Tento příkaz může být použit k vytvoření nového připojení k serveru bez
|
|
použití příkazu `/server` (see `/help connect`).
|
|
|
|
Ve výchozím nastavení jsou serverové bufery spojen s WeeChat _core_ buferem.
|
|
K přepnutí mezi _core_ a server bufery můžete použít klávesu kbd:[Ctrl+x].
|
|
|
|
Je možné vypnout automatické sloučení serverových buferů a mít nezávislé
|
|
serverové bufery:
|
|
|
|
----
|
|
/set irc.look.server_buffer independent
|
|
----
|
|
|
|
[[join_part_irc_channels]]
|
|
== Připojení/Opuštění IRC kanálů
|
|
|
|
Připojení kanálu:
|
|
|
|
----
|
|
/join #channel
|
|
----
|
|
|
|
Opuštění kanálu (zachování otevřeného buferu):
|
|
|
|
----
|
|
/part [quit message]
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
Close a server, channel or private buffer (`/close` is an alias for
|
|
`/buffer close`):
|
|
|
|
----
|
|
/close
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
[WARNING]
|
|
Closing the server buffer will close all channel/private buffers.
|
|
|
|
// TRANSLATION MISSING
|
|
Disconnect from server, on the server buffer:
|
|
|
|
----
|
|
/disconnect
|
|
----
|
|
|
|
[[irc_private_messages]]
|
|
== IRC soukromé zprávy
|
|
|
|
Otevření buferu a poslání soukromé zprávy jinému uživateli (přezdívka _foo_):
|
|
|
|
----
|
|
/query foo tato zpráva
|
|
----
|
|
|
|
Uzavření soukromého buferu:
|
|
|
|
----
|
|
/close
|
|
----
|
|
|
|
[[buffer_window]]
|
|
== Managment Buferu/Okna
|
|
|
|
Bufer je komponenta navázaná na plugin s číslem, kategoriía jménem. Bufer
|
|
obsahuje data zobrazená na obrazovce.
|
|
|
|
Okno je pohled na bufer. Ve výchozím stavu je zde pouze jedno okno zobrazijící
|
|
jeden bufer. Pokud rozdělíte obrazovku, můžete vidět více oken s více bufery
|
|
ve stejný čas.
|
|
|
|
Příkazy k spravování buferů a oken:
|
|
|
|
----
|
|
/buffer
|
|
/window
|
|
----
|
|
|
|
Například, k svislému rozdělení obrazovky na malé okno (1/3 šířky), a velké
|
|
okno (2/3), použijte příkaz:
|
|
|
|
----
|
|
/window splitv 33
|
|
----
|
|
|
|
// TRANSLATION MISSING
|
|
To remove the split:
|
|
|
|
----
|
|
/window merge
|
|
----
|
|
|
|
[[key_bindings]]
|
|
== Předvoblby klávesových zkratek
|
|
|
|
WeeChat používá ve výchozím nastavení mnoho klávesových zkratek, Všechny
|
|
najdete v dokumentaci, ale je dobré znát alespoň pár těchto důležitých:
|
|
|
|
- kbd:[Alt+←] / kbd:[Alt+→] nebo kbd:[F5] / kbd:[F6]: přepnout na předchozí/další bufer
|
|
// TRANSLATION MISSING
|
|
- kbd:[F1] / kbd:[F2]: scroll bar with list of buffers ("buflist")
|
|
- kbd:[F7] / kbd:[F8]: přepnout na předchozí/další okno (pokud je obrazovka rozdělena)
|
|
- kbd:[F9] / kbd:[F10]: posunoutí titulku
|
|
- kbd:[F11] / kbd:[F12]: posunutí seznamu přezdívek
|
|
- kbd:[Tab]: doplnění textu v vstupním řádku, podobně jak v shellu
|
|
- kbd:[PgUp] / kbd:[PgDn]: posunutí textu v aktuálním buferu
|
|
- kbd:[Alt+a]: přepni do aktivního buferu (v seznamu)
|
|
|
|
Dle Vaší klávesnice a/nebo vašich potřeb, můžete přenastavit jakoukoliv
|
|
klávesovou zkratku pomocí příkazu `/key`.
|
|
Užitečná zkratka je kbd:[Alt+k] k najítí kodů kláves.
|
|
|
|
Například k nastavení zkratky kbd:[Alt+!] na příkaz `/buffer close`:
|
|
|
|
----
|
|
/key bind (press alt-k) (press alt-!) /buffer close
|
|
----
|
|
|
|
Můžete vytvořit příkaz jako:
|
|
|
|
----
|
|
/key bind meta-! /buffer close
|
|
----
|
|
|
|
K smazání klávesové zkratky:
|
|
|
|
----
|
|
/key unbind meta-!
|
|
----
|
|
|
|
[[plugins_scripts]]
|
|
== Pluginy/Skripty
|
|
|
|
Na mnoha distribucích, například Debian, jsou pluginy dostupné přes oddělený
|
|
balíček (něco jako weechat-plugins).
|
|
Pluginy jsou automaticky nahrány při nálezení (prosím nahlédněte do
|
|
dokumentace WeeChatu jak nahrát/odebrat plugin nebo skript)
|
|
|
|
Mnoho externích skriptů (od přispěvovatelů) je dostupných pro WeeChat. můžete
|
|
stáhnout a nainstalovat scripty z repozitáře pomocí příkazu `/script`,
|
|
například:
|
|
|
|
----
|
|
/script install go.py
|
|
----
|
|
|
|
Zkuste `/help script` pro více informací.
|
|
|
|
|
|
A seznam skriptů je dostupný v WeeChatu s příkazem `/script` nebo na této
|
|
adrese https://weechat.org/scripts
|
|
|
|
[[more_doc]]
|
|
== Další dokumentace
|
|
|
|
Nyní jste schopni používat WeeChat a můžete si přečíst FAQ/dokumentaci pro
|
|
jakékoliv další otázky: https://weechat.org/doc
|
|
|
|
Ať máte radost z použití WeeChatu!
|