ドキュメントサイトについて
ドキュメントサイトは、Cleveraの記事を検索、AIアシスタント、読者からのフィードバック、多言語対応を備えたホスト型ヘルプセンターに変換します。読者が利用できる機能、権限ごとの操作範囲、クレジット消費の対象について説明します。
更新日: 読了時間 2 分
ドキュメントサイトとは、Cleveraワークスペース内の記事から作成されるホスト型ヘルプセンターです。記事の作成や編集は既存の場所で行い、それをページとしてサイトに追加して公開します。読者は、検索機能、ページを引用するAIアシスタント、役立たなかった箇所を報告する機能を備えた高速な公開サイトを利用できます。ドキュメントサイトは、Freeプランを含むすべてのプランに含まれています。
ドキュメントサイトの仕組み
- 記事がページになります。 ドキュメントサイトのページには、ライブラリ内の記事が表示されます。記事を編集すると、次回の公開時にページに反映されます。記事はコンテンツ内に保持され、サイトからページを削除しても記事自体が削除されることはありません。
- バージョンを公開します。 変更内容は、新しいバージョンとして公開されるまで蓄積されます。すべてのバージョンは公開中に保存されるため、変更内容の確認やロールバックが可能です。
- 独自のURLが割り当てられます。 すべてのサイトに無料のURL（
your-site.clevera.help）が提供されます。Starterプラン以上では、help.example.comのような独自のドメインで運用することも可能です。 - 読者はワークスペースを見ることができません。 読者にはサイトのみが表示されます。ワークスペースのメンバーは、サイドバーのドキュメントサイトからサイトを管理します。
各サイトには、サイドバーでグループ化された以下の画面があります。
| グループ | 画面 | 操作内容 |
|---|---|---|
| 概要 | 概要 | セットアップチェックリスト、トラフィック、次のステップ |
| コンテンツ | ページ、変更履歴、リダイレクト | セクション、ページとその順序、リリースノート、古いURL |
| 分析 | 分析、検索、アシスタント、フィードバック | 閲覧数、読者の検索・質問内容、ページの評価 |
| サイト | 外観、ナビゲーション、ドメイン、設定、公開中 | デザイン、メニュー、独自ドメイン、アクセス権とアシスタント、バージョン管理 |
読者が利用できる機能
| 機能 | 読者への表示 |
|---|---|
| ホームページ | タイトル、検索ボックス、トピックカードとしてのセクション、おすすめページ |
| 検索 | ヘッダーの検索…、またはどのページからでも**⌘ K** / Ctrl K で利用可能。入力に合わせて結果が更新され、最近の検索履歴も保持されます。 |
| AIアシスタント | AIに質問する機能。公開されたページに基づいて回答し、使用したソースをリストアップします。設定 → AIアシスタントで有効にできます。 |
| ページフィードバック | 各ページの最後にある「このページは役に立ちましたか？」という質問。理由の選択やコメントの追加が可能です。 |
| 言語 | サイトが複数言語に対応している場合、ヘッダーに言語切り替えが表示されます。翻訳がないページはデフォルト言語で表示され、短い通知が表示されます。 |
| ライト/ダークモード | ヘッダーのテーマ切り替え。デフォルト設定は管理者が行います。 |
| ページ操作 | ページのMarkdownコピー、プレーンテキスト表示、AIチャットアプリでの質問用リンクの取得 |
| 機械可読コピー | AIツール用の公開ページのllms.txtおよびMarkdownコピー、検索エンジン用のサイトマップ |
| 変更履歴 | カテゴリ（新規、改善、修正、セキュリティ、非推奨）別のリリースノートページとRSSフィード |
| お問い合わせフォーム | サポートに問い合わせる機能。確認済みのメールアドレス宛にメッセージを送信します（Starterプラン以上）。 |
Freeプランのサイトには「Powered by」の小さなバッジが表示されます。Starterプラン以上では非表示にできます。
権限ごとの操作範囲
ドキュメントサイトでは、ワークスペースのロールが適用されます。ワークスペース内の全員がすべてのドキュメントサイトを開くことができます。
| タスク | オーナー | 管理者 | エディター | コンテンツ作成者 |
|---|---|---|---|---|
| サイト、ページ、分析の閲覧 | はい | はい | はい | はい |
| ページ、セクション、変更履歴の編集 | はい | はい | はい | はい |
| 新規記事、サイトページ、変更履歴の追加 | はい | はい | いいえ | はい |
| 公開、ロールバック、デザイン・ナビゲーション・ドメイン・設定の変更 | はい | はい | はい | いいえ |
| ドキュメントサイトの作成 | はい | はい | いいえ | いいえ |
| ドキュメントサイトの削除 | はい | はい | いいえ | いいえ |
| コンテンツのインポートとエクスポート | はい | 閲覧のみ | いいえ | いいえ |
エディターは既存コンテンツの改善と公開を行いますが、新規コンテンツの作成はできません。コンテンツ作成者は記事の作成と編集を行い、オーナー、管理者、またはエディターが公開します。権限がない操作にはツールチップが表示され、「ワークスペースのオーナーと管理者のみがドキュメントサイトを作成できます」といった理由が示されます。
クレジット消費の対象
ドキュメントサイトのホスティングは無料です。サイト上で行われる操作のほとんどはクレジットを消費しません。
| 操作 | クレジット |
|---|---|
| ホスティング、ページビュー、訪問者数、帯域幅 | なし |
| 読者による検索 | なし |
| AIアシスタントによる回答 | なし。各プランに月間の回答数が含まれています。 |
| ページタイトル、セクション名、メニューラベルの翻訳 | なし |
| 公開、ロールバック、リダイレクト、分析 | なし |
| 他プラットフォームからのインポート、サイトのエクスポート | なし |
| AIによるサイトページの生成または翻訳 | 記事AIクレジット。開始前にダイアログで「最大Nクレジット」と表示されます。 |
| 変更履歴の翻訳 | 記事AIクレジット |
| AIによる記事作成（Composeまたは記事エディター内） | 通常の記事クレジット |
クレジットの仕組みについてはクレジットについてを、各プランの詳細はドキュメントサイトのプランと制限をご覧ください。