Mercurial > hgrepos > hgweb.cgi > after5
annotate index.html @ 108:786b7b768819 draft default tip master
Update copyright line
author | HIROSE Yuuji <yuuji@gentei.org> |
---|---|
date | Wed, 05 Apr 2023 10:42:43 +0859 |
parents | 43b6e8c1272c |
children |
rev | line source |
---|---|
19 | 1 <html> |
2 <head> | |
3 <title> | |
4 | |
5 </title> | |
6 <link rel="stylesheet" type="text/css" href="after5.css"> | |
7 </head> | |
8 | |
9 <body> | |
97 | 10 <h1>みんなの予定表 <img src="after5.png" alt="「アフター5」" |
11 style="vertical-align: middle;"></h1> | |
12 <h2>なんじゃこれ</h2> | |
21 | 13 <p>仲間同士が、極秘じゃない予定を共有するためのもの。</p> |
19 | 14 |
97 | 15 <h2>何ができるじゃ?</h2> |
21 | 16 <p>こんなん</p> |
19 | 17 <ul> |
77 | 18 <li>個人の予定を登録するとみんなにその予定が見える</li> |
19 <li>他人には見せないようなプライベートな予定も入れられる</li> | |
20 <li>予定が近づくと指定した宛先にメイルを送ってくれる</li> | |
21 <li>いつメイルを送るかは登録時にある程度選べる</li> | |
22 <li>グループを作ってグループの予定も登録できる</li> | |
23 <li>グループの予定通知メイルはグループメンバー全員に送られる</li> | |
24 <li>グループ予定はグループメンバー以外には見せないようにもできる</li> | |
25 <li>グループ全員に一斉メイルを流せる</li> | |
19 | 26 </ul> |
21 | 27 <p>こんだけ。グループウェアからファイル共有機能を取っぱらって |
77 | 28 メイル通知機能とグループ作りまくり機能とML機能を足したような感じ?</p> |
19 | 29 |
21 | 30 <p>まあ、<a href="demo/a5.cgi">デモ版で遊んで</a>みれ。 |
31 予定通知メイルがない他は本物と同じじゃ。</p> | |
19 | 32 |
97 | 33 <h2>何ができないか</h2> |
21 | 34 <p>こういうことはできない。</p> |
19 | 35 <ul> |
21 | 36 <li> ファイル共有機能 |
37 <li> 回覧 | |
38 <li> 予約や日程調整 | |
19 | 39 </ul> |
21 | 40 <p>そゆのやりたいなら、ぐるーぷうぇあつこてくれ。「予定共有」だけを |
41 したいからこれ作った。予定共有したいだけなのに PHP や SQL や Servelet な | |
42 んかをいれてシステムのセキュリティレベルを下げるのが嫌だ、ってことが | |
43 きっかけで作ったのがAfter5なので、基本的に予定共有以外の部分は無視。</p> | |
19 | 44 |
21 | 45 <p>あ、日程調整なら<a href="/~yuuji/software/uogashi/">魚がしぷらんなー</a> |
46 がええぞ。</p> | |
19 | 47 |
97 | 48 <h2>インストール1</h2> |
21 | 49 <p>「スケジュールデータをhttpd権限で保存するんでいいや」って場合は |
50 こんな感じ。</p> | |
19 | 51 <ol> |
97 | 52 <li><p>インストールするディレクトリを決める。 |
53 <code>~/public_html/after5</code> ってことにしよう。</p></li> | |
100 | 54 <li><p>最新版をインストールする</p> |
97 | 55 <div class="screen"> |
19 | 56 <pre> |
100 | 57 % <span class="u">cd ~/public_html</span> |
58 % <span class="u">git clone https://www.yatex.org/gitbucket/yuuji/after5</span> | |
59 % <span class="u">cd after5</span> | |
19 | 60 </pre> |
97 | 61 </div></li> |
62 <li><p><code>after5.cf</code> に管理人のメイルアドレスと、After5を | |
63 設置するURLを記述する。</p> | |
64 <div class="list"> | |
19 | 65 <pre> |
21 | 66 maintainer=<var>あなたのメイルアドレス</var> |
67 url=http://<var>設置するURL</var> | |
68 name=<var>設置After5につける短い名前</var> | |
19 | 69 </pre> |
97 | 70 </div></li> |
71 <li><p>全てのデータをカレントディレクトリの <code>s/</code> ディレクト | |
72 リに書くようになっているので、ここにhttpdが動く権限でデータをかき | |
73 こめるようにする。</p> | |
74 <div class="screen"> | |
19 | 75 <pre> |
76 % <span class="u">mkdir s</span> | |
77 % <span class="u">chmod 1777 s</span> | |
78 </pre> | |
97 | 79 </div> |
80 <p>でも欲をいえば s ディレクトリはhttpdの動くUIDの持ち物にした方が | |
81 赤の他人ユーザに書き込まれなくて好ましい。httpdがnobodyで動いてい | |
82 るなら root 権限で</p> | |
83 <div class="screen"> | |
19 | 84 <pre> |
85 # <span class="u">chown nobody s</span> | |
86 # <span class="u">chmod og-w s</span> | |
87 </pre> | |
97 | 88 </div> |
89 <p>しておいた方がええね。</p></li> | |
90 <li><p><code>.htaccess</code> ファイルでディレクトリインデックスを変える | |
91 権限があるなら</p> | |
92 <div class="list"> | |
19 | 93 <pre> |
94 DirectoryIndex after5.cgi | |
95 </pre> | |
97 | 96 </div> |
97 <p>などとしておく。</p></li> | |
98 <li><p>CGIがうまく動くことを確認したらURLにパスワードをかける</p> | |
99 <div class="list"> | |
19 | 100 <pre> |
101 % <span class="u">htpasswd -c passwd after5</span> | |
102 </pre> | |
97 | 103 </div> |
104 <p><code>.htaccess</code> にこんな感じなのを追加</p> | |
105 <div class="list"> | |
19 | 106 <pre> |
107 AuthUserFile /home/tarosan/public_html/after5/passwd | |
108 AuthGroupFile /dev/null | |
109 AuthName Schedule | |
110 AuthType Basic | |
111 | |
112 require user after5 | |
113 </pre> | |
97 | 114 </div> |
115 <p>すまん、htpasswdのかけ方の説明する程の元気がない。 | |
116 Webページへのパスワードのかけ方はgoogleさんにしっかり | |
117 教わってくり。</p></li> | |
19 | 118 </ol> |
119 | |
97 | 120 <h2>インストール2</h2> |
21 | 121 <p>httpd権限じゃなくて、After5固有の個人権限で動かす場合。 |
122 専用ユーザを作ることでデータの覗き見ができなくなる。けど、 | |
123 サーバにユーザを作る必要があるので、管理者に頼もう(おそらく自分だね)。 | |
19 | 124 </p> |
125 <ol> | |
97 | 126 <li><p>管理者に頼むかrootになってAfter5専用のユーザを作る</p></li> |
127 <li><p>After5専用のユーザにsuする。</p></li> | |
128 <li><p>「インストール1」の通りに after5 を展開し、 | |
129 <code>after5.cf</code> を作成する。</p></li> | |
130 <li><p>wrapperプログラム <code>a5.cgi</code> をコンパイル</p> | |
131 <div class="screen"> | |
19 | 132 <pre> |
133 % make | |
134 </pre> | |
97 | 135 </div></li> |
136 <li><p>カレントディレクトリに <code>a5.cgi</code> ができるので | |
137 こっちを公開CGIのURLとする</p></li> | |
19 | 138 </ol> |
139 | |
97 | 140 <h2>cronの設定</h2> |
141 <p>予定が近づいたときの通知メイルを送るにはシステムの crontab | |
142 に定期的メイルを送信するようコマンドを登録する必要がある。 | |
143 仮に after5 のwrapperをインストールしたパスが | |
144 <code>/home/tarosan/public_html/after5/a5.cgi</code> | |
145 だとすると、ユーザ:tarosan の crontab は次のように登録する。</p> | |
146 <div class="list"> | |
147 <pre> | |
148 */5 * * * * /home/tarosan/public_html/after5/a5.cgi -notify | |
149 </pre> | |
150 </div> | |
151 <p>crontab の登録はおそらく <code>crontab -e</code> | |
152 とかでできるんちゃうかな。</p> | |
153 | |
154 <h2>ML機能</h2> | |
155 <p>なんとなく<a href="http://www.fml.org">FML</a>っぽい | |
156 ML機能がある。カレンダー画面の下部にある「グループ管理」に進み、 | |
157 表に書かれている各グループの「一斉送信」を利用すると、 | |
158 そのグループに所属している全員にメイル送信できる。そのアドレスに | |
159 返信すれば普通のMLと同様にやりとりできる。</p> | |
160 <p>ML機能をしっかりと動かしたい場合は、メイルドメインを設定し、 | |
161 そのドメイン宛てのメイルがafter5プログラムに届くようにする必要がある。 | |
162 その設定例を示そう。以下の例では、</p> | |
163 | |
164 <table class="border"> | |
165 <tr><td>after5ディレクトリの所有ユーザ名</td><td>aft5</td></tr> | |
166 <tr><td>uid:gid</td><td>1050:80</td></tr> | |
167 <tr><td>ディレクトリ</td><td>/var/www/aft5</td></tr> | |
168 </table> | |
169 | |
170 <p>だとする。</p> | |
171 | |
172 <h3>ドメインまるごと供与の場合</h3> | |
173 <p>たとえば @after5.example.com を専用ドメインとし、 | |
174 hogehoge@after5.example.com に届いたメッセージを該当after5の | |
175 hogehoge グループに送信する場合の設定を示す。</p> | |
176 | |
177 <ol> | |
178 <li>DNS登録と virtual domain の設定 | |
179 <p>まず、after5.example.com の MX レコードをDNS登録し、 | |
180 サーバにメイルが届くようにし、そのドメイン宛てのメイルを | |
181 after5のディレクトリに向ける。qmailの場合は、 | |
182 /var/qmail/virtualdomains に</p> | |
183 <div class="list"> | |
184 <pre> | |
185 after5.example.com:a5 | |
186 </pre> | |
187 </div> | |
188 <p>と書き、pkill -HUP qmail-send し、/var/qmail/users/assign に</p> | |
189 <div class="list"> | |
190 <pre> | |
191 +a5-:aft5:1050:80:/var/www/aft5:-:list-: | |
192 </pre> | |
193 </div> | |
194 <p>を(最後の行より前に)追加し、qmail-newu する。これで、 | |
195 hogehoge@after5.example.com 宛てのメイルが | |
196 /var/www/aft5/.qmail-list-hogehoge 宛てに届く。</p> | |
197 </li> | |
198 <li>dot-qmailファイルの作成 | |
199 <p>.qmail-list-hogehoge は以下のように記述する。</p> | |
200 <div class="list"> | |
201 <pre> | |
202 | ./after5.rb -list | |
203 </pre> | |
204 </div> | |
205 </li> | |
206 </ol> | |
207 | |
208 <h2>specialさんくす</h2> | |
19 | 209 <ul> |
97 | 210 <li>的確なアドバイスをくれた<a href="/~loony/">loony</a></li> |
19 | 211 </ul> |
212 | |
21 | 213 <h2>既定値変更</h2> |
214 <p><code>./after5.cf</code> ファイルに <var>オプション</var>=<var>値</var> | |
215 の形式で1行ずつ値を設定する。設定できる値は以下のとおり。</p> | |
20
2215d7b9750b
Add a section about significant parameters for after5.cf.
HIROSE Yuuji <yuuji@gentei.org>
parents:
19
diff
changeset
|
216 <table> |
21 | 217 <tr><th>オプション</th><th>意味</th><th>既定値</th></tr> |
218 <tr><th><code>bg</code></th><td>背景色</td><td>ivory</td></tr> | |
219 <tr><th><code>forgot</code></th><td>ユーザパスワード失念時用のおまじない</td><td>wasureta</td></tr> | |
220 <tr><th><code>morning</code></th><td>当日の予定メイルを送る時刻</td><td>6</td></tr> | |
221 <tr><th><code>night</code></th><td>翌日の予定メイルを送る時刻</td><td>22</td></tr> | |
20
2215d7b9750b
Add a section about significant parameters for after5.cf.
HIROSE Yuuji <yuuji@gentei.org>
parents:
19
diff
changeset
|
222 </table> |
21 | 223 <p>たとえば、パスワードを忘れてしまったときのおまじないパスワードを |
224 hogehogeにしたいときは <code>after5.cf</code> ファイルに以下のように | |
225 追記する。</p> | |
20
2215d7b9750b
Add a section about significant parameters for after5.cf.
HIROSE Yuuji <yuuji@gentei.org>
parents:
19
diff
changeset
|
226 <div class="list"> |
2215d7b9750b
Add a section about significant parameters for after5.cf.
HIROSE Yuuji <yuuji@gentei.org>
parents:
19
diff
changeset
|
227 <pre> |
2215d7b9750b
Add a section about significant parameters for after5.cf.
HIROSE Yuuji <yuuji@gentei.org>
parents:
19
diff
changeset
|
228 forgot=hogehoge |
2215d7b9750b
Add a section about significant parameters for after5.cf.
HIROSE Yuuji <yuuji@gentei.org>
parents:
19
diff
changeset
|
229 </pre> |
2215d7b9750b
Add a section about significant parameters for after5.cf.
HIROSE Yuuji <yuuji@gentei.org>
parents:
19
diff
changeset
|
230 </div> |
2215d7b9750b
Add a section about significant parameters for after5.cf.
HIROSE Yuuji <yuuji@gentei.org>
parents:
19
diff
changeset
|
231 |
21 | 232 <h2>ちうい</h2> |
19 | 233 |
21 | 234 <p>HTTPで情報をやりとりするのでセキュリティは低い。というか、 |
235 Webってもともと情報を公開するためのもんだからな。 | |
236 といっても、よほど頑張らないと覗き見することは難しい。 | |
237 といってもばれたら立場があやうくなるような機密情報は手許の手帳にだけ | |
238 書くよろし。</p> | |
19 | 239 |
21 | 240 <p>てことで、どこに出張にいくから飲もうぜ、とか、ひそかにみんなを驚かそ |
241 うと企んでる、なんてなことをみんなで共有して楽しんでくれ!</p> | |
19 | 242 |
243 <hr> | |
244 <!--#include virtual="/~yuuji/signature.html"--> | |
245 </body> | |
246 </html> |