Grav - 開發



您可以使用不同型別的開發來構建 Grav,例如Grav 核心Grav 外掛Grav 骨架Grav 主題

Grav 核心

Grav 是一個現代化的 CMS,其中內容編寫簡單,頁面構建更友好、更直觀。Grav 核心特別講述了控制 Grav 所有內容的系統資料夾,它代表了 Grav 工作流程和生命週期的特性。它主要關注以良好方式編寫的頁面。它專注於您的內容,並將您的內容轉換為可導航的網站。

Grav 外掛

外掛是一段軟體,它提供了 Grav 核心功能最初未完成的增強功能。Grav 程式碼庫中提供了許多外掛,這些外掛展示了網站上的功能。

考慮以下與 Grav 外掛相關的要點:

  • Grav 本身是極其精簡的,只為您的網站新增必要的外掛。

  • 無需等待新增您想要的功能。要實現此目的,只需建立一個外掛來擴充套件 Grav。

  • 外掛非常靈活且功能強大,可以顯示站點地圖、部落格存檔、搜尋引擎,提供麵包屑導航等。

Grav 骨架

Grav 骨架描述了一個示例網站,其中包含 Grav 核心、外掛、頁面、主題等所有內容。Grav 最初的想法是讓網站構建非常容易。開發網站所需的一切都放在使用者資料夾中。Grav 的骨架附帶各種依賴項,例如外掛、主題等,並存儲在一個可以解壓縮的包中。

Grav 主題

Grav 支援不同型別的主題,這些主題構成了 Grav 網站不可或缺的一部分。當您在系統上安裝 Grav 時,它會附帶Antimatter 主題。大多數主題都帶有骨架包或示例頁面。您可以在user/pages資料夾下看到示例頁面,這些頁面提供了與骨架包類似的體驗。

已安裝的主題需要適合您頁面的Twig 模板。主題是主題和內容的組合,等於整個網站的設計。您可以根據自己的設計建立自己的 Twig 模板引擎。

主題/外掛釋出流程

您可以注意到新增到 Grav 程式碼庫中您建立的主題或外掛的一些要點。

  • 這是一個開源專案,由MIT許可。

  • 它包含README.md檔案,該檔案指定專案的安裝過程和配置。

  • 它包含blueprints.yaml檔案,其中包含有關資源的資訊,可以在每個外掛和主題的根目錄中找到。

  • 包含CHANGELOG.md檔案,其中包含主題或外掛的版本,並在每次更改檔案時顯示資訊。

  • 建立發行版是在GitHub上放置已完成的主題或外掛的更好方法。如果沒有發行版,您將找不到您的外掛或主題。

  • 新增有關您的外掛或主題的詳細資訊,並進行測試以確保其功能正常。

變更日誌格式

變更日誌格式使用 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/的新資料夾中建立一個配置檔案,以使用該命令查詢程式碼庫,您需要在根目錄下建立此檔案。

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

導航到您的 Grav 資料夾,並使用-s標誌設定符號連結的站點。

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

這裡,www是根資料夾,Grav是您將建立測試站點的地址。

Grav Development
廣告
© . All rights reserved.