Skip to content

Repository files navigation

otspec.dev

OpenType 仕様のための MDN — Microsoft の OpenType Specification を、わかりやすくインタラクティブに解説するリファレンスサイト。

https://otspec.dev

Note

🚧 構築中です。いまは Pull Request を受け付けていません。 コンテンツが揃って整ったら受け付ける予定です。理由は CONTRIBUTING.md をご覧ください。

🚧 Under construction. Pull requests are not being accepted at the moment. They will open once there is enough content and the structure has settled. See CONTRIBUTING.md.

なぜ作るのか

OpenType の公式仕様書は実装者向けに書かれており、フォント開発者や Web 開発者が読むには障壁が高い。MDN が HTML/CSS/JS の仕様書を「開発者が実際に使えるリファレンス」に変換しているように、otspec.dev は OpenType 仕様に対して同じことを行う。

  • バイナリ構造定義 → 概念と動作の説明
  • Hex データ例 → インタラクティブな Playground
  • テーブル間の暗黙の依存 → 明示的な関係図とリンク
  • 実装者向け仕様 → .fea 構文と CSS の実践的なコード例

特徴

  • Feature Tag リファレンス: 各 Feature の動作説明、.fea での実装、CSS での使い方を1ページに集約
  • テーブルリファレンス: 全 OpenType テーブルの解説(動作が先、バイナリ定義は折りたたみ)
  • Playground: Feature テスター、Lookup ビジュアライザ、グリフインスペクタ等のインタラクティブツール
  • 学習パス: Getting Started からテーブル詳細まで段階的にナビゲート

ステータス

設計・計画フェーズ。詳細は ROADMAP.md を参照。

技術スタック

  • Astro + Starlight(ドキュメントフレームワーク)
  • React(Playground コンポーネント、Islands Architecture)
  • fontations(Rust → WASM、フォントパース・グリフ描画)/ harfbuzzjs(テキストシェーピング)
  • GitHub Pages + Cloudflare DNS

ドキュメント

docs/ に設計・戦略ドキュメントがある。詳しくは docs/README.md を参照。

ライセンス

対象ごとに分けている。詳細は LICENSE.md を参照。

  • 文章CC BY 4.0
  • コード例.fea スニペット等) — CC0 1.0。帰属表示なしで自分のフォントにコピーできる
  • ソフトウェア — MIT
  • 同梱フォント — OFL 1.1(第三者の著作物)

About

OpenType Reference Guide for Font Developers

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages