Experience Manager GuidesとEdge Delivery Services

Experience Manager Guides ボイラープレートテンプレートリポジトリ aem-guides-boilerplateを開きます。

このテンプレートを使用して新しいリポジトリを作成します。 テンプレート 🔗からリポジトリを作成するについて説明します。 リポジトリの表示が​ パブリック ​に設定されていることを確認し、EDSがアクセスできるようにします。

GitHubで、左側のサイドバーに移動し、開発者設定​を選択します。

左側のサイドバーで、OAuth Apps​を選択します。

新規OAuth アプリ​を選択します。

{width="650"}

次の必須の詳細を指定して、アプリケーションを登録します。

• アプリケーション名: EDS リポジトリの名前を入力します
• ホームページ URL: Experience Manager Guides インスタンスのURLを入力します。 （URL形式のサンプルについては、新しいGitHub アプリの作成 セクションの手順4を参照してください）。
• 認証コールバック URL: ホームページ URLと同じ

「デバイスフローを有効にする」オプションを選択し、「アプリケーションを登録」を選択して登録を完了します。

{width="650"}

GitHub リポジトリで、fstab.yaml ファイルを開きます。

次の形式を使用してurl値を更新します。

https://guides.adobe.com/eds-workers/<account type>/<git acc domain>/<git username>/<git repo>/<branch>/<root folder>

次の表に、URLの各フィールドを示します。

例えば、GitHub ユーザー名がmy-username、リポジトリ名がmy-eds-repoの場合、fstab.yaml ファイルは次のように表示されます。

mountpoints:
  /:
    url: https://guides.adobe.com/eds-workers/github/github.com/my-username/my-eds-repo/main/docs
    type: markup

{width="650"}

リポジトリを認証するには、「AEM Code Sync経由でGitHubをAdobeに接続」セクションの手順2と3を繰り返します。

AEM Code Sync ページに移動し、インストール​を選択します。

AEM Code Sync​は、リポジトリの変更を監視し、更新がGitHubに正しくプッシュされるようにします。

次のページで、作成したリポジトリへのアクセス権を付与します。 「リポジトリのみを選択」を選択し、ドロップダウンからリポジトリを選択します。

{width="350"}

「インストールして承認」を選択します。

GitHub設定ページにリダイレクトされます。

ソースコードの詳細を確認し、次へ​を選択してください。

コンテンツソース ページで、次の設定を行います。

• コンテンツ ソースの種類： その他（独自のマークアップを取り込む）​を選択します。
• コンテンツソース URL: fstab.yaml ファイルでマウントポイント URLとして設定されたURLを確認します。 ファイル内のURLを更新していない場合は、ここで更新できます。
• ファイル拡張子： デフォルトの.html接尾辞を.htmに変更します。

別のコンテンツソースを使用​が選択されていることを確認します。

ユーザー ページで、必要に応じてユーザーを追加し、次​を選択します。

設定の概要を確認し、保存​を選択します。

登録が成功すると、確認ページが表示されます。 このページから、web サイトの​ プレビュー ​および​ ライブ ​のURLをコピーして保存できます。

Workspace settings > プロファイルの公開​に移動します。

+ アイコンを選択して、新しい公開プロファイルを作成し、次の詳細を指定します。

• Server type*: ドロップダウンから「Git （Edge Delivery Service）」を選択します。

• 名前*:​公開プロファイルの名前を入力します。

• Git アカウントの種類*: Git リポジトリ プロバイダーに応じて、ドロップダウンから​ GitHub ​または​ GitLab ​を選択します。

• インスタンス URL*: GitHubまたはGitLab インスタンスのURL （例：https://github.comまたはhttps://gitlab.com）を入力します。

• リポジトリ名*: GitHubまたはGitLab リポジトリの名前を入力します。

• ユーザー名*: GitHubまたはGitLabのユーザー名を入力します。

• 分岐名：​をmainに設定しました（デフォルト）。

• ルートフォルダー*:​をdocsに設定（デフォルト）。

• サイト所有者（GitLabのみ）: Edge Delivery Services サイトの所有者を入力します。

• サイトリポジトリ （GitLabのみ）: Edge Delivery Services サイトに関連付けられているリポジトリ名を入力します。

• HLX API キー： EDS設定のHLX API キーを入力します。 このキーは、Experience Manager Guides as a Cloud Serviceの2026.11.0 リリースで導入された非公開機能をサポートするために必要です。 また、コンテンツサイズが100個を超える場合は、コンテンツをEDSに公開するためにキーが必要です。

• 認証資格情報：​選択したGit アカウントの種類に基づいて資格情報を指定します：

  • GitHub: GitHub OAuth アプリから取得した​ クライアント ID* と​ クライアントシークレット* を入力します。 詳しくは、新しいOAuth アプリの作成を参照してください。
  • GitLab: GitLab アカウント用に生成された​ アクセストークン* を入力します。

（GitHubのみ）認証する​ ログイン ​を選択します。 GitLabの場合、アクセストークンは認証に使用されるため、ログインは必要ありません。

{width="650"}

「保存」を選択します。 GitHubの場合、認証が成功すると、保存 オプションが使用できます。

マップコンソールでマップを開きます。

出力プリセット タブで、+​を選択して、新しい出力プリセットを作成します。

新しい出力プリセット ダイアログで、次の詳細を入力します。

• 種類: Edge Delivery サービス​を選択
• 名前：このプリセットの名前を指定します

「追加」を選択します。

{width="650"}

新しく作成したEDS出力プリセットを開き、次のフィールドを設定します。

• 条件付きフィルタリング： なし​を選択してフィルタリングせずに出力を生成するか、DITAVAL​を使用して条件付きフィルタリングを適用します。

• サブフォルダーを公開：​出力が公開されるサブフォルダーの名前を入力します。 サブフォルダーはルートフォルダーの下のリポジトリーに作成され、その名前は公開されたコンテンツへのEDS リンクに表示されます。 例えば、ルートフォルダーがdocs、公開サブフォルダーがproduct-guideの場合、コンテンツはdocs/contents/product-guideに公開されます。

• 公開プロファイル：​前のセクションで設定したGitHubまたはGitLab公開プロファイルを選択します。

  {width="650"}

「保存」を選択し、「出力を生成」を選択します。

GitHub リポジトリに移動し、blocks フォルダーを開きます。

パンくずリスト ブロックを選択します。

{width="650"}

css ファイルを開き、テキストの色を更新します。

変更をGitHubにコミットします。

ライブ web サイトを更新して、更新を表示します。

トピックファイルを開き、タグ要素内のテキストを選択します。

次のスクリーンショットでは、example タグ内のコンテンツが選択されています。
{width="650"}

example タグ内のテキストを設定するには：

• コンテンツのプロパティ​に移動します。
• outputclass属性を追加します。
• 値をexample eds-force-blockに設定します。
• 「追加」を選択します。
  {width="650"}

出力を保存して再生成します。

blocks ディレクトリ内にoutputclassと同じ名前の新しいフォルダーを作成します。 ​ リポジトリへのファイルの追加について説明します。

{width="650"}

必要なcssとオプションのjs ファイルを追加します。

{width="650"}

変更をコミットして出力を再生成します。