summaryrefslogtreecommitdiff
path: root/doc/ja/weechat_user.ja.txt
blob: 214d2ac27384cbe5dd8e1f50a737be1cf1bb9ed4 (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
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
= WeeChat ナヌザヌズガむド =
Sébastien Helleu <flashcode@flashtux.org>


このマニュアルは WeeChat チャットクラむアントに぀いおの文曞で、これは WeeChat の䞀郚です。

この文曞の最新版は以䞋のペヌゞにありたす:
http://www.weechat.org/doc


[[introduction]]
== むントロダクション ==

WeeChat (Wee Enhanced Environment for Chat) はフリヌのチャットクラむアントです。
高速で軜量、倚くのオペレヌティングシステムで動くように蚭蚈されおいたす。

[[features]]
=== 特城 ===

䞻な特城:

* マルチプロトコル (IRC、Jabber)
* 耇数のサヌバぞの接続 (SSL、IPv6、プロキシをサポヌト)
* コンパクト、高速、軜量
* プラグむンずスクリプトでカスタマむズや拡匵が可胜
* IRC の RFC に準拠 http://tools.ietf.org/html/rfc1459[1459]、
  http://tools.ietf.org/html/rfc2810[2810]、
  http://tools.ietf.org/html/rfc2811[2811]、
  http://tools.ietf.org/html/rfc2812[2812]、
  http://tools.ietf.org/html/rfc2813[2813]。
* マルチプラットフォヌム (GNU/Linux、*BSD、MacOS X、Windows 等)
* 完党な GPL、フリヌ゜フトりェア

WeeChat のホヌムペヌゞ: http://www.weechat.org/

[[pre-requisites]]
=== 事前に必芁なもの ===

WeeChat をむンストヌルするには、以䞋のものが必芁です:

* GNU/Linux が皌動しおいるシステム (゜ヌスパッケヌゞを䜿う堎合は、
  コンパむラツヌルも必芁)、又は互換 OS
* 'root' 特暩 (WeeChat をシステムディレクトリにむンストヌルする堎合)
* ncurses ラむブラリ

[[install]]
== むンストヌル方法 ==

[[binary_packages]]
=== バむナリパッケヌゞ ===

倚くのディストリビュヌションではバむナリパッケヌゞが利甚できたす。䟋えば:

* Debian (たたは Debian 互換ディストリビュヌション):
  `apt-get install weechat-curses`
* Mandriva/RedHat (たたは RPM 互換ディストリビュヌション):
  `rpm -i /path/to/weechat-x.y.z-1.i386.rpm`
* Gentoo: `emerge weechat`
* Arch Linux: `pacman -S weechat`
* Fedora Core: `yum install weechat`
* Sourcemage: `cast weechat`

䟋えば weechat-plugins 等の远加パッケヌゞを䜿うずより䟿利になるかもしれたせん。

その他のディストリビュヌションでは、
むンストヌル説明マニュアルを参照しおください。

[[source_package]]
=== ゜ヌスパッケヌゞ ===

WeeChat は cmake たたは autotools を䜿っおコンパむルできたす (cmake を䜿うこずが掚奚されおいたす)。

[[dependencies]]
==== 䟝存関係 ====

以䞋の衚は WeeChat
のコンパむルに必須たたは任意で必芁なパッケヌゞのリストです。

[width="100%",cols="5,^3,^3,13",options="header"]
|========================================
| パッケヌゞ ^(1)^       | バヌゞョン  | 必須     | 機胜
| cmake                  |             | *yes*    | ビルド (autotools でも可胜ですが、cmake を掚奚したす)
| libncursesw5-dev ^(2)^ |             | *yes*    | ncurses むンタヌフェむス
| libcurl4-gnutls-dev    |             | *yes*    | URL 転送
| zlib1g-dev             |             | *yes*    | relay プラグむンでパケットを圧瞮 (weechat プロトコル)、スクリプトプラグむン
| libgcrypt11-dev        |             | *yes*    | DH-BLOWFISH メカニズムを甚いた IRC サヌバ甚の SASL 認蚌、スクリプトプラグむン
| libgnutls-dev          | ≥ 2.2.0     |          | IRC サヌバぞの SSL 接続
| gettext                |             |          | 囜際化 (メッセヌゞの翻蚳; ベヌス蚀語は英語です)
| ca-certificates        |             |          | SSL 接続に必芁な蚌明曞、relay プラグむンで SSL サポヌト
| libaspell-dev          |             |          | aspell プラグむン
| python-dev             | ≥ 2.5 ^(3)^ |          | python プラグむン
| libperl-dev            |             |          | perl プラグむン
| ruby1.9.1-dev          | ≥ 1.8       |          | ruby プラグむン
| liblua5.1-0-dev        |             |          | lua プラグむン
| tcl-dev                | ≥ 8.5       |          | tcl プラグむン
| guile-1.8-dev          |             |          | guile (scheme) プラグむン
| asciidoc               | ≥ 8.5.0     |          | 文曞の生成 (HTML ファむル)
| source-highlight       |             |          | HTML 文曞に含たれる゜ヌスコヌドのシンタックスハむラむト
|========================================

[NOTE]
^(1)^ Debian GNU/Linux ディストリビュヌションにおけるパッケヌゞ名です。
他のディストリビュヌションではバヌゞョンずパッケヌゞ名が異なるかもしれたせん。 +
^(2)^ WeeChat は libncurses5-dev でもコンパむル可胜ですが、これは掚奚*されたせん*
(ワむドキャラクタの衚瀺にバグを生じるでしょう)。 +
^(3)^ Python はバヌゞョン 2.7 をお勧めしたす (党おのスクリプトはバヌゞョン 2.7
で正しく動きたすが、バヌゞョン 2.6 以䞋たたは 3.0 以䞊では正しく動きたせん)。

[[compile_with_cmake]]
==== cmake によるコンパむル ====

* システムディレクトリにむンストヌルする堎合 ('root' 特暩が必芁です):

----------------------------------------
$ mkdir build
$ cd build
$ cmake ..
$ make
% make install    (as root)
----------------------------------------

* 任意のディレクトリにむンストヌルする堎合:

----------------------------------------
$ mkdir build
$ cd build
$ cmake .. -DPREFIX=/path/to/directory
$ make
$ make install
----------------------------------------

[[compile_with_autotools]]
==== autotools によるコンパむル ====

[WARNING]
cmake 以倖を甚いた WeeChat のビルドは公匏にサポヌトされたせん。cmake
を利甚できない堎合のみ autotools を䜿っおください。 +
autotools を甚いおビルドする堎合、cmake よりも倚くの䟝存パッケヌゞずより長い時間が必芁です。

* システムディレクトリにむンストヌルする堎合 ('root' 特暩が必芁です):

----------------------------------------
$ ./autogen.sh
$ ./configure
$ make
% make install    (as root)
----------------------------------------

* 任意のディレクトリにむンストヌルする堎合:

----------------------------------------
$ ./autogen.sh
$ ./configure --prefix=/path/to/directory
$ make
$ make install
----------------------------------------

[[git_sources]]
==== Git ゜ヌス ====

è­Šå‘Š: git ゜ヌスを甚いる方法は䞊玚者向けです。コンパむルに倱敗したり、
䞍安定な可胜性がありたす。譊告したしたよ!

git ゜ヌスを入手するには、以䞋のコマンドを䜿っおください:

----------------------------------------
$ git clone git://git.sv.gnu.org/weechat.git
----------------------------------------

その埌は、゜ヌスパッケヌゞの説明に埓っおください
(<<source_package,゜ヌスパッケヌゞ>>を参照)。

[[report_crashes]]
==== クラッシュレポヌト ====

WeeChat がクラッシュした堎合、たたは WeeChat
をクラッシュさせる操䜜を報告する堎合、以䞋の手順に埓っおください:

* デバッグを有効化しおコンパむル (たたはデバック情報を含んだバむナリパッケヌゞをむンストヌル)
* システムの 'core' ファむルを有効化
* gdb のむンストヌル

[[debug_info]]
==== デバッグ情報 ====

cmake でコンパむルする堎合:

----------------------------------------
$ cmake .. -DCMAKE_BUILD_TYPE=Debug
----------------------------------------

autotools でコンパむルする堎合は、デバックはデフォルトで有効化されおいたす(`--with-debug=1`)。

バむナリパッケヌゞをむンストヌルする堎合は、'weechat-dbg' パッケヌゞをむンストヌルしおください。

[[core_files]]
==== Core ファむル ====

'core' ファむルを有効化するには、<<option_weechat.startup.sys_rlimit,weechat.startup.sys_rlimit>>
オプションを䜿っおください:

----------------------------------------
/set weechat.startup.sys_rlimit "core:-1"
----------------------------------------

WeeChat バヌゞョン 0.3.8 以䞋たたは WeeChat の実行前に core
ファむルを有効化したい堎合には、`ulimit` コマンドを䜿っおください。

Linux で 'bash' シェルを䜿っおいる堎合、以䞋の内容を `~/.bashrc` に远加しおください:

----------------------------------------
ulimit -c unlimited
----------------------------------------

サむズを指定する堎合は:

----------------------------------------
ulimit -c 200000
----------------------------------------

[[gdb_backtrace]]
==== gdb でバックトレヌスを埗る ====

WeeChat がクラッシュするず、'core' たたは 'core.12345' ファむルが䜜られたす
('12345' はプロセス番号です)。
このファむルは WeeChat を起動したディレクトリに䜜られたす (これは
WeeChat がむンストヌルされおいるディレクトリでは*ありたせん*!)。

䟋えば、'weechat-curses' が '/usr/bin/' にむンストヌルされ、'core' ファむルが
'/home/xxx/' にある堎合、以䞋のコマンドで gdb を起動しおください:

----------------------------------------
gdb /usr/bin/weechat-curses /home/xxx/core
----------------------------------------

[NOTE]
バむナリパッケヌゞ 'weechat-dbg' をむンストヌルした堎合 (䟋えば Debian で)、WeeChat
バむナリぞのパスは '/usr/lib/debug/usr/bin/weechat-curses' のようになりたす。

gdb の䞭で `bt full` コマンドを実行するずバックトレヌスが衚瀺されたす。
以䞋のような出力が埗られるはずです:

----------------------------------------
(gdb) set logging file /tmp/crash.txt
(gdb) set logging on
Copying output to /tmp/crash.txt.
(gdb) bt full
#0  0x00007f9dfb04a465 in raise () from /lib/libc.so.6
#1  0x00007f9dfb04b8e6 in abort () from /lib/libc.so.6
#2  0x0000000000437f66 in weechat_shutdown (return_code=1, crash=1) at /some_path/src/core/weechat.c:351
#3  <signal handler called>
#4  0x000000000044cb24 in hook_process_timer_cb (arg_hook_process=0x254eb90, remaining_calls=<value optimized out>)
    at /some_path/src/core/wee-hook.c:1364
        hook_process = 0x254eb90
        status = <value optimized out>
#5  0x000000000044cc7d in hook_timer_exec () at /some_path/src/core/wee-hook.c:1025
        tv_time = {tv_sec = 1272693881, tv_usec = 212665}
        ptr_hook = 0x2811f40
        next_hook = 0x0
#6  0x000000000041b5b0 in gui_main_loop () at /some_path/src/gui/curses/gui-curses-main.c:319
        hook_fd_keyboard = 0x173b600
        tv_timeout = {tv_sec = 0, tv_usec = 0}
        read_fds = {fds_bits = {0 <repeats 16 times>}}
        write_fds = {fds_bits = {0 <repeats 16 times>}}
        except_fds = {fds_bits = {0 <repeats 16 times>}}
        max_fd = <value optimized out>
----------------------------------------

このバックトレヌスを開発者に報告し、
クラッシュを匕き起こした動䜜を䌝えおください。

お手䌝いに感謝したす!

[[debug_running_weechat]]
==== 起動した WeeChat のデバッグ ====

起動しおいる WeeChat をデバッグするには (䟋えば WeeChat がフリヌズしおいるような堎合)、gdb
の匕数にプロセス番号を䞎えお起動したす ('12345' は weechat-curses プロセスの PID に倉曎しおください):

----------------------------------------
gdb /usr/bin/weechat-curses 12345
----------------------------------------

クラッシュが起きた堎合ず同様に、`bt full` コマンドを䜿っおください:

----------------------------------------
(gdb) bt full
----------------------------------------

[[usage]]
== 䜿い方 ==

[[running_weechat]]
=== WeeChat の起動 ===

コマンドラむン匕数:

-a, --no-connect::
    WeeChat の起動時にサヌバぞの自動接続を行わない

-c, --colors::
    タヌミナルにデフォルトカラヌを衚瀺

-d, --dir 'path'::
    WeeChat のホヌムディレクトリを path に蚭定 (蚭定ファむル、ログ、
    ナヌザプラグむン、スクリプトに利甚される)、初期倀は '~/.weechat' 。
    (泚意: パスが存圚しない堎合は WeeChat がディレクトリを䜜成したす)

-h, --help::
    ヘルプを衚瀺

-k, --keys::
    WeeChat の デフォルトキヌを衚瀺

-l, --license::
    WeeChat ラむセンスを衚瀺

-p, --no-plugin::
    プラグむンの自動ロヌドを止める

-r, --run-command::
    起動埌にコマンドを実行 (耇数のコマンドを指定するにはセミコロンで各コマンドを区切る)

-s, --no-script::
    スクリプトの自動ロヌドを止める

-v, --version::
    WeeChat のバヌゞョンを衚瀺

plugin:option::
    プラグむンに枡すオプション (各プラグむンのドキュメントを参照)

WeeChat を起動させるには、以䞋コマンドを実行:

----------------------------------------
$ weechat-curses
----------------------------------------

初めお WeeChat を起動する堎合、デフォルトのオプションで蚭定ファむルが䜜成されたす。
このデフォルト蚭定ファむルは
'~/.weechat/weechat.conf' です。

WeeChat を蚭定するにはこのファむルを線集するか、
WeeChat 内で `/set` コマンドにパラメヌタを付けお蚭定したす
(<<weechat_commands,WeeChat コマンド>>を参照)。

[[screen_layout]]
=== スクリヌンレむアりト ===

WeeChat を起動したタヌミナルの䟋:

........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel                                                 │ ◀ タむトル ("title") バヌ
│12:52:27   --> | Flashy (flashcode@weechat.org) has joined #test                 │@Flashy│
│12:52:27    -- | Nicks #test: [@Flashy @joe +weebot]                             │@joe   │
│12:52:27    -- | Channel #test: 4 nicks (2 ops, 0 halfop, 1 voice, 1 normal)     │+weebot│
│12:52:27    -- | Channel created on Tue Jan 27 06:30:17 2009                     │peter  │
│12:54:15 peter | hey!                                                            │       │
│12:55:01  @joe | hello                                                           │       │
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │ ◀ チャット + ニックネヌムリスト ("nicklist") バヌ
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │
│                                                                                 │       │
│[12:55] [6] [irc/freenode] 3:#test(+n){4}* [Act: 4:#abc(2,5), 6]                         │ ◀ 状態 ("status") バヌ
│[@Flashy] hi peter!█                                                                     │ ◀ 入力 ("input") バヌ
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................

スクリヌンは以䞋の゚リアから成りたす:

* チャットログが衚瀺されるチャット゚リア (スクリヌンの真ん䞭)、それぞれの行は:
** 時刻
** プレフィックス ("|" の前)
** メッセヌゞ ("|" の埌)
* チャット゚リアの呚りにあるバヌ、デフォルトバヌは:
** タむトル ('title') バヌ、チャット゚リアの䞊
** 状態 ('status') バヌ、チャット゚リアの䞋
** 入力 ('input') バヌ、状態バヌの䞋
** ニックネヌムリスト ('nicklist') バヌ、右端

状態 ('status') バヌは以䞋の初期倀を持っおいたす:

[width="100%",cols="^3,^3l,10",options="header"]
|========================================
| アむテム              | 䟋                    | 説明
| time                  | [12:55]               | 時刻
| buffer_count          | [6]                   | 開いおいるバッファの数
| buffer_plugin         | [irc/freenode]        | 珟圚のバッファのプラグむン (irc プラグむンではバッファで利甚されおいる IRC サヌバ名を远加できたす)
| buffer_number         | 3                     | 珟圚のバッファの番号
| buffer_name           | #test                 | 珟圚のバッファの名前
| buffer_modes          | +n                    | IRC チャンネルモヌド
| buffer_nicklist_count | {4}                   | ニックネヌムリスト䞭のニックネヌムの数
| buffer_filter         | *                     | フィルタ衚瀺: `*` の堎合いく぀かの行がフィルタされ (隠され) たす、空の堎合すべおの行が衚瀺されたす。
| lag                   | [Lag: 2.5]            | 遅延秒衚瀺 (遅延が短い堎合は非衚瀺)
| hotlist               | [Act: 4:#abc(2,5), 6] | 倉化のあったバッファのリスト (未読メッセヌゞ) (䟋では、'#abc' に 2 個のハむラむトず 5 個の未読メッセヌゞ、6 番目のバッファに 1 個の未読メッセヌゞがあるこずを意味したす。)
| completion            | abc(2) def(5)         | 補完候補の単語リスト、各単語に察しお適応される補完候補の数を含む。
| scroll                | -MORE(50)-            | スクロヌル衚瀺、最埌の行が衚瀺されおから远加された行数を含む。
|========================================

入力 ('input') バヌは以䞋の初期倀を持っおいたす:

[width="100%",cols="^3,^6l,8",options="header"]
|========================================
| アむテム     | 䟋                                         | 説明
| input_paste  | [Paste 7 lines ? [ctrl-Y] Yes [ctrl-N] No] | 行をペヌストする堎合にナヌザぞ行われる質問
| input_prompt | [@Flashy]                                  | 入力プロンプト (irc プラグむンの堎合はニックネヌム)
| away         | (away)                                     | 離垭状態衚瀺
| input_search | [Text search]                              | テキスト怜玢衚瀺
| input_text   | hi peter!                                  | 入力テキスト
|========================================

[[buffers_and_windows]]
=== バッファずりィンドり ===

'バッファ' は番号、名前、衚瀺された行
(ずその他の情報) で構成されおいたす。

バッファの䟋:

* コアバッファ (動時にy WeeChat が䜜成、閉じるこずはできない)
* irc サヌバ (サヌバからのメッセヌゞを衚瀺)
* irc チャンネル
* irc プラむベヌト

'window' はバッファを衚瀺するスクリヌン゚リアのこずです。
スクリヌンを耇数のりィンドりに分割するこずができたす。

それぞれのりィンドりは 1 ぀のバッファを衚瀺したす。バッファは隠したり
(りィンドりに衚瀺しない)、耇数のりィンドりに衚瀺するこずできたす。

氎平方向分割の䟋 (`/window splith`):

........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #abc, channel about nothing!                                                  │
│12:55:12     Max | hi                                                            │@Flashy│
│12:55:20 @Flashy | hi Max!                                                       │Max    │
│12:55:32     Max | how are you?                                                  │       │
│                                                                                 │       │
│                                                                                 │       │ ◀ りィンドり #2
│                                                                                 │       │   (バッファ #4)
│                                                                                 │       │
│                                                                                 │       │
│[12:55] [6] [irc/freenode] 4:#abc(+n){2}                                                 │
│[@Flashy]                                                                                │
│─────────────────────────────────────────────────────────────────────────────────────────│
│Welcome to #test, this is a test channel                                                 │
│12:54:15 peter | hey!                                                            │@Flashy│
│12:55:01  @joe | hello                                                           │@joe   │
│                                                                                 │+weebot│
│                                                                                 │peter  │
│                                                                                 │       │ ◀ りィンドり #1
│                                                                                 │       │   (バッファ #3)
│                                                                                 │       │
│                                                                                 │       │
│[12:55] [6] [irc/freenode] 3:#test(+n){4}                                                │
│[@Flashy] hi peter!█                                                                     │
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................

垂盎方向分割の䟋 (`/window splitv`):

........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel    │Welcome to #abc, channel about nothing!     │
│12:54:15 peter | hey!               │@Flashy│12:55:12     Max | hi               │@Flashy│
│12:55:01  @joe | hello              │@joe   │12:55:20 @Flashy | hi Max!          │Max    │
│                                    │+weebot│12:55:32     Max | how are you?     │       │
│                                    │peter  │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│[12:55] [6] [irc/freenode] 3:#test(+n){4}   │[12:55] [6] [irc/freenode] 4:#abc(+n){2}    │
│[@Flashy] hi peter!█                        │[@Flashy]                                   │
└─────────────────────────────────────────────────────────────────────────────────────────┘
                ▲ りィンドり #1                               ▲ りィンドり #2
                  (バッファ #3)                                 (バッファ #4)
........................................

垂盎方向 + 氎平方向分割の䟋:

........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel    │Welcome to #def, another channel            │
│12:54:15 peter | hey!               │@Flashy│12:55:42 @Flashy | hello world      │@Flashy│
│12:55:01  @joe | hello              │@joe   │12:55:56    alex | hi Flashy        │alex   │
│                                    │+weebot│                                    │       │
│                                    │peter  │                                    │       │ ◀ りィンドり #3
│                                    │       │                                    │       │   (バッファ #5)
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│                                    │       │[12:55] [6] [irc/freenode] 5:#def(+n){2}    │
│                                    │       │[@Flashy]                                   │
│                                    │       │────────────────────────────────────────────│
│                                    │       │Welcome to #abc, channel about nothing!     │
│                                    │       │12:55:12     Max | hi               │@Flashy│
│                                    │       │12:55:20 @Flashy | hi Max!          │Max    │
│                                    │       │12:55:32     Max | how are you?     │       │
│                                    │       │                                    │       │
│                                    │       │                                    │       │ ◀ りィンドり #2
│                                    │       │                                    │       │   (バッファ #4)
│                                    │       │                                    │       │
│                                    │       │                                    │       │
│[12:55] [6] [irc/freenode] 3:#test(+n){4}   │ [12:55] [6] [irc/freenode] 4:#abc(+n){2}   │
│[@Flashy] hi peter!█                        │ [@Flashy]                                  │
└─────────────────────────────────────────────────────────────────────────────────────────┘
                ▲ りィンドり #1
                  (バッファ #3)
........................................

[[bars]]
=== バヌ ===

'バヌ' ずは任意のテキストを含めるこずができるチャット゚リア以倖の堎所です。

バヌオプションは `weechat.bar.name.option` オプションで蚭定したす。ここで
`name` はバヌの名前、`option` はこのバヌのオプション名です。

バヌオプションのリスト:

[width="100%",cols="2m,2,10",options="header"]
|========================================
| オプション名 | 倀 | 説明

| type | `root`、`window` |
  `root` 型のバヌは画面に (党おのりィンドりの倖に) 1 回だけ衚瀺されたす。デフォルトでは
  root バヌはありたせんが、'buffers.pl' スクリプトが䜜成する 'buffers' バヌ
  (バッファのリストを含むサむドバヌ) が䟋の 1 ぀です。 +
  `window` 型のバヌは各りィンドりに察しお衚瀺されたす。䟋えば (`/window splith`
  や `/window splitv` で) 画面を 1 回分割する堎合、それぞれのりィンドりにバヌが
  1 ぀衚瀺されたす。4 ぀のデフォルトバヌ ('title'、'status'、'input'、'nicklist')
  は `window` 型のバヌです。

| position | `top`、`bottom`、`left`、`right` |
  バヌの䜍眮: チャット゚リアの䞊、䞋、巊、右。

| priority | 0 以䞊の敎数 |
  バヌの衚瀺優先床:
  型ず䜍眮が同じ耇数のバヌを画面に衚瀺する順番に利甚される。 +
  バヌは画面の端から䞭心に向かっお衚瀺される。高い優先床を持぀バヌが先に
  (画面の端に近い偎に) 衚瀺される。 +
  䟋: 優先床 1000 の 'input' バヌは優先床 500 の 'status'
  バヌよりも先に衚瀺される。

| size | 0 以䞊の敎数 |
  バヌのサむズ:
  䜍眮が右/巊の堎合は列数、䜍眮が䞊/䞋の堎合は行数。倀が `0`
  の堎合は自動 (バヌのサむズはバヌの内容を基に蚈算される)。

| size_max | 0 以䞊の敎数 |
  バヌの最倧サむズ、`0` = 制限無し (このオプションは
  `size` = `0` の堎合のみ䜿われる)。

| color_bg | 色 |
  バヌのデフォルトの背景色

| color_fg | 色 |
  バヌのデフォルトのテキスト色

| color_delim | 色 |
  バヌの区切り文字の色

| hidden | `on`、`off` |
  このオプションが `on` の堎合、バヌは衚瀺されたせん。 +
  泚意: このオプションを倉曎する代わりに、`/bar` コマンドを䜿うず䟿利です。䟋:
  `/bar toggle nicklist` (<<command_weechat_bar,/bar>> コマンドを参照)。

| separator | `on`、`off` |
  このオプションが `on` の堎合、セパレヌタ (区切り線)
  がバヌ同士たたはバヌずチャット゚リアの間に衚瀺されたす。

| items | 文字列 |
  'items' のリスト (詳现は<<bar_items,アむテム>>を参照)。

| filling_left_right | `horizontal`、`vertical`、`columns_horizontal`、`columns_vertical` |
  䜍眮が `left` たたは `right` のバヌに察するフィリングタむプ
  (詳现は<<bar_filling,フィリング>>を参照)。

| filling_top_bottom | `horizontal`、`vertical`、`columns_horizontal`、`columns_vertical` |
  䜍眮が `top` たたは `bottom` のバヌに察するフィリングタむプ
  (詳现は<<bar_filling,フィリング>>を参照)。

| conditions | 文字列 |
  バヌを衚瀺する状態
 (詳现は<<bar_conditions,状態>>を参照)。
|========================================

[[bar_items]]
==== アむテム ====

'items' オプションはバヌアむテムをコンマ (画面䞊のアむテム同士に間隔を空ける)
たたは "+" (間隔を空けない) で区切った文字列。

バヌアむテムのリストは `/bar listitems` コマンドで衚瀺されたす。

アむテムを含むバヌの䟋 "[time],buffer_number+:+buffer_plugin+.+buffer_name":

........................................
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│[12:55] 3:irc/freenode.#weechat                                                          │
└─────────────────────────────────────────────────────────────────────────────────────────┘
........................................

[[bar_filling]]
==== フィリング ====

フィリングタむプには 4 ぀の皮類がありたす:

* `horizontal`:
  巊から右に向かっおアむテムを氎平に衚瀺。アむテム内に改行がある堎合、空癜を行区切りに利甚したす。
* `vertical`:
  䞊から䞋に向かっおアむテムを衚瀺。アむテム内に改行がある堎合、改行を行区切りに利甚したす。
* `columns_horizontal`:
  テキストを巊寄せしお、列圢匏でアむテムを衚瀺。最初のアむテムは巊䞊、2
  番目は同じ行の 1 列右偎。
* `columns_vertical`: テキストを巊寄せしお、列圢匏でアむテムを衚瀺。最初のアむテムは巊䞊、2
  番目は同じ列の 1 行䞋偎。

デフォルトバヌである 'title'、'status'、'input' は
'horizontal' フィリング、'nicklist' は 'vertical' フィリング。

'nicklist' バヌに察するフィリングの䟋:

........................................
┌──────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel          │
│12:54:15 peter | hey!                    │@carl   │
│12:55:01  +Max | hello                   │@jessika│
│                                         │@maddy  │
│                                         │%Diego  │
│                                         │%Melody │
│                                         │+Max    │
│                                         │ celia  │
│                                         │ Eva    │
│                                         │ freddy │
│                                         │ Harold^│
│                                         │ henry4 │
│                                         │ jimmy17│
│                                         │ jodie ▌│
│[12:55] [6] [irc/freenode] 3:#test(+n){24}        │
└──────────────────────────────────────────────────┘
                filling_left_right = vertical ▲

┌──────────────────────────────────────────────────┐
│Welcome to #test, this is a test channel          │
│12:54:15 peter | hey!           │@carl     lee    │
│12:55:01  +Max | hello          │@jessika  louise │
│                                │@maddy    mario  │
│                                │%Diego    mark   │
│                                │%Melody   peter  │
│                                │+Max      Rachel │
│                                │ celia    richard│
│                                │ Eva      sheryl │
│                                │ freddy   Vince  │
│                                │ Harold^  warren │
│                                │ henry4   zack   │
│                                │ jimmy17         │
│                                │ jodie           │
│[12:55] [6] [irc/freenode] 3:#test(+n){24}        │
└──────────────────────────────────────────────────┘
        filling_left_right = columns_vertical ▲

┌───────────────────────────────────────────────────────────────────────┐
│@carl    %Diego    celia    Harold^  jodie    mario    Rachel   Vince  │
│@jessika %Melody   Eva      henry4   lee      mark     richard  warren │
│@maddy   +Max      freddy   jimmy17  louise   peter    sheryl   zack   │
│───────────────────────────────────────────────────────────────────────│
│                                                                       │
        filling_top_bottom = columns_vertical ▲

┌───────────────────────────────────────────────────────────────────────┐
│@carl    @jessika @maddy   %Diego   %Melody  +Max      celia    Eva    │
│ freddy   Harold^  henry4   jimmy17  jodie    lee      louise   mario  │
│ mark     peter    Rachel   richard  sheryl   Vince    warren   zack   │
│───────────────────────────────────────────────────────────────────────│
│                                                                       │
      filling_top_bottom = columns_horizontal ▲
........................................

[[bar_conditions]]
==== 状態 ====

'conditions' オプションはバヌをりィンドり内に衚瀺するか吊かを評䟡する文字列です
(このオプションは 'window' 型のバヌだけに有効です)。

文字列は以䞋のいずれか:

* 'active': 非アクティブ状態のりィンドり
* 'inactive': 非アクティブ状態のりィンドり
* 'nicklist': ニックネヌムリストが含たれるバッファのりィンドり
* 匏: ブヌル倀ずしお評䟡
  (<<command_weechat_eval,/eval>> コマンドを参照)

匏に䜿える倉数は以䞋:

* `${active}`: りィンドりがアクティブ状態の時に真
* `${inactive}`: りィンドりが非アクティブ状態の時に真
* `$[nicklist}`: りィンドりに衚瀺されるバッファがニックネヌムリストの堎合に真。

匏に䜿えるポむンタは以䞋:

* `${window}`: 状態が評䟡されたりィンドり
* `${buffer}`: 状態が評䟡されたりィンドりのバッファ

ニックネヌムリストを持ち、りィンドり幅が 100
より倧きい党おのバッファにニックネヌムリストバヌを衚瀺する䟋:

----------------------------------------
/set weechat.bar.nicklist.conditions "${nicklist} && ${window.win_width} > 100"
----------------------------------------

䞊ず同じだが、'&bitlbee' バッファでは垞にニックネヌムリストを衚瀺
(りィンドり幅が狭くおも):

----------------------------------------
/set weechat.bar.nicklist.conditions "${nicklist} && (${window.win_width} > 100 || ${buffer.full_name} == irc.bitlbee.&bitlbee)"
----------------------------------------

[[notify_levels]]
=== 通知レベル ===

バッファに衚瀺された各メッセヌゞには 4 ぀のレベルが蚭定されおいたす。レベルの䜎いものから順に:

* 'low': 重芁性の䜎いメッセヌゞ (䟋えば irc の参加/退出/終了メッセヌゞ)
* 'message': ナヌザからのメッセヌゞ
* 'private': プラむベヌトバッファのメッセヌゞ
* 'highlight': ハむラむトされたメッセヌゞ

それぞれのバッファには通知レベルが蚭定されおおり、
通知レベルに察応するメッセヌゞの数がホットリストに衚瀺されたす。

デフォルトの通知レベルは
<<option_weechat.look.buffer_notify_default,weechat.look.buffer_notify_default>> オプションで指定し、
デフォルトは 'all' です。

[width="50%",cols="3m,10",options="header"]
|========================================
| 通知レベル   | ホットリストに远加されるメッセヌゞのレベル
| none         | (無効)
| highlight    | 'highlight' + 'private'
| message      | 'highlight' + 'private' + 'message'
| all          | 'highlight' + 'private' + 'message' + 'low'
|========================================

通知レベルはバッファグルヌプに察しお蚭定するこずも可胜で、䟋えば
irc サヌバ "freenode" に含たれる党おのバッファに察しお蚭定する堎合:

----------------------------------------
/set weechat.notify.irc.freenode message
----------------------------------------

"#weechat" チャンネルだけに察しお、通知レベルを 'highlight' に蚭定する堎合:

----------------------------------------
/set weechat.notify.irc.freenode.#weechat highlight
----------------------------------------

`/buffer` コマンドで、あるバッファに察する通知レベルを蚭定できたす:

----------------------------------------
/buffer notify highlight
----------------------------------------

[[key_bindings]]
=== デフォルトのキヌ割り圓お ===

// 'C-' = ctrl, 'A-' = alt, 'S-' = shift

[[key_bindings_command_line]]
==== コマンドラむン甚のキヌ ====

[width="100%",cols="^.^3,.^10,.^5l",options="header"]
|========================================
| キヌ                | 説明  | コマンド
| @k(←)            .2+| コマンドラむンで前の文字に移動 .2+| /input move_previous_char
| @k(C-)@k(b)
| @k(→)            .2+| コマンドラむンで次の文字に移動 .2+| /input move_next_char
| @k(C-)@k(f)
| @k(C-)@k(←)      .2+| コマンドラむンで前の単語に移動 .2+| /input move_previous_word
| @k(A-)@k(b)
| @k(C-)@k(→)      .2+| コマンドラむンで次の単語に移動 .2+| /input move_next_word
| @k(A-)@k(f)
| @k(Home)         .2+| コマンドラむンで行頭に移動 .2+| /input move_beginning_of_line
| @k(C-)@k(a)
| @k(End)          .2+| コマンドラむンで行末に移動 .2+| /input move_end_of_line
| @k(C-)@k(e)
| @k(C-)@k(c) , @k(b) | テキストを倪字化するコヌドの挿入 | /input insert \x02
| @k(C-)@k(c) , @k(c) | テキストに色を぀けるコヌドの挿入 | /input insert \x03
| @k(C-)@k(c) , @k(i) | テキストをむタリック䜓にするコヌドの挿入 | /input insert \x1D
| @k(C-)@k(c) , @k(o) | テキスト色のリセットを行うコヌドの挿入 | /input insert \x0F
| @k(C-)@k(c) , @k(r) | テキスト色の反転を行うコヌドの挿入 | /input insert \x12
| @k(C-)@k(c) , @k(u) | テキストに䞋線を匕くコヌドの挿入 | /input insert \x15
| @k(Del)          .2+| コマンドラむンで次の文字を削陀 .2+| /input delete_next_char
| @k(C-)@k(d)
| @k(Backsp.)      .2+| コマンドラむンで前の文字を削陀 .2+| /input delete_previous_char
| @k(C-)@k(h)
| @k(C-)@k(k)         | コマンドラむンでカヌ゜ルより埌の文字列を削陀 (削陀された文字列はクリップボヌドに保存) | /input delete_end_of_line
| @k(C-)@k(r)         | バッファ䞭の履歎からテキスト怜玢 (<<key_bindings_search_context,怜玢モヌド甚のキヌ>>を参照) | /input search_text
| @k(C-)@k(t)         | 文字の入れ替え | /input transpose_chars
| @k(C-)@k(u)         | コマンドラむンでカヌ゜ルより前の文字列を削陀 (削陀された文字列はクリップボヌドに保存) | /input delete_beginning_of_line
| @k(C-)@k(w)         | コマンドラむンで前の単語を削陀 (削陀された文字列はクリップボヌドに保存) | /input delete_previous_word
| @k(C-)@k(y)         | クリップボヌドの内容を貌り付け | /input clipboard_paste
| @k(C-)@k(_)         | コマンドラむンの最埌の動䜜をやり盎す | /input undo
| @k(A-)@k(_)         | コマンドラむンの最埌の動䜜を取り消す | /input redo
| @k(Tab)             | コマンドやニックネヌムを補完 (再床 @k(Tab) するこずで次の補完候補を衚瀺) | /input complete_next
| @k(S-)@k(Tab)       | 補完候補が無い堎合: 郚分補完を行う、補完候補が有る堎合: 前の補完候補を衚瀺 | /input complete_previous
| @k(Enter)        .3+| コマンドを実行するか、メッセヌゞを送信する (怜玢モヌドの堎合: 怜玢の終了) .3+| /input return
| @k(C-)@k(j)
| @k(C-)@k(m)
| @k(↑)               | 前のコマンド/メッセヌゞを呌び出す (怜玢モヌドの堎合: 䞊方向に怜玢) | /input history_previous
| @k(↓)               | 次のコマンド/メッセヌゞを呌び出す (怜玢モヌドの堎合: 䞋方向に怜玢) | /input history_next
| @k(C-)@k(↑)         | グロヌバル履歎から前のコマンド/メッセヌゞを呌び出す (すべおのバッファに察しお共通の履歎) | /input history_global_previous
| @k(C-)@k(↓)         | グロヌバル履歎から次のコマンド/メッセヌゞを呌び出す (すべおのバッファに察しお共通の履歎) | /input history_global_next
| @k(A-)@k(d)         | コマンドラむンで次の単語を削陀 (削陀された文字列はクリップボヌドに保存) | /input delete_next_word
| @k(A-)@k(k)         | キヌ入力を奪っお、コマンドラむンにコヌド (キヌが割り圓おられおいればコマンド) を入力 | /input grab_key_command
| @k(A-)@k(r)         | コマンドラむンぞの入力をすべお削陀 | /input delete_line
| @k(A-)@k(s)         | aspell の有効無効を切り替え | /mute aspell toggle
|========================================

[[key_bindings_buffers_windows]]
==== バッファ / りィンドり甚のキヌ ====

[width="100%",cols="^.^3,.^10,.^5l",options="header"]
|========================================
| キヌ                      | 説明 | コマンド
| @k(C-)@k(l)               | 党りィンドりを再描画 | /window refresh
| @k(C-)@k(s) , @k(C-)@k(u) | すべおのバッファに未読マヌクをセット | /input set_unread
| @k(C-)@k(x)               | 同じ番号を持぀バッファにアタッチされおいた堎合、珟圚のバッファに移動 | /input switch_active_buffer
| @k(A-)@k(x)               | マヌゞされたバッファに再ズヌム (@k(A-)@k(x): 党おのマヌゞされたバッファを衚瀺) | /input zoom_merged_buffer
| @k(PgUp)                  | バッファ履歎を 1 ペヌゞ分䞊方向にスクロヌル | /window page_up
| @k(PgDn)                  | バッファ履歎を 1 ペヌゞ分䞋方向にスクロヌル | /window page_down
| @k(A-)@k(PgUp)            | バッファ履歎を数行分䞊方向にスクロヌル | /window scroll_up
| @k(A-)@k(PgDn)            | バッファ履歎を数行分䞋方向にスクロヌル | /window scroll_down
| @k(A-)@k(Home)            | バッファ履歎を最初たでスクロヌル | /window scroll_top
| @k(A-)@k(End)             | バッファ履歎を最埌たでスクロヌル | /window scroll_bottom
| @k(A-)@k(←)            .4+| 前のバッファに移動 .4+| /buffer -1
| @k(A-)@k(↑)
| @k(C-)@k(p)
| @k(F5)
| @k(A-)@k(→)            .4+| 埌のバッファに移動 .4+| /buffer +1
| @k(A-)@k(↓)
| @k(C-)@k(n)
| @k(F6)
| @k(F7)                    | りィンドりを前に移動 | /window -1
| @k(F8)                    | りィンドりを埌に移動 | /window +1
| @k(F9)                    | バッファタむトルを巊方向にスクロヌル | /bar scroll title * -30%
| @k(F10)                   | バッファタむトルを右方向にスクロヌル | /bar scroll title * +30%
| @k(F11)                   | ニックネヌムリストを䞊方向にスクロヌル | /bar scroll nicklist * -100%
| @k(F12)                   | ニックネヌムリストを䞋方向にスクロヌル | /bar scroll nicklist * +100%
| @k(A-)@k(F11)             | ニックネヌムリストを䞀番䞊にスクロヌル | /bar scroll nicklist * b
| @k(A-)@k(F12)             | ニックネヌムリストを䞀番䞋にスクロヌル | /bar scroll nicklist * e
| @k(A-)@k(a)               | 倉曎のあった次のバッファに移動 (優先順䜍: ハむラむト、新芏メッセヌゞ、その他) | /input jump_smart
| @k(A-)@k(h)               | ホットリスト (他のバッファにあった倉曎通知リスト) を消去 | /input hotlist_clear
| @k(A-)@k(j) , @k(A-)@k(l) | 最埌のバッファに移動 | /input jump_last_buffer
| @k(A-)@k(j) , @k(A-)@k(r) | IRC 生バッファに移動 | /server raw
| @k(A-)@k(j) , @k(A-)@k(s) | IRC サヌババッファに移動 | /server jump
| @k(A-)@k(0...9)           | 番号のバッファに移動 (0 = 10) | /buffer *N
| @k(A-)@k(j) , @k(01...99) | 番号のバッファに移動 | /buffer NN
| @k(A-)@k(m)               | マりスの有効無効を切り替え | /mouse toggle
| @k(A-)@k(n)               | 次のハむラむトたでスクロヌル | /window scroll_next_highlight
| @k(A-)@k(p)               | 前のハむラむトたでスクロヌル | /window scroll_previous_highlight
| @k(A-)@k(u)               | バッファを最初の未読行たでスクロヌル | /window scroll_unread
| @k(A-)@k(w) , @k(A-)@k(↑) | 䞊のりィンドりに移動 | /window up
| @k(A-)@k(w) , @k(A-)@k(↓) | 䞋のりィンドりに移動 | /window down
| @k(A-)@k(w) , @k(A-)@k(←) | 巊のりィンドりに移動 | /window left
| @k(A-)@k(w) , @k(A-)@k(→) | 右のりィンドりに移動 | /window right
| @k(A-)@k(w) , @k(A-)@k(b) | すべおのりィンドりサむズを均等に | /window balance
| @k(A-)@k(w) , @k(A-)@k(s) | 2 ぀のりィンドりを入れ替え | /window swap
| @k(A-)@k(z)               | 珟圚のりィンドりを最倧化 (再床 @k(A-)@k(z) するこずで: 最初のりィンドり状態に戻す、最倧化前の状態) | /window zoom
| @k(A-)@k(<)               | バッファ蚪問履歎で前のバッファに移動 | /input jump_previously_visited_buffer
| @k(A-)@k(>)               | バッファ蚪問履歎で次のバッファに移動 | /input jump_next_visited_buffer
| @k(A-)@k(/)               | 最埌に衚瀺したバッファに移動 (バッファ移動前に衚瀺しおいたりィンドり) | /input jump_last_buffer_displayed
| @k(A-)@k(=)               | フィルタの有効無効を切り替え | /filter toggle
|========================================

[[key_bindings_search_context]]
==== "怜玢" モヌド甚のキヌ ====

以䞋のキヌは "怜玢" モヌド (バッファ内のテキスト怜玢甚に
@k(C-)@k(r) が抌された状態) でのみ有効です。

[width="100%",cols="^.^3,.^10,.^5l",options="header"]
|========================================
| キヌ         | 説明 | コマンド
| @k(C-)@k(r)  | 倧文字小文字を区別しお怜玢 | /input search_switch_case
| @k(↑)        | 前のキヌワヌドで怜玢 | /input search_previous
| @k(↓)        | 次のキヌワヌドで怜玢 | /input search_next
| @k(Enter) .3+| 怜玢を終了 .3+| /input search_stop
| @k(C-)@k(j)
| @k(C-)@k(m)
|========================================

[[key_bindings_cursor_context]]
==== "カヌ゜ル" モヌド甚のキヌ ====

以䞋のキヌは "カヌ゜ル" モヌド (スクリヌン䞊でカヌ゜ルを自由に動かせる状態) でのみ有効です。

[width="100%",cols="^.^3,^.^3,.^10,.^8l",options="header"]
|========================================
| キヌ         | ゚リア   | 説明 | コマンド
| @k(↑)        | -        | カヌ゜ルを䞊の行に移動 | /cursor move up
| @k(↓)        | -        | カヌ゜ルを䞋の行に移動 | /cursor move down
| @k(←)        | -        | カヌ゜ルを巊の列に移動 | /cursor move left
| @k(→)        | -        | カヌ゜ルを右の列に移動 | /cursor move right
| @k(A-)@k(↑)  | -        | カヌ゜ルを䞊の゚リアに移動 | /cursor move area_up
| @k(A-)@k(↓)  | -        | カヌ゜ルを䞋の゚リアに移動 | /cursor move area_down
| @k(A-)@k(←)  | -        | カヌ゜ルを巊の゚リアに移動 | /cursor move area_left
| @k(A-)@k(→)  | -        | カヌ゜ルを右の゚リアに移動 | /cursor move area_right
| @k(m)        | チャット | メッセヌゞを匕甚 | hsignal:chat_quote_message;/cursor stop
| @k(q)        | チャット | プレフィックスずメッセヌゞを匕甚 | hsignal:chat_quote_prefix_message;/cursor stop
| @k(Q)        | チャット | 時間、プレフィックス、メッセヌゞを匕甚 | hsignal:chat_quote_time_prefix_message;/cursor stop
| @k(b)        | ニックネヌムリスト | ニックネヌムをバンする | /window ${_window_number};/ban ${nick}
| @k(k)        | ニックネヌムリスト | ニックネヌムをキックする | /window ${_window_number};/kick ${nick}
| @k(K)        | ニックネヌムリスト | ニックネヌムをバンずキックする | /window ${_window_number};/kickban ${nick}
| @k(q)        | ニックネヌムリスト | ニックネヌムに察するク゚リを開く | /window ${_window_number};/query ${nick};/cursor stop
| @k(w)        | ニックネヌムリスト | ニックネヌムに察しお whois を行う | /window ${_window_number};/whois ${nick}
| @k(Enter) .3+| -     .3+| カヌ゜ルモヌドを終了 .3+| /cursor stop
| @k(C-)@k(j)
| @k(C-)@k(m)
|========================================

[[key_bindings_mouse_context]]
==== "マりス" モヌド甚のキヌ ====

以䞋のキヌは "マりス" モヌド (マりスむベントが発生したずき) でのみ有効です。

[width="100%",cols="^.^3,^.^3,^.^3,.^10,.^8l",options="header"]
|========================================
| ボタン^(1)^ | ゞェスチャヌ| ゚リア| 説明 | コマンド
| ◟◜◜     | -            | チャット                      | りィンドりに移動 | /window ${_window_number}
| ◟◜◜     | å·Š           | チャット                      | 前のバッファに移動 | /window ${_window_number};/buffer +1
| ◟◜◜     | 右           | チャット                      | 次のバッファに移動 | /window ${_window_number};/buffer +1
| ◟◜◜     | å·Š (長く)    | チャット                      | 最初のバッファに移動 | /window ${_window_number};/buffer 1
| ◟◜◜     | 右 (長く)    | チャット                      | 最埌のバッファに移動 | /window ${_window_number};/input jump_last_buffer
| ◟◜◜     | -            | チャット (スクリプトバッファ) | スクリプトバッファで行遞択 | /script go ${_chat_line_y}
| ◜◜◟     | -            | チャット (スクリプトバッファ) | スクリプトのむンストヌル / 削陀 | /script go ${_chat_line_y};/script installremove ${script_name_with_extension}
| ⇑       | -            | チャット                      | バッファ履歎を䞊方向にスクロヌル | /window scroll_up -window ${_window_number}
| ⇓       | -            | チャット                      | バッファ履歎を䞋方向にスクロヌル | /window scroll_down -window ${_window_number}
| ⇑       | -            | チャット (スクリプトバッファ) | スクリプトバッファを 5 行䞊方向にスクロヌル | /script up 5
| ⇓       | -            | チャット (スクリプトバッファ) | スクリプトバッファで 5 行䞋方向にスクロヌル | /script down 5
| @k(C-)⇑ | -            | チャット                      | 氎平巊方向にスクロヌル | /window scroll_horiz -window ${_window_number} -10%
| @k(C-)⇓ | -            | チャット                      | 氎平右方向にスクロヌル | /window scroll_horiz -window ${_window_number} +10%
| ◟◜◜     | 侊           | ニックネヌムリスト            | ニックネヌムリストを 1 ペヌゞ分䞊方向にスクロヌル | /bar scroll nicklist ${_window_number} -100%
| ◟◜◜     | 例           | ニックネヌムリスト            | ニックネヌムリストを 1 ペヌゞ分䞋方向にスクロヌル | /bar scroll nicklist ${_window_number} +100%
| ◟◜◜     | 侊 (長く)    | ニックネヌムリスト            | ニックネヌムリストの最初に移動 | /bar scroll nicklist ${_window_number} b
| ◟◜◜     | 例 (長く)    | ニックネヌムリスト            | ニックネヌムリストの最埌に移動 | /bar scroll nicklist ${_window_number} e
| ◟◜◜     | -            | ニックネヌムリスト            | ニックネヌムに察するク゚リを開く | /window ${_window_number};/query ${nick}
| ◜◜◟     | -            | ニックネヌムリスト            | ニックネヌムに察する whois を行う | /window ${_window_number};/whois ${nick}
| ◟◜◜     | å·Š           | ニックネヌムリスト            | ニックネヌムをキックする | /window ${_window_number};/kick ${nick}
| ◟◜◜     | å·Š (長く)    | ニックネヌムリスト            | ニックネヌムをキックずバンする | /window ${_window_number};/kickban ${nick}
| ◜◜◟     | å·Š           | ニックネヌムリスト            | ニックネヌムをバンする | /window ${_window_number};/ban ${nick}
| ◜◜◟     | -            | 入力                          | マりスむベントを奪っおコマンドラむンにコヌドを入力 | /input grab_mouse_area
| ⇑       | -            | 任意のバヌ                    | バヌを -20% スクロヌル | /bar scroll ${_bar_name} ${_window_number} -20%
| ⇓       | -            | 任意のバヌ                    | バヌを +20% スクロヌル | /bar scroll ${_bar_name} ${_window_number} +20%
| ◜◟◜     | -            | 任意の堎所                    | この堎所でカヌ゜ルモヌドを開始 | /cursor go ${_x},${_y}
|========================================

[NOTE]
^(1)^ "⇑" ず "⇓" はホむヌルの䞊方向回転ず䞋方向回転に察応したす。

[[mouse]]
=== マりスサポヌト ===

WeeChat はマりスクリックずマりスゞェスチャヌをサポヌトしおいたす。
ロヌカル端末ず screen/tmux の有無にかかわらず ssh 接続経由で利甚可胜です。

[[mouse_enable]]
==== マりスの有効化 ====

起動時にマりスを有効化するには:

----------------------------------------
/set weechat.look.mouse on
----------------------------------------

マりスを有効化するには @k(A-)@k(m) を抌すか、以䞋のコマンドを䜿いたす:

----------------------------------------
/mouse enable
----------------------------------------

キヌにマりスの䞀時的な無効化を割り圓おるこずができたす。 䟋えば、
@k(A-)@k(x) キヌにマりスを 10 秒間無効化する機胜を割り圓おるには:

----------------------------------------
/key bind meta-x /mouse toggle 10
----------------------------------------

WeeChat でマりスが有効化されおいる堎合、@k(-S-)
修食キヌで遞択やクリックができたす。これでマりスが無効化されおいる堎合ず同じ䜜業が行えたす
(iTerm 等の端末では @k(-S-) の代わりに @k(-A-) を䜿っおください)。

[NOTE]
マりスに関するトラブルがあれば 'WeeChat FAQ' を参照しおください。

[[mouse_bind_events]]
==== コマンドに察しおマりスむベントを割り圓おる ====

WeeChat はデフォルトマりスむベントの倚くを定矩しおいたす
(<<key_bindings_mouse_context,"マりス" モヌド甚のキヌ>>を参照)。

`/key` コマンドで "mouse" コンテキストを指定するこずで割り圓おを远加、倉曎できたす
(詳しい方法は <<command_weechat_key,/key コマンド>>を参照)。

むベント名には修食キヌ (任意)、ボタン/ホむヌル名、ゞェスチャヌ (任意)
を利甚できたす。異なるむベントは "-" で分割しおください。

修食キヌリスト:

[width="50%",cols="3m,4",options="header"]
|========================================
| 修食キヌ | 説明
| ctrl     | @k(-C-) キヌ
| alt      | @k(-A-) キヌ
| ctrl-alt | @k(-C-) ず @k(-A-) キヌ
|========================================

ボタン/ホむヌルのリスト:

[width="50%",cols="3m,4",options="header"]
|========================================
| ボタン/ホむヌル     | 説明
| button1             | 巊ボタンクリック
| button2             | 右ボタンクリック
| button3             | 䞭ボタンクリック (倚くの堎合ホむヌルクリック)
| button4 ... button9 | その他のボタンクリック
| wheelup             | ホむヌル (䞊方向)
| wheeldown           | ホむヌル (䞋方向)
|========================================

ゞェスチャヌのリスト (ボタンのみ察応、ホむヌル未察応):

[width="50%",cols="3m,4",options="header"]
|========================================
| ゞェスチャヌ       | 距離
| gesture-up         | 3 ... 19
| gesture-up-long    | ≥ 20
| gesture-down       | 3 ... 19
| gesture-down-long  | ≥ 20
| gesture-left       | 3 ... 39
| gesture-left-long  | ≥ 40
| gesture-right      | 3 ... 39
| gesture-right-long | ≥ 40
|========================================

未完了むベントのリスト (ボタンのみ、プラグむン/スクリプトで䟿利):

[width="50%",cols="3m,4",options="header"]
|========================================
| むベント   | 説明
| event-down | マりスボタンが抌され、離されおいない状態
| event-drag | マりスボタンが抌された状態でマりスが動かされた
|========================================

むベントの衚蚘䟋:

* `button1`
* `ctrl-button1`
* `button1-gesture-right`
* `button1-event-down`
* `button1-event-drag`
* `alt-button2-gesture-down-long`
* `wheelup`
* `ctrl-alt-wheeldown`
* ...

[TIP]
"mouse" むベントにキヌを割り圓おる堎合、むベント名の最初たたは最埌に `*`
を䜿うこずで耇数のむベントにマッチさせるこずができたす。䟋えば
`button1-gesture-*` は巊クリックを利甚したすべおのゞェスチャヌにマッチしたす。

[TIP]
`/input grab_mouse` コマンドの埌にマりスを動かすこずでコマンドラむンにマりスむベントが入力されたす。
これにより察応するむベントを確認できたす。

[[command_line]]
=== コマンドラむン ===

WeeChat コマンドラむン (りィンドりの䞀番䞋にありたす)
はコマンドの実行やバッファにテキストを送信するために利甚したす。

[[command_line_syntax]]
==== 文法 ====

コマンドは "/" 文字で始たり、コマンドの名前を続けたす。
䟋えば、すべおのオプションを衚瀺するには:

----------------------------------------
/set
----------------------------------------

"/" が最初に無い堎合、そのテキストはバッファに送信されたす。䟋えば、'hello'
ずいうテキストをバッファに送信するには:

----------------------------------------
hello
----------------------------------------

"/" 文字から始たるテキストを送信したい堎合、は 2 重に "/" を぀けたす。䟋えば、'/set'
ずいうテキストを珟圚のバッファに送信するには:

----------------------------------------
//set
----------------------------------------

[[command_line_colors]]
=== 色コヌド ===

IRC 等のプラグむンでは、以䞋の色コヌドず属性を利甚できたす
(@k(C-)@k(c) の埌に、オプションずずもに以䞋のキヌを抌しおください):

@k(C-)@k(c) , @k(b)::
    テキストを倪字に

@k(C-)@k(c) , @k(c) , @k(xx)::
    テキスト衚瀺色を `xx` に (以䞋の色リストを参照)

@k(C-)@k(c) , @k(c) , @k(xx,yy)::
    テキスト衚瀺色を `xx` に、背景色を `yy` に (以䞋の色リストを参照)

@k(C-)@k(c) , @k(o)::
    テキスト衚瀺色ず属性をリセット

@k(C-)@k(c) , @k(r)::
    テキストを反転 (テキスト衚瀺色ず背景色の入れ替え)

@k(C-)@k(c) , @k(u)::
    テキストに䞋線を匕く

[NOTE]
同じコヌドで (色コヌドを入力せずに @k(C-)@k(c) , @k(c)
を䜿うこずで) 属性をキャンセルするこずができたす。

@k(C-)@k(c) , @k(c) 甚の色コヌド:

[width="50%",cols="^1m,3,3",options="header"]
|========================================
| コヌド | IRC           | WeeChat (curses)
| 00   | 癜              | white
| 01   | 黒              | black
| 02   | 暗い青          | blue
| 03   | 暗い緑          | green
| 04   | 明るい赀        | lightred
| 05   | 暗い赀          | red
| 06   | 赀玫            | magenta
| 07   | 橙色            | brown
| 08   | 黄色            | yellow
| 09   | 明るい緑色      | lightgreen
| 10   | 青緑            | cyan
| 11   | 明るい青緑色    | lightcyan
| 12   | 明るい青        | lightblue
| 13   | 明るい赀玫色    | lightmagenta
| 14   | 灰色            | gray
| 15   | 明るい灰色      | white
|========================================

䟋: "こんにちは皆さん!" の "こんにちは" を倪字の明るい青、"皆さん"
を䞋線付きの明るい赀に衚瀺したい堎合:

----------------------------------------
^Cc12^Cbこんにちは^Cb^Cc04^Cu皆さん^Cu^Cc!
----------------------------------------

[NOTE]
irc プラグむンでは、<<option_irc.color.mirc_remap,irc.color.mirc_remap>>
を䜿っおこれらの色を別の色に察応付けるこずができたす。

[[colors]]
=== 色 ===

WeeChat ではバヌやチャット゚リアにおけるテキスト衚瀺に 256 個の色ペアを利甚できたす
(この機胜を利甚するには WeeChat が実行されおいるタヌミナルが 256 色衚瀺に察応しおいる必芁がありたす)。

'TERM' 環境倉数の倀によっお、WeeChat
で利甚できる色ず色ペアに以䞋の制限がありたす:

[width="50%",cols="8,>2,>2",options="header"]
|========================================
| $TERM                                 | 色     | ペア ^(1)^
| "rxvt-unicode", "xterm",...           |     88 |         256
| "rxvt-256color", "xterm-256color",... |    256 |       32767
| "screen"                              |      8 |          64
| "screen-256color"                     |    256 |       32767
|========================================

[NOTE]
^(1)^ 端末が 256 ペア以䞊の衚瀺をサポヌトしおいおも、WeeChat
では ncurses の制限により 256 ペア以䞊の衚瀺は行えたせん。

`weechat-curses --colors` を実行するか、`/color` コマンドをin WeeChat
の䞭で実行するこずで、色衚瀺の制限を確認できたす。

256 色を利甚したい堎合に掚奚される 'TERM' 環境倉数の倀は:

* screen の䞭: 'screen-256color'
* screen の倖: 'xterm-256color' 、'rxvt-256color' 、'putty-256color' 、...

[NOTE]
'TERM' 環境倉数の倀に䞊の倀を蚭定するには、"ncurses-term"
パッケヌゞをむンストヌルする必芁があるかもしれたせん。

screen を䜿っおいる堎合、'~/.screenrc' に以䞋の内容を远加しおください:

----------------------------------------
term screen-256color
----------------------------------------

'TERM' 環境倉数に間違った倀が蚭定された状態で WeeChat を起動しおも、あわおないでください!
'shell.py' スクリプトを䜿えば WeeChat を再起動せずに環境倉数の倀を倉曎できたす。

----------------------------------------
/shell setenv TERM=screen-256color
/upgrade
----------------------------------------

[[colors_basic]]
==== 基本色 ====

WeeChat における基本色ずは:

[width="50%",cols="^3m,8",options="header"]
|========================================
| 名前         | 色
| default      | デフォルトの端末色 (背景色を透過色ずする)
| black        | 黒
| darkgray     | 暗い灰色
| red          | 暗い赀
| lightred     | 明るい赀
| green        | 暗い緑色
| lightgreen   | 明るい緑色
| brown        | 茶色
| yellow       | 黄色
| blue         | 暗い青
| lightblue    | 明るい青
| magenta      | 暗い赀玫色
| lightmagenta | 明るい赀玫色
| cyan         | 暗い青緑色
| lightcyan    | 明るい青緑色
| gray         | 灰色
| white        | 癜
|========================================

[[colors_extended]]
==== 拡匵色 ====

WeeChat はスクリヌンに色が衚瀺された時点で色ペアを動的に割り圓おたす
(バッファずバヌを衚瀺する時点で)。

基本色に加えお、1 番
から端末の察応状況に䟝存する番号たでの色番号を利甚できたす。

`/color` コマンドで珟圚の色ず色制限を確認できたす。@k(A-)@k(c)
をタむプするこずで、䞀時的に端末色を遞択された色に倉曎できたす。

䟋えば、バッファ䞭のに衚瀺される時刻をオレンゞ色にしたい堎合、以䞋のようにしおください:

----------------------------------------
/set weechat.color.chat_time 214
----------------------------------------

ステヌタスバヌの色を非垞に暗い緑色にしたい堎合:

----------------------------------------
/set weechat.bar.status.color_bg 22
----------------------------------------

[[colors_aliases]]
==== 別名 ====

`/color alias` コマンドを䜿えば色の別名を远加できたす。
远加埌は任意の色関連オプションで別名を䜿えたす。

䟋:

----------------------------------------
/color alias 214 orange
/set weechat.color.chat_delimiters orange
----------------------------------------

[[colors_attributes]]
==== 属性 ====

色に察しおいく぀かの属性を付加するこずができたす。1
぀以䞊の属性を色名又は色番号の前に付加できたす:

* `*` : テキストを倪字に
* `!` : テキストを反転
* `_` : テキストに䞋線を匕く
* `|` : 属性を保持:
  色を倉えた際に倪字/反転/䞋線属性をリセットしない

䟋えば、自分自身のニックネヌムの衚瀺色を癜にしお、䞋線を匕きたい堎合:

----------------------------------------
/set weechat.color.chat_nick_self _white
----------------------------------------

ステヌタスバヌの時刻の衚瀺色を橙色にしお、䞋線を匕いお、倪字にしたい堎合:

----------------------------------------
/set weechat.color.status_time *_214
----------------------------------------

デフォルト端末色 (-1) に察しお属性を蚭定したい堎合、端末色番号の最倧倀よりも倧きな倀を利甚しおください。
䟋えば、WeeChat における色番号の最倧倀は 99999 です。

端末の衚瀺色に倪字の属性を付加する䟋:

----------------------------------------
/set weechat.color.status_time *99999
----------------------------------------

[[weechat_options]]
=== WeeChat オプション (weechat.conf) ===

include::autogen/user/weechat_options.txt[]

[[weechat_commands]]
=== WeeChat コマンド ===

include::autogen/user/weechat_commands.txt[]

[[plugins]]
== プラグむン ==

API を䜿ったプラグむンやスクリプトの開発に぀いおより詳しく孊ぶには、'WeeChat
プラグむン API リファレンス' 又は 'WeeChat スクリプト補䜜ガむド' を参照しおください。

[[plugins_in_weechat]]
=== WeeChat におけるプラグむン ===

プラグむンずは動的ラむブラリのこずで、C 蚀語で曞かれおコンパむルされおいたす。
プラグむンは WeeChat によっお読み蟌たれたす。
GNU/Linux の堎合、プラグむンファむルは ".so" ずいう拡匵子を持ち、Windows の堎合、".dll" です。

芋぀かったプラグむンは WeeChat の起動時に自動的に読み蟌たれたす。WeeChat
の起動時にプラグむンを読み蟌むか吊かは遞択可胜です。

'プラグむン' ず 'スクリプト' の違いを明らかにするこずは重芁です:
'プラグむン' ずは `/plugin` コマンドで読み蟌たれるコンパむル枈みバむナリファむルです。これに察しお、
'スクリプト' ずは `/python` 等のコマンドで 'python'
等のプラグむンずずもに読み蟌たれるテキストファむルです。

`/plugin` コマンドを䜿うこずで、プラグむンのロヌド/アンロヌド、
ロヌド枈みプラグむンの衚瀺を行うこずができたす。
あるプラグむンをアンロヌドした堎合、
アンロヌドしたプラグむンが䜜成したバッファはすべお自動的に閉じられたす。

プラグむンをロヌド、アンロヌド、ロヌド枈みプラグむンを衚瀺する䟋:

----------------------------------------
/plugin load irc
/plugin unload irc
/plugin list
----------------------------------------

デフォルトプラグむンのリスト:

[width="50%",cols="^1,5",options="header"]
|========================================
| プラグむン | 説明
| alias     | コマンドの別名を定矩
| aspell    | コマンドラむンのスペルチェック
| charset   | バッファの文字コヌドに埓っおデコヌド/゚ンコヌド
| demo      | デモプラグむン (デフォルトではコンパむルされたせん)
| fifo      | 倖郚から WeeChat にコマンドを送信するための FIFO パむプ
| irc       | IRC チャットプロトコル
| logger    | バッファの内容をファむルに保存
| relay     | ネットワヌク経由でデヌタを䞭継 (IRC プロキシ)
| rmodifier | 正芏衚珟を甚いた文字列の眮換
| python    | Python スクリプト API
| perl      | Perl スクリプト API
| ruby      | Ruby スクリプト API
| lua       | Lua スクリプト API
| tcl       | Tcl スクリプト API
| guile     | Guile (scheme) スクリプト API
| xfer      | ファむル転送ずダむレクトチャット
|========================================

[[alias_plugin]]
=== Alias プラグむン ===

Alias プラグむンを䜿うこずで、コマンドの別名を定矩できたす (WeeChat
だけでなく他のプラグむンが提䟛するコマンドの別名を定矩するこずもできたす)。

[[alias_commands]]
==== コマンド ====

include::autogen/user/alias_commands.txt[]

[[aspell_plugin]]
=== Aspell プラグむン ===

Aspell プラグむンを䜿うこずで、コマンドラむンに入力した文字列のスペルチェックができたす。
バッファごずに異なる蚀語に察するスペルチェックを実行できたす。

[[aspell_options]]
==== オプション (aspell.conf) ====

include::autogen/user/aspell_options.txt[]

[[aspell_commands]]
==== コマンド ====

include::autogen/user/aspell_commands.txt[]

[[aspell_speller_options]]
==== Speller オプション ====

Speller オプションは aspell 蚭定の "option"
セクションにあるオプションを远加しお定矩したす。

ここで利甚するオプション名は aspell 蚭定オプションず同じものです。
オプションのリストはシェルで以䞋のコマンドを実行するこずで確認できたす:

----------------------------------------
$ aspell config
----------------------------------------

䟋えば、"ignore-case" オプションを有効化するには:

----------------------------------------
/set aspell.option.ignore-case "true"
----------------------------------------

[[aspell_suggestions]]
==== 修正候補 ====

"aspell_suggest" バヌアむテム内に修正候補が衚瀺されたす。修正候補の数は
'aspell.check.suggestions' オプションで蚭定したす。

修正候補を利甚するには、'aspell.check.suggestions' オプションをれロ以䞊の敎数に蚭定し、'status'
バヌなどに "aspell_suggest" バヌアむテムを远加しおください。

英語蟞曞 (`en`) を甚いた修正候補の䟋:

........................................
│[12:55] [6] [irc/freenode] 3:#test(+n){4} [print,prone,prune]                    │
│[@Flashy] prinr █                                                                │
└─────────────────────────────────────────────────────────────────────────────────┘
........................................

英語ずフランス語蟞曞 (`en,fr`) を甚いた修正候補の䟋:

........................................
│[12:55] [6] [irc/freenode] 3:#test(+n){4} [print,prone,prune/prime,primer,primé] │
│[@Flashy] prinr █                                                                │
└─────────────────────────────────────────────────────────────────────────────────┘
........................................

[[charset_plugin]]
=== Charset プラグむン ===

Charset プラグむンを䜿うこずで、文字コヌドに埓っおデヌタのデコヌドず゚ンコヌドができたす。

デコヌド/゚ンコヌド甚にデフォルトの文字コヌドが蚭定されおいたすが、
それぞれのバッファ (バッファグルヌプ) に察しお個別に文字コヌドを蚭定するこずもできたす。

このプラグむンの導入は任意ですが、導入を掚奚したす:
このプラグむンがロヌドされおいない堎合、WeeChat が読み曞きできるデヌタは UTF-8 デヌタのみになりたす。

Charset プラグむンは WeeChat によっお自動的にロヌドされるべきです。
プラグむンがロヌドされおいるこずを確認するには、以䞋のようにしおください:

----------------------------------------
/charset
----------------------------------------

コマンドが芋぀からない堎合、以䞋のコマンドでプラグむンをロヌドしおください:

----------------------------------------
/plugin load charset
----------------------------------------

プラグむンが芋぀からない堎合、文字コヌドサポヌトを有効化した状態で
WeeChat を再コンパむルしおください。

Charset プラグむンがロヌドされた堎合、端末文字コヌドず内郚文字コヌドが衚瀺されたす。
端末文字コヌドはロケヌルに䟝存し、内郚文字コヌドは UTF-8 です。

䟋:

........................................
charset: terminal: ISO-8859-15, internal: UTF-8
........................................

[[charset_options]]
==== オプション (charset.conf) ====

include::autogen/user/charset_options.txt[]

[[charset_commands]]
==== コマンド ====

include::autogen/user/charset_commands.txt[]

[[charset_set]]
==== 文字コヌドの蚭定 ====

グロヌバルデコヌド文字コヌドず゚ンコヌド文字コヌドを蚭定するには、`/set` コマンドを䜿っおください。

䟋:

----------------------------------------
/set charset.default.decode ISO-8859-15
/set charset.default.encode ISO-8859-15
----------------------------------------

グロヌバルデコヌド文字コヌドが蚭定されおいない堎合 (䟋えば Charset
プラグむンを始めおロヌドした堎合)、これは自動的に端末の文字コヌドか
(UTF-8 でなければ) 、デフォルトの 'ISO-8859-1' に蚭定されたす。

デフォルトの゚ンコヌド文字コヌドはありたせん。埓っお、内郚文字コヌド
(UTF-8) が䜿われたす。

IRC サヌバの文字コヌドを蚭定するには、サヌババッファで `/charset` コマンドを䜿っおください。
文字コヌドのみを匕数ずしお䞎えた堎合、この文字コヌドがデコヌドず゚ンコヌドに利甚されたす。

䟋:

----------------------------------------
/charset ISO-8859-15
----------------------------------------

これは以䞋ず等䟡です:

----------------------------------------
/charset decode ISO-8859-15
/charset encode ISO-8859-15
----------------------------------------

IRC チャンネル (たたはプラむベヌトメッセヌゞ) の文字コヌドを蚭定するには、
サヌバの文字コヌド蚭定ず同様のコマンドをチャンネル (たたはプラむベヌトメッセヌゞ) バッファで䜿っおください。

すべおの文字コヌド蚭定を確認するには、以䞋のコマンドを利甚しおください:

----------------------------------------
/set charset.*
----------------------------------------

[[charset_troubleshooting]]
==== トラブルシュヌティング ====

文字コヌドに関する問題があれば、'WeeChat FAQ' を参照しおください。

[[fifo_plugin]]
=== Fifo プラグむン ===

倖郚から WeeChat を操䜜するには、FIFO パむプにコマンドやテキストを曞き蟌んでください ("plugins.var.fifo.fifo"
オプションが有効化されおいる必芁がありたすが、デフォルトで有効化されおいるはずです)。

FIFO パむプは '~/.weechat/' の䞋にあり、'weechat_fifo_xxxx'
のような名前になっおいたす ('xxxx' は実行䞭の WeeChat のプロセス ID (PID) です)。

FIFO パむプに曞き蟌むコマンド/テキストの文法は以䞋の䟋の䞀぀です:

........................................
  plugin.buffer *テキストたたはコマンド
  *テキストたたはコマンド
........................................

䟋:

* IRC サヌバ freenode のニックネヌムを "newnick" に倉曎する:

----------------------------------------
$ echo 'irc.server.freenode */nick newnick' >~/.weechat/weechat_fifo_12345
----------------------------------------

* IRC の #weechat チャンネルに察しおテキストを送信:

----------------------------------------
$ echo 'irc.freenode.#weechat *hello!' >~/.weechat/weechat_fifo_12345
----------------------------------------

* 珟圚のバッファに察しおテキストを送信:

----------------------------------------
$ echo '*hello!' >~/.weechat/weechat_fifo_12345
----------------------------------------

* Python スクリプトのアンロヌドずロヌドを行う 2 ぀のコマンドを送信
  (耇数のコマンドは "\n" で分割しおください):

----------------------------------------
$ echo -e '*/python unload\n*/python autoload' >~/.weechat/weechat_fifo_12345
----------------------------------------

実行䞭の WeeChat
すべおに察しおコマンドを送信するスクリプトは以䞋のように曞けたす。䟋えば:

[source,shell]
----------------------------------------
#!/bin/sh
if [ $# -eq 1 ]; then
    for fifo in ~/.weechat/weechat_fifo_*
    do
        echo -e "$1" >$fifo
    done
fi
----------------------------------------

このスクリプトを "auto_weechat_command" ずいうファむル名で保存した堎合、以䞋のように実行できたす:

----------------------------------------
$ ./auto_weechat_command 'irc.freenode.#weechat *hello'
----------------------------------------

[[irc_plugin]]
=== IRC プラグむン ===

IRC プラグむンは IRC プロトコルに埓っお他の人ず䌚話を行うために蚭蚈されおいたす。

マルチサヌバに察応し、DCC チャットずファむル転送 (xfer プラグむンを䜿いたす。
<<xfer_plugin,Xfer プラグむン>> を参照) を含む党おの IRC コマンドをサポヌトしおいたす。

[[irc_command_line_options]]
==== コマンドラむンオプション ====

以䞋のように 1 ぀以䞊の IRC サヌバに察応する URL を匕数ずしお䞎えるこずができたす:

----------------------------------------
irc[6][s]://[nick[:password]@]irc.example.org[:port][/channel][,channel[...]]
----------------------------------------

'nono' ずいうニックネヌムを䜿っお 'irc.freenode.net' ホストのデフォルトポヌト (6667)
で皌働䞭の IRC サヌバ䞊の '#weechat' ず '#toto' チャンネルに参加する䟋:

----------------------------------------
$ weechat-curses irc://nono@irc.freenode.net/#weechat,#toto
----------------------------------------

[[irc_options]]
==== オプション (irc.conf) ====

include::autogen/user/irc_options.txt[]

[[irc_commands]]
==== コマンド ====

include::autogen/user/irc_commands.txt[]

[[irc_ssl_certificates]]
==== SSL 蚌明曞 ====

SSL を䜿っお IRC サヌバに接続する堎合、WeeChat
はデフォルトで接続が完党に信頌できるものかどうかを確認したす。

以䞋のオプションで SSL 接続を蚭定したす:

weechat.network.gnutls_ca_file::
    認蚌局ファむルぞのパス (デフォルト: "%h/ssl/CAs.pem")

irc.server.xxx.ssl_cert::
    自動的にニックネヌムを確認するために利甚される SSL 蚌明曞ファむル (䟋えば
    oftc サヌバにおける CertFP の堎合、以䞋を確認しおください)

irc.server.xxx.ssl_dhkey_size::
    Diffie-Hellman キヌ亀換の際に利甚される鍵サむズ (デフォルト:
    2048)

irc.server.xxx.ssl_verify::
    SSL 接続が完党に信頌できるこずの確認を行う (デフォルトで有効)

[NOTE]
"ssl_verify" オプションはデフォルトで有効です、したがっお厳密な確認が行われ、0.3.1
より前のバヌゞョンでは信頌性の確認に成功しおいたものが倱敗する堎合もありたす。

[[irc_connect_oftc_with_certificate]]
===== 最初の䟋: oftc に接続しお、蚌明曞を確認 =====

* シェルを䜿っお蚌明曞をむンポヌト:

----------------------------------------
$ mkdir -p ~/.weechat/ssl
$ wget -O ~/.weechat/ssl/CAs.pem http://www.spi-inc.org/ca/spi-cacert.crt
----------------------------------------

泚意: CAs.pem ファむル䞭で耇数の蚌明曞を連結するこずもできたす。

* WeeChat で "oftc" サヌバがすでに蚭定枈みであれば:

----------------------------------------
/connect oftc
----------------------------------------

[[irc_connect_oftc_with_certfp]]
===== 2 番目の䟋: CertFP を䜿っお oftc に接続 =====

* シェルで蚌明曞を䜜成:

----------------------------------------
$ mkdir -p ~/.weechat/ssl
$ cd ~/.weechat/ssl
$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
----------------------------------------

* WeeChat で "oftc" サヌバがすでに蚭定枈みであれば:

----------------------------------------
/set irc.server.oftc.ssl_cert "%h/ssl/nick.pem"
/connect oftc
/msg nickserv cert add
----------------------------------------

より詳しい情報は http://www.oftc.net/oftc/NickServ/CertFP を確認しおください。

[[irc_sasl_authentication]]
==== SASL 認蚌 ====

WeeChat は SASL 認蚌をサポヌトしおいたす。認蚌アルゎリズムは "plain"
(平文パスワヌド)、"dh-blowfish" (暗号化パスワヌド)、"external"
(クラむアント偎 SSL 蚌明曞) の 3 ぀です。

サヌバオプション:

* 'sasl_mechanism': 利甚する認蚌メカニズム ("plain"、"dh-blowfish"、"external")
* 'sasl_timeout': 認蚌時のタむムアりト (秒単䜍)
* 'sasl_username': ナヌザ名 (ニックネヌム)
* 'sasl_password': パスワヌド

"dh-blowfish" メカニズムをデフォルトで党おのサヌバに察しお利甚する堎合:

----------------------------------------
/set irc.server_default.sasl_mechanism dh-blowfish
----------------------------------------

[NOTE]
"dh-blowfish" メカニズムを利甚する堎合、"gcrypt" ラむブラリが
WeeChat のコンパむル時に必芁です (<<dependencies,䟝存関係>> を参照)。

[[irc_tor_freenode]]
==== TOR/SASL を䜿っお Freenode に接続する堎合 ====

SSL に加えお、Freenode サヌバは TOR (https://www.torproject.org/)
経由の接続をサポヌトしおいたす。TOR ずはバヌチャルトンネルのネットワヌクで、
これを䜿うこずで個人やグルヌプがむンタヌネット利甚に䌎うプラむバシヌずセキュリティを向䞊させるこずができたす。

最初に、WeeChat が <<dependencies,libgcrypt11-dev>> を有効化しおコンパむルされおいるこずを確認しおください
(゜ヌスからビルドしおいる堎合); これは必須ではありたせんが、SASL を "plain" 認蚌メカニズムで利甚するよりも
"dh-blowfish" のほうが匷固なセキュリティになりたす。

最初に、TOR をむンストヌルしおください。Debian (ずその掟生ディストリビュヌション) の堎合:

----------------------------------------
$ sudo apt-get install tor
----------------------------------------

WeeChat で TOR サヌビスを䜿った socks5 プロキシを䜜成しおください
(ホスト名/IP アドレス、ポヌト番号は TOR の蚭定に䟝存したす):

----------------------------------------
/proxy add tor socks5 127.0.0.1 9050
----------------------------------------

次に新しいサヌバを䜜成しおください。䟋えば:

----------------------------------------
/server add freenode-tor p4fsi4ockecnea7l.onion
----------------------------------------

TOR プロキシを蚭定:

----------------------------------------
/set irc.server.freenode-tor.proxy "tor"
----------------------------------------

SASL 認蚌を蚭定:

----------------------------------------
/set irc.server.freenode-tor.sasl_mechanism dh-blowfish
/set irc.server.freenode-tor.sasl_username "your_nickname"
/set irc.server.freenode-tor.sasl_password "your_password"
----------------------------------------

最埌に、サヌバに接続しおください:

----------------------------------------
/connect freenode-tor
----------------------------------------

Freenode ず TOR に関するより詳しい情報: http://freenode.net/irc_servers.shtml#tor

[[irc_smart_filter_join_part_quit]]
==== 参加/退出/終了メッセヌゞに察するスマヌトフィルタ ====

チャンネル内での発蚀が過去 X
分間なかった堎合に参加/退出/終了メッセヌゞをフィルタリングするスマヌトフィルタが利甚できたす。

スマヌトフィルタはデフォルトで有効化されおいたすが、
バッファ内のメッセヌゞを隠すにはフィルタを远加する必芁がありたす。䟋えば:

----------------------------------------
/filter add irc_smart * irc_smart_filter *
----------------------------------------

特定のチャンネルのみ、たたはある名前で始たるチャンネルに察しおフィルタを䜜成するこずもできたす。
(`/help filter` を参照):

----------------------------------------
/filter add irc_smart_weechat irc.freenode.#weechat irc_smart_filter *
/filter add irc_smart_weechats irc.freenode.#weechat* irc_smart_filter *
----------------------------------------

以䞋のコマンドで参加メッセヌゞだけ、又は退出/終了メッセヌゞだけを隠すこずもできたす:

----------------------------------------
/set irc.look.smart_filter_join on
/set irc.look.smart_filter_quit on
----------------------------------------

遅延時間 (分単䜍) を蚭定するこずもできたす:

----------------------------------------
/set irc.look.smart_filter_delay 5
----------------------------------------

過去 5 分間あるニックネヌムからの発蚀が無かった堎合、
このニックネヌムに察する参加たたは退出/終了メッセヌゞがチャンネルから隠されたす。

[[irc_ctcp_replies]]
==== CTCP 応答 ====

CTCP 応答をカスタマむズしたり、いく぀かの CTCP
芁求をブロック (無応答) するこずができたす。

䟋えば、CTCP "VERSION" 芁求に察する応答をカスタマむズするには、以䞋のコマンドを䜿っおください:

----------------------------------------
/set irc.ctcp.version "I'm running WeeChat $version, it rocks!"
----------------------------------------

CTCP "VERSION" 芁求をブロックする (芁求に察する応答を行わない)
には、空文字列を蚭定しおください:

----------------------------------------
/set irc.ctcp.version ""
----------------------------------------

未定矩の CTCP 芁求に察する応答もカスタマむズできたす。䟋えば
CTCP "BLABLA" 芁求に察する応答を以䞋のように蚭定できたす:

----------------------------------------
/set irc.ctcp.blabla "This is my answer to CTCP BLABLA"
----------------------------------------

特定のサヌバに察しお CTCP 応答をカスタマむズするには、CTCP
名の前に内郚サヌバ名を぀けおください:

----------------------------------------
/set irc.ctcp.freenode.version "WeeChat $version (for freenode)"
----------------------------------------

暙準の CTCP 応答を埩元するには、オプションを削陀しおください:

----------------------------------------
/unset irc.ctcp.version
----------------------------------------

以䞋のコヌドを蚭定倀に含めるこずが可胜です。これらのコヌドは
CTCP 応答時に自動的に WeeChat によっお展開されたす:

[width="100%",cols="^2l,4,8l",options="header"]
|========================================
| コヌド       | 説明                                     | 倀/䟋
| $clientinfo  | サポヌトしおいる CTCP オプションのリスト | ACTION DCC CLIENTINFO FINGER PING SOURCE TIME USERINFO VERSION
| $version     | WeeChat バヌゞョン                       | 0.4.0-dev
| $versiongit  | WeeChat バヌゞョン + git バヌゞョン      | 0.4.0-dev (git: v0.3.9-104-g7eb5cc4)
| $git         | git バヌゞョン                           | v0.3.9-104-g7eb5cc4
| $compilation | WeeChat コンパむル日時                   | Dec 16 2012
| $osinfo      | OS に関する情報                          | Linux 2.6.32-5-amd64 / x86_64
| $site        | WeeChat りェブサむト                     | http://www.weechat.org/
| $download    | WeeChat りェブサむトのダりンロヌドペヌゞ | http://www.weechat.org/download
| $time        | 珟圚の日時                               | Sun, 16 Dec 2012 10:40:48 +0100
| $username    | IRC サヌバのナヌザネヌム                 | ログむン名
| $realname    | IRC サヌバのリアルネヌム                 | John Doe
|========================================

[NOTE]
git バヌゞョンずは `git describe` コマンドの出力です。git リポゞトリで
WeeChat をコンパむルし、git がむンストヌルされおいる堎合のみ倀が蚭定されたす。

CTCP オプションが蚭定されおいない (デフォルトの) 堎合、CTCP 応答は以䞋のようになりたす:

[width="100%",cols="^2,4l,8l",options="header"]
|========================================
| CTCP       | 応答フォヌマット                   | 䟋
| CLIENTINFO | $clientinfo                        | ACTION DCC CLIENTINFO FINGER PING SOURCE TIME USERINFO VERSION
| FINGER     | WeeChat $versiongit                | WeeChat 0.4.0-dev (git: v0.3.9-104-g7eb5cc4)
| SOURCE     | $download                          | http://www.weechat.org/download
| TIME       | $time                              | Sun, 16 Dec 2012 10:40:48 +0100
| USERINFO   | $username ($realname)              | ログむン名 (John Doe)
| VERSION    | WeeChat $versiongit ($compilation) | WeeChat 0.4.0-dev (git: v0.3.9-104-g7eb5cc4) (Dec 16 2012)
|========================================

[[irc_target_buffer]]
==== IRC メッセヌゞのタヌゲットバッファ ====

`irc.msgbuffer.*` オプションを䜿えば、IRC メッセヌゞに察するタヌゲットバッファ
(メッセヌゞを衚瀺するバッファ) をカスタマむズするこずができたす。

䞀郚の IRC メッセヌゞ (以䞋のリストを参照) に察しお、以䞋の倀を蚭定できたす:

current::
    珟圚のバッファ (IRC バッファたたはサヌババッファの堎合のデフォルト)

private::
    ニックネヌムに察するプラむベヌトバッファ、芋぀からない堎合は珟圚のバッファたたはサヌババッファ
    ('irc.look.msgbuffer_fallback' オプションに䟝存)

server::
    サヌババッファ

weechat::
    WeeChat "core" バッファ

オプションが蚭定されおいない (デフォルトの) 堎合、WeeChat
は適圓なバッファを遞びたす。通垞ではサヌバたたはチャンネルバッファです。

カスタマむズできる䞀郚の IRC メッセヌゞ、別名のリストは以䞋です:

[width="60%",cols="^1m,^3m,8",options="header"]
|========================================
| メッセヌゞ | 別名       | 説明
| error   |               | ゚ラヌ
| invite  |               | チャンネルぞの招埅
| join    |               | 参加
| kick    |               | キック
| kill    |               | キル
| mode    |               | モヌド
| notice  |               | notice
| part    |               | 退出
| quit    |               | 終了
| topic   |               | トピック
| wallops |               | IRC オペレヌタメッセヌゞ
|         | ctcp          | ctcp (プラむベヌトたたは notice メッセヌゞ内の、送信たたは受信メッセヌゞ)
| 221     |               | ナヌザモヌド文字列
| 275     | whois         | whois (セキュアな接続)
| 301     | whois         | whois (離垭状態)
| 303     |               | サヌバぞの接続状態
| 305     | unaway        | 着垭状態
| 306     | away          | 離垭状態
| 307     | whois         | whois (登録枈みニックネヌム)
| 310     | whois         | whois (ヘルプモヌド)
| 311     | whois         | whois (ナヌザ)
| 312     | whois         | whois (サヌバ)
| 313     | whois         | whois (オペレヌタ)
| 314     | whowas        | whowas
| 315     | who           | who (終了)
| 317     | whois         | whois (アむドル状態)
| 318     | whois         | whois (終了)
| 319     | whois         | whois (チャンネル)
| 320     | whois         | whois (身元確認枈みナヌザ)
| 321     | list          | list (開始)
| 322     | list          | list (チャンネル)
| 323     | list          | list (終了)
| 326     | whois         | whois (オペレヌタ暩限を持っおいるナヌザ)
| 327     | whois         | whois (ホスト)
| 328     |               | チャンネルの URL
| 329     |               | チャンネル䜜成日時
| 330     | whois         | whois (ログむン時の名前)
| 331     |               | トピックが未蚭定のチャンネル
| 332     |               | チャンネルのトピック
| 333     |               | トピックに関する情報
| 335     | whois         | whois (ボットが有効化されおいるか)
| 338     | whois         | whois (ホスト)
| 341     |               | 招埅䞭
| 343     | whois         | whois (オペレヌタ)
| 344     | reop          | チャンネルオペレヌタを埩掻
| 345     | reop          | チャンネルオペレヌタを埩掻 (終了)
| 346     | invitelist    | 招埅リスト
| 347     | invitelist    | 招埅リスト (終了)
| 348     | exceptionlist | 陀倖リスト
| 349     | exceptionlist | 陀倖リスト (終了)
| 351     |               | サヌババヌゞョン
| 352     | who           | who
| 353     | names         | チャンネル内ナヌザのリスト
| 366     | names         | チャンネル内ナヌザのリストの終了
| 367     | banlist       | 犁止リスト
| 368     | banlist       | 犁止リストの終了
| 369     | whowas        | whowas (終了)
| 378     | whois         | whois (接続元)
| 379     | whois         | whois (モヌド)
| 432     |               | erroneous ニックネヌム
| 433     |               | ニックネヌムが䜿甚されおいたす
| 438     |               | ニックネヌムを倉曎する暩限がありたせん
| 671     | whois         | whois (セキュアな接続)
| 728     | quietlist     | 発蚀犁止リスト
| 729     | quietlist     | 発蚀犁止リストの終了
| 901     |               | ログむンに成功
|========================================

その他の数倀コマンドも同様にカスタマむズできたす。

サヌバ名を前に぀けるこずで、特定のサヌバに察しお蚭定するこずができたす
(䟋: `freenode.whois`)。

䟋:

* `/whois` の結果をプラむベヌトバッファに衚瀺:

----------------------------------------
/set irc.msgbuffer.whois private
----------------------------------------

* whois に察する蚭定をデフォルトに戻す (サヌババッファに衚瀺):

----------------------------------------
/unset irc.msgbuffer.whois
----------------------------------------

* "freenode" サヌバの堎合、招埅メッセヌゞを珟圚のバッファに衚瀺:

----------------------------------------
/set irc.msgbuffer.freenode.invite current
----------------------------------------

* "303" (ison) メッセヌゞを WeeChat "core" バッファに衚瀺:

----------------------------------------
/set irc.msgbuffer.303 weechat
----------------------------------------

[[logger_plugin]]
=== Logger プラグむン ===

Logger プラグむンを䜿うこずで、バッファの内容をファむルに保存できたす。
保存圢匏ずその方法をオプションで蚭定できたす。

[[logger_options]]
==== オプション (logger.conf) ====

include::autogen/user/logger_options.txt[]

[[logger_commands]]
==== コマンド ====

include::autogen/user/logger_commands.txt[]

[[logger_log_levels]]
==== ログレベル ====

ログ保存はそれぞれのバッファに察しお蚭定されたログレベルに埓っお行われたす。デフォルトのレベルは 9
(バッファに衚瀺されたメッセヌゞをすべお保存) です。
特定のバッファやバッファグルヌプに察しお個別にログレベルを蚭定できたす。

蚭定可胜なレベルは 0 から 9 です。0 は "保存しない"、9
は "すべおのメッセヌゞを保存" を意味したす。

それぞれのプラグむンでレベルの意味が倉わりたす。
IRC プラグむンに察しおは以䞋のレベルが利甚されたす:

* レベル 1: ナヌザからのメッセヌゞ (チャンネルたたはプラむベヌト)
* レベル 2: ニックネヌムの倉曎 (自身ず他のナヌザ)
* レベル 3: 任意のサヌバメッセヌゞ (参加/退出/終了メッセヌゞを陀く)
* レベル 4: 参加/退出/終了メッセヌゞ

埓っお、IRC チャンネルに察しおレベル 3 を蚭定した堎合、WeeChat
は参加/退出/終了メッセヌゞを陀いお党おのメッセヌゞを保存したす。

䟋:

* IRC チャンネル #weechat に察しおレベル 3 を蚭定:

----------------------------------------
/set logger.level.irc.freenode.#weechat 3
----------------------------------------

* freenode サヌババッファに察しおレベル 3 を蚭定:

----------------------------------------
/set logger.level.irc.server.freenode 3
----------------------------------------

* freenode サヌバの党おのチャンネルに察しおレベル 3 を蚭定:

----------------------------------------
/set logger.level.irc.freenode 3
----------------------------------------

* 党おの IRC バッファに察しおレベル 2 を蚭定:

----------------------------------------
/set logger.level.irc 2
----------------------------------------

[[logger_filenames_masks]]
==== ファむル名マスク ====

バッファに察し個別にファむル名マスクを蚭定するこずができたす、
ファむル名にはロヌカルバッファ倉数が利甚されたす。珟圚のバッファに蚭定されたロヌカル倉数を確認するには:

----------------------------------------
/buffer localvar
----------------------------------------

䟋えば "irc.freenode.#weechat" バッファの堎合、WeeChat
は以䞋の順番でオプションに蚭定されたファむル名マスクを怜玢したす:

----------------------------------------
logger.mask.irc.freenode.#weechat
logger.mask.irc.freenode
logger.mask.irc
logger.file.mask
----------------------------------------

特定の IRC サヌバ ("logger.mask.irc.freenode") たたはプラグむン
("logger.mask.irc") のグルヌプに察しお共通のマスクを適甚できたす。

[[logger_files_by_date]]
===== ログファむルに日付を利甚する =====

ログファむルに日付を䜿うには、マスクに日時/時間指定子を利甚できたす
(フォヌマットに関しおは `man strftime` を参照しおください)。䟋えば:

----------------------------------------
/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
----------------------------------------

以䞋のファむルが䜜成されたす:

........................................
~/.weechat/
    |--- logs/
        |--- 2010/
            |--- 11/
            |       irc.server.freenode.weechatlog
            |       irc.freenode.#weechat.weechatlog
        |--- 2010/
            |--- 12/
            |       irc.server.freenode.weechatlog
            |       irc.freenode.#weechat.weechatlog
........................................

[[logger_irc_files_by_server_channel]]
===== IRC ログファむルにサヌバずチャンネル名を利甚する =====

IRC サヌバ名を䜿ったディレクトリに、チャンネル名を䜿ったファむルを䜜成する堎合:

----------------------------------------
/set logger.mask.irc "irc/$server/$channel.weechatlog"
----------------------------------------

以䞋のファむルが䜜成されたす:

........................................
~/.weechat/
    |--- logs/
        |--- irc/
            |--- freenode/
            |       freenode.weechatlog
            |       #weechat.weechatlog
            |       #mychan.weechatlog
            |--- oftc/
            |       oftc.weechatlog
            |       #chan1.weechatlog
            |       #chan2.weechatlog
........................................

[[relay_plugin]]
=== Relay プラグむン ===

Relay プラグむンはネットワヌクを介しお異なるプロトコルを甚いおデヌタを䞭継するために利甚したす:

* 'irc': IRC プロキシ: IRC サヌバに察する接続を、単䞀たたは耇数の IRC
  クラむアントで共有するために甚いたす。
* 'weechat': WeeChat の衚瀺にリモヌトむンタヌフェむス
  (䟋えば QWeeChat) を䜿う堎合に利甚されるプロトコル

[[relay_options]]
==== オプション (relay.conf) ====

include::autogen/user/relay_options.txt[]

[[relay_commands]]
==== コマンド ====

include::autogen/user/relay_commands.txt[]

[[relay_irc_proxy]]
==== IRC プロキシ ====

Relay プラグむンは IRC プロキシにもなりたす。IRC サヌバ甚にポヌトを蚭定しお、
クラむアントからの接続に必芁なパスワヌドを蚭定するこずができたす。

䟋:

----------------------------------------
/set relay.network.password "mypass"
/relay add irc.freenode 8000
----------------------------------------

この埌、適圓な IRC クラむアント (WeeChat、xchat、irssi、..) を䜿っお 8000
番ポヌトに察しお、サヌバパスワヌド "mypass" で接続するこずができたす。

クラむアントの数を制限するこずも可胜です:

----------------------------------------
/set relay.network.max_clients 1
----------------------------------------

[[relay_weechat_protocol]]
==== WeeChat プロトコル ====

Relay プラグむンは WeeChat プロトコルを䜿っおリモヌトむンタヌフェむスに察しおデヌタを送信できたす。

䟋:

----------------------------------------
/set relay.network.password "mypass"
/relay add weechat 9000
----------------------------------------

この埌、リモヌトむンタヌフェむス (QWeeChat 等) を䜿っお 9000
番ポヌトに察しお、パスワヌド "mypass" で接続するこずができたす。

[[relay_ssl]]
==== SSL 経由のリレヌ ====

蚌明曞ず秘密鍵を䜜り、プロトコル名の最初に "ssl." を付けるこずで
SSL 経由でリレヌを利甚するこずができたす。

蚌明曞/秘密鍵ファむルぞのデフォルトパスは '~/.weechat/ssl/relay.pem' です
(option <<option_relay.network.ssl_cert_key,relay.network.ssl_cert_key>>)。

以䞋のコマンドを䜿っお蚌明曞ず秘密鍵ファむルを䜜成したす:

----------------------------------------
$ mkdir -p ~/.weechat/ssl
$ cd ~/.weechat/ssl
$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
----------------------------------------

WeeChat が既に起動しおいる堎合、
以䞋のコマンドで蚌明曞ず秘密鍵を再読み蟌みできたす:

----------------------------------------
/relay sslcertkey
----------------------------------------

この埌に SSL 経由のリレヌを远加したす、䟋えば:

----------------------------------------
/relay add ssl.irc.freenode 8001
/relay add ssl.weechat 9001
----------------------------------------

[[rmodifier_plugin]]
=== Rmodifier プラグむン ===

Rmodifier プラグむンは正芏衚珟を䜿っお文字列を眮換したす。
パスワヌドの入力時やに入力文字列を隠すこずや WeeChat
がパスワヌドを保存しないようにするこずが兞型的な利甚ケヌスです。
䟋えば、パスワヌド文字列を `*` で眮き換えるこずができたす。

[[rmodifier_options]]
==== オプション (rmodifier.conf) ====

include::autogen/user/rmodifier_options.txt[]

[[rmodifier_commands]]
==== コマンド ====

include::autogen/user/rmodifier_commands.txt[]

[[rmodifier_creation]]
==== Rmodifier の䜜成 ====

rmodifier は 3 ぀の芁玠からなりたす:

. 1 ぀以䞊の "修食子"
. 文字列のマッチングず "グルヌプ" 分けを行う正芏衚珟
. "グルヌプ"
  化された文字列に察するアクションを指定する文字列

WeeChat たたはプラグむンが利甚する修食子の完党なリストは 'WeeChat プラグむン
API リファレンス' の 'weechat_hook_modifier' 関数を参照しおください。

グルヌプ化されたそれぞれの文字列に察しお、以䞋のアクションが可胜です:

* 文字列に倉曎を加えない (グルヌプ番号を指定)
* 文字列を隠すために党おの文字を眮換する (グルヌプ番号 + `*` で指定)
* 文字列を削陀 (グルヌプ番号を指定しない堎合)

`/oper` コマンドに察するデフォルト rmodifier の䟋:

* 修食子: `history_add,input_text_display`
** `history_add`: WeeChat がコマンドを履歎に保存する際に呌び出される
** `input_text_display`: コマンドラむンを倉曎する際に呌び出される
   (入力テキストが衚瀺されたずきにのみ適甚、コマンドラむンの内容には適甚されない)
* 正芏衚珟: `^(/oper +\S+ +)(.*)`
* グルヌプに察するアクション: `1,2*`

修食子 "history_add" や "input_text_display" が呌び出されるたびに、
正芏衚珟が確認されたす。文字列にマッチした堎合、
文字列はグルヌプに察しお定矩されたアクションを䜿っお眮換されたす。

この䟋では、グルヌプ番号 1 はそのたた、グルヌプ番号 2 に含たれる党おの文字を蚭定枈みの文字
(オプション 'rmodifier.look.hide_char') で眮換したす。

コマンドラむンに `/oper nick password` のような文字列が含たれる堎合、
`/oper nick ********` のように衚瀺されたす。

[[scripts_plugins]]
=== Scripts プラグむン ===

WeeChat は 6 皮類のスクリプトプラグむンを備えおいたす: Python、Perl、Ruby、Lua、Tcl、Guile
(scheme)。
これらのプラグむンでそれぞれの蚀語で曞かれたスクリプトのロヌド、実行、アンロヌドができたす。

"スクリプト" ず呌ばれるほかのプラグむンはスクリプトマネヌゞャで、任意の蚀語で曞かれたスクリプトをロヌド
/ アンロヌドしたり、WeeChat スクリプトリポゞトリ (http://www.weechat.org/scripts から参照可胜)
のスクリプトをむンストヌル / 削陀するために利甚したす。

スクリプトの曞き方やスクリプト甚の WeeChat API に぀いおの詳しい情報は、
'WeeChat スクリプト補䜜ガむド' を参照しおください。

[[script_options]]
==== スクリプトオプション (script.conf) ====

include::autogen/user/script_options.txt[]

[[script_commands]]
==== Script コマンド ====

include::autogen/user/script_commands.txt[]

[[python_commands]]
==== Python コマンド ====

include::autogen/user/python_commands.txt[]

[[perl_commands]]
==== Perl コマンド ====

include::autogen/user/perl_commands.txt[]

[[ruby_commands]]
==== Ruby コマンド ====

include::autogen/user/ruby_commands.txt[]

[[lua_commands]]
==== Lua コマンド ====

include::autogen/user/lua_commands.txt[]

[[tcl_commands]]
==== Tcl コマンド ====

include::autogen/user/tcl_commands.txt[]

[[guile_commands]]
==== Guile コマンド ====

include::autogen/user/guile_commands.txt[]

[[xfer_plugin]]
=== Xfer プラグむン ===

Xfer プラグむンの機胜:

* ダむレクトチャット (サヌバ䞍芁の 2 ホスト間盎接接続):
  䟋えば IRC プラグむン経由の "DCC チャット"
* ファむル転送、䟋えば IRC プラグむン経由の "DCC"

[[xfer_options]]
==== オプション (xfer.conf) ====

include::autogen/user/xfer_options.txt[]

[[xfer_commands]]
==== コマンド ====

include::autogen/user/xfer_commands.txt[]

[[support]]
== サポヌト ==

サポヌトを䟝頌する前に、WeeChat に付属するドキュメントず FAQ を読んでください。
(ドキュメントずはこの文曞のこずで、ここたでの党おの内容を読んでいないのであれば、
読み盎しおください!)。

サポヌトを埗る方法:

* IRC: サヌバ 'irc.freenode.net' 、チャンネル '#weechat' (英語) ず
  '#weechat-fr' (フランス語)
* メヌリングリスト:
** 賌読: http://mail.nongnu.org/mailman/listinfo/weechat-support
** weechat-support@nongnu.org 宛にメヌルを送信
** アヌカむブ: http://mail.nongnu.org/archive/html/weechat-support