X-Git-Url: http://cgit.sxemacs.org/?p=riece;a=blobdiff_plain;f=doc%2Friece-ja.texi;h=90a766b77124b236bc96d73c3a705ca93f42b471;hp=86c68423e4aa28bc4cecb5b24ed9b183c46206cc;hb=4e7d94f9c055bad351eb2f33ac2cafa281ea7a62;hpb=822a47ed1253e41aa1768a1c3d7e1635749e82bd diff --git a/doc/riece-ja.texi b/doc/riece-ja.texi index 86c6842..90a766b 100644 --- a/doc/riece-ja.texi +++ b/doc/riece-ja.texi @@ -1,10 +1,11 @@ -\input texinfo @c -*- mode: texinfo; coding: iso-2022-jp -*- +\input texinfo @c -*- mode: texinfo; coding: utf-8 -*- @c %**start of header @setfilename riece-ja.info @settitle Riece -- An IRC client for Emacsen -- @c %**end of header @include version-ja.texi @c @documentlanguage ja +@c @documentencoding utf-8 @dircategory GNU Emacs Lisp @direntry @@ -14,7 +15,7 @@ @ifinfo This file describes Riece. -Copyright (C) 2003,2004,2005,2006,2007,2008,2009 Daiki Ueno. +Copyright (C) 2003,2004,2005,2006,2007,2008,2009,2010 Daiki Ueno. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -49,16 +50,16 @@ Free Documentation License". @node Top, Overview, (dir), (dir) @top Riece user's manual -$B$3$N%^%K%e%"%k$G$O!"(BRiece $B%P!<%8%g%s(B @value{VERSION} $B$K$D$$$F2r@b$7$^$9!#(B -$B$3$N%^%K%e%"%k$G07$&HO0O$r1[$($?>pJs$O(B Riece $B$N8x<0%[!<%`%Z!<%8(B -@uref{http://www.nongnu.org/riece/} $B$+$iF@$i$l$k$+$b$7$l$^$;$s!#(B +このマニュアルでは、Riece バージョン @value{VERSION} について解説します。 +このマニュアルで扱う範囲を越えた情報は Riece の公式ホームページ +@uref{http://www.nongnu.org/riece/} から得られるかもしれません。 @menu -* Overview:: $B$O$8$a$KFI$s$G$M(B -* Getting started:: IRC $B%5!<%P$K@\B3$7$F2qOC$7$F$_$h$&(B -* Basic usage:: $B4pK\E*$J;H$$J}(B -* Advanced usage:: $B?J$s$@;H$$J}(B -* Tips:: $BJXMx$J@_Dj(B +* Overview:: はじめに読んでね +* Getting started:: IRC サーバに接続して会話してみよう +* Basic usage:: 基本的な使い方 +* Advanced usage:: 進んだ使い方 +* Tips:: 便利な設定 * Index:: * Function Index:: * Variable Index:: @@ -67,24 +68,24 @@ Free Documentation License". @node Overview, Getting started, Top, Top @chapter Overview -Riece $B$O(B IRC (Internet Relay Chat) $B$N@$3&$G%A%c%C%H$r3Z$7$`$?$a$N%f!<%6(B -$B%$%s%?!<%U%'!<%9$G$9!#(BRiece $B$O!V$j!<$9!W$HFI$_$^$9!#(B +Riece は IRC (Internet Relay Chat) の世界でチャットを楽しむためのユーザ +インターフェースです。Riece は「りーす」と読みます。 -Riece $B$N$N(B elisp $B%Q%C%1!<%8$K0MB8$7$J$$$?$a!"%$%s%9%H!<%k$,4JC1(B -@item $B@_Dj$,4JC1$G!"A02s5/F0;~$N@_Dj$r5-O?!&I|85$9$k;EAH$_$rDs6!(B -@item $BCJ3,E*$JA`:n@bL@=q$,ImB0(B -@item $B:G?7$N(B IRC $B$N%/%i%$%"%s%H%W%m%H%3%k(B (RFC2812) $B$K=`5r(B +@item 複数の IRC サーバに同時に接続可能 +@item アドオンにより機能の追加や取り外しが容易 +@item 他の elisp パッケージに依存しないため、インストールが簡単 +@item 設定が簡単で、前回起動時の設定を記録・復元する仕組みを提供 +@item 段階的な操作説明書が附属 +@item 最新の IRC のクライアントプロトコル (RFC2812) に準拠 @end itemize @node Getting started, Basic usage, Overview, Top @chapter Getting started -Riece $B$r5/F0$9$kl9g$K(B -$B$O%$%s%9%H!<%k$K<:GT$7$F$$$^$9!#<+J,$G%=!<%9$+$i%$%s%9%H!<%k$7$?>l9g$K$O(B -README $B$r$b$&0lEYFI$_D>$7$F$/$@$5$$!#(BOS$B!&%G%#%9%H%j%S%e!<%7%g%s$N%Q%C%1!<(B -$B%8$+$i%$%s%9%H!<%k$7$?>l9g$K$O!"%Q%C%1!<%8$K4^$^$l$kJ8=q$r$43NG'$/$@$5$$!#(B +もし (1) で @samp{Cannot open load file: riece} のエラーが発生する場合に +はインストールに失敗しています。自分でソースからインストールした場合には +README をもう一度読み直してください。OS・ディストリビューションのパッケー +ジからインストールした場合には、パッケージに含まれる文書をご確認ください。 -Riece $B$r5/F0$9$k$H!"(BIRC $B%5!<%P$NL>A0$rJ9$+$l$^$9!#8x6&$KMxMQ2DG=$J(B IRC -$B%5!<%P$N0lMw$O(B Web $B%Z!<%8$J$I$+$iF@$k$3$H$,$G$-$^$9!#(B +Riece を起動すると、IRC サーバの名前を聞かれます。公共に利用可能な IRC +サーバの一覧は Web ページなどから得ることができます。 @itemize @bullet @item http://www.ircnet.jp @item http://freenode.net @end itemize -$B$^$?!"0J2<$N$h$&$J%a%C%;!<%8$,I=<($5$l$k$+$b$7$l$^$;$s!#(B +また、以下のようなメッセージが表示されるかもしれません。 @example Nickname "ueno" already in use. Choose a new one: @end example -IRC $B$G$O!";22CN$,;H$o$l(B -$B$^$9!#$b$74uK>$N%K%C%/%M!<%`$,B>$NC/$+$K;HMQ$5$l$F$$$k>l9g!"JL$N%K%C%/%M!<(B -$B%`$rA*$VI,MW$,$"$j$^$9!#(B +IRC では、参加者を表すのに@emph{ニックネーム}と呼ばれる短い呼称が使われ +ます。もし希望のニックネームが他の誰かに使用されている場合、別のニックネー +ムを選ぶ必要があります。 -IRC $B%5!<%P$K@\B3$G$-$?$i!"A[E*$J2q5D<<$K;22C$7$F2qOC$r9T$J$$$^$9!#%A%c%s%M%k$KF~$k$K$O(B -@kbd{C-c j} $B$H%?%$%W$7$^$9!#;22C$9$k%A%c%s%M%kL>$r?R$M$i$l$?$i!"E,@Z$J%A%c(B -$B%s%M%kL>$rF~NO$7$^$7$g$&!#(BIRCnet $B$K$O(B @samp{#Riece} $B$H$$$&%A%c%s%M%k$,$"(B -$B$k$N$G!"%F%9%H$r$7$?$$>l9g$K$O<+M3$K$*;H$$$/$@$5$$!#(B +IRC サーバに接続できたら、次は会話をしてみましょう。IRC では@emph{チャンネル} +と呼ばれる仮想的な会議室に参加して会話を行ないます。チャンネルに入るには +@kbd{C-c j} とタイプします。参加するチャンネル名を尋ねられたら、適切なチャ +ンネル名を入力しましょう。IRCnet には @samp{#Riece} というチャンネルがあ +るので、テストをしたい場合には自由にお使いください。 -$B%A%c%s%M%k$KF~$k$H!"2<$N?^$K<($9$h$&$J(B 5 $B$D$N%&%#%s%I%&(B -@footnote{$B$^$.$i$o$7$$$G$9$,!"(BEmacs $B$N@$3&$G$O%P%C%U%!$rI=<($9$kNN0h$r%&%#(B -$B%s%I%&$H8F$S$^$9!#(B}$B$+$i$J$k2hLL$K@Z$jBX$o$j$^$9!#(B +チャンネルに入ると、下の図に示すような 5 つのウィンドウ +@footnote{まぎらわしいですが、Emacs の世界ではバッファを表示する領域をウィ +ンドウと呼びます。}からなる画面に切り替わります。 @example +-----+-----------------+ @@ -143,16 +144,16 @@ IRC $B%5!<%P$K@\B3$G$-$?$i!"O$rF~NO$7$F%j%?!<%s%-!<$r2!$9$H(B -$BH/8@$G$-$^$9!#B>$N;22CuBV$NI=<((B -* Commands:: $B%3%^%s%I$N0lMw(B +* Windows:: 画面構成 +* Indicators:: 自分の状態の表示 +* Commands:: コマンドの一覧 @end menu @node Windows, Indicators, Basic usage, Basic usage @@ -174,239 +175,239 @@ IRC $B%5!<%P$K@\B3$G$-$?$i!"O$d%3%^%s%I$rAw?.$9$k$?$a$K;H$$(B -$B$^$9!#(B +コマンドバッファ (@samp{*Command*})。文章やコマンドを送信するために使い +ます。 @item -$B%"%6!<%:%P%C%U%!(B (@samp{ *Others*})$B!#8=:_A*BrCf$N%A%c%s%M%k0J30$N2qOC$,N.(B -$B$l$^$9!#(B +アザーズバッファ (@samp{ *Others*})。現在選択中のチャンネル以外の会話が流 +れます。 @end enumerate @node Indicators, Commands, Windows, Basic usage @section Indicators -$B%b!<%I%i%$%s$N:8C<$K$O!"8=:_$N<+J,$N>uBV$r<($90u$,I=<($5$l$^$9!#(B -@footnote{$B$b$72hA|$rI=<($G$-$k(B Emacs $B$r$*;H$$$J$i!":8C<$K(B "R" $B$N%"%$%3%s(B -$B$,I=<($5$l$^$9!#(B} +モードラインの左端には、現在の自分の状態を示す印が表示されます。 +@footnote{もし画像を表示できる Emacs をお使いなら、左端に "R" のアイコン +が表示されます。} @example Riece: ---- ueno #Riece [n] @end example -$B$3$3$G!"(B@samp{----} $B$NItJ,$K$O:8$+$i=g$K0J2<$N0UL#$,$"$j$^$9!#(B +ここで、@samp{----} の部分には左から順に以下の意味があります。 @enumerate @item -$BN%@J>uBV(B ($BN%@J$7$F$$$l$P(B @samp{A}) +離席状態 (離席していれば @samp{A}) @item -IRC $B%*%Z%l!<%?>uBV(B (IRC $B%M%C%H%o!<%/$N4IM}uBV(B ($B%A%c%s%M%k$N4IM}O$rF~NO$7$?%P%C%U%!$O%3%^%s%I%P%C%U%!$H8F$P$l$^$9!#(B -$B%3%^%s%I%P%C%U%!$+$i$OJ8>O$rAw?.$9$k0J30$K!"MM!9$J%3%^%s%I$rH/9T$9$k$3$H(B -$B$,$G$-$^$9!#0J2<$K0lIt$r5s$2$^$9!#(B +@ref{Basic usage}で文章を入力したバッファはコマンドバッファと呼ばれます。 +コマンドバッファからは文章を送信する以外に、様々なコマンドを発行すること +ができます。以下に一部を挙げます。 -$B:G=i$O$J$+$J$+3P$($K$/$$$G$9$,!"(B@kbd{C-h b} - (@kbd{M-x describe-bindings}) $B$G;HMQ2DG=$J%-!/$7$:$D3P$($F$$$/$HNI$$$G$7$g$&!#(B +最初はなかなか覚えにくいですが、@kbd{C-h b} + (@kbd{M-x describe-bindings}) で使用可能なキー操作の一覧が表示されるの +で少しずつ覚えていくと良いでしょう。 @subsection IRC commands @table @kbd @item RET @findex riece-command-enter-message -$BJ8>O$rAw$j$^$9(B(@code{riece-command-enter-message}) +文章を送ります(@code{riece-command-enter-message}) @item C-RET @findex riece-command-enter-message-as-notice -$BJ8>O$r(B NOTICE $B$H$7$FAw$j$^$9(B(@code{riece-command-enter-message-as-notice}) +文章を NOTICE として送ります(@code{riece-command-enter-message-as-notice}) @item C-c j @findex riece-command-join -$B%A%c%s%M%k$K;22C$7$^$9(B(@code{riece-command-join}) +チャンネルに参加します(@code{riece-command-join}) @item C-c C-p @findex riece-command-part -$B%A%c%s%M%k$+$iN%C&$7$^$9(B(@code{riece-command-part}) +チャンネルから離脱します(@code{riece-command-part}) @item C-c p @findex riece-command-enter-message-to-user -$B08@h$r;XDj$7$F8=:_$N9T$rAw$j$^$9(B(@code{riece-command-enter-message-to-user}) +宛先を指定して現在の行を送ります(@code{riece-command-enter-message-to-user}) @item C-c q @findex riece-command-quit -IRC $B$r$d$a$^$9(B(@code{riece-command-quit}) +IRC をやめます(@code{riece-command-quit}) @item C-c n @findex riece-command-change-nickname -$B<+J,$N%K%C%/%M!<%`$rJQ99$7$^$9(B(@code{riece-command-change-nickname}) +自分のニックネームを変更します(@code{riece-command-change-nickname}) @item C-c f @findex riece-command-finger -$B%f!<%6$N>pJs$rD4$Y$^$9(B(@code{riece-command-finger}) +ユーザの情報を調べます(@code{riece-command-finger}) @item C-c C-k @findex riece-command-kick -$B%f!<%6$r%A%c%s%M%k$+$i=3$j=P$7$^$9(B(@code{riece-command-kick}) +ユーザをチャンネルから蹴り出します(@code{riece-command-kick}) @item C-c i @findex riece-command-invite -$B%f!<%6$r%A%c%s%M%k$K>7BT$7$^$9(B(@code{riece-command-invite}) +ユーザをチャンネルに招待します(@code{riece-command-invite}) @item C-c l @findex riece-command-list -$B%Q%?!<%s$KBP$7$F(B LIST $B$rH/9T$7$^$9(B(@code{riece-command-list}) +パターンに対して LIST を発行します(@code{riece-command-list}) @item C-c C-n @findex riece-command-names -$B%Q%?!<%s$KBP$7$F(B NAMES $B$rH/9T$7$^$9(B(@code{riece-command-names}) +パターンに対して NAMES を発行します(@code{riece-command-names}) @item C-c w @findex riece-command-who -$B%Q%?!<%s$KBP$7$F(B WHO $B$rH/9T$7$^$9(B(@code{riece-command-who}) +パターンに対して WHO を発行します(@code{riece-command-who}) @item C-c t @findex riece-command-topic -$B%A%c%s%M%k$N%H%T%C%/$r@_Dj$7$^$9(B(@code{riece-command-topic}) +チャンネルのトピックを設定します(@code{riece-command-topic}) @item C-c C-m @findex riece-command-change-mode -$B%A%c%s%M%k$N%b!<%I$r@_Dj$7$^$9(B(@code{riece-command-change-mode}) +チャンネルのモードを設定します(@code{riece-command-change-mode}) @item C-c o @findex riece-command-set-operators -$B%f!<%6$K%A%c%s%M%k$N4IM}\:Y$J>pJs$rI=<($7$^$9!#(B +Riece のバージョンを表示します。(@kbd{C-u C-c V}) で、より詳細な情報を表示します。 @item C-c / @findex riece-command-raw -IRC $B%3%^%s%I$rD>@\Aw$j$^$9(B(@code{riece-command-raw}) +IRC コマンドを直接送ります(@code{riece-command-raw}) @end table @subsection Window manipulating commands @table @kbd @item C-c r @findex riece-command-configure-windows -$B%U%l!<%`A4BN$r:FIA2h$7$^$9(B(@code{riece-command-configure-windows}) -@item C-c C-j $B$^$?$O(B C-c > +フレーム全体を再描画します(@code{riece-command-configure-windows}) +@item C-c C-j または C-c > @findex riece-command-next-channel -$B%A%c%s%M%k0lMw$GeC<$^$G%9%/%m!<%k$7$^$9(B(@code{riece-command-beginning-of-buffer}) +チャンネルバッファ、またはダイアログバッファを上端までスクロールします(@code{riece-command-beginning-of-buffer}) @item C-c $ @findex riece-command-end-of-buffer -$B%A%c%s%M%k%P%C%U%!!"$^$?$O%@%$%"%m%0%P%C%U%!$r2eJ}8~$K%9%/%m!<%k$7$^$9(B(@code{riece-command-scroll-up}) +チャンネルバッファ、またはダイアログバッファを上方向にスクロールします(@code{riece-command-scroll-up}) @item C-c DEL @findex riece-command-scroll-down -$B%A%c%s%M%k%P%C%U%!!"$^$?$O%@%$%"%m%0%P%C%U%!$r2uBV$r@Z$jBX$($^$9(B(@code{riece-command-toggle-away}) +自分の離席状態を切り替えます(@code{riece-command-toggle-away}) @end table @node Advanced usage, Tips, Basic usage, Top @chapter Advanced usage -$B$3$N>O$G$O!"$b$C$H?J$s$@;H$$J}$r2r@b$7$^$9!#(B +この章では、もっと進んだ使い方を解説します。 @menu -* Startup File:: $B@_Dj%U%!%$%k(B -* Server settings:: $B%5!<%P$N>\:Y@_Dj(B -* Multiple servers:: $BJ#?t$N%5!<%P$K@\B3$9$k$K$O(B -* Add-ons:: $B%"%I%*%s$H$O(B +* Startup File:: 設定ファイル +* Server settings:: サーバの詳細設定 +* Multiple servers:: 複数のサーバに接続するには +* Add-ons:: アドオンとは @end menu @node Startup File, Server settings, Advanced usage, Advanced usage @section Startup file -Riece $B$N@_Dj$O(B Emacs $B$N@_Dj%U%!%$%k$K=q$$$F$bNI$$$G$9$,!"(BRiece $B$K8GM-$N(B -$B@_Dj$O$J$k$Y$/(B @file{~/.riece/init} $B$K=q$/$3$H$r?d>)$7$^$9!#(B +Riece の設定は Emacs の設定ファイルに書いても良いですが、Riece に固有の +設定はなるべく @file{~/.riece/init} に書くことを推奨します。 -$B$^$?!"(BRiece $B$r5/F0$7$F=*N;$9$k$H(B @file{~/.riece/save} $B$H$$$&%U%!%$%k$,(B -$B:n@.$5$l$^$9!#$3$N%U%!%$%k$K$OA02s5/F0;~$N@_Dj$N0lIt$,<+F0E*$KJ]B8$5$l(B -$B$^$9!#(B +また、Riece を起動して終了すると @file{~/.riece/save} というファイルが +作成されます。このファイルには前回起動時の設定の一部が自動的に保存され +ます。 -$B5/F0;~$K$O!":G=i$K(B @file{~/.riece/save} $B$r!"e=q$-$5$l$^$9!#(B +起動時には、最初に @file{~/.riece/save} を、次に @file{~/.riece/init}を +読み込みます。つまり、前回起動時に @file{~/.riece/save} に保存された内容 +は、@file{~/.riece/init} の内容で上書きされます。 @node Server settings, Multiple servers, Startup File, Advanced usage @section Server settings -$B5/F0;~$K@\B3$9$k(B IRC $B%5!<%P$OJQ?t(B @code{riece-server} $B$G;XDj$7$^$9!#(B +起動時に接続する IRC サーバは変数 @code{riece-server} で指定します。 @vindex riece-server -@code{riece-server} $B$OJ8;zNs$G!"$=$N7A<0$O(B} +@code{IRC サーバのホスト名} @item -@code{IRC $B%5!<%P$N%[%9%HL>(B:$B%]!<%HHV9f(B} +@code{IRC サーバのホスト名:ポート番号} @item -@code{IRC $B%5!<%P$N%[%9%HL>(B:$B%]!<%HHV9f(B:$B%Q%9%o!<%I(B} +@code{IRC サーバのホスト名:ポート番号:パスワード} @item -$B>\:Y@_Dj$NL>A0(B +詳細設定の名前 @end enumerate -4. $B$N>l9g$K$O!"(B@code{riece-server} $B$NCM$r%-!<$K(B -@code{riece-server-alist} $B$r8!:w$7$^$9!#(B@code{riece-server-alist} $B$OA0$N@_Dj$G$O!"(BIRC $B%5!<%P$N%[%9%HL>$K(B @samp{irc.example.com}$B!";HMQ$9$kJ8;z%3!<%I$K(B Shift_JIS $B$r;H$&(B +@samp{foo} という名前の設定では、IRC サーバのホスト名に @samp{irc.example.com}、使用する文字コードに Shift_JIS を使う @item -@samp{bar} $B$H$$$&L>A0$N@_Dj$G$O!"(BIRC $B%5!<%P$N%[%9%HL>$O(B @samp{irc.example.net}$B!"$3$N%5!<%P$G$O%K%C%/%M!<%`(B @samp{baz} $B$r;H$&(B +@samp{bar} という名前の設定では、IRC サーバのホスト名は @samp{irc.example.net}、このサーバではニックネーム @samp{baz} を使う @end itemize -$B;XDj$G$-$k%-!<%o!<%I$N0lMw$O0J2<$NDL$j$G$9!#(B +指定できるキーワードの一覧は以下の通りです。 @table @code @item :host -$B%5!<%P$N%[%9%HL>$^$?$O(B IP $B%"%I%l%9(B +サーバのホスト名または IP アドレス @item :service -$B%5!<%P$N%5!<%S%9L>$^$?$O%]!<%HHV9f(B ($B4{DjCM$O(B @code{6667}) +サーバのサービス名またはポート番号 (既定値は @code{6667}) @item :nickname -$B@\B3;~$N%K%C%/%M!<%`(B ($B4{DjCM$OJQ?t(B @code{user-real-login-name} $B$NCM(B) +接続時のニックネーム (既定値は変数 @code{user-real-login-name} の値) @item :username -$B@\B3;~$N%f!<%6%M!<%`(B ($B4{DjCM$OJQ?t(B @code{user-full-name} $B$NCM(B) +接続時のユーザネーム (既定値は変数 @code{user-full-name} の値) @item :password -$B@\B3;~$N%Q%9%o!<%I(B +接続時のパスワード @item :function -$B@\B3MQ4X?t(B ($B4{DjCM$O(B @code{open-network-stream}) +接続用関数 (既定値は @code{open-network-stream}) @item :coding -$BJ8;z%3!<%I(B ($B4{DjCM$O(B @code{riece-default-coding-system} $B$NCM(B) +文字コード (既定値は @code{riece-default-coding-system} の値) @end table -@code{riece-server-alist} $B$rBPOCE*$K@_Dj$9$k$K$OuBV$G!"JL$N%5!<%P$K@\B3$9$k$K$O(B @kbd{C-c O} (@code{riece-command-open-server}) $B$r;H$$$^$9!#(B +既に特定のサーバに接続している状態で、別のサーバに接続するには @kbd{C-c O} (@code{riece-command-open-server}) を使います。 -$BJL$N%5!<%P>e$N%A%c%s%M%k$K;22C$9$k$K$O!"(B@kbd{C-c j} -(@code{riece-command-join})$B$G%A%c%s%M%kL>$K(B @samp{@@} $B$KB3$$$F%5!<%PL>$r(B -$BB3$1$^$9!#(B +別のサーバ上のチャンネルに参加するには、@kbd{C-c j} +(@code{riece-command-join})でチャンネル名に @samp{@@} に続いてサーバ名を +続けます。 -$B$?$H$($P!"%5!<%P(B @samp{irc.freenode.net} $B>e$N(B @samp{#Riece} $B$O$H%5!<%P$N6h@Z$jJ8;z(B @samp{@@} $B$O(B -$BJQ?t(B @code{riece-alias-alternate-separator} $B$GJQ99$G$-$^$9!#(B +チャンネル名とサーバの区切り文字 @samp{@@} は +変数 @code{riece-alias-alternate-separator} で変更できます。 -$B$^$?$O!"6uGrJ8;z$G$bBeMQ$G$-$^$9!#$3$N;~$K$O!"(B@kbd{C-q SPC} $B$HF~NO$9$k(B -$BI,MW$,$"$j$^$9!#(B +または、空白文字でも代用できます。この時には、@kbd{C-q SPC} と入力する +必要があります。 -$BJ#?t$N@\B3$rA`:n$9$k%3%^%s%I$r0J2<$K$^$H$a$^$9!#(B +複数の接続を操作するコマンドを以下にまとめます。 @table @kbd @item C-c O @findex riece-command-open-server -$BJL$N%5!<%P$K@\B3$7$^$9(B(@code{riece-command-open-server}) +別のサーバに接続します(@code{riece-command-open-server}) @item C-c C @findex riece-command-close-server -$B%5!<%P$H$N@\B3$r@ZCG$7$^$9(B(@code{riece-command-close-server}) +サーバとの接続を切断します(@code{riece-command-close-server}) @item C-c M @findex riece-command-universal-server-name-argument -$BFCDj$N%5!<%P$KBP$7$F!"B3$/%3%^%s%I$rH/9T$7$^$9(B(@code{riece-command-universal-server-name-argument}) +特定のサーバに対して、続くコマンドを発行します(@code{riece-command-universal-server-name-argument}) @end table @node Add-ons, , Multiple servers, Advanced usage @section Add-ons -Riece $B$G$O!";(B?$J5!G=$rA*BrE*$KMxMQ$G$-$k$h$&!"%"%I%*%s$H8F$P$l$k5!9=(B -$B$rMQ0U$7$F$$$^$9!#%"%I%*%s$ODL>o$N(B elisp $B%b%8%e!<%k$r3HD%$7$?$b$N$G!"(B -$B0BA4$JuBV$,$"$j$^$9!#(B +アドオンには次の四種類の状態があります。 @table @asis @item unloaded -$BFI$_9~$_A0!#%"%I%*%s$N(B elisp $B%b%8%e!<%k$,FI$_9~$^$l$F$$$J$$>uBV(B +読み込み前。アドオンの elisp モジュールが読み込まれていない状態 @item insinuated -$BAH$_9~$_:Q$_!#%"%I%*%s$N(B elisp $B%b%8%e!<%k$,FI$_9~$^$l!"=i4|2==hM}$,40N;$7$?>uBV(B +組み込み済み。アドオンの elisp モジュールが読み込まれ、初期化処理が完了した状態 @item enabled -$BM-8z!#%"%I%*%s$,F0:nCf(B +有効。アドオンが動作中 @item disabled -$BL58z!#%"%I%*%s$NF0:n$,Dd;_Cf(B +無効。アドオンの動作が停止中 @end table @menu -* Add-on browser:: $B%"%I%*%s$N0lMwI=<((B -* Available add-ons:: $BI8=`E:IU$N%"%I%*%s$N>R2p(B +* Add-on browser:: アドオンの一覧表示 +* Available add-ons:: 標準添付のアドオンの紹介 @end menu @node Add-on browser, Available add-ons, Add-ons, Add-ons @subsection Add-on browser -Riece $B$NF0:nCf$K%"%I%*%s$N0lMw$rD/$a$k$K$O%"%I%*%s%V%i%&%6$r;H$&$HJXMx$G$9!#(B -$B%3%^%s%I%P%C%U%!$G(B @kbd{C-c ^} $B$H$9$k$H!"uBV$rI=$o$7$F$$$^$9!#(B@samp{+} $B$OAH9~$^(B -$B$l$FM-8z$J%"%I%*%s!"6uGr$O%m!<%I$5$l$F$$$J$$%"%I%*%s$G$9!#(B +各行の左端のマークはアドオンの状態を表わしています。@samp{+} は組込ま +れて有効なアドオン、空白はロードされていないアドオンです。 -$B$3$3$G!"(Briece-button $B$rL58z$K$7$?$$>l9g!";M9TL\$N@hF,$G(B @kbd{-} $B$H$7$^(B -$B$9!#$9$k$H!"@hF,$N%^!<%/$,(B @samp{+} $B$+$i(B @samp{-} $B$KJQ2=$7$^$9!#(B +ここで、riece-button を無効にしたい場合、四行目の先頭で @kbd{-} としま +す。すると、先頭のマークが @samp{+} から @samp{-} に変化します。 @example + riece-alias Define aliases for IRC names. @@ -548,15 +549,15 @@ Riece $B$NF0:nCf$K%"%I%*%s$N0lMw$rD/$a$k$K$O%"%I%*%s%V%i%&%6$r;H$&$HJXMx$G$9!# + riece-ctlseq Mark up control sequences in IRC buffers. @end example -$B$5$i$K!"(B@samp{u} $B$H$9$k$H!"(Briece-button $B$r%"%I%*%s$N@_Dj$+$i=|30$7$^$9!#(B -$B$5$i$K!"(B@samp{U} $B$H$9$k$H!"(Briece-button $B$r40A4$K%"%s%m!<%I$7$^$9!#(B +さらに、@samp{u} とすると、riece-button をアドオンの設定から除外します。 +さらに、@samp{U} とすると、riece-button を完全にアンロードします。 -$B$3$N>uBV$G!"(B@samp{s} $B$^$?$O(B @samp{M-x riece-command-save-variables} $B$H(B -$B$9$k$H!"@_Dj$rJ]B8$7$^$9!#(B +この状態で、@samp{s} または @samp{M-x riece-command-save-variables} と +すると、設定を保存します。 -@file{~/.riece/init} $B$G%"%I%*%s$rAH$_9~$`$K$O(B @code{riece-addons} $B$r@_(B -$BDj$7$^$9!#$?$H$($P(B @samp{riece-alias} $B$rAH$_9~$`>l9g$K$O!"0J2<$N$h$&$K(B -$B5-=R$7$^$9!#(B +@file{~/.riece/init} でアドオンを組み込むには @code{riece-addons} を設 +定します。たとえば @samp{riece-alias} を組み込む場合には、以下のように +記述します。 @vindex riece-addons @example @@ -566,169 +567,169 @@ Riece $B$NF0:nCf$K%"%I%*%s$N0lMw$rD/$a$k$K$O%"%I%*%s%V%i%&%6$r;H$&$HJXMx$G$9!# @node Available add-ons, , Add-on browser, Add-ons @subsection Available add-ons -$BMxMQ2DG=$J%"%I%*%s$O$d%K%C%/%M!<%`$NJLL>$rDj5A(B +チャンネル名やニックネームの別名を定義 @item riece-async -Emacs $B$,(B busy or suspend $B>uBV$K$J$k$3$H$KHw$(!"(B -PING $B$K1~Ez$9$k(B local proxy $B7PM3$G(B IRC $B%5!<%P$K@\B3(B +Emacs が busy or suspend 状態になることに備え、 +PING に応答する local proxy 経由で IRC サーバに接続 @item riece-biff -$BB>$N%P%C%U%!$K$$$k;~$KH/8@$,$"$k$H%b!<%I%i%$%s$K0u(B ("[R]") $B$rI=<((B +他のバッファにいる時に発言があるとモードラインに印 ("[R]") を表示 @item riece-button -$B%\%?%s$d%]%C%W%"%C%W%a%K%e!<$NI=<((B +ボタンやポップアップメニューの表示 @item riece-ctcp CTCP (Client To Client Protocol) @item riece-ctlseq -$B%3%s%H%m!<%k%7!<%1%s%9(B (^B $B$J$I(B) $B$K$h$k6/D4I=<((B +コントロールシーケンス (^B など) による強調表示 @item riece-desktop-notify -$B%a%C%;!<%8$NE~Ce$r%G%9%/%H%C%W$KDLCN(B +メッセージの到着をデスクトップに通知 @item riece-doctor -doctor.el $B$HO"7H$7$F@:?@2J0e$K$J$j$9$^$9(B +doctor.el と連携して精神科医になりすます @item riece-epg -EasyPG @uref{http://www.easypg.org} $B$K$h$k2qOC$N0E9f2=(B +EasyPG @uref{http://www.easypg.org} による会話の暗号化 @item riece-eval-ruby -$BF~NO$5$l$?J8;zNs$r(B Ruby $B$N<0$H$7$FI>2A(B +入力された文字列を Ruby の式として評価 @item riece-eval -$BF~NO$5$l$?J8;zNs$r(B Emacs Lisp $B$N<0$H$7$FI>2A(B +入力された文字列を Emacs Lisp の式として評価 @item riece-foolproof -$B%A%c%s%M%k%_%9$rKI$0(B +チャンネルミスを防ぐ @item riece-google -$B%-!<%o!<%I$r(B Google $B$G8!:w(B +キーワードを Google で検索 @item riece-guess -$B?'!9$JJ}K!$G0\F0@h$N%A%c%s%M%k$r?dB,(B +色々な方法で移動先のチャンネルを推測 @item reice-hangman -$B%A%c%s%M%kFb$G(B hangman $B$GM7$V(B +チャンネル内で hangman で遊ぶ @item riece-highlight -$B%P%C%U%!$N?'IU$1(B +バッファの色付け @item riece-history -$B%A%c%s%M%k0\F0$NMzNr4IM}(B +チャンネル移動の履歴管理 @item riece-icon -$B%P%C%U%!Cf$K%"%$%3%s$rI=<((B +バッファ中にアイコンを表示 @item riece-ignore -$B;XDj$7$?%f!<%6$NH/8@$rL5;k(B +指定したユーザの発言を無視 @item riece-kakasi -$BF|K\8l$NDL$i$J$$CAw(B -(Emacs 22 $B$G$N$_F0:n(B) +DCC (Direct Client to Client protocol) によるファイル転送 +(Emacs 22 でのみ動作) @item riece-rdcc -DCC (Direct Client to Client protocol) $B$K$h$k%U%!%$%kE>Aw(B +DCC (Direct Client to Client protocol) によるファイル転送 @item riece-shrink-buffer -$B%a%b%j3NJ]$N$?$a!"%P%C%U%!$rDj4|E*$K@Z$j5M$a$k(B +メモリ確保のため、バッファを定期的に切り詰める @item riece-skk-kakutei -SKK $B;HMQ;~$KJQ49%b!<%I$N0u$rH/8@$+$iuBV$rAw?.(B +CTCP ACTION (@kbd{C-c C-c a}) と同時に Twitter に状態を送信 @item riece-unread -$BH/8@$N$"$C$?%A%c%s%M%k$K(B@samp{!}$B%^!<%/$r$D$1$k(B +発言のあったチャンネルに@samp{!}マークをつける @item riece-url -$B2qOC$K8=$l$?(B URL $B$N<}=8(B +会話に現れた URL の収集 @item riece-xface -$B%f!<%6%j%9%H%P%C%U%!$K%f!<%6$N(B X-Face $B$rI=<((B +ユーザリストバッファにユーザの X-Face を表示 @item riece-xfaceb -$B%f!<%6%j%9%H%P%C%U%!$K%f!<%6$N(B X-Face $B$rI=<((B -(BBDB @uref{http://bbdb.sourceforge.net} $B$,I,MW(B) +ユーザリストバッファにユーザの X-Face を表示 +(BBDB @uref{http://bbdb.sourceforge.net} が必要) @item riece-yank -@kbd{C-c y} $B$G(B kill-ring $B$+$iJ8;zNs$rAw?.(B +@kbd{C-c y} で kill-ring から文字列を送信 @end table @node Tips, Index, Advanced usage, Top @comment node-name, next, previous, up @chapter Tips -$B$3$N>O$G$O!"$h$/J9$+$l$kR2p$7$^$9!#(B +この章では、よく聞かれる質問に対する答えと便利な設定例を紹介します。 -@section $BD>A0$KA*Br$7$F$$$?%A%c%s%M%k$K0\F0$7$?$$(B +@section 直前に選択していたチャンネルに移動したい @vindex riece-guess-channel-try-functions -$B0J2<$N9T$r(B @file{~/.riece/init} $B$KDI2C$9$k$3$H$G!"(B@kbd{C-c g} $B$GMzNr$rC)(B -$B$j$D$D0\F0$G$-$^$9!#(B@samp{riece-guess} $B%"%I%*%s$O!"%A%c%s%M%kA*Br$NMzNr(B -$B$dL$FI%a%C%;!<%8$NM-L5$J$I$+$i~$rM^@)$7$?$$(B +@section 装飾を抑制したい -@code{riece-addons} $B$+$iAu>~$N$?$a$N%"%I%*%s$r=|30$7$^$9!#(B -$BDL>oM-8z$K$J$C$F$$$kAu>~$N$?$a$N%"%I%*%s$OuBV$rAw?.(B @item #emacsen @item -$B$J$7(B +なし @item #debianjp @end enumerate -3 $BHVL\$N%A%c%s%M%k$,6u@J$H$J$C$F$$$k$3$H$K$4Cm0U$/$@$5$$!#?7$?$J%A%c%s%M(B -$B%k$K;22C$7$?>l9g!"$=$N%A%c%s%M%k$,(B 3 $BHVL\$N0LCV$K3dEv$F$i$l$^$9!#(B +3 番目のチャンネルが空席となっていることにご注意ください。新たなチャンネ +ルに参加した場合、そのチャンネルが 3 番目の位置に割当てられます。 -@section $B5/F0;~$K<+F0E*$K%A%c%s%M%k$K;22C$7$?$$(B +@section 起動時に自動的にチャンネルに参加したい @vindex riece-startup-channel-list -$BJQ?t(B @samp{riece-startup-channel-list} $B$r@_Dj$7$^$9!#(B +変数 @samp{riece-startup-channel-list} を設定します。 @example (setq riece-startup-channel-list '("#Riece" "#public")) @end example -$B$3$N@_DjNc$O!"(B@samp{#Riece} $B$H(B @samp{#public} $B$K;22C$9$k$3$H$r0UL#$7$F$$(B -$B$^$9!#%A%c%s%M%k$K;22C$9$k:]$K%Q%9%o!<%I$,I,MW$J>l9g$K$OuBV$rAw?.(B ("freenode" :host "irc.ipv6.freenode.net"))) @end example -$B$3$N@_DjNc$G$O!"5/F0;~$K@\B3$9$k$N$O(B "ircnet" $B$@$1$G$9!#(B -@samp{riece-startup-server-list} $B$r0J2<$N$h$&$K@_Dj$9$k$H!"(B -"freenode" $B$K$b@\B3$9$k$h$&$K$J$j$^$9!#(B +この設定例では、起動時に接続するのは "ircnet" だけです。 +@samp{riece-startup-server-list} を以下のように設定すると、 +"freenode" にも接続するようになります。 @example (setq riece-startup-server-list '("freenode")) @end example -@section HTTP $B%W%m%-%7$r2p$7$F(B IRC $B%5!<%P$K@\B3$7$?$$(B -@file{relay.el} $B$H(B @file{connect.c} $B$r;H$&$H!"(B -HTTP $B%W%m%-%7$r2p$7$F(B IRC $B%5!<%P$K@\B3$9$k$3$H$,$G$-$^$9!#(B +@section HTTP プロキシを介して IRC サーバに接続したい +@file{relay.el} と @file{connect.c} を使うと、 +HTTP プロキシを介して IRC サーバに接続することができます。 @table @asis @item relay.el @@ -794,9 +795,9 @@ HTTP $B%W%m%-%7$r2p$7$F(B IRC $B%5!<%P$K@\B3$9$k$3$H$,$G$-$^$9!#(B @uref{http://www.taiyo.co.jp/~gotoh/ssh/connect.html} @end table -$B$?$H$($P!"(B@samp{proxy.example.com:8080} $B7PM3$G(B -@samp{irc.tokyo.wide.ad.jp} $B$K@\B3$9$k>l9g$K$O!"0J2<$N9T$r(B -@file{~/.riece/init} $B$KDI2C$7$^$9!#(B +たとえば、@samp{proxy.example.com:8080} 経由で +@samp{irc.tokyo.wide.ad.jp} に接続する場合には、以下の行を +@file{~/.riece/init} に追加します。 @example (require 'relay) @@ -809,29 +810,29 @@ HTTP $B%W%m%-%7$r2p$7$F(B IRC $B%5!<%P$K@\B3$9$k$3$H$,$G$-$^$9!#(B riece-server-alist)) @end example -@section $B2qOC$N%m%0$r%U%!%$%k$KJ]B8$7$?$$(B +@section 会話のログをファイルに保存したい @vindex riece-log-directory-map -@samp{riece-log} $B%"%I%*%s$r;H$&$H!"2qOC$N%m%0$r%U%!%$%k$KJ]B8$7!":F5/F0(B -$B;~$K;2>H$G$-$^$9!#(B@samp{riece-log} $B%"%I%*%s$OI8=`$GAH$_9~$^$l$F$$$^$9!#(B +@samp{riece-log} アドオンを使うと、会話のログをファイルに保存し、再起動 +時に参照できます。@samp{riece-log} アドオンは標準で組み込まれています。 -$BDL>o$O(B @file{~/.riece/log} $B$N2<$K(B IRC $B%5!<%P$NL>A0!"%A%c%s%M%kL>$N%G%#%l(B -$B%/%j$,:n@.$5$l!"$=$NCf$KF|$K$AKh$KJ,JL$5$l$FJ]B8$5$l$^$9!#(B +通常は @file{~/.riece/log} の下に IRC サーバの名前、チャンネル名のディレ +クリが作成され、その中に日にち毎に分別されて保存されます。 -$B%G%#%l%/%H%jL>$,J8;z2=$1$9$k>l9g$K$O!"(B -@code{file-name-coding-system} $B$NCM$rE,@Z$K@_Dj$9$k$+!"$"$k$$$O(B -@code{riece-log-directory-map} $B$r;H$C$F%A%c%s%M%kL>$r(B US-ASCII $BJ8;zNs$K(B -$BJQ49$9$kI,MW$,$"$j$^$9!#(B +ディレクトリ名が文字化けする場合には、 +@code{file-name-coding-system} の値を適切に設定するか、あるいは +@code{riece-log-directory-map} を使ってチャンネル名を US-ASCII 文字列に +変換する必要があります。 @example -(setq riece-log-directory-map '(("#$B$j!<$9(B" . "riece"))) +(setq riece-log-directory-map '(("#りーす" . "riece"))) @end example -@section $B%&%#%s%I%&4V$r<+M3$K0\F0$7$?$$(B +@section ウィンドウ間を自由に移動したい -GNU Emacs $B$KImB0$N(B @samp{windmove.el} $B$r;H$&$HJXMx$G$9!#>\:Y$O(B -@samp{windmove.el} $B$N%3%a%s%H$r;2>H$/$@$5$$!#(B@samp{windmove.el} $B$O(B -$B:n