Simple Content Creation Workflows
The AEM Guides Editor has multiple shortcuts that simplify the content creation workflow. These shortcuts allow users to quickly add and modify images, work with multiple topics at once, correct errors, download topic PDFs, and work with versions and labels.
Add an image
Images can be added directly from a local drive.
-
Drag and drop the image directly into the topic. The Upload Assets dialog appears.
-
Modify the folder path to the desired image location.
-
Change the image name to something representative of its purpose.
-
Click Upload.
Modify an image
-
Resize an image by dragging and dropping a corner.
-
Move an image to another location within the topic by dragging and dropping it.
-
Use Content Properties on the right side panel to modify an image’s
-
scale
-
position
-
alignment, or
-
other attributes.
-
Work with multiple topics
Split View is helpful when comparing topics, copying and pasting between topics, or dragging and dropping content from one topic to another.
-
Open two or more related topics.
-
Click on one file’s Title Tab to open the contextual menu.
-
Select Split.
-
Choose Right.
Correct typographical errors
-
Locate the word or phrase containing the error.
-
Press and hold Ctrl.
-
Click the secondary mouse button on the error.
-
Select the correct spelling.
The error has been corrected in the topic text.
Download a topic PDF
Users may want to download a PDF of the current topic to mark up or share with others.
-
Click Preview at the top right of the screen.
-
Click the PDF icon above the topic. A dialog appears.
-
Fill in the information for either Transformation Name or DITA-OT Command Line Arguments if required. Note that a PDF still generates if all fields are left blank.
-
Click Download. The PDF generates.
-
Use available icons to configure, download, or share the PDF topic.
Locate a topic in the Repository or Map
-
Open the topic.
-
Click the secondary mouse button on the Title Tab.
-
Select Locate In.
-
Choose either Repository or Map to jump to the desired topic location.
Version a topic
-
Make a change to a topic.
-
Save the topic.
-
Click the Repository icon on the top left menu.
-
In the dialog, add Comments for New Version.
-
Click Save.
The version number updates.
Load version labels
Trying to track a topic’s state based on only the Version Number can be difficult. Labels make it easier to identify the exact state of a topic that has undergone multiple revisions.
-
Select a Folder Profile.
-
Within the Folder Profile, configure the XML Editor.
a. Select Edit at the top left of the screen.
b. Under XML Content Version Labels, either add a new topic or use an existing one.
-
Select Upload.
-
Choose a file such as ReviewLabels.json or similar. Details on how to create such a file are covered in another video.
-
Click Open.
-
Click Save at the top left of the Folder Profile screen.
-
Click Close at the top right.
Version labels are now loaded.
Assign version labels
-
Load version labels.
-
Click the User Preferences icon at the top left of the current topic.
-
Select the same Folder Profile where version labels were previously loaded.
-
In the User Preferences dialog, ensure the Base Path references the same information the Folder Profile has been applied to.
-
Click Save.
-
Version the topic.
-
Add a comment and select a version label from the dropdown.
-
Click Save.
The version number updates.
View version history and labels
-
From the left panel, locate the current topic title.
-
Click on the title to open the contextual menu.
-
Select View in Assets UI.
- The version history with labels is displayed on the left.
-
Click on a version to access options such as Revert to this Version and Preview Version.
Create a new template
Templates exist for both topics and maps. Administrators can access Templates in the left panel.
-
Click Templates in the left panel.
-
Select either Map or Topic to open the associated contextual menu.
-
Click to add the new template.
-
Populate the fields in the resulting dialog.
The shell template appears, containing sample content and a sample structure.