summaryrefslogtreecommitdiff
path: root/doc/pl/weechat_quickstart.pl.adoc
blob: f7dd790456d8441650408d536db8231f8e6a2966 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
= WeeChat szybki start
:author: Sébastien Helleu
:email: flashcode@flashtux.org
:lang: pl
:toc: left
:toc-title: Spis treści
:sectnums:
:docinfo1:


Tłumaczenie:

* Krzysztof Korościk <soltys1@gmail.com>, 2009-2016


[[start]]
== Uruchamianie WeeChat

Zalecanym emulatorem terminala dla X (ale nieobowiązkowym) jest rxvt-unicode:
posiada dobre wsparcie UTF-8, oraz nie ma problemów z domyślnymi skrótami
klawiszowymi.

Wywołaj z terminala:

----
$ weechat
----

[[help_options]]
== Pomoc online / opcje

WeeChat posiada pomoc dla wszystkich komend, wystarczy wywołać:

----
/help
----

Aby otrzymać pomoc dla konkretnej komendy wpisz:

----
/help komenda
----

Do ustawiania opcji służy:

----
/set config.sekcja.opcja wartość
----

(gdzie `config` jest nazwą konfiguracyjną (`weechat` dla rdzenia, lub nazwa
wtyczki), `sekcja` sekcja pliku konfiguracyjnego, oraz `opcja` nazwa opcji).

WeeChat natychmiast używa nowej wartości (*nigdy* nie musisz restartować WeeChat
po zmianach w ustawieniach).

Możesz użyć `/set` z częściową nazwą zmiennej oraz dziką kartą "*" na początku
lub końcu, aby wyświetlić wszystkie opcje zawierające te litery.
Na przykład:

* wyświetli wszystkie opcje (WeeChat oraz wtyczek):

----
/set
----

* wyświetli opcje WeeChat:

----
/set weechat.*
----

* wyświetli opcje wtyczki IRC:

----
/set irc.*
----

Możesz wyświetlić pomoc dla opcji dzięki `/help`, na przykład:

----
/help weechat.look.highlight
----

Wszystkie ustawienia są zapisywane podczas wyjścia z WeeChat (lub za pomocą
komendy `/save`, która wymusza zapisanie opcji).

[IMPORTANT]
*Nie zaleca się* ręcznie edytować plików konfiguracyjnych, ponieważ WeeChat
może je nadpisać w dowolnej chwili (na przykład podczas `/quit`),
oraz po każdej zmianie musisz wykonać komendę `/reload`
(ryzykując utratę zmian, które nie zostały zapisane za pomocą `/save`). +
Możesz użyć komendy `/set`, która sprawdza wartość i nanosi od razu wymagane
zmiany.

[[core_vs_plugins]]
== Rdzeń vs wtyczki

"Rdzeń" WeeChat jest używany tylko do wyświetlania danych na ekranie oraz
interakcji z użytkownikiem, oznacza to, że rdzeń weechat bez wtyczek jest
bezużyteczny (wierni użytkownicy: IRC był częścią rdzenia dla wersji ≤ 0.2.6).

Wszystkie protokoły sieciowe jak IRC są dostarczane w oddzielnych wtyczkach.

Użyj komendy `/plugin` do wyświetlenia załadowanych wtyczek, powinieneś zobaczyć
na liście "irc" oraz inne wtyczki.

[[add_irc_server]]
== Dodawanie serwera IRC

Możesz dodać serwer IRC za pomocą komendy `/server`, na przykład:

----
/server add freenode chat.freenode.net
----

Jak zawsze w razie wątpliwości dostępna jest pomoc:

----
/help server
----

[[irc_server_options]]
== Ustawianie własnych opcji dla serwerów IRC

WeeChat używa domyślnych wartości dla wszystkich serwerów ("fall backs"), jeśli
nie określisz konkretnej wartości dla opcji serwera.
Te domyślne opcje to "irc.server_default.*".

Dla każdej opcji serwera WeeChat używa jej wartości jeśli jest zdefiniowana (nie
"null"). W przeciwnym przypadku WeeChat używa wartości domyślnych ("irc.server_default.xxx").

Na przykład znajdują się tam domyślne nicki (bazujące na Twoim loginie un*x),
możesz je zmienić dla serwera freenode następującą komendą:

----
/set irc.server.freenode.nicks "mójnick,mójnick2,mójnick3,mójnick4,mójnick5"
----

Ustawienie nazwy użytkownika i imienia:

----
/set irc.server.freenode.username "Moja nazwa użytkownika"
/set irc.server.freenode.realname "Moje imię"
----

Aby włączyć automatyczne łączenie się z serwerem przy starcie:

----
/set irc.server.freenode.autoconnect on
----

W celu połączenia z użyciem SSL:

----
/set irc.server.freenode.addresses "chat.freenode.net/7000"
/set irc.server.freenode.ssl on
----

Jeśli SASL jest dostępny na serwerze, można użyć go do uwierzytelnienia (zostaniesz
zidentyfikowany przed wejściem na kanał):

----
/set irc.server.freenode.sasl_username "mójnick"
/set irc.server.freenode.sasl_password "xxxxxxx"
----

Żeby wykonać komendę po połączeniu z serwerem, na przykład uwierzytelnienie
przez nickserv (tylko jeśli nie uwierzytelniasz się przez SASL):

----
/set irc.server.freenode.command "/msg nickserv identify xxxxxxx"
----

[NOTE]
Opcja _command_ może zawierać wiele komend, należy je oddzielić `;` (średnik).

Jeśli chcesz zabezpieczyć swoje hasło podane w plikach konfiguracyjnych możesz
użyć bezpiecznych danych.

Najpierw ustaw hasło:

----
/secure passphrase to jest moje tajne hasło
----

Następnie dodaj swoje hasło, np dla sieci freenode:

----
/secure set freenode_password xxxxxxx
----

Następnie możesz użyć `+${sec.data.freenode_password}+` zamiast swojego hasła dla
opcji IRC omówionych wcześniej, na przykład:

----
/set irc.server.freenode.sasl_password "${sec.data.freenode_password}"
----

Aby automatycznie wejść na kanały po połączeniu z serwerem:

----
/set irc.server.freenode.autojoin "#kanał1,#kanał2"
----

Aby usunąć wartość dla opcji serwera, używając w zamian wartości domyślnej,
na przykład, aby używać domyślnych nicków (irc.server_default.nicks):

----
/set irc.server.freenode.nicks null
----

Inne opcje: możesz ustawić pozostałe opcje za pomocą komendy ("xxx" to
nazwa opcji):

----
/set irc.server.freenode.xxx wartość
----

[[connect_to_irc_server]]
== Łączenie się z serwerem IRC i automatyczne wchodzenie na kanały

----
/connect freenode
----

[NOTE]
Ta komenda może być użyta do utworzenia i połączenia się z nowym serwerem bez
użycia komendy `/server` (czy mam powtarzać, że pomoc dla tej komendy można
uzyskać dzięki `/help connect` ?).

Domyślnie bufory serwerów są połączone z buforem WeeChat _core_. Aby przełączać
się pomiędzy buforem _core_ a buforami serwerów możesz użyć kbd:[Ctrl+x].

Jest możliwe wyłączenie automatycznego łączenia buforów serwerów, aby mieć
oddzielne bufory dla serwerów:

----
/set irc.look.server_buffer independent
----

[[join_part_irc_channels]]
== Wchodzenie/wychodzenie z kanałów IRC

Wejście na kanał:

----
/join #kanał
----

Wyjście z kanału (zostawiając otwarty bufor):

----
/part [wiadomość pożegnalna]
----

Zamknij serwer, kanał albo prywatny bufor (`/close` to alias dla
`/buffer close`):

----
/close
----

[WARNING]
Zamknięcie buforu serwera poskutkuje zamknięciem wszystkich buforów prywatnych/kanałów.

Rozłączanie się z serwerem, w buforze serwera:

----
/disconnect
----

[[irc_private_messages]]
== Prywatne wiadomości IRC

Otworzenie bufora i wysłanie wiadomości do innego użytkownika (nick _foo_):

----
/query foo to jest wiadomość
----

Zamykanie prywatnego bufora:

----
/close
----

[[buffer_window]]
== Zarządzanie buforami/oknami

Bufor jest to element łączący wtyczkę z numerem, kategorią,
oraz nazwą. Zawiera on dane wyświetlane na ekranie.

Okno jest widokiem na bufor. Domyślnie jedno okno wyświetla jeden bufor.
Jeśli podzielisz ekran, ujrzysz wiele okien z wieloma buforami jednocześnie.

Komendy do zarządzania buforami i oknami:

----
/buffer
/window
----

(Nie będę powtarzać, że możesz uzyskać pomoc za pomocą /help na tych komendach)

Na przykład, aby pionowo podzielić ekran na małe okno (1/3 szerokości),
oraz duże okno (2/3), użyj komendy:

----
/window splitv 33
----

Usunięcie podziału:

----
/window merge
----

[[key_bindings]]
== Skróty klawiszowe

WeeChat używa domyślnie wiele klawiszy. Wszystkie z nich są w dokumentacji,
ale powinieneś znać przynajmniej kilka najprzydatniejszych:

- kbd:[Alt+←] / kbd:[Alt+→] lub kbd:[F5] / kbd:[F6]: przełącza na
  poprzedni/następny bufor
- kbd:[F7] / kbd:[F8]: przełącza na poprzednie/następne okno (jeśli ekran jest
  podzielony)
- kbd:[F9] / kbd:[F10]: przewija pasek z tematem kanału
- kbd:[F11] / kbd:[F12]: przewija listę z nickami
- kbd:[Tab]: dopełnia tekst w pasku danych wejściowych, dokładnie jak w terminalu
- kbd:[PgUp] / kbd:[PgDn]: przewija tekst w obecnym buforze
- kbd:[Alt+a]: skocz do bufora z aktywnością (w hotliście)

Zgodnie z Twoją klawiaturą i/lub potrzebami, możesz zmienić przypisanie
dowolnego klawisza do komendy używając komendy `/key`.
Przydatnym skrótem jest kbd:[Alt+k] do odnajdywania kodów klawiszy.

Na przykład, aby przypisać kbd:[Alt+!] do komendy `/buffer close`:

----
/key bind (wciśnij alt-k) (wciśnij alt-!) /buffer close
----

Otrzymasz w linii poleceń:

----
/key bind meta-! /buffer close
----

Aby usunąć klawisz:

----
/key unbind meta-!
----

[[plugins_scripts]]
== Wtyczki/skrypty

W niektórych dystrybucjach, jak np Debian, wtyczki są dostarczane jako oddzielne
pakiety (jak weechat-plugins).
Wtyczki są automatycznie ładowane, kiedy zostaną wykryte (proszę spojrzeć do
dokumentacji WeeChat, aby się dowiedzieć jak ładować/wyładowywać wtyczki lub
skrypty).

Dostępne jest wiele zewnętrznych skryptów (od społeczności), możesz je pobrać
i zainstalować za pomocą komendy `/script`, na przykład:

----
/script install go.py
----

Więcej informacji można uzyskać wykonując komendę `/help script`.

Listę skryptów dostepnych dla WeeChat można uzyskać wywołując komendę `/script`
lub pod adresem https://weechat.org/scripts

[[more_doc]]
== Więcej dokumentacji

Możesz teraz używać WeeChat oraz przeczytać FAQ/dokumentację w razie innych pytań:
https://weechat.org/doc

Miłej pracy z WeeChat!