OSDN Git Service

78941bf9ef34a753da194ab2c7280067267a8e13
[webchat/WebChat.git] / readme.html
1 <!DOCTYPE html>\r
2 <html>\r
3 <head>\r
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">\r
5 <meta http-equiv="content-language" content="ja">\r
6 <meta name="keywords" content="WebChat,マニュアル,使い方">\r
7 <meta name="description" content="WebChatの使い方を解説しています">\r
8 <meta name="robots" content="ALL" />\r
9 <title>MANUAL</title>\r
10 </head>\r
11 <div id="content">\r
12         <h2>動作環境</h2>\r
13         <ul>\r
14                 <li>node.js 0.8.x</li>\r
15                 <li>redis 2.4.6以降</li>\r
16         </ul>\r
17         <h2>インストール方法</h2>\r
18         <h3>Windows</h3>\r
19         <ol>\r
20                 <li><a href="https://github.com/rgl/redis/downloads">ここ</a>からRedis Serverダウンロードし、インストールする</li>\r
21                 <li><a href="http://nodejs.org/">ここ</a>のDownloadページからをnode.jsダウンロードし、インストールする</li>\r
22                 <li><a href="http://www-jp.mysql.com/">ここ</a>のダウンロードからMySQLをダウンロードし、インストールする</li>\r
23                 <li>mysql -u root -p &lt; init.sqlを実行する</li>\r
24                 <li>npm installを実行する</li>\r
25                 <li>configue.jsのusernameとpasswordを適切なものに変更する</li>\r
26                 <li>configue.jsのredis~を変更する(ローカル内でRedisSeverを起動する場合は不要)</li>\r
27                 <li>configue.jsのdb_~を変更する(ローカル内でRedisSeverを起動する場合は不要)</li>\r
28                 <li>redisを起動し、main.jsを起動する</li>\r
29         </ol>\r
30         <h3>CentOS系列</h3>\r
31         <ol>\r
32                 <li>yum groupinstall "Development Tools"を実行する</li>\r
33                 <li>yum instlall gitを実行する</li>\r
34                 <li>yum install wgetを実行する</li>\r
35                 <li>yum install openssl-develを実行する</li>\r
36                 <li><a href="http://redis.io/download">ここ</a>にアクセスし、redisをインストールする</li>\r
37                 <li>redis-2.4.17/utils/install_server.shを実行する</li>\r
38                 <li><a href="http://nodejs.org/dist/v0.8.14/node-v0.8.14.tar.gz">ここ</a>からダウンロードする</li>\r
39                 <li>yum install mysql-serverを実行する</li>\r
40                 <li>/etc/my.cnfのclient,mysql,mysqldumpセクションのdefault-character-setをutf8にする</li>\r
41                 <li>chkconfig mysqld onを実行する</li>\r
42                 <li>/etc/rc.d/init.d/mysqld startを実行する</li>\r
43                 <li>tar xzf node-v0.8.14.tar.gzを実行する</li>\r
44                 <li>cd node-v0.8.14を実行する</li>\r
45                 <li>./configureを実行する</li>\r
46                 <li>makeを実行し、make installも実行する</li>\r
47                 <li>git clone git://git.sourceforge.jp/gitroot/webchat/WebChat.gitを実行する</li>\r
48                 <li>npm installを実行する</li>\r
49                 <li>configue.jsのusernameとpasswordを適切なものに変更する</li>\r
50                 <li>configue.jsのredis~を変更する(ローカル内でRedisSeverを起動する場合は不要)</li>\r
51                 <li>configue.jsのdb_~を変更する(ローカル内でRedisSeverを起動する場合は不要)</li>\r
52                 <li>mysql -u root -p &lt; init.sqlを実行する</li>\r
53                 <li>main.jsを起動する</li>\r
54         </ol>\r
55         <h2>チャットの管理</h2>\r
56         <p>[設置しているサーバー]/chat/adminとアドレスバーに入力することでチャット管理用のページにアクセスできます</p>\r
57         <p>このページではログの削除、アクセスを禁止するIPアドレスの設定、ルームの設定を行うことができます。</p>\r
58         <h3>ipアドレスの設定</h3>\r
59         <p>テキストエリアに「IPアドレス:r」と記述することで読み取りを禁止し、「IPアドレス」だけを記述することで書き込みを禁止することができます。</p>\r
60         <h3>ルームの設定</h3>\r
61         <p>部屋番号にチェックを入れると、最初に入室した人がパスワードを設定できるようになります。この状態でROM禁止にチェックマークを付けた場合、入室するまでチャットの内容を表示できなくなります。パスワードを入力した場合、パスワードを入力しないと入室できなくなります。</p>\r
62         <h2>チャットルームへのアクセス</h2>\r
63         <p>アドレスバーに[設置しているサーバー]/chatと入力することでチャットルームにアクセスできます。</p>\r
64         <h2>複数のルームの設置</h2>\r
65         <p>URLを[設置しているサーバー]/chat?rno=[ルーム番号]とすることで複数のチャットルームを使い分けることができます。</p>\r
66         <p>なお、デフォルトではchatServer.jsの$max_room_numberの値が3になっているので、この値を設置したい個数にしてください。(設定を変えた後は再起動してください)</p>\r
67         <h2>ルームごとにスタイル変える方法</h2>\r
68         <p>&lt;link rel=&amp;quot;stylesheet&amp;quot; href=&amp;quot;stylesheets/&lt;%= rno %&gt;.css&amp;quot; type=&amp;quot;text/css&amp;quot; /&gt;</p>\r
69         <p>この記述をchat.ejsファイルの&lt;head&gt;から&lt;/head&gt;の間に追加し、[ルーム番号].cssという名前のファイルを用意することで部屋ごとにデザインを変えることができます</p>\r
70         <h2>プロファイルへのリンク方法</h2>\r
71         <p>chatclient.jsの$profile_linkをプロファイルの設定に合わせてください。何も設定を変えない場合は標準のプロファイルシステムを使用します</p>\r
72         <p>例:$profile_link=http://localhost/profile.cgi?name=%n</p>\r
73         <h2>プロフィールの管理</h2>\r
74         <p>[設置しているサーバー]/profile/adminにアクセスすることでプロフィールの管理を行うことができます</p>\r
75         <p>このページにある全削除ボタンを押した場合はすべてのプロフィールを削除することができ、削除ボタンを押した場合は選択したプロフィールを削除できます</p>\r
76         <p>注意!! このページからそれぞれのプロフィールにアクセスした場合、パスワードを入力せずに編集と削除を行うことができます</p>\r
77         <h2>コマンドの追加方法</h2>\r
78         <p>WebChatでは必要に応じて外部コマンドを追加することができます。追加する場合はchat.ejsのcommandparser.jsを呼び出している行よりも後に追加してください。そうでない場合、正常に動作しないことがあります</p>\r
79         <h2>プロフィールに項目を追加する方法</h2>\r
80         <p>init.sqlとconfigure.jsを編集することで項目を増減させることができます。なお、Don't editで囲まれた部分は削除しないでください。削除すると正常に動作しなくなります</p>\r
81         <h2>トラブルシューティング</h2>\r
82         <h3>500 Redis connection to [サイト名] failed - connect ECONNREFUSEDと表示される</h3>\r
83         <p>Redisサーバーが起動していない。もしくは$redisHost,$redisPort,$redisPasswordの設定が間違っていることが考えられます</p>\r
84         <h3>Error: connect ECONNREFUSEDと表示される</h3>\r
85         <p>MySQLサーバーがきどうしていない。もしくはサーバーの設定が間違ってることが考えられます</p>\r
86         <h2>不具合報告</h2>\r
87         <p>不具合報告は<a href="http://sourceforge.jp/projects/webchat/">このサイト</a>にあるフォーラムもしくはチケットからお願いします</p>\r
88         <h2>著作権</h2>\r
89         <dl>\r
90                 <dt>BellG@11.wav、BellG@11.mp3</dt>\r
91                 <dd><a href="http://wwl.s-t-t.com/">WEB WAVE LIB</a>様</dd>\r
92         </dl>\r
93         <h2>ライセンス</h2>\r
94         <p>著作権で定義されたものを除き、すべてのファイルはBSDライセンスにより提供されるものとします</p>\r
95 </div>\r
96 <div id="footer">\r
97         <div id="copyright">Copyright (C) FooProject All Rights Reserved.</div>\r
98 </div>\r
99 <body>\r
100 </body>\r
101 </html>\r