SXA CLIを使用してテーマを追加する
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
SXA CLIは、SXAプロジェクトのタスクを自動化するための便利なコマンドライン ツールです。このトピックでは、SXA CLIを使用してテーマを追加する方法について説明します。これは、アセットをより詳細に制御し、Gitなどのバージョン管理システムを使用する場合に便利です。
SXA CLIを使用してテーマを追加する前に、node.jsをインストールし、Node Package Manager (NPM) をグローバルにインストールしてください。
-
npmとinstallコマンドを使用して、SXA CLIをグローバル パッケージとしてインストールします ( npm i -g @sitecore/sxa-cli)。
SXA CLIを使用してテーマを追加するには:
-
Sitecoreテーマの定型文をダウンロードします。
-
Website\App_Config\Include\z.Feature.Overridesに移動し、z.SPE.Sync.Enabler.Gulp.config.disabledファイルを有効にします。
-
ダウンロードしたテーマの定型文フォルダに切り替えます。
-
sxa initを実行します。
-
Gulpタスクの設定ファイルを更新します。
ThemeRoot/gulp/config.jsに移動し、serverOptions.serverにSitecoreインスタンスへのパスを入力します。
-
If you use Creative Exchange, skip this step.
ThemeRoot/gulp/serverConfig.jsonを開き、次のように入力します。
-
serverOptions.projectPath - テーマが配置されているプロジェクトへのパス。
-
serverOptions.themePath - プロジェクトルートからの基本テーマフォルダへのパス。
-
-
コマンドラインでテーマのルートフォルダを開きます。
-
npm iを実行します。
-
これで、新しいテーマが利用可能になりました。新しいテーマをサイトに割り当てるようにしてください。
に移動し、Sitecore/Content/<tenant>/<site>/SettingsSite Configuration設定のCompatible themesフィールドで、新しいテーマをSelectedフィールドに追加します。これで、サイトの現在のテーマとしてテーマを選択できます。
次の表では、テーマ設定でSXA CLIを使用するための最も重要なコマンドについて説明します。
|
命令 |
別名 |
形容 |
|---|---|---|
|
sxa init |
sxa i |
Creative Exchangeライブモードとの互換性を保つために必要なすべてのファイルをダウンロードします。このプロセスでは、不足しているファイルがダウンロードされ、既存のファイルは置き換えられません。 |
|
sxa new <ThemeName> --url <url> |
sxa n |
テーマ作成パイプラインを実行し、テーマをローカルとSitecoreの両方に保存します。このコマンドを使用して、サイトの新しいテーマを作成します。 テーマを作成するインスタンスに追加できます。現在登録されているSitecoreインスタンスでテーマを作成する場合は、URLを指定する必要はありません。 |
|
sxa config |
sxa c |
質問のリストに回答することで、テーマ変数を設定します。このコマンドを使用して、テーマの設定を変更します。 |
|
sxa register <url> |
sxa reg |
Sitecore URLのインスタンスをグローバルに登録します。 |
|
sxa get-url |
sxa g |
現在登録されているURLを確認します。 |
|
sxa build taskName |
sxa b |
現在のテーマ設定に基づいてテーマアセットを構築します。利用可能なタスクについては 、「SXAの監視、ビルド、アップロード タスク」を参照してください。 |
|
sxa upload taskName |
sxa u |
テーマ設定に基づいてテーマアセットをアップロードします。利用可能なタスクについては、SXAの監視、ビルド、アップロード タスク を参照してください。 |
|
sxa watch taskName |
sxa w |
テーマアセットの変更を監視し、変更されたファイルを自動的にアップロードします。利用可能なタスクについては、SXAの監視、ビルド、アップロード タスク を参照してください。 sxa configコマンドで設定できます。 |
|
sxa rebuild taskName |
sxa r |
テーマアセットを再構築してアップロードします。使用可能なタスクについては、 |