Organizing Pages creating-and-organizing-pages
Learn how to organize your website with AEM. Once you understand how you need to organize your pages, you can create new pages and manage exiting pages.
Organizing your Site organizing-your-site
As an author, you need to organize your site within AEM. This involves creating and naming your content pages so that:
- You can easily find them on the author environment
- Visitors to your site can easily browse them on the publish environment
You can also use folders to help organize your content.
The structure of a website can be thought of as a tree that holds your content pages. The names of these content pages are used to form the URLs, whereas the titles are shown when the page content is viewed.
The following shows an example from the WKND Tutorial site, where an article about skateparks (la-skateparks
) is accessed:
http://<host>:<port>/editor.html/content/wknd/en/sports/la-skateparks.html
/content
/wknd
/en
/music
/...
/sports
/la-skateparks
/five-gyms-la
/mountain-bike-routes
/shopping
/...
/art
/...
/...
This structure can be viewed From the Sites console, where you can navigate through the pages of your website and perform actions on the pages.
Page Naming Conventions page-naming-conventions
When creating a page there are two keys fields:
-
- This is displayed to the user in the console and shown at the top of the page content when editing.
- This field is mandatory.
-
Name:
- This is used to generate the URI.
- User input for this field is optional. If not specified, the name is derived from the title. See the following section Page Name Restrictions and Best Practices for details.
Page Name Restrictions and Best Practices page-name-restrictions-and-best-practices
The page Title and Name can be created separately but are related:
- When creating a page, only the Title field is required. If no Name is provided at page creation, AEM will generate a name from the first 64 characters of the title (observing the validation set out below). Only the first 64 characters are used to support the best practice of short page names.
- If a page name is manually specified by the author, the 64 character limit does not apply, however other technical limitations on the page name length may.
title
element for more information.When creating a page, AEM validates the page name according to the conventions imposed by AEM and the JCR.
The minimum allowed characters are:
a
throughz
A
throughZ
0
through9
_
(underscore)-
(hyphen/minus)
Full details of all characters allowed can be found in the naming conventions.
Title title
If you supply only a page Title when creating a page, AEM derives the page Name from this string and validate the name according to the conventions imposed by AEM and JCR.
A Title field containing invalid characters is accepted, but the name derived has the invalid characters substituted. For example:
schoen.html
sc---c-.html
Name name
When you supply a page Name when creating a page, AEM validates the name according to the conventions imposed by AEM and JCR. You cannot submit invalid characters in the Name field. When AEM detects invalid characters, the field is highlighted with an explanatory message.
Templates templates
In AEM, a template is a specialized type of page used as the basis for any new page being created.
The template defines the structure of a page including a thumbnail image and other properties. For example, you may have separate templates for product pages, sitemaps, and contact information. Templates are comprised of components.
AEM comes with several templates provided out-of-the-box. The templates available depend on the individual website. The key fields are:
- Title - The title displayed on the resulting web-page
- Name - Used when naming the page
- Template - A list of templates available for use when generating the new page
Components components
Components are the elements provided by AEM so that you can add specific types of content. AEM comes with a range of out-of-the-box components, called the Core Components, that provide comprehensive functionality. Some examples of the components are:
- Text
- Image
- Title
- Carousel
- And many more
Once you have created and opened a page you can add content using the components, which are available from the component browser.