Release Notes | Adobe Experience Manager Guides 3.6

Disclaimer:

Adobe Experience Manager Guides was formerly branded as XML Documentation for Adobe Experience Manager. Please note certain references within the documentation may still refer to prior branding but are still applicable to the current offering.

New features and enhancements in 3.6.6 release

• Translation: Changed the default value of the "Component-based translation" flag to false. This will only impact new installs.
  
  
• Files with a name pattern such as "GUID-*" caused exceptions in the file loading code causing failures on all features that tried to load a file with such a name. Fixed this by making sure that this pattern is initialized to an invalid value in non-uuid builds, so that it never matches an actual file.
  
  
• Fixed the index entry /oak: index/effectiveSourcePath so that it doesn't overwrite the /oak:index/sourcePath node.
  
  
• Fixed an issue with the DIRECTNONKEYEDREFS HTTP API that caused it to return an empty response.
  
  
• Fixed an issue in Post Processing of DITA files that prevented extraction and caching of conrefs without an anchor tag.
  
  
• Fixed a conflict issue that prevented Publish Listener from starting up whenever any hotfix/service pack that updates a DoX related bundle is deployed.
  
  
• Added a control flag "Set ditamaps updated on topic updates" in (/system/console/configMgr/com.adobe.fmdita.config.ConfigManager) with a default value of "False (Unchecked)" to control updating the ditamap "contentLastModified" property every time a topic in the DITA map hierarchy is modified. Also added more logging to Post Processing.
  
  
• Map Dashboard page can now be overlaid from the /apps folder.
  
  
• Fixed an issue faced while exporting baselines of a map having references above the language folders.
  
  
• With this fix, the published zip from any DITA map using html5 preset is an asset and is explorable in the asset view page.
  
  
• While moving the folders, the screen shows a blank page on step 4 Closed - Updated the moveassetwizard.js file to reflect changes in this file due to AEM 6.5 service pack.
  
  
• Fixed an issue where the link patching API was not called prior to fetching version binaries of DITA files such as in baseline publishing, version preview.
  
  
• Changed queries to use dam:Asset instead of dam:AssetContent to leverage indexing support for the former.
  
  
• Added additional checks to prevent queries being triggered on entire repository.
  
  
• Fixed the issue when you don't provide DITAVAL file with STS settings, our API was not communicating the STS file to FMPS server. So it was always using the default STS in that case.
  
  
• Fixed the issue where on DITA map report page, edit mode is not displaying STS file selected for html5 and EPub output types.
  
  
• Fixed merged cells of table getting distorted when importing word document
  
  
  

New features and enhancements in 3.6 release

There are a number of new features and enhancements introduced in the following areas of the product. 

Web Editor

• Access the Web Editor directly from the AEM's Navigation page. 

• Access the DITA map console directly from the context menu of a .ditamap file.

• Assign friendly names to DITA elements and attributes.

• Restrict the elements and attributes to a limited set.
• Quickly access your most frequently used or work-in-progress files and folders by adding them to your favorites collection.  

• Directly search your files from the Repository View. You can also apply filters to restrict your search to a particular folder in the repository, DITA files, or image files only. 

• New Reusable Contents panel has been introduced to help you author quickly. You can easily add your most frequently used common content to this panel and add it in your document with a simple drag-and-drop. 

• Add your glossary terms to the root map and it appears in the Glossary panel from where you can easily insert it in your document. 
  
• See the content updates made in your map or topic files by opening it in the Preview mode.
• Merge content updates made by different authors or across different versions of your map or topic files. The merge feature gives you options to see changes using the track changes mode, wherein you have the option of accepting or rejecting changes. Or, you can revert to a particular version of the map or topic file directly.   

• Use the spell checker inbuilt in your browser or AEM server.
• As an administrator, you can create conditional presets directly from the Web Editor. The new Conditions panel gives admins an easy and quick access to configure the foreground and background colors for conditions. 
• Authors can easily apply conditions in their topics by simply dragging and dropping conditions on the content. 
• As an administrator, you can define snippets. These snippets are shown in the Snippets panel from where authors can use them in their content. 
• Use the global search and replace feature to find and replace content in a particular folder in your repository or search the entire repository.    
• As an administrator, you can now create topic and map templates directly from the Web Editor. Use the Templates panel to create and store new templates. 
• Use the UI theme to Dark or Light to suite your work environment. 

• Insert the <mathml> element to launch the MathML equation pod. The intuitive interface of the MathML equations pod allows you to easily create complex mathematical or chemical equations and insert them in your document.  

• Insert images directly from your local system by dragging and dropping an image from your file explorer to your topic. You can also specify the location where the file is uploaded. 

Enhanced features in the Web Editor

• The following improvements have been made in working with tables:
  • Use the up and down arrow keys to move between rows.
    
  • Pasting data using Crtl+v in the last column of a table will not move to the next row.
    
  • Applying valign alignment to any table entry is immediately visible.
  • Deleting an element from a table cell by placing the cursor on the table cell works seamlessly.
    
  • Select <xref> element when placed inside merged cells.
    
  • Merged cells render properly when used in combination with insert rows/columns.
  • Create a line within the same cell by pressing the Enter key in a cell with text.

The following enhancements are now available while working in a list:

• You can configure to add a new list item <li> along with a <p> element.
• Use the Tab key within a list to create a sublist. Similarly, Shift+Tab shifts the list item one left up.
• Nested paragraph element within a list is indented properly. 
• Removing inline elements like <i>, <b> is recorded and made available in track changes.     

The following improvements are now available in track changes:

• Adding and removing formatting changes are tracked properly and are not shown as text insertion.
• Keyboard tab entry is tracked by the undo and redo operations.
  
• Tracking new paragraph insert made the existing paragraph as inserted.
  

Some more enhancements in the Web Editor are listed below:

• Ability to start the review task directly from the Web Editor.
• Tab key is now considered in undo/redo operation for a list and table.
  
• Better navigability through improved navigation icons in the Repository, Map, and Favorites panel views.
• The prompt message when the user is creating a version of the document is now improved.
  
• Option to check out a map from the Map panel is added and a different icon is added for Cancel Checkout.
• The user name is now shown on a checked-out topic's file tab's tooltip on mouse hover.
  
• Generate ID works on multiple selected elements.
  
• While adding an image as <xref>, the user will be able to preview the image.
  
• If a map has keydefs only, then even without the check-out user will be able to preview the map.
  
• When an SVG is created using a keyref, the image is shown in the Web Editor in Author and Preview modes.
• Administrators can configure the Web Editor's user interface by using the ui_config.json file, defining global-level CSS templates, setting root map, and more within the folder profiles.
  
• Navigation title for the <topichead > with <conref> is shown correctly on the map panel.
  
• You can now view markdown (.md) files in the Repository view. 
• Equations in a Word document are inserted properly in the Web Editor.
  
• By default, a map file is opened for editing in the Basic Map Editor. You can configure it to always open in the Advanced Map Editor.

Output generation

• Cancel an output generation task that is in active state (the generation is not complete yet).
• A new Publish Dashboard is now available for administrators to view the status of all active publish jobs in the system. 

• Support added for LwDITA publishing.
  
• Duplicate site node generation for the conref pages is now fixed.

Review

• Ability to add attachments to a review comment and download the attachments. 

• Issues on importing review comments when the review is opened in multiple tabs is fixed. 
  
• Review data is moved outside the workflow nodes.

Bug fixes and other enhancements

• Improvements in the Baseline tab performance.
  
• Document Status is now shown on maps and topics.
• Performance improvements on loading Map dashboard.
  
• Disable setting root maps while creating a DITA Project and editing project.
• You no longer have to clear the cache for installing the newer version of XML Documentation solution.
  
• Issues fixed on regenerating individual topics in a map.
• Issue of missing spaces between two consecutive conrefs is solved.
• The following APIs have been introduced and upgraded:
  • Introduced API for creating baselines using labels.
  • Create baseline API now handles automatic version creation. 
  • Updated the snippet configuration API.