Flare 2020 r2 Release Notes

 Article #: GEN1064F  Product: Flare   Version: 2020 r2

Summary:

Build 16.1.7573

Release Date: 10/5/2020

New Features

  • Definition List Support

  • List Enhancements

  • Micro Content Styles

  • Styled Variables

  • MadCap Connect for Salesforce® Enhancements

  • MadCap Connect for Zendesk® Flexible Hierarchy Support

  • Azure DevOps Source Control Support

  • jQuery Updated to 3.5.1 for Online Outputs

  • Include Only Topics Linked from TOC for Online Outputs

  • Accessibility Improvements for Tables in HTML5 Output

Structural Changes for HTML5 Output

There are no structural changes to HTML5 Output in this release, but there is a change to how variables are included in the output as well as new attributes included in the child div under div class="body-containter">.

Prior to 2020 r2, variables were wrapped in a span with class VariableFileNameVariableName. For example, if the variable set file name is MyVariables, and variable name is Company - the variable was wrapped in a span element when included in HTML5 output (e.g. <span class="MyVariablesCompany">. If the variable set file was nested under a folder, then the class also included the folder name - such as <span class="MyFolder/MyVariablesCompany">.

Starting in 2020 r2, span elements wrapping variables will include additional mc-variable and variable selectors and also a period to separate the variable set filename and the variable name. This change was necessary to support the new styled variables feature. The format for variable span classes is now mc-variable VariableFileName.Variable Name variable. Using the same example as above, the variable will now be included in HTML5 output wrapped in a span element with class="mc-variable MyVariables.CompanyName variable". If the variable set file is nested under a folder, then the class also includes the folder name - such as class="mc-variable MyFolder/MyVariables.CompanyName variable.

Also in 2020 r2, additional attributes are included in the child div under div class="body-containter">. Prior to 2020 r2 , this div had attribute data=mc-content-body (e.g. <div data-mc-content-body="True">). In 2020 r2, height-container and height-container-sidenav selectors are included along with a min-height style attribute (e.g. <div data-mc-content-body="True" class="height-container-sidenav height-container" style="min-height: calc(100vh - 199.1px);">).

JavaScript Changes for HTML5 Output

Updated jQuery to 3.5.1 and other security improvements. Several accessibility improvements have also been included in HTML5 output which are applied via JavaScript at runtime.

  • aria-current="true" attribute applied to the selected TOC entry when the option “Automatically Synchronize TOC” is enabled for the primary skin

  • scope=”col" attribute applied to table header cells <th> included within the table header tag <thead>

  • scope=”row" attribute applied to table header cells <th> included within a table row <tr>

MadCap Connect for Salesforce® Enhancements

Major improvements were made for MadCap Connect for Salesforce®. As part of the changes, the default URL Names for published articles (published from earlier Flare versions) will be modified using Flare 2020 r2. This change was necessary in order to support new features and provide a more consistent publishing experience. However, if the older URL Name is desired, that can be accomplished by using the new URL Naming option and selecting to use CSH identifiers. This new option provides a way to map the articles to their desired URL Name. More information is available at this help topic.

Bug Fixes

The following is a list of customer-reported issues that are fixed in Flare 2020 r2. This release we focused on improving list usability and functionality along with other feature additions to Flare 2020 r2. To read more about the new features, please visit our What's New topic.

Central Integration Fixes

146724 - Unreferenced/stale files deleted through reimport continue to be pulled from Central

163705 - Files deleted by project import are not deleted from the repository after changes are pushed

Code Snippet Fixes

160717 - Borders for table <td> tags are inherited by code snippets in print output

161272 - Code snippet Copy button takes user to top of page in Tripane output

161495 - Font-family styles for <td> tags are inherited by code snippets in print output

162625 - Unexpected undo and redo behavior in the Code Snippet Editor

162960 - Code snippets display columns of text unevenly

HTML5 Output Bug Fixes

51625 - Topic popups can only be closed on iPad browsing to another page from the TOC

82139 - Hyperlink to top of the current document works incorrectly after the first use

88952 - Hyperlink to bookmark in dropdown does not go to bookmarked location

101655, 160940 - Search, CSH calls, and slideshows do not work for frameless output viewed through an iframe

105720 - Not able to customize the message that search was not properly formatted in HTML5 output

116583 - Glossary terms are incorrectly converted when used in a cross-reference

123598 - Use of a master page results in loss of custom JavaScript embedded in topics

129628 - Use of multiple master pages for an output result in master page files being incorrectly included in the output

132045 - When search includes a repeated word, clicking to remove search highlight deletes the word from the topic

132175 - Background image set in the stylesheet incorrectly removed from output when using options to "Generate web-safe images,” "Exclude content not linked directly or indirectly from the target,” and mc-condition property is applied to a style class.

134859 - Next and previous topic buttons do not work for Top Navigation output hosted on Apache Tomcat server when using option to “Synchronize navigation elements with TOC entries”

137431 - Heading links generated using option to “Compute TOC sub-entries from linked file” do not work if the heading includes quotation marks

138420 - Meta tags are not included in the output when toggling, then saving changes to the option to "Add meta tags to content”

138724 - Build failed with "parameter is not valid" error when SVG images are used for dropdown icons

142372 - Long strings in glossary term definitions run beyond the edge of glossary popup windows

148859 - Option to include Mark of the Web does not work for default.htm in multilingual output

152451 - Cross-reference to bookmark in different topic does not scroll to correct position in Side Navigation output when Powered by MadCap Software is enabled

154367 - Topic heading links in the menu proxy are not responsive to page scrolling in a specific project

154474 - Cross-reference to bookmark in a table in different topic does not work correctly in Side Navigation output

155407, 156354, 158785 - Use of a master page results in loss of some attributes for link and script elements in the output

155568 - Invalid element property: ToolbarItem.ExpandAll/AltText and CollapseAll/AltText console errors when a topic toolbar is used in German output

156498, 159152 - Extra space above bookmarks when selected from side navigation menu

156543 - Link to bookmark does not work if the bookmark name matches a named element on the same page

157835 - Security scan issues for HTML5 output

159527 - Side Navigation TOC links to bookmark within a table do not go to the correct location when using Chrome

160252 - Missing breadcrumb when using option to "compute sub-entries from linked file,” and sub-heading uses mc-auto-number-format with two spaces at the end of the format

162336 - No ARIA label to show the active TOC entry for frameless HTML5 output

162721 - Unable to build skinless HTML5 target when there are no skins in the project

163950 - Canonical links applied to master page overwrite canonical links applied to topics

List Fixes

20689 - Invalid XHTML created when pasting web content as list in the XML Editor

26995 - Indenting a list item under a snippet makes the list item become part of the snippet causing malformed XML

30223 - Error when indenting list items that span across different levels

30861 - Unbinding paragraph list items creates nested paragraph tags

32302 - Incorrect position of bullet when a table or multi-line snippet block is used as the list item

35674, 35680 - Incorrect list structure when outdenting a paragraph list item

35675, 50149 - Not able to set paragraph list items as the default

35677 - Incorrect result when pasting a list item inside another list item

36603 - Unexpected results when using backspace to delete paragraph list items

48497 - Ability to sort a list at build time

49988 - Start value is not removed from lists markup after it is set to continue sequence

50046, 50818 - Continue sequence does not work after an unordered list

52088 - Incorrect page breaks when page-break-inside: avoid are applied to <li> and <ol> elements

55014, 136405 - Not able to create snippet from only a portion of a list

81754 - Unordered list items should not include value attributes in HTML5 output

86038, 129928 - Not able to change list type or make into paragraph list for group of list items that spans across a page break

97701 - Continue Sequence does not automatically refresh and update when previous list item is indented

99922 - List incorrectly duplicates when it spans across a page break and grouped into a <div>

102509 - Wrapping a div around part of the list items in an ordered list causes numbering to restart

105801, 134468 - Incorrect behavior with copying and pasting from list items without parent <ul> or <ol> tags

122754 - Not able to convert to paragraph list items when list contains nested lists

130980 - Incorrect numbering when non-<li> tags are included as children of an <ol> tag

137829 - XML Editor renders list items incorrectly when padding style is applied to <li> tag

155574 - Continue sequence markup remains on list after being changed to an unordered list from the ribbon

160582 - Loss of list content after using backspace key for space between <li> and <span> tag

163324 - Merge with list option incorrectly enabled when list is above or below a <div> tag

163328 - Not able to undo list sort using CTRL + Z

163337 - “Sort on compile” should be changed to “Sort on build”

MadCap Connect for Salesforce® Fixes

129914 - Links to hosted or shared PDF/files do not display in published articles

129941 - Style borders for various elements are not shown in published articles

130668 - “DUPLICATE_VALUE - The URL Name cannot match the draft or published version of any other article" error when publishing same topics from two targets with different categories selected

133959, 145272, 150009 - DUPLICATE_VALUE error when publishing topic and various edits were previously made for the article in Salesforce

144485 - URL Name for published article changes when changing destination options between publishes

149791 - DUPLICATE_VALUE error when publishing to Salesforce after changing article type in destination settings

151476 - Ampersand characters in a topic name are stripped when published to Salesforce

153930 - Not able to choose a rich text field for published content

155026 - Unable to publish to Salesforce if a topic contain links to external images

155649 - Iframes included in topics are not included for publish to Salesforce

157591 - Alt text for images are not included for publish to Salesforce

160818 - Multiple authors are not able to update the same articles in Salesforce

MadCap Connect for Zendesk® Fixes

162079 - Zendesk theme does not use the correct stylesheet when "Preserve unsafe HTML" is not selected in the destination

163123 - Object reference error after entering credentials in Destination Editor, due to change in the API response from Zendesk

163339 - User visibility resets after saving, closing, and reopening the destination file

163615 - Republishing creates duplicate images and log files for the article on Zendesk

163768 - Unable to publish when using the target option "Do not use ‘content’ folder in output"

163983 - Publish failed when using HTML5 output with an index term linked to over 300 articles, and index was chunked during compile

Source Control Fixes

146029 - Unable to import or bind to non stream-enabled depot in some Perforce servers

146686 - Renaming flprj file of Git-bound project results in multiple flprj files

150869 - Moving files in large Git-bound project bound can result in loss of file statuses

157259 - Option to “Send to File Issues Viewer” does not work from Pending Changes window

157426 - "Version control client could not be initialized" error when attempting to connect to Azure DevOps URL

Topic Preview Fixes

149094 - Topic toolbar used in topic preview breaks the topic toolbar in HTML5 Output

160931 - Popup thumbnail images do not work correctly in topic preview

161147 - Slideshow no longer appears in topic preview

161300 - Toolbar buttons no longer work correctly in topic preview

Variable Fixes

26914, 39645 - Not able to apply span styles to variable text

33142, 45840, 47739, 88342 - Not able to apply variable styles in generated outputs

56804 - Incorrect markup applied after applying a span class to variables or equations

159804 - Custom style class incorrectly applied to a variable if part of the variable name matches the name of the custom class

163537 - Exception thrown when inserting variable from an empty variable set

Miscellaneous Fixes

143273 - Delete stale files does not work for Flare project import when using option to "auto-exclude non-tagged files"

143274 - When importing from a Flare project based on conditions, using option to auto-exclude non-tagged files, the non-tagged files are reported as unreferenced files

156228 - Add File dialog opens too small for the list of templates to display on systems with HiDPI

158166 - Relationship links in Clean XHTML output show the filename instead of the heading

159620 - Console.FMClient.exe has stopped error working when importing FrameMaker 2019 files to Flare

160669 - Double-clicking variable and condition tag sets expands and opens the set when it should only open the file editor.

160688 - Selecting a line in the text editor doesn't select correct line in the XML Editor

160707, 160734 - Exception occurs when inserting character in front of text with an inline tag applied

161337 - Exception occurs when double-clicking a changed word in the Find Results pane

161366 - Not able to repeatedly close topics using CTRL + F4

161486 - Keyboard shortcut Alt+Shift+C displays <menu title> instead of "Collapse elements”

162803 - Error when hovering over collapse tag arrow when topic has <![CDATA[ ]]> between block tags

Documentation Fixes

147676 - Add note that Flare needs one repository per project

159154 - Typo for a word in the “Using the People Menu” topic

159720 - “Enabling Glossaries in Skins” topic should specify which outputs are supported

163217 - Improve Elasticsearch installation documentation

163402 - Add note on how to modify Flare installation to add Zendesk support

Attribution:

Last updated:

10/5/2020

Author:

Marvin Mallari

Contributions by:

MadCap QA