Creating a Map

A map is an organizational tool that allows you to add and organize information in a hierarchical structure. Here, you will learn to create a map and organize content within it.

You can download example dita files from here:

  1. Documents-with-Visual-Content.dita

  2. Working-with-Tables.dita

Uploading map components

If desired, you can upload some local sample files into AEM for a more complete set of materials.

  1. Drag and drop any local files into AEM to upload them.
  2. Repeat as needed for any files, including images and topics.

Creating a map

  1. Select the ellipsis icon on your main folder to open the Options menu.

    Ellipsis icon

  2. Select Create > Map.

    Create map

    The Create New Map dialog displays.

  3. In the Template field, select Bookmap from the drop-down menu and give your map a title.

  4. Select Create.

    Your map is created, and the left rail automatically changes from the Repository view to the Map view.

Inserting map components

  1. Select the pencil icon in the left rail.

    ![Edit icon](images/lesson-8/pencil-icon.png

    This is the Edit icon, and allows you to open the map in the editor.

  2. Switch back to Repository view by selecting the Repository icon.

    Repository icon

  3. Add a topic to the map by dragging and dropping it from the Repository into the map in the editor.

    The line indicator will show you where your topic will be placed.

  4. Continue to add topics as needed.

Viewing a map preview

Preview provides a quick look at the content using default formats. It displays the headings, paragraphs, lists, and any other content in the topics is shown.

  1. Select Preview from the top black menu bar.

    Preview button

Your content opens in Preview.

  1. To return to Author View and resume map editing, select Author.

    Author button

Configuring map structure

You can edit the hierarchy of topics inside the map.

  1. Click a topic's icon to select it.

  2. Use the Move Right and Move Left icons to demote and promote elements respectively.

    Repository icon

Saving the map as a new version

Now that the map is complete, you can save your work as a new version and record your changes.

  1. Select the Save as New Version icon.

    Save as New Version icon

  2. In the Comments for new Version field, enter a brief but clear summary of changes.

  3. In the Version Labels field, enter any relevant labels.

    Labels allow you to specify the version you want to include when publishing.

    NOTE

    If your program is configured with predefined labels, you can select from these to ensure consistent labelling.

  4. Select Save.

    You have created a new version of your map, and the version number is updated.

On this page