SXA CLIを使ってテーマを追加する

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

SXA CLIは、SXAプロジェクトのタスクを自動化するための便利なコマンドラインツールです。このトピックでは、SXA CLIを使ってテーマを追加する方法について説明します。これは、Gitのようなバージョン管理システムを使って資産をよりコントロールしたい場合に便利です。

CLIでテーマを追加する前に、SXA node.jsをインストールし、Node Package Manager (NPM)をグローバルにインストールしてください。

npmとインストールコマンドを使って、CLIをグローバルパッケージとしてSXAインストールしてください: 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.serverSitecoreインスタンスへのパスを入力します。
Creative Exchangeを使う場合は、このステップを省略してください。

ThemeRoot/gulp/serverConfig.json開いて入力してください:
- serverOptions.projectPath - テーマが配置されるプロジェクトへのパス。
- serverOptions.themePath - プロジェクトルートから基本テーマフォルダへのパス。
コマンドラインでThemeのルートフォルダを開きます。
走ってnpm i。
新しいテーマが利用可能になりました。新しいテーマを必ずあなたのサイトに割り当ててください:

Sitecore/Content///Settingsに行き、サイト設定の**「互換性のあるテーマ」**欄で「選択済み」欄に新しいテーマを追加してください。これで、そのテーマをサイトの現在のテーマとして選択できます。

以下の表は、テーマ設定でSXA CLIを使用する際の最も重要なコマンドを説明しています:

指揮

別名

概要

sxa init

sxa i

Creative Exchange Live Modeとの互換性のために必要なすべてのファイルをダウンロードします。このプロセスは欠けているファイルをダウンロードし、既存のファイルを置き換えるものではありません。

sxa new --url

sxa n

Create theme pipelineを実行し、テーマをローカルとSitecoreの両方に保存します。このコマンドを使って新しいテーマを作成してください。

テーマを作成するべきインスタンスに追加できます。現在登録されているSitecoreインスタンスでテーマを作成したい場合は、URLを指定する必要はありません。

sxa config

sxa c

質問リストに答えてテーマ変数を設定します。このコマンドを使ってテーマ設定を変更します。

sxa register

sxa reg

グローバルにSitecore URLのインスタンスを登録します。

sxa get-url

sxa g

現在登録されているURLを確認します。

sxa build taskName

sxa b

現在のテーマ設定に基づいてテーマアセットを作成します。利用可能なタスクについては、 SXAのウォッチ、ビルド、アップロードタスクにアクセスしてください。

sxa upload taskName

sxa u

sxa watch taskName

sxa w

コマンドで設定 sxa config 可能です。

sxa rebuild taskName

sxa r

テーマアセットの再構築とアップロード。利用可能なタスクについては、

この記事を改善するための提案がある場合は、お知らせください!