LibKa

LibKa デザインプラットフォーム

Markdown で一度文書を書くだけで、ウェブページ、A4 PDF、16:9 のスライド、編集可能な Word ファイルを作成できます。それぞれのアクセシビリティを検証し、検証内容を署名付きで記録します。

LibKa は、デザインシステム（W3C DTCG デザイントークン）であり、文書プラットフォームでもあります。ステップ、コールアウト、表、グラフ、図、タイムライン、比較、リリースノートなど（全 35 種類）の LibKa ブロックを使って、Markdown ファイルを 1 つ作成します。ビルドでは、文書が指定した形式の出力を生成します。Guard は各出力と実際のブラウザーで表示したページを検証し、合格した出力について、検証内容を記したマニフェストに署名します。LibKa Studio なら、Markdown に触れることなく、誰でも同じ文書を視覚的に作成できます。

• ウェブサイト： https://libka.aivigator.ai/
• ブラウザーで LibKa Studio を試す： https://libka-studio.aivigator.ai/
• ドキュメント： docs/。まずははじめにとブロックカタログをご覧ください。

ステータス： バージョン 2.0.1。Windows で開発・テストされています。CI では Linux（Ubuntu）でテストスイート全体を実行し、Windows でヘルスチェックを実行します。macOS ではテストされていません。

LibKa を選ぶ理由

Markdown パブリッシングツールを使えば、すでに 1 つのソースからウェブページ、PDF、スライドを作成できます。LibKa の違いは、すべての出力を検証し、検証内容を正確に示すことです。

• 自動化できるルールを適用し、それ以外は人による確認事項として提示します： ブロックにはアクセシビリティルールが設定されています（画像には代替テキストが必須です）。問題があるとビルドは file:line 形式のメッセージを表示して停止します。Guard はソースではなく、Chrome 上でレンダリングされた結果を測定します。適合レポートには、人が確認する必要のある項目が記載されます。
• PDF は修復・検証されます： Chrome が生成したタグ付き PDF を PDF/UA-1 に準拠するよう修復し、PDF Association のリファレンスバリデーターである veraPDF を使って、機械で検証可能なすべてのルールに対して検証します（意味のある読み上げ順序など、PDF/UA の残りの要件は人による確認が必要です）。
• すべての出力に記録が付与されます： ビルドごとに、検証内容を記した署名付きマニフェストと、WCAG 2.2 / EN 301 549 適合レポートが作成されます。
• テーマではなく、デザインシステムです： 色、書体、間隔には DTCG トークンが使われます。トークンのビルド時にコントラストがチェックされ、ライト、ダーク、ハイコントラストに対応します。
• Markdown を使わない人も視覚的に編集できます。 LibKa Studio では同じ検証をリアルタイムで行い、Markdown を単一のソースとして維持します。

LibKa は、アクセシブルで一貫性のある文書が必要なマニュアル、ガイド、ポリシー、レポート、スライド資料に適しています。ページレイアウトツールではないため、配置ではなくブロックを選んで使います。

LibKa Studio

ドキュメントを自分のデバイスに保存するインストール可能なウェブアプリです。ビジュアルエディター、ソースエディター、または両方を横並びで使用でき、ウェブページ、スマートフォン、A4、スライドのライブプレビューを表示します。入力中も同じ Guard チェックが行われ、安全に修正できる場合はワンクリックで修正し、それ以外の場合は平易な言葉で説明します。バージョン管理、コマンドパレット、英語とチェコ語、ライトモード、ダークモード、高コントラスト表示に対応し、一度開けばオフラインでも使えます。Studio には独自のアクセシビリティ自己監査（docs/acr/studio.md）があり、キーボードのみでの操作、NVDA、強制配色、リフロー、タッチエミュレーションでテストされています。

ローカルで実行するには、npx -y @libka/cli studio を実行し、表示されたアドレスを開いてください。

クイックスタート

必要なもの	用途
Node.js 22.18 以降、Google Chrome	ドキュメントのビルドとチェック（libka doctor でお使いのコンピューターに何があるか確認できます）
Java 21 と veraPDF（管理者権限なしでインストール）	PDF を PDF/UA-1 に照らして検証します（ビルドには任意です。これらがなくても PDF はビルドされますが、マニフェスト、適合性レポート、verify に未検証であることが示されます。check.py では必須です）
Python 3.12 以降	LibKa 自体の開発（check.py）

プロジェクトを開始します：

npm create libka@latest my-docs        # add -- --lang cs for the example in Czech
cd my-docs
npm install
npm run build                          # web page, PDF, slides and Word file in dist/, checked and signed
npm run verify                         # the files (the slides too) are the ones that were checked and signed

スターターには、サンプルドキュメント、npm run check（ソースのみを数秒でチェックし、ブラウザーは不要）、すべてのプッシュとプルリクエストを LibKa Guard アクションでチェックして各問題を該当行に表示する GitHub Actions ワークフロー、次の手順を記載した README が含まれています。ドキュメントの出力形式はフロントマターで指定します。outputs: [web, pdf, deck, docx] を指定しない場合は、ウェブページと PDF が生成されます。各プロジェクトは独自の鍵で署名します。この鍵は最初のビルド時に .libka/ に作成され、.libka/trusted-keys.json で信頼されます（署名鍵）。

このリポジトリをクローンした状態から：

git clone https://github.com/aivigator-ai/open-libka-design-platform.git && cd open-libka-design-platform
npx --yes [email protected] install
node packages/cli/src/libka.ts build examples/manual/guide.md     # the outputs land in examples/manual/dist/

ドキュメントの作成

ドキュメントはフロントマターとブロックを含む Markdown です：

---
title: Setting up the router
lang: en
outputs: [web, pdf, docx]
---

## Connect it

:::steps
1. **Plug in the power** The light turns orange.
2. **Connect the cable** Use the yellow port.
:::

:::callout[Before you start]{variant=important}
Keep the box: the Wi-Fi password is on its label.
:::

• examples/manual/guide.md は構文を説明する短いサンプルです。実際の長編ガイドである examples/open-source-guide/guide.md は、GitHub の 2 つのオープンソースガイド（CC BY 4.0）をマニュアルとスライドにしたものです。
• 各ブロックは packages/blocks で一度だけ定義されています。構文、属性、JSON スキーマ、アクセシビリティルール、アンチパターン、およびウェブページ、PDF、スライド、Word ファイルでの表示方法が定義されています。
• スライドは同じファイルから作成されます： 各 ## と ### がスライドになり、:::notes に発表者ノートを記述します。内容が多すぎるスライドは少し縮小するか、続きのスライドに分割されます。
• チェコ語のドキュメント（lang: cs）では、チェコ語のラベルとチェコ語の組版が使用されます。

すべての出力に含まれるもの

• 実際のブラウザーでのチェック： WCAG 2.2 A および AA のルールに基づく axe-core、すべての表示テキストと実際の背景とのコントラスト（4.5:1、読者がより高いコントラストを求める場合は 7:1）、LibKa の構造ルール、横スクロールなしで表示できる幅 320 ピクセルの画面へのページのリフロー、画面内に収める必要があるスライド、厳格な Content Security Policy。
• PDF/UA-1（ISO 14289-1）に準拠していることを veraPDF で検証した PDF：機械でチェックできるすべてのルールを対象とします。
• 実際の構造を備えた Word ファイル： 見出し、リスト、脚注、ヘッダー行を繰り返す表、代替テキスト付きの画像、文書の言語。Guard が構造とコントラストをチェックします。
• 署名済みマニフェスト： ソース、LibKa のバージョン、すべての出力とすべてのチェック結果のハッシュが含まれます。ファイルがチェック済みのものと同一であること、および実行されたチェックを証明します。証明できないことも記録されています。
• 適合性レポート： WCAG 2.2 A/AA の全 55 項目の達成基準を EN 301 549 の条項とともに記載し、自動チェック済み、不合格、人的確認が必要、または該当なしのいずれかを示します。
• バイト単位で同一のビルド： 同じソースから、同じ Web ページと Word ファイルが生成され、Chrome のバージョンが同じであれば、同じ PDF が生成されます。

LibKa が謳わないこと。 自動チェックで対象となるのは、アクセシビリティの一部です。チェックに合格した出力は「これらのテストでチェック済み」であり、「アクセシブル」や「準拠」ではありません。適合性レポートには、人による確認が必要な項目が記載されています。LibKa の出力に関するドラフトレポートは docs/acr/libka-outputs.md です。

AI による作成

• .claude/skills/libka-author/ にある エージェントスキル：ワークフローと、すべてのブロックの正確な構文（レジストリから生成）。
• MCP サーバー @libka/mcp（packages/mcp 内）：ブロックの一覧表示と説明、ドキュメントのチェックとビルド。
• **Claude Code 向けには、**両方を 1 つのプラグインとして利用できます：/plugin marketplace add aivigator-ai/open-libka-design-platform、続いて /plugin install libka@libka。Claude Desktop、claude.ai、API、その他の MCP クライアントについては docs/ai-tools.md をご覧ください。
• AI が作成したものはすべて、同じチェックを受けます。ドキュメント内で AI 作成と宣言されているコンテンツ（レビュー担当者付きの AI 要約、AI バッジ）は、署名済みマニフェストに記載されます。

リポジトリの構成

パス	内容
tokens/、libka.resolver.json、generate.py	DTCG デザイントークンとそのビルド：CSS、SCSS、Tailwind（docs/tokens.md、デザインシステムのマニュアル）
packages/blocks	ブロックレジストリ、カタログ、スキル参照資料のジェネレーター
packages/model	Markdown から型付きブロックへの変換。問題を行ごとに、コードと安全な修正方法とともに表示します（docs/problem-codes.md）
packages/render	Web ページ、スライド、チャート、スライドのフィッティング、Content Security Policy、タイポグラフィ、ブロックのスタイル
packages/guard	ブラウザーのチェック、Word ファイルのチェック、WCAG / EN 301 549 の対応付け、署名済みマニフェスト
packages/pdf、packages/docx	PDF/UA の修復と veraPDF による検証、Word ファイル
packages/editor	ビジュアル編集：ProseMirror スキーマ、Markdown とのロスレスな往復変換、ブロックコマンド
packages/cli、packages/mcp	libka build | lint | check | verify | studio | doctor、MCP サーバー
packages/create-libka	スターター、npm create libka
npm/、plugins/libka、.claude-plugin/	npm パッケージのビルドとクイックスタートテスト、Claude Code プラグインとそのマーケットプレースファイル
apps/studio	LibKa Studio
examples/、docs/	使用例、ドキュメント、メンテナーガイド

貢献

問題の報告やプルリクエストを歓迎します。まず CONTRIBUTING.md をお読みください。AI コーディングエージェントは AGENTS.md から始めてください。質問やアイデアはディスカッションにお寄せください（何を期待できるかは SUPPORT.md をご覧ください）。新しいブロックや機能は、リリース時に CHANGELOG.md に記載されます。あらかじめ知っておいていただきたいことが 2 つあります。

• このリポジトリは、メンテナーの開発用リポジトリから公開されています。承認されたプルリクエストはそこで適用され、次のリリースに反映されます。リリースコミットでは共同作者としてクレジットされ、変更履歴でも謝辞が記載されます。
• すべてのコミットに署名してください（git commit -s）。Signed-off-by 行は、プロジェクトのライセンスの下で変更を提供できることを示す Developer Certificate of Origin の証明です。プルリクエスト時にチェックされます。別途署名する同意書はありません。

check.py は、プルリクエストで合格する必要があるすべてのチェックを実行します。Python テスト、厳格な TypeScript 型チェック、すべてのテスト（Chrome テストを含む）、トークンのビルド、生成ファイルがすべて最新であることのチェックです。

ライセンス

Apache License 2.0（LICENSE）。サードパーティの素材は NOTICE に記載されています。フォントは SIL Open Font License の下で提供されています。LibKa、LibKa Design Platform、LibKa Studio は公開元の製品名であり、ライセンスによって使用が許諾されるものではありません。公開する変更版には、独自の名前が必要です（NOTICE）。

aivigator.ai が作成