既存の Dahlia 文書設定を検出
対応する Dahlia の docsLoader と docsSchema から、コンテンツディレクトリとページ属性を検出します。コレクション、ファイルのパス、スキーマを維持し、CMS 用の重複した定義を減らせます。
Prosefly × Dahlia
Dahlia ドキュメント向けの Astro CMS。
Prosefly で Dahlia の Markdown・MDX、ページ属性、docsNav を編集し、変更を確認して Git に公開。既存の Astro ビルドとサイトをそのまま使えます。
既存の Dahlia と Astro の設定を利用し、対応するコレクション、ページ項目、docsNav を読み取ります。CMS 専用のスキーマは不要です。
ドキュメント用テンプレートから始める。
画面の高さ全体を使うナビゲーション、Markdown・MDX ページ、ページ内目次を備えた Astro のドキュメント用スターター。コンテンツとナビゲーション設定をリポジトリに置いたまま、自分の製品向けにカスタマイズできます。
スクリーンショットは公式ドキュメントサイトです。スターターを土台に、ご自身の製品に合うサイトを作れます。
Prosefly エディターを試してみましょう。
サンプルの本文やページプロパティを編集して、変更を確認できます。登録は不要です。
getting-started.mdx
Proseflyエディターを読み込み中…
Markdown、MDX コンポーネント、frontmatter を編集できます。ビジュアルに切り替えると変更が適用されます。
変更を確認する
編集した内容と元のサンプルとの差分を確認できます。
元のサンプル編集後の内容
まだ変更はありません。サンプルを編集すると、ここに差分が表示されます。
自分のファイルを、チームで書く。
ページの属性を本文のそばに
タイトル、説明、並び順など、対応する docsSchema の項目を管理。複雑な属性や独自の MDX はソースで編集できます。
ガイドとナビゲーションを一緒に確認
標準ナビゲーションとの関連付けを確認すると、対応する docsNav 項目を整理し、本文と一緒に設定の差分を確認できます。
リポジトリ内のファイル例を見る
リポジトリ内のコンテンツの例Dahlia
- theme.config.json
- src/content.config.ts
- src/content/docs/overview.mdx
選択中のリポジトリファイル
---
title: Project overview
description: Start here to get to know the project.
order: 1
---
# Your first guide
A place for the things your team learns.本文と一緒に、ナビゲーションも整理。
Dahlia のナビゲーションとの関連付けを確認すると、書き込み可能な既存の docsNav セクションやグループ内でページを整理できます。ガイドの編集から配置の調整まで、同じ流れで進められます。
ナビゲーションの対応範囲を見る
本文とナビゲーションの変更を、まとめて確認。
コミットやプルリクエストを作成する前に、変更した文書と Dahlia のナビゲーション設定をまとめて確認できます。サイトの表示とデプロイは、引き続き Astro のビルドが担当します。
公開ガイドを読む
今の設定を読み取り、確認して編集へ。
- 01
Dahlia のリポジトリを接続
GitHub を認証し、Dahlia のウェブサイトを含むリポジトリを接続します。
- 02
検出された文書とナビゲーションを確認
Dahlia プロジェクトから読み取ったコレクション、フィールド、エディタープロファイル、対応する docsNav の紐付けを確認します。既存の定義を利用できるので、CMS 専用のスキーマは不要です。
- 03
ガイドを編集して Git に公開
下書きを保存し、変更を確認してコミットまたはプルリクエストを作成します。既存のサイトのビルドがその後の処理を引き継ぎます。
接続前に知っておきたいこと
標準ナビゲーションには、実際の Dahlia インテグレーション、それに対応する docsLoader、対応する静的な docsNav が必要です。自動グループはテーマのディレクトリ規則に従います。手動項目を並べ替えてもファイルは移動しません。新しいセクションの作成や、解決できない動的な設定には対応していません。
公開したコンテンツは、自分の Git リポジトリに。
公開するまで、下書きは Prosefly に保存されます。変更を確認してコミットまたはプルリクエストを作成すると、ウェブサイトの既存のビルドがデプロイを引き継ぎます。
コンテンツの所有権についてさらに詳しく
コンテンツスペースの接続、公開の仕組み、ウェブサイトを支えるツールについて。
ほかのフレームワークを見る
サイト用フレームワーク
Astro
Astro Content Collections の Markdown・MDX を編集する Git ベース CMS。
詳しく見る Astro
サイト用フレームワーク
Hugo
Markdown、frontmatter、ページバンドルに対応する Git ベースの Hugo 向け CMS。
詳しく見る Hugo
ドキュメントツール
Starlight
コンポーネントのビジュアル編集、ページ属性、標準サイドバーに対応する Starlight 向け CMS。
詳しく見る Starlight
ドキュメントツール
Fumadocs
MDX の編集、ページ属性、標準の meta.json ナビゲーションに対応する Fumadocs 向け CMS。
詳しく見る Fumadocs
Astro のドキュメントテーマ
Lotus
Lotus ドキュメント向け Astro CMS。ページ属性と docsNav に対応。
詳しく見る Lotus
