準備好開始使用 Gantry 5 了嗎?那太棒了!我們隨時為您提供協助。
在此頁面上,您將獲得一些快速提示,幫助您開始使用 Gantry 5。
我們希望您喜歡 Gantry 5,就像我們喜歡製作它一樣。
Gantry的後端管理需求依優先順序如下:
注意:不再支援 Internet Explorer
Gantry 5 是一個用來製作由 Gantry 驅動的主題的框架。為了讓 Gantry 主題正常運作,您需要安裝框架和主題。要做到這一點並不困難。
您需要做的第一件事是下載最新版本的 Gantry 5 和 Hydrogen。您可以透過點擊下面的連結或透過 GitHub 來完成此操作。
| 下載穩定版 | 下載 CI 構建 |
|---|
一旦獲得最新的軟體包,安裝就很簡單。我們在本文檔的安裝部分提供了逐步指南。
了解更多
當您安裝並啟動 Gantry 框架和 Hydrogen 後,您可以透過多種不同的方式存取 Gantry 5 管理員。最簡單的方法是從 Joomla 後端導航到「元件」>「Gantry 5 模板」 。
在這裡,您將看到所有已安裝的 Gantry 支援的主題的清單。您可以從此處預覽主題,或選擇「設定」直接前往Gantry 管理員,您可以在其中開始修改由 Gantry 驅動的網站。
Gantry 管理員有多個管理工具,您可以瀏覽它們來設定 Gantry 驅動的主題的外觀和功能。以下是每個工具的快速細分,以及您可以使用它們做什麼。
您會注意到 Gantry 5 Administrator 中的下列選單項目:
選單編輯器:此管理面板使您能夠透過更改樣式、重新排列連結以及建立位於 CMS 整合選單管理器之外的選單項目來增強平台的選單。
關於:此頁面為您提供有關當前訪問主題的快速、一目了然的信息。這是一個一站式商店,提供有關主題的信息,包括:名稱、版本號、創建者、支援連結、功能等。
平台設定:此按鈕將帶您進入 Gantry 5 的CMS設定頁面。
清除快取:此按鈕清除與 Gantry 相關的快取檔案。這包括 CSS 和配置資訊之外的所有臨時檔案。
大綱下拉式選單:此下拉式選單可以輕鬆地在大綱之間快速切換,而無需離開 Gantry 管理員。
樣式:此管理面板可讓您存取與樣式相關的輪廓設定。這包括主題顏色、字體、樣式預設等。
設定:此管理面板使您能夠配置主題的功能設定。這包括設定粒子的預設值,以及啟用/停用單一粒子。
佈局:您可以在此管理面板中配置主題的佈局。建立放置模組位置、粒子、間隔和非渲染腳本(例如 Google Analytics 程式碼)均在此面板中完成。
了解更多
由於 Gantry 5 與先前的任何版本的 Gantry 都有很大不同,因此我們提出了一些術語來幫助理解 Gantry 的新功能之間的關係。以下是與 Gantry 5 相關的常用術語的快速細分。
| 學期 | 定義 |
|---|---|
| 大綱 | 一種用於網站的一個或多個區域的可配置樣式。它充當設定頁面樣式、設定和佈局的容器。 |
| 粒子 | 前端使用的典型小數據塊。它的行為很像一個小部件/模組,但可以在 Gantry 5 Administrator 中輕鬆配置。 |
| 原子 | 一種包含非渲染資料的粒子類型,例如自訂腳本(JS、CSS 等)或用於流量追蹤的分析腳本。 |
了解更多
我們已經使用 Gitter 設置了一個聊天室,您可以在其中與開發人員、貢獻者和社群的其他成員討論專案。這是獲取快速提示並與其他人討論功能的最佳地點。
文件也是可用的,並且隨著開發的進展而不斷添加。是不是少了什麼?您可以透過 GitHub 為文件做出貢獻。
為 Gantry 5 框架或其相關文件做出貢獻很容易。這兩個專案的開發都是透過 Github 進行的,您可以在其中提交問題來報告任何錯誤或提出改進建議,也可以提交您自己的Pull 請求來提交您自己的修復和添加。
我們建議在提交拉取請求之前透過 Gitter 與團隊聊天,以避免重複修復已經待處理或可能被即將發生的變更覆蓋的修復。
要使用 Git 版本的 Gantry,首先需要安裝 Composer 依賴項。為此,請運行:
bin/composer-install
之後,您需要將 Gantry 正確符號連結到您的 CMS 安裝中。
在我們的開發環境中,我們使用Gulp來捆綁JavaScript並編譯帶有watch功能的SCSS ,這樣目標檔案的任何變更都會自動觸發重新編譯。
如果您想在自己的開發環境中進行設置,可以按照這些簡單的說明進行操作。
請注意,要使其工作,您需要有Gantry 5原始碼而不是軟體包。您可以克隆它或從 GitHub下載原始程式碼。
您首先需要的是Node / NPM 。如果您還沒有,您可以從 https://nodejs.org/download/ 取得適合您作業系統的安裝程式。
下一步是安裝所有 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。哪個對你來說比較容易記住。程式碼將自行了解是否需要首次安裝或僅更新節點模組。請注意,這可能需要一些時間。
此時,您已擁有執行 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://developers.google.com/fonts/docs/developer_api上的指南生成,或簡單地使用https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY網址。您需要啟用 Google Fonts API 的使用,並提供您的 API 金鑰來取代YOUR-API-KEY 。
Gantry Framework v5 或更高版本在雙授權系統(MIT 或GPL 版本2 或更高版本)下獲得許可。 )。
| 更多詳情 |
|---|