Changeset 11358
- Timestamp:
- 05/10/08 23:36:12 (5 years ago)
- Files:
-
- 1 modified
Legend:
- Unmodified
- Added
- Removed
-
lang/perl/tiarra/branches/utf8/doc-src/conf-main.tdoc
r11357 r11358 2 2 $Id$ 3 3 4 perl�Υ������˻Ȥ�pod�ѡ�����Ѥ��Ƥ����ǡ�packageʸ��pod��cut�ǽ������������� 5 �إå��nfo-is-ommited��o-switch�Ϥɤ���������ʤ����ʤ����� 4 perlのソースに使うpodパーサを流用しているので、package文と=pod〜=cutで書く必要があります。 5 ヘッダのinfo-is-ommitedとno-switchはどちらも値を真に定義しなければなりません。 6 6 7 * general 7 8 package general; 8 9 =pod 9 info: conf���Ȥ�����ɤ���������ʤɤ�ꤹ��nfo-is-omitted: 1 10 no-switch: 1 11 12 # tiarra.conf���Ȥ������# ���������is,sjis,euc,utf8,utf16,utf32���(����ͤ�nicode::Japanese�ˤ��Τޤ�Ϥ�����) 13 # auto����ꤵ�줿���ޤ��Ͼ�����줿���ϼ�ưȽ����ޤ��� 10 info: conf自身の文字コードやユーザー情報などを指定する 11 info-is-omitted: 1 12 no-switch: 1 13 14 # tiarra.conf自身の文字コード 15 # コード名はjis,sjis,euc,utf8,utf16,utf32等。(この値はUnicode::Japaneseにそのまま渡されます) 16 # autoが指定された、または省略された場合は自動判別します。 14 17 conf-encoding: utf8 15 18 16 # �桼������# ����ǽ�Ǥ��� 19 # ユーザー情報 20 # 省略不能です。 17 21 nick: tiarra 18 22 user: tiarra 19 23 name: Tiarra the "Aeon" 20 24 21 # �ɤΤ褦�ʥ桼�����⡼�ɤǥ���뤫��+iw���Τ褦�˻�ꤹ�롣22 # ������줿���ϥ桼�����⡼�ɤ���ꤷ�ʤ���25 # どのようなユーザーモードでログインするか。+iwや+iのように指定する。 26 # 省略された場合はユーザーモードを特に設定しない。 23 27 -user-mode: +i 24 28 25 # Tiarra �ؤ�����Ĥ����������魯�ޥ�����26 # ��¤ʤ��ΤǤ���"*"��ꤹ�뤫������롣29 # Tiarraへの接続を許可するホスト名を表わすマスク。 30 # 制限をしないのであれば"*"を指定するか省略する。 27 31 client-allowed: * 28 32 29 # Tiarra �������ݡ��ȡ������˻�ꤷ���ݡ��Ȥإ��饤������������롣30 # ������줿�����Ȥ��ʤ���33 # Tiarraが開くポート。ここに指定したポートへクライアントに接続させる。 34 # 省略されたらポートを開かない。 31 35 tiarra-port: 6667 32 36 33 # Tiarra ���ݡ���iarra-port���ݡ�IPv6��Pv4�Τɤ���ꥹ�˥�ʤ�����34 # 'v4' �ޤ���v6'�ǻ�ꤷ�ޤ����ǥե�����v4'�Ǥ���35 # IPv6 ���������ocket6.pm��������Ǥ��������������37 # Tiarraがポートtiarra-portを開く際、IPv6とIPv4のどちらでリスニングを行なうか。 38 # 'v4'または'v6'で指定します。デフォルトは'v4'です。 39 # IPv6を使うためにはSocket6.pmが利用可能である必要があります。 36 40 -tiarra-ip-version: v4 37 41 38 # Tiarra ���ݡ���iarra-port���ݤΥ���륢�ɥ쥹��39 # �����ʬ��������������Ʋ�������40 # �ǥե����ϡ�IPv4�Τ�NADDR_ANY��IPv6�Τ�n6addr_any�ˤʤ�����42 # Tiarraがポートtiarra-portを開く際のローカルアドレス。 43 # 意味が分からなければ省略して下さい。 44 # デフォルトは、IPv4のはINADDR_ANY、IPv6のはin6addr_anyになります。 41 45 -tiarra-ipv4-bind-addr: 0.0.0.0 42 46 -tiarra-ipv6-bind-addr: ::0 43 47 44 # Tiarra �˥��饤������³������᤹������ɤ�pt����ʸ��45 # �������ꤵ�줿��ά���줿���ϥѥ���ɤ�ᤷ�ʤ���46 # crypt ��./tiarra --make-password �ǹԤ��ޤ���48 # Tiarraにクライアントが接続する際に要求するパスワードをcryptした文字列。 49 # 空の文字列が指定されたり省略された場合はパスワードを要求しない。 50 # crypt は ./tiarra --make-password で行えます。 47 51 tiarra-password: xl7cflIcH9AwE 48 52 49 # ����ץ������arra���뤹����NIX�ɥᥤ���åȤ�����50 # �����foo"��ꤷ�����������å�tmp/tiarra-control/foo��������51 # ������줿���Ϥ��ε�ǽ����롣52 # �ޤ����UNIX�Ķ��ǤϤ��⤽��IX�ɥᥤ���åȤ�������Ǥʤ����ᡢ53 # ���Τ褦�ʾ��ˤ⤳�ε�ǽ������롣53 # 外部プログラムからtiarraをコントロールする為のUNIXドメインソケットの名前。 54 # 例えば"foo"を指定した場合、ソケット/tmp/tiarra-control/fooが作られる。 55 # 省略された場合はこの機能を無効とする。 56 # また、非UNIX環境ではそもそもUNIXドメインソケットが利用可能でないため、 57 # そのような場合にもこの機能は無効となる。 54 58 -control-socket-name: test 55 59 56 # IRC�����С��������������ɤȡ�IRC�����С�����������# �ɤ��������줿����is�� 60 # IRCサーバーから送られる文字のコードと、IRCサーバーへ送る文字のコード 61 # どちらも省略された場合はjis。 57 62 server-in-encoding: jis 58 63 server-out-encoding: jis 59 64 60 # ���饤�����������ʸ�����ɤȡ����饤���������������# �ɤ��������줿����is�� 65 # クライアントから受け取る文字のコードと、クライアントへ伝える文字のコード 66 # どちらも省略された場合はjis。 61 67 client-in-encoding: jis 62 68 client-out-encoding: jis 63 69 64 # Tiarra ��������͡��ʥ���������Ϥ��뤬����������ɤ�ꤹ�롣������ˤ�uc�Ȥʤ롣65 # �����tiarra.conf�Υѡ�������λ�����Ǥ�����ɤ�Ѵ��ϹԤʤ��ʤ�(�Ĥޤꤳ���꤬ͭ������)���Ȥ�����Ʋ�������70 # Tiarraは標準出力に様々なメッセージを出力するが、その文字コードを指定する。省略時にはeucとなる。 71 # ただしtiarra.confのパースが完了するまでは文字コードの変換は行なわれない(つまりこの設定が有効にならない)ことに注意して下さい。 66 72 stdout-encoding: utf8 67 73 68 # Tiarra �ϥ��顼�������������˽�Ϥ��뤬�����λ��������Ƥ��륯�饤������������饤����ˤ�TICE��������69 # ����ͤ����������ε�ǽ��ͭ���롣������뤫0��ꤹ�����ε�ǽ������롣74 # Tiarraはエラーメッセージを標準出力に出力するが、その時に接続しているクライアントがあればクライアントにもNOTICEで送る事が出来る。 75 # この値を1にすると、その機能が有効になる。省略するか0を指定するとこの機能は無効になる。 70 76 notice-error-messages: 1 71 77 72 # Tiarra �ǥ���ͥ��桼�����Υޥ�����ꤹ�����η����73 # plum �����iarra��������Ǥ��ޤ���78 # Tiarraでチャンネルとユーザーのマスクを指定するときの形式。 79 # plum形式とTiarra形式が選択できます。 74 80 #----------------- 75 # plum ���: (channel�ˤ���ϻȤ��ʤ���channel�Ͼ������*�Ȥߤʤ���)81 # plum形式: (channelには+や-は使えない。channelは省略すると*とみなす。) 76 82 # + syntax: user[ channel[ channel[ ...]]] 77 83 # … … 80 86 # mask: -*!*@* 81 87 #----------------- 82 # Tiarra ���: (channel�ˤ�����롣)88 # Tiarra形式: (channelにも+や-を使える。) 83 89 # + syntax: channel user 84 90 # 85 91 # mask: #{example}@ircnet,-#{example2}@2ch +*!*@*.example.com 86 # mask: ++{example3}@ircnet,-+{example4}@2ch +*!*@*.example.com # + �ǻϤޤ����ͥ롣92 # mask: ++{example3}@ircnet,-+{example4}@2ch +*!*@*.example.com # +で始まるチャンネル。 87 93 # mask: * -*!*@* 88 94 #----------------- 89 # �Ȥʤ����� �����Ϥޤä���Ʊ���ޥ�������Ƥ��ޤ���90 91 # ����ͤ�m�ˤ�����plum�����������뤫tiarra��ꤹ����Tiarra����ˤʤ�����95 # となります。 この二つはまったく同じマスクを表しています。 96 97 # この値をplumにすると、plum形式、省略するかtiarraを指定すると、Tiarra形式になります。 92 98 chanmask-mode: tiarra 93 99 94 # �����С�����������������ΤɤΥ��ɥ쥹�˥Х�����뤫��95 # �����ʬ��������������Ʋ�������96 # �ǥե����ϡ�IPv4�Τ�NADDR_ANY��IPv6�Τ�n6addr_any�ˤʤ�����100 # サーバーに接続する際、ローカル側のどのアドレスにバインドするか。 101 # 意味が分からなければ省略して下さい。 102 # デフォルトは、IPv4のはINADDR_ANY、IPv6のはin6addr_anyになります。 97 103 -ipv4-bind-addr: 0.0.0.0 98 104 -ipv6-bind-addr: ::0 99 105 100 # tiarra ���� 001 ��02 �䡢 recent log ����������ʤɤ˻Ȥ� prefix 101 # ��ꤷ�ޤ��� hostname ��qdn �äݤ�����ꤹ��������⤷������# �ǥե�����tiarra �Ǥ������������Ϥ�������-sysmsg-prefix: tiarra 106 # tiarra が、 001 や 002 や、 recent log を送信するときなどに使う prefix 107 # を指定します。 hostname や fqdn っぽいものを指定すると良いかもしれません。 108 # デフォルトは tiarra です。普通変える必要はありません。 109 -sysmsg-prefix: tiarra 102 110 103 111 sysmsg-prefix-use-masks { 104 # sysmsg-prefix ��Ѥ�������ꤹ�롣 105 106 # �����ƥ��å�����(NumericReply �ʤ����ǥե�����* �Ǥ��� 107 # �դĤ��������������Ϥ������� system: * 108 109 # �ĿͰ���������(Notice,Privmsg ���)���ǥե����Ϥʤ��� 112 # sysmsg-prefix を使用する場所を指定する。 113 114 # システムメッセージ(NumericReply など)。デフォルトは * です。 115 # ふつうこれを変更する必要はありません。 116 system: * 117 118 # 個人宛メッセージ(Notice,Privmsg の中で)。デフォルトはなし。 110 119 -priv: 111 120 112 # ����ͥ밸��������(Notice,Privmsg ���)���ǥե�����* �Ǥ��� 113 # Ziciz �ʤɤΥ��饤�������������� 114 # -*::log ��ꤷ�Ƥ����Ȥ������⤷������ channel: * 121 # チャンネル宛メッセージ(Notice,Privmsg の中で)。デフォルトは * です。 122 # Ziciz などのクライアントを接続する場合は、 123 # -*::log を指定しておくといいかもしれません。 124 channel: * 115 125 } 116 126 117 # Tiarra �� nick ������ξ�����������ɤ�ꤷ�ޤ���118 # 0: Tiarra ���³�������˼�ư�����ޤ���119 # 1: ���饤����ˤ��Τޤ�ꤲ�ޤ���120 # ʣ����饤����� nick ����������˴�Ǥ���121 # ( �����IRC ���饤�����ʣ��ʤ��äƤ������ޤߤޤ�)122 # 2: ������륨�顼�������������NOTICE ��Ѵ����ơ�123 # ���饤�����ꤲ�ޤ���124 # multi-server-mode ���Υǥե�����0 �� single-server-mode ���Υǥե�����1 �Ǥ���127 # Tiarra が nick 変更時の衝突等を処理するモードを指定します。 128 # 0: Tiarra が接続時と同様に自動処理します。 129 # 1: クライアントにそのまま投げます。 130 # 複数のクライアントが nick 重複を処理する場合は非常に危険です。 131 # (設定不足の IRC クライアントが複数つながっている場合も含みます) 132 # 2: 対応するエラーメッセージ付きの NOTICE に変換して、 133 # クライアントに投げます。 134 # multi-server-mode 時のデフォルトは 0 、 single-server-mode 時のデフォルトは 1 です。 125 135 -nick-fix-mode: 0 126 136 127 137 messages { 128 # Tiarra ����Ѥ��롢�����Ĥ��Υ���������ꤹ�롣138 # Tiarra が使用する、いくつかのメッセージを指定する。 129 139 130 140 quit { 131 # �ͥåȥ������������졢��������������������141 # ネットワーク設定が変更され、再接続する場合の切断メッセージ 132 142 netconf-changed-reconnect: Server Configuration changed; reconnect 133 143 134 # �ͥåȥ������������졢������������������144 # ネットワーク設定が変更され、切断する場合の切断メッセージ 135 145 netconf-changed-disconnect: Server Configuration changed; disconnect 136 146 } … … 141 151 package networks; 142 152 =pod 143 info: Tiarra ����³�����åȥ������������144 info-is-omitted: 1 145 no-switch: 1 146 147 # ʣ������С��ؤ�������ˤ��뤫�ɤ�����1(����0(�����ǻ�ꡣ148 # ����1�ˤ���������ame��������������ˤʤꡢ149 # ʣ������С��������������褦�ˤʤ�����150 # ���ΰ�������1�ˤ��Ƥ����ϡ�����ͥ��˥ͥåȥ��̾����ä������151 # IRC ���ʬ�Υ���������Tiarra�ˤ��������ޤ���152 # ����0�ˤ��Ƥ����ϡ�����ame���������Ͻ�����ʤ�����153 # �ޥ������С��⡼�ɤ�����ư���Ѥ��������饤������鸫������ͥ���154 # ����ˤʤ�������饤�������Ū����ƤΥ���ͥ뤫��rt�����褦�˸�����155 # �������join��ľ�����褦�˸����ޤ���156 # �ǥե����Ǥ��Ǥ���153 info: Tiarraから接続するネットワークの定義、その他 154 info-is-omitted: 1 155 no-switch: 1 156 157 # 複数のサーバーへの接続を可能にするかどうか。1(オン)と0(オフ)で指定。 158 # これを1にすると、次のnameを複数個定義する事が可能になり、 159 # 複数のサーバーに同時に接続出来るようになります。 160 # その一方、これを1にしている時は、チャンネル名にネットワーク名が付加される等、 161 # IRCの大部分のメッセージがTiarraによる改変を受けます。 162 # これを0にしている間は、次のnameを複数個定義する事は出来なくなります。 163 # マルチサーバーモードの設定を起動中に変えると、クライアントから見たチャンネル名が 164 # 変更になる為、全クライアントが一時的に全てのチャンネルからpartしたように見え、 165 # その直後にjoinし直したように見えます。 166 # デフォルトでは1です。 157 167 multi-server-mode: 1 158 168 159 # �³����C�ͥåȥ����������ޤ����������ϸ���Ѥ��ޤ���160 # ʣ��ͥåȥ�����������������������Ʋ�������169 # 接続するIRCネットワークに名前を付けます。この名前は後で使用します。 170 # 複数のネットワークに接続したい場合は多重定義して下さい。 161 171 name: ircnet 162 172 name: 2ch 163 173 164 # ���arra�Ǥϥ���ͥ���Tiarra@ircnet�פΤ褦��������ޤ���165 # �����ͥåȥ��ircnet���Tiarra�Ȥ�������ͥ�ɽ�路�ޤ���166 # @ �ʹߤϾ������Ǥ�����������줿���Υǥե����Υͥåȥ��̾���ǻ�ꤷ�ޤ���167 # ����������ϺǤ��������줿name���ǥե����ˤʤ�����168 # ( ������ame���������ä�����ain���ǥե����ˤʤ���)174 # 通常Tiarraではチャンネル名を「#Tiarra@ircnet」のように表現します。 175 # これはネットワークircnet内の#Tiarraというチャンネルを表わします。 176 # @以降は省略可能ですが、省略された場合のデフォルトのネットワーク名をここで指定します。 177 # 省略した場合は最も始めに定義されたnameがデフォルトになります。 178 # (そしてnameが一つも無かった場合はmainがデフォルトになります) 169 179 -default: ircnet 170 180 171 # ���Ҥ٤���ꡢ�ǥե����Ǥ�iarra�ϥ���ͥ��ȥͥåȥ��̾����������172 # ���ζ������դ�������������������������줿�����ˤʤ�����181 # 上に述べた通り、デフォルトではTiarraはチャンネル名とネットワーク名を@で区切ります。 182 # この区切り文字は任意の文字に変更する事が出来ます。省略された場合は@になります。 173 183 # 174 # System::PrivTranslator �⥸�塼�������Ƥ����硢 prefix ��nick �ʬ�ˤ� �������������Τ��ᡢ ! �� ��������������饤�������ư���� �����������Τ�����Ƥ�������� 184 # System::PrivTranslator モジュールを利用している場合、 prefix の nick 部分にも 185 # 利用されます。そのため、 ! や @ を含む文字列を利用するとクライアントが誤作動する 186 # 場合がありますので注意してください。 175 187 channel-network-separator: @ 176 188 177 # �³��Υ����С���������줿���ˡ�join���Ƥ������Υ����С��Υ���ͥ��ɤ����뤫�� 178 # 1. "part-and-join"�ξ��ϡ��������ȥ��饤����ˤϥ���ͥ뤫��rt�����褦�˸����ݤ��� 179 # ����������ȺƤ�oin�����褦�˸����ݤ��롣�Ǥ��٤��⤤��(����plum�˻��������# 2. "one-message"�ξ��ϡ��������ȥ��饤����˰��Ƥ�iarra��NOTICE�Ǥ��λݤ�𤹤롣 180 # ����������ȺƤ�OTICE�����롣JOIN��RT�Ϥ��ʤ��Τǡ� 181 # ���饤��������ޤ���Υ���ͥ��ĤäƤ��뤫�Τ褦�˸����롣 182 # 3. "message-for-each"�ξ��ϡ��������ȥ��饤����˰��Ƥ�iarra�� 183 # �ã�ǽ�ˤʤä���ƤΥ���ͥ�NOTICE�Ǥ��λݤ�𤹤롣 184 # ����������ȺƤ�OTICE�����롣JOIN��RT�Ϥ��ʤ��� 185 # �ǥե�����art-and-join�Ǥ��� 189 # 接続先のサーバーから切断された時に、joinしていたそのサーバーのチャンネルをどうするか。 190 # 1. "part-and-join"の場合は、切断されるとクライアントにはチャンネルからpartしたように見せ掛け、 191 # 再接続に成功すると再びjoinしたように見せ掛ける。最も負荷が高い。(これはplumに似た動作である) 192 # 2. "one-message"の場合は、切断されるとクライアントに宛ててTiarraがNOTICEでその旨を報告する。 193 # 再接続に成功すると再びNOTICEで報告する。JOINやPARTはしないので、 194 # クライアントからはまだそのチャンネルに残っているかのように見える。 195 # 3. "message-for-each"の場合は、切断されるとクライアントに宛ててTiarraが 196 # 到達不能になった全てのチャンネルにNOTICEでその旨を報告する。 197 # 再接続に成功すると再びNOTICEで報告する。JOINやPARTはしない。 198 # デフォルトはpart-and-joinです。 186 199 action-when-disconnected: message-for-each 187 200 188 # NICK ��������ˡ�������������С��Ǥο�����NICK��ICE�Ǿ������뤫�ɤ�����189 # 1 �ʤ���������0�ʤ�����nick�������ck(���饤����������ν��nick)�Ȱ��Ƥ��������Τ��롣190 # �ǥե������Ǥ���201 # NICKを変更する度に、変更したサーバーでの新しいNICKをNOTICEで常に通知するかどうか。 202 # 1なら必ず通知し、0なら変更後のnickがローカルnick(クライアントが見る事の出来るnick)と違っている場合のみ通知する。 203 # デフォルトは0です。 191 204 always-notify-new-nick: 0 192 205 193 206 fixed-channels { 194 # Tiarra �����饤���������˥���ͥ��������ꤹ�롣195 # �ޥå���ʤ��ä�����ͥ��Ĥ��ƤϺǸ��ޤȤ�196 # ( ��������㤴����ʤä�����Ƥ��ޤ���197 channel: # �Ƥ��Ȥ���ͤ�rcnet198 channel: # �Ƥ���localserver207 # Tiarra がクライアント接続時にチャンネル情報を送る順番を指定する。 208 # マッチしなかったチャンネルについては最後にまとめて 209 # (順番がごちゃごちゃになって)送られてきます。 210 channel: #てすとちゃんねる@ircnet 211 channel: #てすと@localserver 199 212 channel: *@localserver 200 213 channel: *@localserver:*.jp … … 206 219 package ircnet; 207 220 =pod 208 info: �ͥåȥ������IRCnet)209 info-is-omitted: 1 210 no-switch: 1 211 212 # �����С��Υۥ��Ȥȥݡ��ȡ������ġ�221 info: ネットワーク定義例 (IRCnet) 222 info-is-omitted: 1 223 no-switch: 1 224 225 # サーバーのホストとポート。省略不可。 213 226 host: irc.nara.wide.ad.jp 214 227 port: 6663 215 228 216 # general/user ���ꤷ���桼��̾��鷺�ˡ��ƥͥåȥ����ȼ��Υ桼��̾��Ѥ�����ǽ��217 # ������줿�����general/user���ꤷ�������Ȥ��롣229 # general/userで設定したユーザ名を使わずに、各ネットワークで独自のユーザ名を使用する事も可能。 230 # 省略されたら当然、general/userで設定したものが使われる。 218 231 -user: hoge 219 232 220 # general/name ���ꤷ���̾(��)��鷺�ˡ��ƥͥåȥ����ȼ�������Ѳ����233 # general/nameで設定した本名(建前上)を使わずに、各ネットワークで独自の本名を使用可能。 221 234 -name: hoge 222 235 223 # ���Υ����С���᤹������ɡ���������236 # このサーバーの要求するパスワード。省略可能。 224 237 -password: hoge 225 238 226 # general/setver-in/out-encoding ���ꤷ�������ǥ���鷺�ˡ�227 # �ƥͥåȥ����ȼ��Υ����ǥ���Ѥ�����ǽ��228 # ������줿�����general���ꤷ�������Ȥ��롣239 # general/setver-in/out-encodingで設定したエンコーディングを使わずに、 240 # 各ネットワークで独自のエンコーディングを使用する事も可能。 241 # 省略されたら当然、generalで設定したものが使われる。 229 242 -in-encoding: jis 230 243 -out-encoding: jis 231 244 232 # general/(ipv4|ipv6)bind-addr ���ꤷ������륢�ɥ쥹��鷺�ˡ�233 # �ƥͥåȥ����ȼ���ind_addr��Ѥ�����ǽ��234 # ������줿��neral���ꤷ�������Ȥ��롣245 # general/(ipv4|ipv6)bind-addrで設定したローカルアドレスを使わずに、 246 # 各ネットワークで独自のbind_addrを使用する事も可能。 247 # 省略されたらgeneralで設定したものが使われる。 235 248 -ipv4-bind-addr: 0.0.0.0 236 249 -ipv6-bind-addr: ::0 … … 240 253 package 2ch; 241 254 =pod 242 info: �ͥåȥ������2ch)255 info: ネットワーク定義例 (2ch) 243 256 info-is-omitted: 1 244 257 no-switch: 1
![(please configure the [header_logo] section in trac.ini)](/share/chrome/site/your_project_logo.png)