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

このページの手順では、テキストエディターを使用してローカル環境でドキュメントを作成し、プルリクエスト(PR)を送信する方法について説明します。 ここで示す手順を実行する前に、Adobe Experience Platformの宛先の宛先を文書化をお読みください。

GitHubに接続し、ローカルオーサリング環境を設定する set-up-environment

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

  2. リポジトリをforkするには、以下に示すように​ Fork ​をクリックします。 これにより、自分のGitHub アカウントにExperience Platform リポジトリのコピーが作成されます。

    Fork Adobe ドキュメントリポジトリ

  3. リポジトリをローカルマシンに複製します。 次に示すように、コード/HTTPS/GitHub Desktop​で開くを選択します。 GitHub Desktopがインストールされていることを確認してください。 詳しくは、Adobe コントリビューターガイドの「​ リポジトリのローカルクローンを作成する」を参照してください。

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

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

宛先のドキュメントページを作成する author-documentation

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

レビュー用にドキュメントを送信 submit-review

TIP
ここで壊れるものは何もありません。 このセクションの手順に従うと、ドキュメントの更新を提案するだけです。 提案された更新は、Adobe Experience Platform ドキュメントチームによって承認または編集されます。
  1. GitHub デスクトップで、更新のための作業ブランチを作成し、ブランチを公開​を選択して、ブランチをGitHubに公開します。

新しいブランチ ローカル

  1. GitHub デスクトップで、次に示すように、作業を​ コミット ​します。

    ローカルにコミット

  2. GitHub デスクトップで、次に示すように、作業をremote​ ブランチに プッシュします。

    コミットをプッシュ

  3. GitHub web インターフェイスでプルリクエスト(PR)を開き、作業ブランチをAdobe ドキュメントリポジトリのメインブランチに結合します。 作業したブランチが選択されていることを確認し、Contribute > Open pull request​を選択します。

    プルリクエストの作成

  4. 基本ブランチと比較ブランチが正しいことを確認します。 PRにメモを追加し、更新を説明して、プルリクエストを作成​を選択します。 これにより、フォークの作業ブランチをAdobe リポジトリのメインブランチに結合するためのPRが開きます。

    note tip
    TIP
    AdobeのドキュメントチームがPRの編集を行えるように、「メンテナによる編集を許可する」チェックボックスを選択したままにします。

    Adobeのドキュメントリポジトリへのプルリクエストを作成

  5. この時点で、Adobe コントリビューターライセンス契約(CLA)への署名を求める通知が表示されます。 これは必須のステップです。 CLAに署名したら、PR ページを更新してプルリクエストを送信します。

  6. プルリクエストが送信されたことを確認するには、の「 プルリクエスト https://github.com/AdobeDocs/experience-platform.ja-JP」タブを調べます。

PRが成功しました

  1. ご協力ありがとうございます。Adobeのドキュメントチームは、編集が必要な場合にはPRに連絡し、ドキュメントがいつ公開されるかをお知らせします。
TIP
ドキュメントに画像やリンクを追加し、Markdownに関するその他の質問については、Adobeの共同編集ガイドのMarkdownの使用を参照してください。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6