AEM Brackets Extension aem-brackets-extension
Ökning overview
Med AEM Brackets Extension får du ett smidigt arbetsflöde när du redigerar AEM-komponenter och klientbibliotek. Du använder kraften i Brackets -kodredigeraren som ger åtkomst till Photoshop-filer och -lager inifrån kodredigeraren. Den enkla synkronisering som tillägget ger (ingen Maven eller filvalv krävs) ökar utvecklarens effektivitet och hjälper även gränssnittsutvecklare med begränsade AEM-kunskaper att delta i projekt. Det här tillägget har även stöd för HTML Template Language (HTL), vilket gör JSP-komponenten mer komplex och gör komponentutvecklingen enklare och säkrare.
Funktioner features
Huvudfunktionerna i AEM Brackets Extension är:
- Automatisk synkronisering av ändrade filer till AEM-utvecklingsinstansen.
- Manuell dubbelriktad synkronisering av filer och mappar.
- Fullständig innehållspaketsynkronisering av projektet.
- HTML-kodkomplettering för uttryck och
data-sly-*
blocksatser.
Brackets har dessutom många användbara funktioner för AEM teckensnittsutvecklare:
- Stöd för Photoshop-filer för att extrahera information från en PSD-fil, t.ex. lager, mått, färger, teckensnitt, texter och så vidare.
- Kodtips från PSD om du enkelt vill återanvända den extraherade informationen i koden.
- Stöd för CSS-preprocessorer, som LESS och SCSS.
- Och hundratals tillägg som täcker mer specifika behov.
Installation installation
Parenteser brackets
AEM Brackets Extension stöder Brackets version 1.0 eller senare.
Hämta den senaste Brackets-versionen från brackets.io.
Tillägget the-extension
Så här installerar du tillägget:
-
Öppna Brackets. I menyn Arkiv väljer du Extension Manager…
-
Ange AEM i sökfältet och sök efter AEM Brackets Extension.
-
Klicka på Installera.
-
Stäng dialogrutan och Extension Manager när installationen är klar.
Komma igång getting-started
Innehållspaketprojektet the-content-package-project
När tillägget har installerats kan du börja utveckla AEM-komponenter genom att öppna en innehållspaketmapp från filsystemet med Brackets.
Projektet måste innehålla minst
-
en
jcr_root
-mapp (till exempelmyproject/jcr_root
) -
en
filter.xml
-fil (till exempelmyproject/META-INF/vault/filter.xml
). Mer information om strukturen för filenfilter.xml
finns i Workspace-filterdefinitionen.
Välj Öppna mapp… på menyn Arkiv i hakparenteser och välj antingen mappen jcr_root
eller den överordnade projektmappen.
jcr_root
i Brackets enligt instruktionerna ovan. Följ sedan stegen nedan för att konfigurera projektinställningarna och överföra slutligen hela paketet till din AEM-utvecklingsinstans genom att göra ett Exportera innehållspaket enligt anvisningarna längre ned i avsnittet Fullständig synkronisering av innehållspaket./content/todo.html
på din AEM-utvecklingsinstans och du kan börja göra ändringar i koden i hakparenteser och se hur ändringarna synkroniserades direkt till AEM-servern när du har gjort en uppdatering i webbläsaren.Projektinställningar project-settings
Om du vill synkronisera ditt innehåll till och från en AEM-utvecklingsinstans måste du definiera dina projektinställningar. Detta kan du göra genom att gå till menyn AEM och välja Projektinställningar…
Med projektinställningarna kan du definiera följande:
- Server-URL (till exempel
http://localhost:4502
) - Om servrar som inte har ett giltigt HTTPS-certifikat ska tolereras (håll inte markerat om det inte krävs)
- Användarnamnet som används för att synkronisera innehåll (till exempel
admin
) - Användarens lösenord (till exempel
admin
)
Synkroniserar innehåll synchronizing-content
AEM Brackets Extension tillhandahåller följande typer av innehållssynkronisering för filer och mappar som tillåts av filtreringsreglerna som definieras i filter.xml
:
Automatisk synkronisering av ändrade filer automated-synchronization-of-changed-files
Detta synkroniserar endast ändringar från Brackets till AEM-instansen, men inte tvärtom.
Manuell dubbelriktad synkronisering manual-bidirectional-synchronization
I projektutforskaren öppnar du snabbmenyn genom att högerklicka på en fil eller mapp och alternativen Exportera till server eller Importera från server är tillgängliga.
jcr_root
inaktiveras sammanhangsbaserade menyposter för Exportera till server och Importera från server.Fullständig synkronisering av innehållspaket full-content-package-synchronization
På menyn AEM kan du synkronisera hela projektet med servern med alternativen Exportera innehållspaket eller Importera innehållspaket .
Synkroniseringsstatus synchronization-status
I AEM Brackets Extension finns en meddelandeikon i verktygsfältet till höger om Brackets-fönstret, som anger status för den senaste synkroniseringen:
- grön - alla filer har synkroniserats
- blue - en synkroniseringsåtgärd pågår
- gult - vissa av filerna synkroniserades inte
- röd - ingen av filerna synkroniserades
Om du klickar på meddelandeikonen öppnas dialogrutan Synkroniseringsstatus med en lista över all status för varje synkroniserad fil.
filter.xml
synkroniseras, oavsett vilken synkroniseringsmetod som används..vltignore
-filer för att utesluta innehåll från synkronisering till och från databasen.Redigera HTML-kod editing-htl-code
AEM Brackets Extension innehåller även vissa funktioner för automatisk komplettering som underlättar skrivandet av HTML-attribut och -uttryck.
Automatisk komplettering av attribut attribute-auto-completion
- I ett HTML-attribut skriver du
sly
. Attributet har fyllts i automatiskt tilldata-sly-
. - Markera HTL-attributet i listrutan.
Automatisk komplettering av uttryck expression-auto-completion
Inom ett uttryck ${}
slutförs gemensamma variabelnamn automatiskt.
Mer information more-information
AEM Brackets Extension är ett öppen källkodsprojekt som hanteras av GitHub av Adobe Marketing Cloud -organisationen, under Apache-licensen, version 2.0:
- Koddatabas: https://github.com/Adobe-Marketing-Cloud/aem-sightly-brackets-extension
- Apache License, version 2.0: https://www.apache.org/licenses/LICENSE-2.0.html
Kodredigeraren Brackets är också ett öppen källkodsprojekt som hanteras av GitHub av Adobe Systems Incorporated -organisationen:
- Koddatabas: https://github.com/adobe/brackets
Du kan bidra!