Web Music Documentation は, Web ブラウザでシンセサイザーや DAW などの音楽アプリケーションを制作したいという Web ディベロッパーのための有益なドキュメントとなることを目指して制作しています.
Web はアプリケーションプラットフォームにもなっていますが, この Web サイトはあくまでドキュメントであるということを重視して, Web 標準技術のみで制作することを原則とします.
Web 標準技術は以下の 3 つです.
- HTML 5.x 以上
- CSS 3.x 以上
- JavaScript (ES2015 以上)
したがって, HTML テンプレートや, TypeScript, React などサードパーティ製のライブラリやフレームワークは使いません. その代償として, どうしても DRY の原則に従えないケースが多くありますが, サードパーティ製のプロダクトに依存しない, すなわち, Web 標準技術のみで制作することを原則とすることで, Web フロントエンドの技術的パラダイムに影響されずに, 恒久的にメンテナンス可能なドキュメントを目指します.
また, GitHub Pages (静的ホスティングサービス) で公開することで, 特定のサーバー環境やサーバーサイドプログラムに依存しないことを原則とします.
ただし, 例外的に, 以下の 2 つのケースはサードパーティ製のライブラリを使うことにしています.
- シンタックスハイライト
- 数式
制作開始時点では, シンタックスハイライトは Prism.js, 数式は MathJax を利用しています.
ローカルサーバーのために, server.js を置いていますが, 例えば, Python の http.server でローカルサーバーを起動してもドキュメント制作可能にしています. すなわち, どんな方法でもローカルサーバーを起動できれば, ドキュメント制作可能にしています. webpack-dev-server や Docker などを使っても構いませんが, 原始的な手法でも制作可能にすることを原則とします (また, これによってドキュメント制作方針と同様に, サードパーティ製のパッケージへの依存度を下げます).
そのほか, Web アクセシビリティに準拠するため, HTML と CSS には Linter を使っています.
また, 現時点では不要と考えていますが, コントリビューターが増えた場合を考慮して, フォーマッターを使っています.
ドキュメント制作環境に必要なパッケージは, ドキュメント制作に使うものより多少緩くしていますが, 選定基準として, それがなくてもドキュメントの制作・運用を続けることができることを原則とします (例えば, Linter やフォーマッターはなくても制作は可能).
現段階では, 生成 AI によって作成したドキュメントは公開していません. また, コントリビューターも, 生成 AI によって記述されたドキュメントはコントリビュートしないでください.
理由は以下です
- このドキュメントは, ドキュメントを生成することが目的ではない
- オーナー自身も, コントリビューターも, Web Audio API や音響学, オーディオ信号処理を理解して, ドキュメント化 (言語化) できることをコントリビュートの条件とする
ただし, 制作したドキュメントの内容に関して, 検証のために生成 AI を利用することは問題ありません.
音楽素材/魔王魂 で公開されているフリー楽器音を利用させていただいております.
シューベルト 交響曲 第8番 ロ短調 D759 「未完成」 第1楽章 (余談ですが, X JAPAN の「ART OF LIFE」のモチーフになっている曲です) を CMSL クラシック名曲サウンドライブラリー【ライセンスフリー素材音源 700曲】 からダウンロードして利用させていただいております (クロスオリジン制限回避のため, 同一オリジンで公開する必要があるので).