Grav-development

提供:Dev Guides
移動先:案内検索

Grav-開発

*Grav Core* 、 *Grav Plugins* 、 *Grav Skeleton* 、 *Grav Themes* など、さまざまなタイプの *Development* でGravをビルドできます。

Grav Core

Gravは、コンテンツの作成がシンプルで、ページの構築がより友好的で直感的な、最新のCMSです。 * Gravコア*は、Gravに関するすべてを制御し、Gravワークフローとライフサイクルの品質を表すシステムフォルダーについて特に言及しています。 それは主に良い方法で書くことができるページに焦点を当てています。 コンテンツに焦点を合わせ、コンテンツをナビゲート可能なサイトに変えます。

Gravプラグイン

  • プラグイン*は、元々Gravのコア機能では完了していなかった拡張機能を提供するソフトウェアです。 Gravリポジトリには、サイトの機能を示す多くのプラグインがあります。

Gravプラグインに関連する次の点を考慮してください-

  • Grav自体は*スーパーリーン*であり、サイトに必要なプラグインのみを追加します。
  • 必要な機能を追加するのを待つ必要はありません。 これを実現するには、プラグインを作成してGravを拡張します。
  • プラグインは非常に柔軟で強力で、サイトマップ、ブログアーカイブ、検索エンジンを表示し、パンくずリストなどを提供します。

Gravスケルトン

  • Gravスケルトン*は、Grav Core、プラグイン、ページ、テーマをすべて含むサンプルサイトについて説明しています。 Gravの背後にある最初のアイデアは、非常に簡単にサイトを構築することでした。 サイトの開発に必要なものはすべて user フォルダーに配置されます。 Gravのスケルトンには、プラグイン、テーマなどのさまざまな依存関係が付属しています。 解凍可能なパッケージに保存されています。

Gravテーマ

Gravは、Gravサイトに不可欠なさまざまな種類の*テーマ*をサポートしています。 システムにGravをインストールすると、 Antimatter テーマが付属します。 ほとんどのテーマには、スケルトンパッケージまたはサンプルページが付属しています。 スケルトンパッケージと同様のエクスペリエンスを提供する user/pages フォルダーの下にサンプルページがあります。

インストールされたテーマには、ページに適切な* twigテンプレート*が必要です。 テーマは、テーマとコンテンツの組み合わせであり、サイト全体のデザインと同等です。 デザインに応じて、独自の小枝テンプレートエンジンを作成できます。

テーマ/プラグインのリリースプロセス

Gravリポジトリに追加された作成済みのテーマまたはプラグインのポイントのいくつかに気付くことができます。

  • MIT によってライセンスされているオープンソースです。
  • プロジェクトのインストールプロセスと構成を指定する README.md ファイルがあります。
  • リソースに関する情報を含む blueprints.yaml ファイルが含まれており、各プラグインとテーマのルートにあります。
  • テーマまたはプラグインのバージョンを含む CHANGELOG.md ファイルが含まれ、ファイルに変更が加えられるたびに情報が表示されます。
  • リリースの作成は、完成したテーマまたはプラグインを GitHub に配置するための優れた方法です。 リリースがない場合は、プラグインまたはテーマが見つかりません。
  • プラグインまたはテーマに関する詳細を追加し、テストを実行して、機能することを確認します。

変更ログ形式

*changelog format* は、コンテンツと視覚的な表示を分離したままにするMarkdown構文で記述されています。 次の形式で表示される単純なCSSを使用します。
# vX.Y.Z
## 01/01/2015
1. [](#new)
 *New features added
  * Another new feature
2. [](#improved)
 *Improvement made
  * Another improvement
3. [](#bugfix)
 *Bugfix implemented
  * Another bugfix
...repeat...

GitHubのセットアップ

*GitHub* は、プロジェクトをユーザーと共有し、フィードバックを得て、GitHubでホストされているリポジトリに貢献する最大のオープンコミュニティです。

外部リポジトリのURLをローカルシステム上の単一のプロジェクトフォルダーに複製します。 以下の手順に示すように、外部Gitリポジトリを新しいリポジトリに複製できます。

コマンドラインを開き、 "my_project" というフォルダーを作成します。

$ mkdir my_project
$ cd my_project
$ mkdir Grav
$ cd Grav
$ git clone https://github.com/getGrav/Grav.git
$ git clone https://github.com/Grav_project/Grav-plugin-error.git
$ git clone https://github.com/Grav_project/Grav-plugin-problems.git
$ git clone https://github.com/Grav_project/Grav-theme-antimatter.git

ここで、 Grav_project はリポジトリです。このリポジトリに関連するすべてのファイルとフォルダーは、 /my_project/Grav フォルダーに保存されます。 Gravには、 error プラグイン、 problems プラグイン、 Antimatter テーマなどの依存関係が含まれています。

*bin/Grav new-project* コマンドを使用して、Gravのテストサイトをセットアップできます。 Webルートからクローンコードを開発する必要があります。 したがって、*-s *フラグを使用して関連パーツを *bin/Grav new-project* コマンドにシンボリックにリンクする必要があります。

コマンドを使用してリポジトリを見つけるには、*。Grav/*という新しいフォルダーに1つの構成ファイルを作成します。これをルートディレクトリの下に作成する必要があります。

$ cd
$ mkdir .Grav
$ vi .Grav/config

Gravフォルダーに移動し、*-s *フラグを使用してシンボリックリンクサイトをセットアップします。

$ cd ~/Projects/Grav/Grav
$ bin/Grav my-project -s ~/www/Grav

ここで、 www はルートフォルダーであり、 Grav はテストサイトを作成する場所です。

Grav Development