github にアップロードした README.pod が文字化けした問題 (POD の encoding コマンド)
github では、pod やら rdoc やらいくつかのマークアップ形式を理解して、自動的に README ファイルを HTML に変換してくれます。 で、Perl のプロジェクトを作っていたので POD で README ファイルを書いていたのですが、何も考えずにアップロードすると下のように文字化けしてしまいました。
全然知らなかったんですが、pod には encoding コマンドがあって、それで POD ファイルの文字エンコーディングを指定できるのですね。
この encoding コマンドを使って POD ファイルの文字エンコーディングを指定することで、github にアップロードした際にも文字化けせずに表示されるようになりました。
US-ASCII または Latain-1 以外のエンコーディングで POD を書く場合は encoding コマンドでエンコーディングを指定するようにするのが良さそうです。