AEM Brackets擴充功能 aem-brackets-extension

概觀 overview

AEM Brackets Extension提供流暢的工作流程來編輯AEM元件和使用者端程式庫,並運用Brackets程式碼編輯器的強大功能,提供從程式碼編輯器存取Photoshop檔案和圖層的許可權。 擴充功能提供的簡易同步功能(不需要Maven或檔案儲存庫)可提升開發人員效率,也可協助具備有限AEM知識的前端開發人員參與專案。 此擴充功能也提供對HTML範本語言(HTL)的一些支援,可降低JSP的複雜性,讓元件開發更容易、更安全。

chlimage_1-53

功能 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

若要安裝擴充功能,請依照下列步驟進行:

  1. 開啟Brackets。 在功能表​ 檔案 ​中,選取​ Extension Manager…

  2. 在搜尋列中輸入​ AEM,並尋找​ AEM Brackets副檔名

    chlimage_1-54

  3. 按一下​ 安裝

  4. 關閉對話方塊,並在安裝完成後Extension Manager。

快速入門 getting-started

Content-Package專案 the-content-package-project

安裝擴充功能後,您可以從包含Brackets的檔案系統開啟content-package資料夾,以開始開發AEM元件。

專案必須至少包含:

  1. jcr_root資料夾(例如,myproject/jcr_root

  2. filter.xml檔案(例如myproject/META-INF/vault/filter.xml);如需filter.xml檔案結構的詳細資訊,請參閱Workspace篩選器定義

在Brackets的​ 檔案 ​功能表中,選擇​ 開啟資料夾……,然後選取jcr_root資料夾或父專案資料夾。

NOTE
如果您沒有自己的專案包含內容封裝,可以嘗試HTL TodoMVC範例。 在GitHub上,按一下​ 下載ZIP,將檔案解壓縮到本機,然後依照上述指示,在Brackets中開啟jcr_root資料夾。 然後依照下列步驟設定​ 專案設定,最後執行​ 匯出內容封裝,將整個封裝上傳到您的AEM開發執行個體,如完整內容封裝同步化一節中進一步說明的那樣。
執行這些步驟後,您應該能夠存取您AEM開發執行個體上的/content/todo.html URL,並且您可以開始在Brackets中修改程式碼,並瞭解在網頁瀏覽器中重新整理後,變更如何立即同步至AEM伺服器。

專案設定 project-settings

若要將您的內容同步到AEM開發執行個體或從中同步內容,您需要定義您的專案設定。 您可以前往​ AEM ​功能表並選擇​ 專案設定…… ​來完成這項作業

chlimage_1-55

「專案設定」可讓您定義下列專案:

  1. 伺服器URL (例如,http://localhost:4502
  2. 是否容忍沒有有效HTTPS憑證的伺服器(除非必要,否則請保持未勾選的狀態)
  3. 用於同步內容的使用者名稱(例如,admin
  4. 使用者的密碼(例如,admin

同步內容 synchronizing-content

AEM Brackets Extension為filter.xml中定義的篩選規則所允許的檔案和資料夾提供下列型別的內容同步:

自動同步已變更的檔案 automated-synchronization-of-changed-files

這只會同步從Brackets到AEM例項的變更,反之則不會。

手動雙向同步 manual-bidirectional-synchronization

在[專案總管]中,以滑鼠右鍵按一下任何檔案或資料夾來開啟內容功能表,然後可以存取​ 匯出至伺服器 ​或​ 從伺服器匯入 ​選項。

chlimage_1-56

NOTE
如果選取的專案在jcr_root資料夾之外,匯出至伺服器 ​和​ 從伺服器匯入 ​內容功能表專案會停用。

完整內容套件同步 full-content-package-synchronization

在​ AEM ​功能表中,匯出內容封裝 ​或​ 匯入內容封裝 ​選項可讓您與伺服器同步處理整個專案。

chlimage_1-57

同步處理狀態 synchronization-status

AEM Brackets擴充功能在Brackets視窗右側的工具列中有一個通知圖示,可指出上次同步處理的狀態:

  • 綠色 — 所有檔案已成功同步化
  • 藍色 — 同步處理作業正在進行中
  • 黃色 — 部分檔案未同步
  • 紅色 — 未同步處理任何檔案

按一下通知圖示會開啟「同步化狀態報告」對話方塊,其中列出每個已同步檔案的所有狀態。

chlimage_1-58

NOTE
無論使用的同步化方法為何,只有由filter.xml的篩選規則標示為包含的內容才會進行同步化。
此外,支援.vltignore個檔案來排除與存放庫同步和從存放庫同步的內容。

編輯HTL程式碼 editing-htl-code

AEM Brackets擴充功能也提供一些自動完成功能,以便寫入HTL屬性和運算式。

屬性自動完成 attribute-auto-completion

  1. 在HTML屬性中,輸入sly。 屬性已自動完成至data-sly-
  2. 在下拉式清單中選取HTL屬性。

運算式自動完成 expression-auto-completion

在運算式${}中,通用變數名稱會自動完成。

更多資訊 more-information

AEM Brackets擴充功能是開放原始碼專案,由Adobe Marketing Cloud組織在GitHub上託管,使用Apache授權,版本2.0:

Brackets程式碼編輯器也是開放原始碼專案,由Adobe Systems Incorporated組織託管在GitHub上:

歡迎您貢獻內容!

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2