ローカル環境でのテキストエディターを使用した宛先ドキュメントページの作成

このページの手順では、テキストエディターを使用してローカル環境でドキュメントを作成し、プル要求 (PR) を送信する方法を示します。 ここで示す手順を実行する前に、必ず Adobe Experience Platform Destinations での宛先のドキュメント化.

ヒント

GitHub に接続してローカルオーサリング環境を設定する

  1. ブラウザーで、に移動します。 https://github.com/AdobeDocs/experience-platform.en

  2. 宛先 フォーク リポジトリで、 分岐 以下に示すように。 これにより、自分の GitHub アカウントにExperience Platformリポジトリのコピーが作成されます。

    ForkAdobeドキュメントリポジトリ

  3. ローカルマシンにリポジトリのクローンを作成. 選択 コード/ HTTPS / GitHub Desktop で開く、以下に示すように。 次の条件を満たしていることを確認します。 GitHub Desktop インストール済み 詳しくは、 リポジトリのローカルクローンを作成 (Adobe投稿者ガイド )。

    Adobeドキュメントリポジトリをローカル環境に複製

  4. ローカルファイル構造内で、 experience-platform.en/help/destinations/catalog/[...]で、 [...] は、宛先の目的のカテゴリです。 例えば、パーソナライゼーションの宛先をExperience Platformに追加する場合は、 personalization フォルダー。

宛先のドキュメントページのオーサリング

  1. ドキュメントページは、 セルフサービスの宛先テンプレート. をダウンロードします。 宛先テンプレート. 解凍してファイルを展開します。 yourdestination-template.md を上記の手順 4 で説明したディレクトリに追加します。 ファイル名を変更 YOURDESTINATION.md:YOURDESTINATION は、Adobe Experience Platformでの宛先の名前です。 例えば、会社名が Moviestar の場合、ファイルにはという名前を付けます moviestar.md.
  2. 新しいファイルを 選択したテキストエディター. Adobeでは、 Visual Studio Code Markdown Authoring 拡張機能をAdobeします。 拡張機能をインストールするには、Visual Studio Code を開き、 Extensions 」タブをクリックし、 adobe markdown authoring. 拡張機能を選択し、「 Install.
    Markdown AuthoringAdobe拡張機能のインストール
  3. 宛先に関する情報を使用してテンプレートを編集します。 テンプレートの指示に従います。
  4. ドキュメントに追加する予定のスクリーンショットや画像については、に移動します。 GitHub/experience-platform.en/help/destinations/assets/catalog/[...]で、 [...] は、宛先の目的のカテゴリです。 例えば、パーソナライゼーションの宛先をExperience Platformに追加する場合は、 personalization フォルダー。 宛先の新しいフォルダーを作成し、ここに画像を保存します。 オーサリング中のページからリンクする必要があります。 詳しくは、 画像へのリンク方法の説明.
  5. 準備が整ったら、作業中のファイルを保存します。

ドキュメントを送信してレビュー

ヒント

ここで壊れるものは何もありません。 この節の手順に従うことで、単にドキュメントの更新を提案するだけです。 推奨される更新は、Adobe Experience Platformドキュメントチームが承認または編集します。

  1. GitHub Desktop で、更新用の作業ブランチを作成し、「 」を選択します。 ブランチを公開 をクリックして、ブランチを GitHub に公開します。

ローカルの新しいブランチ

  1. GitHub Desktop では、 コミット 以下に示すように、作業内容。

    ローカルにコミット

  2. GitHub Desktop では、 プッシュ あなたの仕事は リモート ブランチに含めることができます。

    コミットをプッシュ

  3. GitHub Web インターフェイスで、プルリクエスト (PR) を開き、作業ブランチをAdobeドキュメントリポジトリの master ブランチに結合します。 作業中のブランチが選択されていることを確認し、「 」を選択します。 貢献/プルリクエストを開く.

    プル要求の作成

  4. ベースと比較ブランチが正しいことを確認します。 PR に、更新内容を説明するメモを追加し、「 」を選択します。 プル要求の作成. これにより、PR が開き、フォークの作業ブランチがAdobeリポジトリの master ブランチにマージされます。

    ヒント

    を メンテナーによる編集を許可 チェックボックスがオンになっているので、Adobeドキュメントチームが PR を編集できます。

    Adobeドキュメントリポジトリへのプル要求の作成

  5. この時点で、Adobeコントリビューター使用許諾契約 (CLA) に署名するよう求める通知が表示されます。 これは必須の手順です。 CLA に署名した後、PR ページを更新し、プル要求を送信します。

  6. プルリクエストが送信されたことを確認するには、 プル要求 タブ https://github.com/AdobeDocs/experience-platform.en.

PR 成功

  1. ご協力ありがとうございます。Adobeドキュメントチームは、編集が必要な場合に備えて PR に問い合わせ、ドキュメントをいつ公開するかを知らせます。
ヒント

ドキュメントに画像やリンクを追加したり、Markdown に関するその他の質問については、以下を参照してください。 Markdown の使用 (Adobeのコラボレーション執筆ガイド )

このページ