RSS

Windows PowerShell で C# などのソースのヘルプファイルを作るには

02 8月

Sandcastle というツールでC# やVBなどのソースのヘルプファイルを作ることができます。

Sandcastle をインストールすると、PowerShell のスクリプト scbuild.ps1 も含まれていて、それを使うことにより、PowerShell でヘルプファイルを簡単に生成できます。

次のスクリプトはこの scbuild.ps1 を使いやすくするためのラッパーです。

(使用例)

PS C:\> sandcastle.ps1 c:\project1\bin\release\app1.exe c:\project1\bin\release\app1.xml c:\temp\help.chm


# Sandcastle を使ってWindowsヘルプ (*.chm) を作成する。
#  使い方
#    PS C:\> getchm.ps1 アセンブリのパス名 XMLファイルのパス名 出力先のパス名
#      $Args[0]  アセンブリのパス名 c:\project1\bin\release\app1.exe
#      $Args[1]  XMLファイルのパス名 c:\project1\bin\release\app1.xml
#      $Args[2]  出力先のパス名 (例) c:\temp\help.chm
#
If ($Args.Length -lt 3 ) {
  "パラメータが不足しています。"
  "使用法  PS C:\> sandcastle.ps1 アセンブリのパス名 XMLファイルのパス名 出力先のパス名"
  exit
}

# PATH に必要なコマンドのパスを追加する。
# TODO: $addpath1 はユーザの環境に応じて変更する。
$addpath1 = ";C:\Program Files (x86)\Sandcastle\ProductionTools;C:\Program Files (x86)\HTML Help Workshop"
If ($env:PATH.IndexOf($addpath1) -lt 0) {
  $env:PATH += $addpath1
  echo "PATH に $addpath1 を追加しました。"
}

# ヘルプファイルをビルドする。
scbuild.ps1 -BuildChm -sources $Args[0],$Args[1] -Style prototype -Name $Args[2]

" ... 終わり"

//

 
コメントする

投稿者: : 2015/08/02 投稿先 PowerShell

 

タグ: ,

コメントを残す

以下に詳細を記入するか、アイコンをクリックしてログインしてください。

WordPress.com ロゴ

WordPress.com アカウントを使ってコメントしています。 ログアウト / 変更 )

Twitter 画像

Twitter アカウントを使ってコメントしています。 ログアウト / 変更 )

Facebook の写真

Facebook アカウントを使ってコメントしています。 ログアウト / 変更 )

Google+ フォト

Google+ アカウントを使ってコメントしています。 ログアウト / 変更 )

%s と連携中

 
%d人のブロガーが「いいね」をつけました。