Vistual Studio 2005＋vb.netのXMLドキュメントを自動的にMSDNのヘルプ形式に変換してくれるツールの紹介。
3年ぐらい前に調べたときは見つけられなかった。
@IT - 特集：ツールを使ったドキュメント作成技法（前編）
とここのブログを参考に。
必要なツールは
Sandcastle ・・・ コマンドベース（現在：2.4.10520）
Sandcastle Help File Builder ・・・ SandcastleをGUIで操作（現在：1.7.0.0）
両方msi形式をダウンロードしてインストール。Microsoftで作成されたフリーのツールらしい。インストール自体はmsiを実行するだけで終了。
Sandcastle Help File Builderを起動して、addボタンからコンパイル時に生成されるXMLドキュメントのxmlファイルを指定。これを生成するためにはVisual StudioのMy Project→コンパイル→「XMLドキュメントファイルを生成する」にチェックする。デフォルトで入っているはず。
ヘルプファイルの生成は
Documentation → Build Project
Project Propert
└Help File
└Language
は日本語を選択しとく。
Error: Unresolved assembly reference
と怒られる場合は、依存関係のファイルを指定しないと駄目らしいので
Project Propert
└Build
└Dependencies
に依存しているdllファイルなどを指定。デフォルトではprivateのメソッドを出力してくれないので、
Project Properties
└Visibility
├DocumentAttributes
└DocumentPrivates
などはTrueの方がいいかも。他はお好みで設定。参考。
ビルド自体はちょっと時間がかかるけど、名前空間や命名規則をしっかり管理していると、とても見やすいドキュメントになる。
ステキすぎる。
＜2009/05/08 追記＞
Sandcastle Help File Builderのバージョンが1.8.0.1 Betaに上がっていたのでインストールし直してみた。
新規にプロジェクトを作成した後にProject Explorerの「Documentation Sources」にVisual Studioのvbprojファイルを追加しただけでヘルプファイルを自動生成してくれた。
依存関係とかうまいこと解決してくれるみたい。
WebminはWebベースのサーバ管理ツール。wikipedia。
Apache, Smaba, sendmailなど多くのアプリケーションの設定をGUIでできる。ユーザの追加なども簡単にできるため、Linuxのコマンドを知らない人でもサーバ管理がやりやすくなる。
インストールはここからrpmパッケージをダウンロード、インストール。
# rpm -Uvh webmin-1.441-1.noarch.rpm
インストール後はhttp://<サーバのアドレス>:10000/でアクセス。10000番ポートを空けるのを忘れずに。参考。
次はUsermin。
Webminはサーバ管理者用の設定ツールに対して、Userminは各ユーザに提供される設定ツール。主にWebベースでメールを読んだり、ファイルにアクセスしたりもできる（もちろん権限によりアクセルできるディレクトリは制限される）。
ファイル管理はJavaで動いている。
インストールはここからrpmパッケージをダウンロード、インストール。
# rpm -Uvh usermin-1.370-1.noarch.rpm
インストール後はhttp://<サーバのアドレス>:20000/でアクセス。20000番ポートを空けるのを忘れずに。
Java SE Development Kit (JDK)をここからダウンロード。J2SEとかJ2EEとかよく分からない場合はここをよんどく。
＜Linux（CentOS5.2）編＞
# ./jdk-6u10-linux-i586-rpm.bin
/usr/java/にインストールされる。
JAVA_HOMEを設定。
# vi ~/.bash_profile
PATH=$PATH:$HOME/bin:/usr/java/latest/bin
export PATH
export JAVA_HOME=/usr/java/latest
# source ~/.bash_profile
あとで見つけたけど、
# yum install jdk
でもできるっぽい。
＜Windows編＞
jdk-6u10-windows-i586-p.exeを実行後、マイコンピュータ→プロパティ→詳細設定→環境変数の「システム環境変数」に新規でJAVA_HOMEを追加。（バージョンよってjdk1.6.0_10の部分は変わる）
次に「Path」を選択して編集。変数値の一番最後に
;C:\Program Files\Java\jdk1.6.0_10\bin
を追記してＯＫ。
一旦ログアウトしてログインすると反映される。
確かめる方法は
ファイル名を指定して実行→cmd
でコマンドプロンプトを起動して
C:>set
を入力すれば設定した値が出力される。
そろそろXoopsからJoomlaへ移行したいと思い立ち。とりあえずJoomlaをインストールしたときのメモ。
Joomlaはここからダウンロード。
初めてインストールする場合は日本語パックが付いている方が管理画面の操作がわかりやすい。
XREAサーバにアップロードするときは解凍したのをアップロードすると恐ろしく時間が掛かるので、サーバで解凍した方が全然早い。
やり方はXREAのサーバ管理画面で「ホスト情報登録」しといて、SSHでアクセス。ユーザ名、パスワードはFTPと同じ。SSHでアクセスするツールはTeraTermが便利。参考。
サーバで解凍するコマンドは
$ tar –xzvf Joomla_1.5.7-Stable-Full_Package.tar.gz
カレントディレクトリにすべて解凍されるので、あらかじめディレクトリを作って作業すること。
zipの場合は
$ unzip Joomla_1_5_6_ja-JP_Stable.zip
データベースはあらかじめUNICODEで作成しておく。
あとはhttp://＜サーバ名＞/にアクセスすれば自動でインストールが始まる。
設定の確認では次のような.htaccessを置いておけばほとんど「はい」になる。
php_flag register_globals off
php_flag output_buffering offphp_flag mbstring.encoding_translation On
php_value mbstring.language neutral
php_value mbstring.http_input auto
configuration.phpはいいえのままだけど、これはこのままでＯＫ。
最初configuration.php-distをコピーしておいたら次のFTPの設定で
Error: the XML response that was returned from the server is invalid.
と怒られたので、用意しておいたら駄目みたい。
FTPの設定はXREAのFTPアカウントそのままでＯＫ．「FTP初期フォルダ検索」で自動で初期フォルダを取得可能。
最後に管理者の情報を入力してインストール完了。
ディレクトリのパーティションを変更する場合は
ヘルプ → システム情報 → ディレクトリパーティション
をみると変更すべきディレクトリ一覧が見れる。
ここなども参考に。
日本語の解説サイトがXoopsよりも少ないのがちょっと不安。XoopsのユーザをJoomlaに移行する手段はないものか・・・。
２年ぐらい前に買ったエルゴヒューマンの椅子を紹介。
座りながら寝れるような椅子を探していてたどり着いた。
８万円するぐらいあって、座り心地は最高。メッシュで構成されているので、全く蒸れない。高さが調整できるのはもちろん、座る所を前後に調整できたりする。
詳しくはここを参照。
椅子は個人によって好みが分かれるので、買うなら試しに座ってから買った方がよい。これは名古屋の東急ハンズに置いてあるので、気になる人は座りに行ってみては？
会社の椅子もこれにしたい・・・。
Googleカレンダーのアラートを携帯に送れるようなので設定してみた。
Googleカレンダーの設定で「モバイルの設定」から自分の携帯のアドレスを入れて、確認コードを送信。携帯に確認コードが届くので、それを入力して作業完了。
↓こんな画面。
メールの転送機能でも同じことが実現できますが、とりあえず設定しとくと後で役に立ちそう。ここでも書いたけど、携帯でGoogleカレンダーにアクセスするには
http://www.google.com/calendar/m
あとは携帯でGoogleカレンダーの予定を新規作成できるようになってほしい。
Webの場合、ログインしたユーザの情報はsessionに格納してアプリケーション内で使い回しますが、クライアントアプリケーションの場合どうやってやるのか調べたメモ。
環境は.Net Framework 2.0, Visual Studio 2005, VB.NET
ここに全ての答えが。
app.configというアプリケーション構成ファイルに設定を記述することができるみたいです。My Projectを開くと設定という項目があるので、ここに設定する値を記述すると自動でapp.configが作成されます。
参照するときは
sUrl = My.Settings.AURORA_URL
か
sUrl = My.Settings(“AURORA_URL”)
設定するときは
My.Settings.AURORA_URL = “http://aurora.exbridge.jp/”
か
My.Settings(“AURORA_URL”) = “http://aurora.exbridge.jp/”
ローカルのファイルに保存されるため、起動時に毎回ログインし直す場合などはアプリケーション終了時にクリアする処理が必要。
VB.NETでクライアントアプリケーション作ってますが、Visual Studio 2005でPostgreSQLに接続するためのメモ。
ODBCを使ってもよいですが、クライアントに設定しないといけないので.NET用のデータプロバイダ（Data Provider）が提供されていないか検索したら、やっぱりありました。ODBCを経由しないから、こっちの方が速いはず。
PostgreSQL8.3.3からはスタックビルダがついていて、これを利用するとNpgsqlも簡単にインストールできますが、PostgreSQL8.3.4の段階では、まだNpgsql v1.0.0でした。
これだと参照設定しても利用できなかったので、たぶん.Net Framework2.0だとNpgsql2.0以上を使わないと駄目なんじゃないかな？ ここから最新バージョンをダウンロードしてきて、適当なフォルダに保存します。 C:\Program Files\Npgsql\2.0\ とか。
そして、Visual Studio 2005のプロジェクト→参照の追加で参照タブから Npgsql.dll を選択すれば使えるようになります。My Projectの「参照」で編集可能。
Imports Npgsql
Public Sub test()
Dim conn As NpgsqlConnection = New NpgsqlConnection("Server=192.168.0.1;Port=5432;User Id=user;Password=pass;Database=hoge_db;")
conn.Open()
Dim command As NpgsqlCommand = New NpgsqlCommand("select name from user where id = 2", conn)
Dim sResult As String = command.ExecuteScalar()
MessageBox.Show(sResult)
conn.Close()
End Sub
日本語が文字化けするというのをメーリングリストなどで見たことがあるけど、今のところ大丈夫そう。
Apache＋mod_sslでSSL通信をしベリサインやグローバルサイン（ジオトラスト）でサーバ証明書を取得しインストールすることはやったことはありますが、サーバ証明書を発行する認証局を自分で構築してしまえばベリサインにお金払わなくてもいいんじゃねぇと思って調べたメモ。
まず認証局（CA, Certification Authority）となるのはOpenSSLがインストールされていれば、どのサーバでもなることは可能。
ただし、私がやりたいのはＩＥなどでエラーがでない証明書を発行する認証局の構築。これはWebTrustという制度（審査）に合格しないと駄目らしい。
3ヶ月ごとに行う厳正な監査らしい。（もちろん個人では無理）
WebTrustに合格すると世界的に認証局として認められて各ブラウザに「信頼されたルート証明機関」として登録される。
つまりベリサインやグローバルサイン（ジオトラスト）で取得したサーバ証明書をインストールするとエラーとならないのはブラウザが既にその認証局を信頼しているから。
↓ＩＥのインターネットオプションからコンテンツを選ぶと見ることができます。
ちなみにシェアはベリサインが53％、グローバルサインが25％、その他22％（wikipediaより）。
グローバルサインの方が安い・・・。
ただ携帯電話用のサーバ証明書を取得する場合、古い携帯電話のブラウザだとベリサインしか信頼してないのもあるらしく、グローバルサインの証明書だと閲覧できない機種が出てきてしまいます。
ベリサインは高いんですけど・・・。
次回は実際に認証局の構築と証明書の発行とインストールをやってみる予定（いつになるか分からないけど）。
３連休は大学の空手合宿に参加しました。
↓合宿の風景
さすがにきつかったですが、久しぶりにいい汗がかけました。
体の衰えも再認識しました。学生の稽古についていけない・・・
しばらく筋肉痛が続きそうです。
私が愛用しているファイル管理ソフト「まめFile」の紹介。
フリーソフトです。作者のページはここから。
などなど機能は豊富。
私の場合はまだ「まめFile4」を愛用中。「まめFile5」でもいいけど、ウィンドウごとに作業内容を決めているので、こっちの方が使いやすい。
圧縮、解凍するときは別途dllをインストールしないといけないですが、caldixを使って一括でインストールすると楽。
あとはTortoiseSVNと連携できれば言うこと無し
