by shigemk2

当面は技術的なことしか書かない

メーリングリストはサポートセンターではなく互助会です

技術系メーリングリストで質問するときのパターン・ランゲージ

「おうちに帰るまでが遠足です」と言わんばかりのタイトルですが、
技術系メーリングリストに投稿するときのポイントについて。

  • 表題 あいさつではなく用件を書きましょう(はじめましては×)
  • 自己紹介 自分の知識・技能・経験を簡潔に書きましょう (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

そういう感じですね。
このサイトの通り皆がやってくれたら、
絶対サポセン黙示録なんてサイトもなくなるのに。