ComboStrap - Release 1.24

About

This is the release documentation of the ComboStrap version 1.25.

The main information is that this release brings:

• two new slots:
  • the main footer (below the main content slot)
  • the main header (above the main content slot)
• a carrousel layout (with image gallery)
• a image Lightbox
• social share and follow buttons
• branding colors (primary, secondary)
• and much more…

Actions

This are the actions that you need to take:

• Follows the update steps
• Optional: The old renderer hierachical breadcrumb has been deleted. If you want to have a hierarchical breadcrumb, you should add the new hierarchical breadcrumb component in the new slot main header

List

New

• New documentation for the main slot (content)
• Two new slots:
  • the main header slot at the top of the main slot
  • the main footer slot at the bottom of the main slot
• The hiearchical breadcrumb has now its own syntax component.
• The hierachical breadcrumb in the renderer is deprecated.
• Added a lot of Icon Libraries from elegant theme, IconScout, Iconoir, Core Ui Brand, … to eva icons
• You can now add more than Share Buttons for instance in the footer slot
• We have added a preserve attribute to overwrite the default svg optimization on style. More … see Support - Why is my svg / icon not rendering correctly ?
• You can now set your branding colors (primary and secondary) that brings a more cohesive styling on all solid component (filled)
• The icon is now branding color aware. It will take by default the color:
  • the primary color if the width is bigger than 36 pixel
  • the secondary color otherwise.
• do page style. The admin and media manager got their style from the snippet manager. (Tabs were styled, bullet were deleted, icon got the primary value)
• The branding color are now inherited by default.
• Added the edit button for the slots and styled them.
• New: the Cache viewer permits to see cache information of the slots.
• New: lightbox. When clicking on a image by default, a lightbox is showing up.
• The head pipeline function got a new parameter: the tail string. This string is added if the input string was cut.
• Added the zoom factor on svg. This attribute is mostly used on icon to make them illustrative image.
• We now supports multiple colors icons

Change

• The default color of icon, button is the primary branding color
• The primary and secondary color of bootstrap are overwritten by the branding colors if set up.
• The default ratio for a card image is now 16:9.
• The dokuwiki configuration useHeading is no more taken into account. See the dedicated support page

Improvement

• The linkwizard used in the search box performs a search on each term and is now case insensitive.
• Svg/Icon optimization: when a path has a fill attribute of none on icon we delete it (See new support article: Support - Why is my svg / icon not rendering correctly ?)
• For a solid icon, if the color is set, we delete all fill attribute in path element.
• For a outline icon, if the color is set, we delete all stroke attribute in path element
• Internal: Added the notion of markup ref in the link in order to be able to call the link component to add link that comes not from the content, (ie share link)
• The brand component has been improved and supports all brand icon included the brand of the actual app. It can be seen as a super interwiki that follows the branding.
• The manifest got:
  • an automatic test
  • the primary branding color
  • an id (now required)
  • any sizes on svg to bug fix the value set by dokuwiki (17×17, 512×512)
• The svg illustration were shrinking on a table with the css property width: auto !important;: we have added the width attribute in this case.
• The illustrative image in a card will stretch to take the whole horizontal space (if too small, we get a blur effect but not white space).
• Cache expiration does not purge the cache of the actual requested page. It creates a request for a new rendering that is done in the background improving the performance.
• The eva and carbon icon library are now optimized. They got rectangle in their source that was appearing as completely black. The rectangle is now deleted.
• The snippet system has been completely revamped to get more consistent output and easier snippet declaration.

Bug

• The snippets could be missing randomly. The snippets are now saved at the same time than the slot html output, making it less likely to miss if the rendering is stopped inadvertently.
• When the page url was permanent, the page info were not refreshed. The rev was not up to date and the edit button would not see that the page may have changed via the metadata manager (frontmatter)
• Admin / Media manager page:
  • they were not working correctly and were sending back junk. This was caused because the output is mainly generated by echo statement and the buffer was quickly full. We start the action that are not show now in the middle of the page.
  • they could use markup syntax and the css/javascript snippet were therefore not present. The snippet are now flushed in the content if this is not a page rendering.
• The page replication in the database was broken because the test was not checking the database replication date against the page date.
• The non-outline heading description cames into the toc, modifying the previous outline heading.