GitHub web インターフェイスを使用した宛先ドキュメントページの作成 github-interface
以下の手順では、GitHub web インターフェイスを使用してドキュメントを作成し、プルリクエスト(PR)を送信する方法について説明します。 ここで示す手順を実行する前に、Adobe Experience Platformの宛先の宛先を文書化をお読みください。
GitHub オーサリング環境の設定 set-up-environment
-
ブラウザーで、
https://github.com/AdobeDocs/experience-platform.ja-JPに移動します。 -
リポジトリをforkするには、以下に示すように Fork をクリックします。 これにより、自分のGitHub アカウントにExperience Platform リポジトリのコピーが作成されます。
-
リポジトリのフォークで、次に示すように、プロジェクト用に新しいブランチを作成します。 この新しいブランチを作業に使用します。
-
フォークされたリポジトリのGitHub フォルダー構造で、
experience-platform.en/help/destinations/catalog/[...]に移動します。ここで、[...]は宛先の目的のカテゴリです。 例えば、Experience Platformにパーソナライズの宛先を追加する場合は、personalizationカテゴリを選択します。 ファイルを追加/新しいファイルを作成を選択します。
-
宛先に
YOURDESTINATION.mdという名前を付けます。ここで、YOURDESTINATIONはAdobe Experience Platformの宛先の名前です。 例えば、会社の名前がMoviestarの場合、ファイルにmoviestar.mdという名前を付けます。
宛先のドキュメントページを作成する author-documentation
-
ドキュメントのセルフサービステンプレート に基づいて、宛先ページのコンテンツを作成します。 テンプレートをダウンロードし、解凍して
.mdファイルテンプレートを抽出します。 -
dillinger.ioなどのオンラインマークダウンエディターで、テンプレートのコンテンツを、宛先の関連情報と共に貼り付けて編集します。 テンプレートの指示に従って、入力する必要がある段落と削除できる段落の詳細を確認します。
note tip TIP ブラウザーのウィンドウはいつでも閉じることができ、後で再度開くことができます。 あなたの作品は自動的に保存され、ブラウザを再度開くときにあなたを待っています。 1. マークダウンエディターからGitHubの新しいファイルにコンテンツをコピーします。
-
使用する予定のスクリーンショットや画像については、GitHub インターフェイスを使用してファイルを
experience-platform.en/help/destinations/assets/catalog/[...]にアップロードします。ここで、[...]は目的のカテゴリーです。 例えば、Experience Platformにパーソナライズの宛先を追加する場合は、personalizationカテゴリを選択します。 オーサリングするページから画像にリンクする必要があります。 画像へのリンク方法の説明を参照してください。 にアップロード
-
準備ができたら、ファイルをブランチに保存します。
レビュー用にドキュメントを送信 submit-review
-
ファイルを保存して目的の画像をアップロードしたら、プルリクエスト(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に連絡し、ドキュメントがいつ公開されるかをお知らせします。