Authoring - the Environment and Tools authoring-the-environment-and-tools

The authoring environment of AEM provides various mechanisms for organizing and editing your content. The tools provided are accessed from the various consoles and page editors.

Managing your Site managing-your-site

The Sites console lets you navigate and manage your website, using the header bar, toolbar, action icons (applicable for the selected resource), breadcrumbs and when selected, secondary rails (for example, timeline and references).

For example, column view:

ateat-01

Editing Page Content editing-page-content

You can edit a page with the page editor. For example:

https://localhost:4502/editor.html/content/we-retail/us/en/equipment.html

ateat-02

NOTE
The first time you open a page for editing, a series of slides provides you with a tour of the features.
You can skip the tour if wanted and repeat it at any time by selecting from the Page Information menu.

Accessing Help accessing-help

When editing a page, Help can be accessed from:

  • the Page Information selector; this shows the introductory slides (as shown the first time that you access the editor).
  • the configuration dialog for specific components (using the question mark (?) icon in the dialog box’s toolbar); this shows context-sensitive Help.

Further help-related resources are available from consoles.

Components Browser components-browser

The components browser shows all components that are available for use on your current page. These can be dragged to the appropriate location, then edited to add your content.

The components browser is a tab within the side panel (together with the assets browser and content tree). To open (or close) the side panel, use the icon at the top left of the toolbar:

ateat-03

When you open the side panel, it slides open from the left side (select the Components tab if necessary). When open you can browse through all the components available for your page.

The actual appearance and handling depends on the device type that you are using:

NOTE
A mobile device is detected when the width is less than 1024px. This can also be the case for a small desktop window.
  • Mobile device (for example, iPad)

    The component browser completely covers the page being edited.

    To add a component to your page, touch-and-hold the required component and move it towards the right - the component browser closes to show the page again - where you can position the component.

    ateat-04

  • Desktop device

    The component browser is opened at the left side of the window.

    To add a component to your page, click the required component and drag it to the location you want.

    ateat-05

    Components are represented by

    • Component name

    • Component group (in gray)

    • Icon or abbreviation

      • Standard components’ icons are monochrome.
      • Abbreviations are always the first two characters of the component name.

    From the top toolbar in the Components browser, you can do the following:

    • Filter components by name.
    • Limit the display to a specific group using the drop-down selection.

    For a more detailed description of the component, you can click the information icon next to the component in the Components browser (if available). For example, for the Layout Container:

    ateat-06

    For even more information about the components available to you, see Component Console.

Assets Browser assets-browser

The assets browser shows all assets that are available for direct use on your current page.

The assets browser is a tab within the side panel along with the components browser and content tree. To open or close the side panel, use the icon at the top left of the toolbar:

ateat-03-1

When you open the side panel, it slides open from the left side. Select the Assets tab if necessary.

ateat-07

When the assets browser is open, you can browse through all the assets available for your page. Infinite scrolling is used to expand the list when required.

ateat-08

To add an asset to your page, select and drag to the required location. This can be:

  • An existing component of the appropriate type.

    • For example, you can drag an asset of type image onto an Image component.
  • A placeholder in the paragraph system to create a component of the appropriate type.

    • For example, you can drag an asset of type image onto the paragraph system to create an Image component.
NOTE
This is available for specific assets and component types. See Inserting a Component using the Assets Browser for more details.

From the top toolbar of the assets browser you can filter the assets by:

  • Name

  • Path

  • Type of asset such as images, manuscripts, documents, videos, pages, paragraphs, and products

  • Asset characteristics such as Orientation (Portrait, Landscape, Square) and Style (Color, Monochrome, Grayscale)

    • Available only for certain asset types

The actual appearance and handling depends on the device type that you are using:

NOTE
A mobile device is detected when the width is less than 1024px; that is, also on a small desktop window.
  • Mobile device such as iPad

    The assets browser completely covers the page being edited.

    To add an asset to your page touch-and-hold the required asset, then move it towards the right - the assets browser closes to show the page again, where you can add the asset to the required component.

    ateat-09

  • Desktop device

    The assets browser is opened at the left side of the window.

    To add an asset to your page, click the asset and drag it to the required component or location.

    ateat-10

If you must quickly change an asset, you can start the Asset Editor directly from the asset browser by clicking the edit icon shown next to the asset’s name.

Assets Browser Desktop device

Content Tree content-tree

The Content Tree gives an overview of all components on the page in a hierarchy so you can see at a glance how the page is composed.

The Content Tree is a tab within the side panel (together with the components and assets browser). To open or close the side panel, use the icon at the top left of the toolbar:

Content tree

When you open the side panel, it slides open (from the left side). Select the Content Tree tab if necessary. When open you can see a tree view representation of your page or template, so that it is easier to understand how its content is structured hierarchically. Also, on a complex page, it makes it easier to jump between components of the page.

ateat-11

A page can easily be composed of many of the same type of components, so the content (component) tree displays descriptive text (in gray) after the name of the component type (in black). The descriptive text comes from common properties of the component such as title or text.

Component types are shown in the user language, whereas the component description text comes from the page language.

Clicking the chevron next to a component collapses or expands that level.

screen_shot_2018-03-22at142559

NOTE
The Content Tree is not available if you are editing a page on a mobile device (if the browser width is less than 1024px).

Clicking the component highlights the component in the page editor. The actions available depend on the page state:

  • For example, a basic page:

    https://localhost:4502/editor.html/content/we-retail/language-masters/en/equipment.html

    ateat-12

    If the component you click in the tree is editable, a wrench icon appears to the right of the name. Clicking this icon opens the edit dialog box for the component.

    Wrench icon - Edit

  • Or a page that is part of a livecopy, where components are inherited from another page; for example:

    https://localhost:4502/editor.html/content/we-retail/us/en/equipment.html

    ateat-13

Fragments - Associated Content Browser fragments-associated-content-browser

If your page contains Content Fragments, then you have access to the browser for Associated Content.

References references

References show connections to the selected page:

  • Blueprints
  • Launches
  • Live copies
  • Language copies
  • Incoming Links
  • Use of the reference component: borrowed and lent content
  • References to Product pages (from the Commerce - Products console)

Open the required console, then navigate to the required resource and open References using:

screen_shot_2018-03-22at153653

Select your required resource shows a list of references types relevant to that resource:

ateat-22

Select the appropriate reference type for more information. In certain situations, further actions are available when you select a specific reference, including:

  • Incoming Links provides a list of pages that reference the page, together with direct access to Edit one of those pages when you select a specific link.

    • This can only show static links, not dynamically generated links; for example, from the List component.
  • Instances of borrowed and lent content using the Reference component, from here you can navigate to the referencing/referenced page

  • References to Product pages (available from the Commerce-Products console)

  • Launches provides access to related launches.

  • Live Copies displays the paths of all live copies that are based on the selected resource.

  • Blueprint provides details and various actions.

  • Languages Copies provides details and various actions.

For example, you can fix a broken reference within a Reference component:

ateat-14

Events - Timeline events-timeline

For appropriate resources (for example, pages from the Sites console, or assets from the Assets console) the timeline can be used to show the recent activity on any selected items.

Open the required console, then navigate to the required resource and open Timeline, using:

ateat-15

Select your required resource, then either Show All or Activities to list any recent actions on the selected resources:

ateat-16

Page Information page-information

The Page Information button (equalizer icon) opens a menu that also provides details about the last edit and the last publication. Depending on the characteristics of the page, its site, and your instance, more or fewer options might be available:

ateat-17

For example, when appropriate, Page Information also has the options:

In addition, Page Information can provide access to analytics and recommendations, when appropriate.

Page Modes page-modes

There are various modes when editing a page allowing for different actions:

  • Edit - use this mode when editing the page content.

  • Layout - lets you create and edit your responsive layout dependent on the device (if the page is based on a layout container)

  • Scaffolding - help you to create a large set of pages that share structure but have different content.

  • Developer - lets you perform various actions (requires privileges). These include inspecting the technical details of a page and its components.

  • Design - lets you enable/disable components for use on a page and to configure the design of the component (if the page is based on a static template).

  • Targeting - increase content relevance through targeting and measuring across all channels.

  • Activity Map - shows Analytics data for the page.

  • Timewarp - lets you view a pages state at a particular point in time.

  • Live Copy Status - allows a quick overview of the live copy status and which components are/are not inherited.

  • Preview - used to view the page as it is shown on the publish environment; or to navigate using links in the content.

  • Annotate - used to add or view annotations on the page.

You can access these using the icons in the top-right corner. The actual icon changes to reflect the mode you are currently using:

ateat-18

NOTE
  • Depending on the characteristics of the page, some modes may not be available.
  • Access to some modes requires the appropriate permissions/privileges.
  • Developer mode is not available on mobile devices due to space restrictions.
  • There is a keyboard shortcut ( Ctrl-Shift-M) to toggle between Preview and the currently selected mode (for example, Edit, and Layout).

Path Selection path-selection

Often when authoring it is necessary to select another resource such as when defining a link to another page or resource or selecting an image. To easily select a path, path fields offer auto-complete and the path browser allows for more robust selection.

Path Fields path-fields

The example used here to illustrate is the image component. For more information about using and editing components, see Components for Page Authoring.

Path fields have auto-complete and look-ahead functionality now to make locating a resource easier.

Clicking the Open Selection Dialog button in the path field opens the path browser dialog to allow for more detailed selection options.

Open Selection Dialog

Alternatively, you can start typing in the path field and AEM offers matching paths as you type.

ateat-19

Path Browser path-browser

The path browser is organized like the column view of the sites console, allowing for more detailed selection of resources.

screen_shot_2018-03-22at154521

  • Once a resource is selected, the Select button at the upper-right of the dialogue becomes active. Click to confirm the selection or Cancel to abort.

  • If the context allows for the selection of multiple resources, selecting a resource also activates the Select button, but also adds a count of the number of selected resources to the upper-right of the window. Click X next to the number to deselect all.

  • When you navigate through the tree, your location is reflected in the breadcrumbs at the top of the dialog. These breadcrumbs can also be used to quickly jump within the resource hierarchy.

  • At any time, you can use the search field at the top of the dialogue. Click the X in the search field to clear the search.

  • To narrow your search, you can reveal the filter options and filter your results based on a certain path.

    ateat-21

Keyboard Shortcuts keyboard-shortcuts

Various keyboard shortcuts are available.

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