「おうちに帰るまでが遠足です」と言わんばかりのタイトルですが、
技術系メーリングリストに投稿するときのポイントについて。
- 表題 あいさつではなく用件を書きましょう(はじめましては×)
- 自己紹介 自分の知識・技能・経験を簡潔に書きましょう (Javaを仕事で使って3年です、CGIは入門書でサンプルを書いているレベルです、など)
- 書き出し 最初に問題の要旨を書きましょう
- 会社の名前を背負っていることを忘れないように(特に会社のメアドを使って投稿しているとき)
- 実行手順 手順は箇条書きで書く
- 期待した結果を書き、実際に起きたことを書く
- ステップ明記どこからうまく行かなくなったか具体的を書く
- 実際の値は条件を具体的に書く
- エラーメッセージは必ずコピー&ペーストする
- 文献を引用し、読者の手間を省くように書く
- 自分の環境を書く
- ソースで、関連する部分を抽出して示す(これもコピペ)
- 投稿前に推敲すべし
- 投稿前にggrks
具体的にはこんな感じ
To: Perlの技術ML From: とむら <tomura@textfile.org> Subject: CGIの文字化け 先月からPerlでCGIを書きはじめた、とむら(仮名)と申します。 Cのプログラミング経験は3年ほどありますが、PerlやCGIははじめてです。 市販されているXXXXスクリプトを修正して実行すると、 文字化けを起こすという問題で困っています。 原因または解決策をご存知の方はいらっしゃいませんか。 私の行った手順は以下です。 (1) XXXX.cgiをhttp://xxxx からダウンロードする。 (2) 管理ファイル名$adminの値をadmin.datからadmin.txtに変更する。 (3) 見出しを「一覧」から「ソフトウェアの表示」に変更する。 (4) XXXX.cgiをサーバにFTPで転送する。 (5) XXXX.cgiのパーミッションを 755(rwxr-xr-x)にする。 (6) ブラウザからXXXXにアクセスする。 すると、 「ソフトウェアの表示」 と表示されるべき部分が、 「ャtトウェアの侮ヲ」 と表示されてしまいます (最後の「ヲ」は半角文字です。 そのままメールすると読めなくなると思い、ここだけ全角で書きなおしました。 あとは表示されたものをそのままコピー&ペーストしています)。 手順の(3)を行わないと、正しく「一覧」と表示されます。 関連すると思われるスクリプトは以下のようになっています。 (これより前に100行ほどあるのですが、多すぎるのでカットしました) print "<head><title>$title</title>"; print "<body>"; print "<h1>ソフトウェアの表示</h1>"; print "</body>"; print "</html>"; ローカルマシンのコマンドラインから、 -cwで文法チェックしても異常は見つかりません(以下のようになります)。 perl -cw XXXX.cgi XXXX.cgi syntax OK なお、私の環境は以下の通りです。 (ローカルマシン) ・Windows NT 4.0 ・Internet Explorer 5.0 (サーバ) ・自作CGIが使えるXXXXプロバイダのサーバ ・サーバはApacheですが、バージョンは不明です。 検索エンジンで「文字化け CGI」を検索しましたが、 解決に役立つ情報は見つかりませんでした。 過去ログも読みましたが、探し方がまずいのか、 関連する情報を見つけることはできませんでした。 ---- とむら(仮名) tomura@textfile.org
そういう感じですね。
このサイトの通り皆がやってくれたら、
絶対サポセン黙示録なんてサイトもなくなるのに。