Vivliostyle Documentation Site

このリポジトリは Vivliostyle の公式ドキュメントサイト（次世代版）のソースです。

概要

• Astro + VFM (Vivliostyle Flavored Markdown) による静的サイト生成
• SSMO (Single Source Multi Output) 対応CSS
• 多言語対応（日本語・英語）
• GitHub Actionsによる自動デプロイ（GitHub Pages）

主な技術

• Astro v5
• @vivliostyle/vfm（Markdown→HTML変換）
• gray-matter（frontmatter抽出）

ディレクトリ構成

/
├── public/           # 静的ファイル（CSS等）
├── src/              # Astroコンポーネント・ページ
│   ├── loaders/      # VFMローダー
│   ├── layouts/      # レイアウト
│   └── pages/        # ページ
├── content/          # ドキュメント本文（Markdown）
├── .github/workflows # CI/CDワークフロー
└── package.json

開発・ビルド・デプロイ

コマンド	説明
npm install	依存パッケージのインストール
npm run dev	開発サーバー起動（http://localhost:4321）
npm run build	静的サイトを ./dist/ にビルド
npm run preview	ビルド成果物のローカルプレビュー

GitHub Actions により astro-Install/main ブランチへの push で自動デプロイされます。

公開URL: https://vivliostyle.github.io/docs2.vivliostyle.org/

コントリビュート・参考

• Vivliostyle公式サイト
• Astro公式ドキュメント
• VFM (Vivliostyle Flavored Markdown)