chmのビルドにPowershellを使う

[dep5]

PR対象

• ドキュメント(md、ヘルプファイル等)

カテゴリ

• 不具合修正

PR の背景

chmのビルドの大半をPowershellで処理します。
Powershellにすることにより、

• ヘルプの編集だけしたい人はHTML Help Workshopを持っていればVisual Studio無しでもコンパイルできるようになります。
• batよりは複雑なコードを書けるようになります。

ヘルプファイルで意図しないフォントが使用されるので対処します。
-> #1896 で解消しました。
#1894 はローカルでしか動かなかったので、CIでもコンパイル可能にしました。

仕様・動作説明

• シフトJISに無い文字を数値文字参照に変換することも可能です
• HTMLヘルプの文字コードを変換する簡易ツールを導入する #996 で作られたEncoderEscapingFallbackクラスから借用しています
• add-typeの制限のためラムダ式、後半のusing句を削除しています
• 変換ツールのビルドに必要だったTargeting Packが必要なくなります
• build-chm.batの処理を/help/build-chm.ps1に移動しています
• ヘルプのキーワードタブを開いたときにできる*.chwを.gitignoreに追加しています
• help以下にある.gitattributesと.gitignoreをルートにまとめています
• 各*.chmコンパイル中のログだけ表示されて、成功のログが表示されていないので対応しています

PR の影響範囲

テスト内容

ローカルでシフトJISに無い文字をソースに書き込んでコンパイル後に数値文字参照に変換されているのを確認しました

関連 issue, PR

#1894
#1896
#996

参考資料

[AppVeyorBot]

✅ Build sakura 1.0.4271 completed (commit f36451aedb by @dep5)

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
0.0% Duplication

[berryzplus]

長いこと放置されてるのであえてコメントします。

「メリットがよくわかりません。」

おそらく、他の方も似た感想を持っているのではないかと。