Skip to content

About

単一HTMLファイルのJS/CSS/HTMLを圧縮する PowerShell ツール | PowerShell tool to minify single-file HTML

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

Optimize-Html

License: MIT-0

単一のHTMLファイル(HTML / CSS / JavaScript 一体型)を圧縮する PowerShell スクリプトです。 esbuild で <script> と <style> を圧縮し、HTML本体はコメントと余分な空白・改行を削除して、元の名前.min.html として保存します。

特長

  • <script> と <style> をすべて圧縮(複数あっても可)
  • src 付きの <script>、application/ld+json や importmap などJS以外の <script> は触らない
  • <pre> と <textarea> の中身は保護
  • 圧縮に失敗したブロックは元のまま残す(警告を表示)
  • --format を使わないため、onclick="foo()" のようなインライン属性から呼ぶ関数名も壊れない
  • UTF-8(BOMなし)で入出力。日本語も文字化けしない
  • ファイルの @license / @preserve を含むコメント、/*! で始まるコメントは残る(ライセンス表記向け)

必要なもの

  • Windows PowerShell 5.1 または PowerShell 7
  • Node.js(npx が使えること。esbuild は初回実行時に自動で取得されます)

使い方

1. ドラッグ&ドロップ(いちばん簡単)

HTMLファイルを optimize-html.cmd に落とします。同じフォルダに ○○.min.html が作られます。

2. コマンドラインから

.\optimize-html.cmd index.html

複数ファイルもまとめて指定できます。

.\optimize-html.cmd index.html about.html

3. PowerShell から直接

.\Optimize-Html.ps1 index.html

関数として読み込む場合は次のとおりです。

. .\Optimize-Html.ps1
Optimize-Html .\index.html

実行ポリシーのエラーが出る場合

optimize-html.cmd は -ExecutionPolicy Bypass を付けて起動するので、通常は問題ありません。 PowerShell から直接実行してエラーになる場合は、そのセッションだけ許可してください。

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

ダウンロードしたファイルがブロックされている場合は、次を実行します。

Unblock-File .\Optimize-Html.ps1

出力例

圧縮完了: 18,420 → 9,310 バイト (51%)
出力ファイル: C:\work\index.min.html

注意点

  • タグ間の空白は削除されます。 <b>A</b> <i>B</i> のようなインライン要素間のスペースが消え、表示が詰まることがあります。その場合は Optimize-Html.ps1 内の '><' を '> <' に変更してください。
  • JavaScript の構文エラーがあると、そのブロックは圧縮されません。 警告が表示され、元のまま出力されます。
  • 変数名の短縮(mangle)は行いません。 安全性を優先しており、極限までの縮小を目的としたツールではありません。
  • 圧縮後は、必ずブラウザで動作確認をしてください。
  • 外部の .js / .css(<script src>、<link>)は処理対象外です。

ライセンス

このプロジェクトはMIT-0ライセンスのもとで公開されています。詳細はLICENSEファイルをご覧ください。

  • 商用利用・個人利用を問わず、完全自由に使用できます。
  • 著作権表示やライセンス文言の保持・記載義務すらありません。
  • ソースコードの改変、流用、再配布、自社製品への組み込み等、制限なくご活用いただけます。

※ esbuild は本リポジトリに同梱せず、実行時に npx で取得して利用します。

About

単一HTMLファイルのJS/CSS/HTMLを圧縮する PowerShell ツール | PowerShell tool to minify single-file HTML

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages