ローカル環境でのテキストエディターを使用した宛先ドキュメントページの作成 local-authoring
このページの手順では、テキストエディターを使用してローカル環境でドキュメントを作成し、プルリクエスト(PR)を送信する方法について説明します。 ここで示す手順を実行する前に、Adobe Experience Platformの宛先の宛先を文書化をお読みください。
GitHubに接続し、ローカルオーサリング環境を設定する set-up-environment
-
ブラウザーで、
https://github.com/AdobeDocs/experience-platform.ja-JPに移動します -
リポジトリをforkするには、以下に示すように Fork をクリックします。 これにより、自分のGitHub アカウントにExperience Platform リポジトリのコピーが作成されます。
-
リポジトリをローカルマシンに複製します。 次に示すように、コード/HTTPS/GitHub Desktopで開くを選択します。 GitHub Desktopがインストールされていることを確認してください。 詳しくは、Adobe コントリビューターガイドの「 リポジトリのローカルクローンを作成する」を参照してください。
-
ローカルファイル構造で、
experience-platform.en/help/destinations/catalog/[...]に移動します。ここで、[...]は宛先の目的のカテゴリです。 例えば、Experience Platformにパーソナライゼーションの宛先を追加する場合は、personalizationフォルダーを選択します。
宛先のドキュメントページを作成する author-documentation
- ドキュメント ページは、 セルフサービスの宛先テンプレート に基づいています。 宛先テンプレート をダウンロードします。 ファイル
yourdestination-template.mdを解凍し、上記の手順4で説明したディレクトリに展開します。 ファイルYOURDESTINATION.mdの名前を変更します。YOURDESTINATIONはAdobe Experience Platformの宛先の名前です。 例えば、会社の名前がMoviestarの場合、ファイルにmoviestar.mdという名前を付けます。 - 新しいファイルを、選択した テキストエディターで開きます。 Adobeでは、Visual Studio Codeを使用して、Adobe Markdown オーサリング拡張機能をインストールすることをお勧めします。 拡張機能をインストールするには、Visual Studio Codeを開き、画面の左側にある「Extensions」タブを選択し、
adobe markdown authoringを検索します。 拡張機能を選択し、Installをクリックします。
- 宛先の関連情報を含むテンプレートを編集します。 テンプレートの指示に従います。
- ドキュメントに追加する予定のスクリーンショットまたは画像については、
GitHub/experience-platform.en/help/destinations/assets/catalog/[...]にアクセスしてください。ここで、[...]は目的のカテゴリーです。 例えば、Experience Platformにパーソナライゼーションの宛先を追加する場合は、personalizationフォルダーを選択します。 宛先の新しいフォルダーを作成し、ここに画像を保存します。 オーサリングしているページからリンクする必要があります。 画像へのリンク方法の説明を参照してください。 - 準備ができたら、作業中のファイルを保存します。
レビュー用にドキュメントを送信 submit-review
- GitHub デスクトップで、更新のための作業ブランチを作成し、ブランチを公開を選択して、ブランチをGitHubに公開します。
-
GitHub デスクトップで、次に示すように、作業を コミット します。
-
GitHub デスクトップで、次に示すように、作業をremote ブランチに プッシュします。
-
GitHub web インターフェイスでプルリクエスト(PR)を開き、作業ブランチをAdobe ドキュメントリポジトリのメインブランチに結合します。 作業したブランチが選択されていることを確認し、Contribute > Open pull requestを選択します。
-
基本ブランチと比較ブランチが正しいことを確認します。 PRにメモを追加し、更新を説明して、プルリクエストを作成を選択します。 これにより、フォークの作業ブランチをAdobe リポジトリのメインブランチに結合するためのPRが開きます。
note tip TIP AdobeのドキュメントチームがPRの編集を行えるように、「メンテナによる編集を許可する」チェックボックスを選択したままにします。
-
この時点で、Adobe コントリビューターライセンス契約(CLA)への署名を求める通知が表示されます。 これは必須のステップです。 CLAに署名したら、PR ページを更新してプルリクエストを送信します。
-
プルリクエストが送信されたことを確認するには、の「 プルリクエスト
https://github.com/AdobeDocs/experience-platform.ja-JP」タブを調べます。
- ご協力ありがとうございます。Adobeのドキュメントチームは、編集が必要な場合にはPRに連絡し、ドキュメントがいつ公開されるかをお知らせします。