Gantry 5 を始める準備はできましたか?それは素晴らしいことです!私たちはお手伝いをするためにここにいます。
このページでは、Gantry 5 を使い始めるのに役立ついくつかの簡単なヒントが表示されます。各セクションの下部にある[詳細]ボタンをクリックすると、これらの各ヒントの詳細なドキュメントが表示されます。
私たちがガントリー 5 の制作を楽しんだのと同じように、皆さんもガントリー 5 を隅々まで楽しんでいただければ幸いです。
Gantry のバックエンド管理要件を優先順に示します。
注: Internet Explorer はサポートされなくなりました
Gantry 5 は、Gantry を利用したテーマを作成するためのフレームワークです。 Gantry テーマが機能するには、フレームワークとテーマの両方をインストールする必要があります。これを行うのはまったく難しいことではありません。
最初に行う必要があるのは、Gantry 5 と Hydrogen の最新ビルドをダウンロードすることです。これは、以下のリンクをクリックするか、GitHub 経由で行うことができます。
安定版をダウンロード | CI ビルドをダウンロードする |
---|
最新のパッケージを入手したら、インストールは簡単です。このドキュメントのインストール部分には、ステップバイステップのガイドが用意されています。
もっと詳しく知る
Gantry フレームワークと Hydrogen の両方をインストールしてアクティブ化すると、いくつかの異なる方法で Gantry 5 管理者にアクセスできます。最も簡単なのは、Joomla のバックエンドから[コンポーネント] > [ガントリー 5 テンプレート]に移動するだけです。
ここには、インストールされているガントリー搭載テーマのリストが表示されます。ここからテーマをプレビューするか、 「構成」を選択してGantry Administratorに直接移動し、Gantry を利用したサイトの変更を開始できます。
Gantry Administrator には、Gantry を利用したテーマの外観と機能を構成するために使用できる複数の管理ツールがあります。ここでは、これらの各ツールの簡単な内訳と、それらを使用して何ができるかを説明します。
Gantry 5 Administrator には次のメニュー項目があることがわかります。
メニュー エディター: この管理パネルを使用すると、スタイルの変更、リンクの再配置、CMS の統合メニュー マネージャーの外部にあるメニュー項目の作成によってプラットフォームのメニューを拡張できます。
概要: このページには、現在アクセスしているテーマに関する一目でわかる情報が表示されます。これは、名前、バージョン番号、作成者、サポート リンク、機能などを含むテーマに関する情報をワンストップで入手できるショップです。
プラットフォーム設定: このボタンを押すと、Gantry 5 の CMS 設定ページに移動します。Joomla では、これは権限設定ページです。
キャッシュのクリア: このボタンは、ガントリーに関連するキャッシュ ファイルをクリアします。これには、CSS の外部にあるすべての一時ファイルと構成情報が含まれます。
アウトライン ドロップダウン: このドロップダウンを使用すると、Gantry Administrator を離れることなく、アウトラインをすばやく簡単に切り替えることができます。
スタイル: この管理パネルでは、スタイル関連のアウトライン設定にアクセスできます。これには、テーマの色、フォント、スタイルのプリセットなどが含まれます。
設定: この管理パネルでは、テーマの機能設定を構成できます。これには、パーティクルのデフォルトの設定や、個々のパーティクルの有効化/無効化が含まれます。
レイアウト: この管理パネルでは、テーマのレイアウトを構成します。配置モジュールの位置、パーティクル、スペーサー、Google Analytics コードなどのレンダリングされないスクリプトの作成はすべてこのパネルで行われます。
もっと詳しく知る
Gantry 5 はそれ以前のバージョンの Gantry とは大きく異なるため、Gantry の新機能の相互関係を理解するのに役立つ用語をいくつか考え出しました。ここでは、Gantry 5 に関連してよく使用される用語を簡単に説明します。
学期 | 意味 |
---|---|
概要 | サイトの 1 つ以上の領域で使用される構成可能なスタイル。これは、ページのスタイル、設定、レイアウトが設定されるコンテナとして機能します。 |
粒子 | フロントエンドで使用される通常の小さなデータ ブロック。これはウィジェット/モジュールとよく似ていますが、Gantry 5 Administrator で簡単に設定できます。 |
原子 | カスタム スクリプト (JS、CSS など) やトラフィック追跡用の分析スクリプトなど、レンダリングされないデータを含むパーティクルのタイプ。 |
もっと詳しく知る
Gitter を使用してチャット ルームがセットアップされており、開発者、貢献者、コミュニティの他のメンバーとプロジェクトについて話し合うことができます。ここは、簡単なヒントを入手したり、他の人と機能について話し合ったりするのに最適な場所です。
ドキュメントも利用可能であり、開発の進行に応じて継続的に追加されます。何かが足りないのでしょうか? GitHub を通じてドキュメントに貢献できます。
Gantry 5 フレームワークやその関連ドキュメントに貢献するのは簡単です。これらのプロジェクトの開発は両方とも Github 経由で行われており、問題を送信してバグを報告したり改善を提案したり、独自の修正や追加を送信するために独自のプル リクエストを送信したりできます。
すでに保留中の修正や今後の変更によって上書きされる可能性のある修正を重複して実行することを避けるために、プル リクエストを送信する前に Gitter 経由でチームとチャットすることをお勧めします。
Gantry の git バージョンを使用するには、まず Composer の依存関係をインストールする必要があります。これを行うには、次を実行します。
bin/composer-install
その後、Gantry を CMS インストールに適切にシンボリックリンクする必要があります。
私たちの開発環境では、 Gulp を使用してJavaScript をバンドルし、 watch
機能でSCSS をコンパイルします。これにより、ターゲット ファイルに変更が加えられると、自動的に再コンパイルがトリガーされます。
これを独自の開発環境で設定したい場合は、次の簡単な手順に従って行うことができます。
これが機能するには、パッケージではなくGantry 5ソースが必要であることに注意してください。クローンを作成するか、GitHub からソースをダウンロードできます。
最初に必要なのはNode / NPM
です。まだお持ちでない場合は、https://nodejs.org/download/ から OS のインストーラーを取得できます。
次のステップでは、すべての JS モジュールの依存関係をインストールします。これを行うには、Gantry 5 プロジェクトのルートにいることを確認し、コマンドnpm install
実行します。
それが完了したら、 Gulp をインストールできます。どのフォルダーからでもコマンドを使用できるように、Gulp をグローバルにインストールすることをお勧めします。そのためのコマンドは次のとおりです: sudo npm install gulp --global
Gantry には、ルートから再コンパイルできるさまざまな JS ファイルと CSS ファイルのセットがあります。 Gantry を初めて使用する場合、またはすべてのモジュールをリセットして再インストールする必要がある場合は、コマンドnpm run build-assets
実行できます。この操作により、すべてのnode_modules
フォルダーが削除され、すべてのプロジェクト フォルダーでnpm install
が再実行されます。しばらく時間がかかります。
すべてのnode_modules
フォルダーを削除しない代替方法は、 gulp -up
を使用することです。
-up
コマンドとともに、-update
、--update
、-up
、--up
、-install
、--install
、-inst
、--inst
、-go
、--go
、-deps
、--deps
を使用することもできます。--deps
。どちらか覚えやすい方を選択してください。コードは、初めてインストールする必要があるのか、それともノード モジュールを更新する必要があるのかを独自に理解します。これには少し時間がかかる場合があることに注意してください。
この時点で、Gulp を実行するために必要なものがすべて揃っています。コマンドgulp
を入力するだけで、CSS と JS がコンパイルされるのが確認できるはずです。
いくつかの便利なタスクも提供しています。
$ gulp
/ $ gulp all
: プロジェクト内のすべての CSS と JS をコンパイルします。$ gulp watch
: コンパイラをwatch
モードで起動します。対象のJSまたはSCSSファイルに変更を適用すると、自動再コンパイルがトリガーされます。$ gulp watch --css
/ $ gulp watch --js
: コンパイラをwatch
モードで起動し、 SCSSまたはJS の変更のみをリッスンします。一方のみに焦点を当て、もう一方には焦点を当てない場合に便利です。$ gulp css
/ $ gulp js
: CSS または JS ファイルのいずれか一方のみを作業し、もう一方を作業しない場合に、そのファイルをすべてコンパイルします。$ gulp —prod
: すべての CSS と JS を運用モードでコンパイルします。コンパイルされたファイルにはソース マップが含まれず、圧縮されます (通常、これには通常モードよりわずかに時間がかかります)。 Google Fonts JSON ファイルは、https: https://developers.google.com/fonts/docs/developer_api
のガイドに従うか、単にhttps://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY
を使用して生成できます。 https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY
URL。 Google Fonts APIの使用を有効にし、 YOUR-API-KEY
の代わりにAPIキーを指定する必要があります。
Gantry Framework v5 以降は、デュアル ライセンス システム (MIT または GPL バージョン 2 以降) に基づいてライセンスされています。つまり、ニーズに適したライセンス (MIT または GPL バージョン 2 以降) を自由に選択できます。
さらに詳しく |
---|