| source-git-commit | workflow-type | source-wordcount | ht-degree |
|---|---|---|---|
a6086afc0a1f099b62014ad61098a5a1dc9d4675 |
tm+mt |
719 |
3% |
ドキュメントチーム以外のAdobeスタッフや、コミュニティからのコントリビューションを歓迎します。
このプロジェクトでは、アドビオープンソース行動規範 または .NET Foundation 行動規範を採用しています。詳しくは、投稿の記事を参照してください。
投稿方法は、投稿者と、投稿したい変更の種類に応じて異なります。
軽微な変更をコントリビューションする場合は、記事にアクセスして記事の下部に表示されるフィードバックエリアをクリックし、詳細なフィードバックオプション をクリックします。次に、編集の提案 をクリックして、GitHub の Markdown ソースファイルに移動します。 GitHub UI を使用して更新を行います。 一般的な Adobeドキュメント投稿者ガイド を参照してください。
このリポジトリのドキュメントおよびコード例について投稿者が送信した軽微な修正や説明は、Adobeの利用規約の対象となります。
Adobeコミュニティのメンバーが新しい記事を作成したり、大きな変更をコントリビューションしたりする場合は、Git リポジトリーの「イシュー」タブを使用してイシューを送信し、ドキュメントチームとのやり取りを開始してください。 計画に同意したら、公開リポジトリと非公開リポジトリでの作業を組み合わせて新しいコンテンツを取り込むために、従業員と協力する必要があります。
Adobe Experience Cloud ソリューションの製品チームのテクニカルライター、プログラムマネージャー、または開発者で技術記事の投稿または作成を担当している場合は、https://git.corp.adobe.com/AdobeDocs のプライベートリポジトリを使用する必要があります。
コミュニティのコントリビューターは、基本的な編集を行う場合は GitHub UI を使用し、大きな変更を加える場合はリポジトリをフォークします。
詳しくは、Adobeドキュメント投稿者ガイド を参照してください。
このリポジトリ内の記事はすべて、GitHub Flavored Markdown を使用しています。 Markdown について詳しくは、以下を参照してください。
一部のトピックでは、データファイルとテンプレートを使用して、公開済みコンテンツを生成します。 このアプローチのユースケースを次に示します。
- プログラムで生成された大きなコンテンツセットの公開
- 統合のために、YAML などの機械読み取り可能なファイル形式を必要とする複数のシステム（Site-Wide Analysis Tool など）をまたいで、顧客に単一の情報源を提供する
テンプレート化されたコンテンツの例としては、次のようなものがあります（ただし、これに限定されません）。
通常、ほとんどのライターは、製品可用性テーブルとシステム要件テーブルにリリースバージョンを追加するだけで済みます。 その他のテンプレート化されたコンテンツのメンテナンスは、すべて専任のチームメンバーが自動化または管理します。 これらの説明は、ほとんどのライターを対象としています。
メモ：
- テンプレート化されたコンテンツを生成するには、ターミナルのコマンドラインで作業する必要があります。
- レンダリングスクリプトを実行するには、Ruby がインストールされている必要があります。 必要なバージョンについては _jekyll/.ruby-version を参照してください。
テンプレート化されたコンテンツのファイル構造について詳しくは、次を参照してください。
_jekyll- テンプレート化されたトピックと必要なアセットが含まれます_jekyll/_data- テンプレートのレンダリングに使用される機械読み取り可能なファイル形式が含まれます_jekyll/templated– 液体テンプレート言語を使用するHTMLベースのテンプレートファイルが含まれますhelp/_includes/templated- テンプレート化されたコンテンツの生成された出力.mdファイル・フォーマットで含み、Experience League・トピックで公開できるようにします。レンダリング・スクリプトによって、生成された出力がこのディレクトリに自動的に書き込まれます
テンプレート化されたコンテンツを更新するには：
-
テキストエディターで、
/jekyll/_dataディレクトリにあるデータファイルを開きます。 例：- 製品可用性テーブル :
/jekyll/_data/product-availability.yml - 必要システム構成テーブル :
/jekyll/_data/system-requirements.yml
- 製品可用性テーブル :
-
既存の YAML 構造を使用してエントリを作成します。
例えば、Adobe Commerceのバージョンを製品稼動テーブルに追加するには、
/jekyll/_data/product-availability.ymlファイルの「extensions」セクションと「services」セクションの各エントリに次のコードを追加します（必要に応じてバージョン番号を変更します）。support: - core: 1.2.3 version: 4.5.6 -
_jekyllディレクトリに移動します。cd _jekyll -
テンプレート化されたコンテンツを生成し、出力を
help/_includes/templatedディレクトリに書き込みます。rake render注意： スクリプトは
_jekyllディレクトリから実行する必要があります。 スクリプトを初めて実行する場合は、bundle installコマンドを使用して Ruby の依存関係をインストールする必要があります。 -
rootディレクトリに戻ります。cd .. -
期待される
help/_includes/templatedファイルが変更されたことを確認します。git status次のような出力が表示されます。
modified: _data/product-availability.yml modified: help/_includes/templated/product-availability-extensions.md -
変更をプッシュします。
git add . git commit -m "descriptive message of the intended commit" git push
データファイル 、 液体フィルター およびその他の機能について詳しくは、Jekyll のドキュメントを参照してください。