AEM Brackets擴充功能 aem-brackets-extension
概觀 overview
AEM Brackets Extension提供流暢的工作流程來編輯AEM元件和使用者端程式庫,並運用Brackets程式碼編輯器的強大功能,提供從程式碼編輯器存取Photoshop檔案和圖層的許可權。 擴充功能提供的簡易同步功能(不需要Maven或檔案儲存庫)可提升開發人員效率,也可協助具備有限AEM知識的前端開發人員參與專案。 此擴充功能也提供對HTML範本語言(HTL)的一些支援,可降低JSP的複雜性,讓元件開發更容易、更安全。
功能 features
AEM Brackets擴充功能的主要功能包括:
- 將變更的檔案自動同步至AEM開發執行個體。
- 手動雙向同步檔案和資料夾。
- 專案的完整內容套件同步。
- 運算式和
data-sly-*
區塊陳述式的HTL程式碼完成。
此外,Brackets還為AEM前端開發人員提供了許多有用的功能:
- Photoshop檔案支援從PSD檔案中擷取資訊,例如圖層、測量、顏色、字型、文字等。
- 來自PSD的程式碼提示,可輕鬆在程式碼中重複使用此擷取的資訊。
- CSS前置處理器支援,例如LESS和SCSS。
- 以及數百種其他擴充功能,可滿足更具體的需求。
安裝 installation
括弧 brackets
AEM Brackets擴充功能支援Brackets 1.0或更新版本。
從brackets.io下載最新的Brackets版本。
擴充功能 the-extension
若要安裝擴充功能,請依照下列步驟進行:
-
開啟Brackets。 在功能表 檔案 中,選取 Extension Manager…
-
在搜尋列中輸入 AEM,並尋找 AEM Brackets副檔名。
-
按一下 安裝。
-
關閉對話方塊,並在安裝完成後Extension Manager。
快速入門 getting-started
Content-Package專案 the-content-package-project
安裝擴充功能後,您可以從包含Brackets的檔案系統開啟content-package資料夾,以開始開發AEM元件。
專案必須至少包含:
-
jcr_root
資料夾(例如,myproject/jcr_root
) -
filter.xml
檔案(例如myproject/META-INF/vault/filter.xml
);如需filter.xml
檔案結構的詳細資訊,請參閱Workspace篩選器定義。
在Brackets的 檔案 功能表中,選擇 開啟資料夾……,然後選取jcr_root
資料夾或父專案資料夾。
jcr_root
資料夾。 然後依照下列步驟設定 專案設定,最後執行 匯出內容封裝,將整個封裝上傳到您的AEM開發執行個體,如完整內容封裝同步化一節中進一步說明的那樣。/content/todo.html
URL,並且您可以開始在Brackets中修改程式碼,並瞭解在網頁瀏覽器中重新整理後,變更如何立即同步至AEM伺服器。專案設定 project-settings
若要將您的內容同步到AEM開發執行個體或從中同步內容,您需要定義您的專案設定。 您可以前往 AEM 功能表並選擇 專案設定…… 來完成這項作業
「專案設定」可讓您定義下列專案:
- 伺服器URL (例如,
http://localhost:4502
) - 是否容忍沒有有效HTTPS憑證的伺服器(除非必要,否則請保持未勾選的狀態)
- 用於同步內容的使用者名稱(例如,
admin
) - 使用者的密碼(例如,
admin
)
同步內容 synchronizing-content
AEM Brackets Extension為filter.xml
中定義的篩選規則所允許的檔案和資料夾提供下列型別的內容同步:
自動同步已變更的檔案 automated-synchronization-of-changed-files
這只會同步從Brackets到AEM例項的變更,反之則不會。
手動雙向同步 manual-bidirectional-synchronization
在[專案總管]中,以滑鼠右鍵按一下任何檔案或資料夾來開啟內容功能表,然後可以存取 匯出至伺服器 或 從伺服器匯入 選項。
jcr_root
資料夾之外,匯出至伺服器 和 從伺服器匯入 內容功能表專案會停用。完整內容套件同步 full-content-package-synchronization
在 AEM 功能表中,匯出內容封裝 或 匯入內容封裝 選項可讓您與伺服器同步處理整個專案。
同步處理狀態 synchronization-status
AEM Brackets擴充功能在Brackets視窗右側的工具列中有一個通知圖示,可指出上次同步處理的狀態:
- 綠色 — 所有檔案已成功同步化
- 藍色 — 同步處理作業正在進行中
- 黃色 — 部分檔案未同步
- 紅色 — 未同步處理任何檔案
按一下通知圖示會開啟「同步化狀態報告」對話方塊,其中列出每個已同步檔案的所有狀態。
filter.xml
的篩選規則標示為包含的內容才會進行同步化。.vltignore
個檔案來排除與存放庫同步和從存放庫同步的內容。編輯HTL程式碼 editing-htl-code
AEM Brackets擴充功能也提供一些自動完成功能,以便寫入HTL屬性和運算式。
屬性自動完成 attribute-auto-completion
- 在HTML屬性中,輸入
sly
。 屬性已自動完成至data-sly-
。 - 在下拉式清單中選取HTL屬性。
運算式自動完成 expression-auto-completion
在運算式${}
中,通用變數名稱會自動完成。
更多資訊 more-information
AEM Brackets擴充功能是開放原始碼專案,由Adobe Marketing Cloud組織在GitHub上託管,使用Apache授權,版本2.0:
Brackets程式碼編輯器也是開放原始碼專案,由Adobe Systems Incorporated組織託管在GitHub上:
歡迎您貢獻內容!