Refined Toolkit for Confluence (Formatting)

Capable recognises 16 macros from Refined Toolkit for Confluence: 14 convert, 8 of them partly, and 2 are reported only.


#About the app

Refined Toolkit for Confluence is a macro collection from Refined, offered for Data Center and Cloud.

It adds tabs, expands, steps, panels, buttons, news, page trees, activity streams, countdowns, banners, backgrounds and LaTeX to pages.

#How Capable is different

  • Tabs, expands, steps and panels become native Confluence content, so they display without any app installed.

  • Tabs become stacked expands, one per tab: the tab strip, orientation, colours and tab icons do not carry over.

  • Every converted expand starts closed; open by default, only one open, colour variants and icons are not kept.

  • Buttons, banners, countdowns, LaTeX and backgrounds become Capable macros; a button inside a sentence moves to its own line below it.

  • Older Data Center and current Cloud versions of each macro are found and converted in the same run.


#At a glance

Macro

In Capable

Support

Tabs

Native Confluence expands, one per tab

Converted

Expand

Native Confluence expands

Converted

Steps

Numbered native table, one row per step

Converted

Panels

Native Confluence panel

Converted

XHTML text box

Native Confluence panel

Converted

LaTeX

Capable LaTeX

Converted

Background

Capable Background

Partly converted

Refined Button

Capable Buttons

Partly converted

Banner

Capable Banner with one slide

Partly converted

Countdown

Capable Countdown

Partly converted

News

Native Confluence blog posts list

Partly converted

Page Tree

Native Confluence page tree

Partly converted

Activity Stream

Native Confluence recently updated list

Partly converted

Child Pages

Capable Search or Capable Search Cards

Partly converted

Custom Code

Stays as it is

Reported only

Jira Work Items

Stays as it is

Reported only

#New in this release

  • A panel on an imported Data Center page now stays converted after the page is saved.

  • Copies of the same macro on one page are each converted, not just the first.

  • Activity Stream, News, Page Tree, Button and Child Pages inside imported Data Center content are now found and converted.

  • The older Activity Stream macro now keeps its space and label filters.

  • An expand that would land inside a native panel becomes a bold title with its content, so the page saves cleanly.


#What each one does

#Refined Button

Becomes

Capable Buttons

Support

Partly converted

Capable buttons sit on their own line, so a button inside a sentence moves below it.

Carried over

  • Label and link

  • Size: small, medium and large

  • Colour, mapped to the closest Capable style

  • Icons on current versions

Not carried over

  • Tooltip, except as the label of an icon-only button

  • Colour on outlined and plain buttons

  • The default grey, which becomes the blue default style

Before: Refined

Refined Button with default settings: grey, medium size.

After: Capable

A Capable button with the same label and link, shown in blue rather than grey.
A Capable button with the same label and link, shown in blue rather than grey.

#Tabs

Becomes

Native Confluence expands, one per tab

Support

Converted

Carried over

  • Tab titles and everything inside each tab

  • Expands and tabs nested inside a tab, as nested expands

Not carried over

  • The tab strip: tabs show as stacked expands

  • Orientation, colour and tab icons

Before: Refined

Refined Tab Container with three tabs.
Refined Tab Container with three tabs.

After: Capable

Three native expands, Overview, Accounts and FAQ, each holding its tab's content.
Three native expands, Overview, Accounts and FAQ, each holding its tab's content.

#Expand

Becomes

Native Confluence expands

Support

Converted

Carried over

  • Titles and content of every item

  • Tabs nested inside an item, as nested expands

Not carried over

  • Open by default: every expand starts closed

  • Only one open at a time

  • Colours, style variants and item icons

Before: Refined

Refined Expand Container with three items, the second open by default.
Refined Expand Container with three items, the second open by default.

After: Capable

Three native expands with the same titles and content, all closed.
Three native expands with the same titles and content, all closed.

#Steps

Becomes

Numbered native table, one row per step

Support

Converted

Covers Step Container and Stepper.

Carried over

  • Each step's content, including lists

  • Number, letter or Roman numeral labels

  • Stepper step titles, as a bold first line

Not carried over

  • The step or stepper visual

  • Orientation, colours and progress tracking

Before: Refined

Refined Step Container with three numbered steps.
Refined Step Container with three numbered steps.

After: Capable

A native numbered table, one row per step; the list in step 2 is kept.
A native numbered table, one row per step; the list in step 2 is kept.

#Panels

Becomes

Native Confluence panel

Support

Converted

Carried over

  • Panel type: info, note, success, warning and error

  • Tip and default types, as custom panels with a colour and icon

  • Panel title, as a bold first line

Not carried over

  • Outlined style

  • Icons with no native match

  • Exact colour: the cyan note panel becomes the purple native note

Before: Refined

Refined Panel, Info type.
Refined Panel, Info type.

After: Capable

A native info panel with the same text and list.
A native info panel with the same text and list.

#XHTML text box

Becomes

Native Confluence panel

Support

Converted

The older Data Center text box converts the same way as Panels.

Carried over

  • Panel type and content, including formatting

Not carried over

  • Exact colour where the native type differs

Before: Refined

XHTML text box from a Data Center import, Note type, cyan.
XHTML text box from a Data Center import, Note type, cyan.

After: Capable

A native note panel with the bold text kept, purple rather than cyan.
A native note panel with the bold text kept, purple rather than cyan.

#Background

Becomes

Capable Background

Support

Partly converted

The oldest Cloud version of the macro becomes a grey native panel instead.

Carried over

  • Background and text colour

  • Border and corner radius

  • Padding and text alignment

Not carried over

  • Any other custom CSS, which is listed in the run report

Becomes

Capable Banner with one slide

Support

Partly converted

Carried over

  • Image, caption and alt text

  • Corner radius

Not carried over

  • Whole-image link, which becomes a button opening in a new tab

  • Fixed height

  • Inverse caption colour

  • Refined's bundled default image

#Countdown

Becomes

Capable Countdown

Support

Partly converted

Carried over

  • Date, time zone and title

  • Message shown after the end

  • Size, colour, alignment and seconds

Not carried over

  • Gauge style, shown as rings

  • Rounded style, shown as tiles

  • Named colours become fixed colour values

#LaTeX

Becomes

Capable LaTeX

Support

Converted

Carried over

  • The formula

  • Left, centre or right alignment

#News

Becomes

Native Confluence blog posts list

Support

Partly converted

Carried over

  • Space and label filters

  • Number of posts

  • Title, as a bold line above, on current versions

Not carried over

  • Image feed and slideshow layouts, shown as a list

  • Profile pictures

  • Creator filter and advanced queries

  • Title on older versions

#Page Tree

Becomes

Native Confluence page tree

Support

Partly converted

Carried over

  • Space home or current page as the root

  • A root page in the same space

  • Title, as a bold line above, on current versions

Not carried over

  • Title on older versions

  • A root page in another space or a folder: left as it is and reported

#Activity Stream

Becomes

Native Confluence recently updated list

Support

Partly converted

Carried over

  • Space, label and content type filters

  • Number of items

  • Title, as a bold line above, on current versions

Not carried over

  • Contributor filter and advanced queries

  • Title on older versions

#Child Pages

Becomes

Capable Search or Capable Search Cards

Support

Partly converted

The list view becomes Capable Search and the cards view Capable Search Cards; details are on the Search page.


#Detected but not converted

These are counted so you can see how many you have. They stay on the page exactly as they are.

#Custom Code

Becomes

Stays as it is

Support

Reported only

Capable has no macro that runs custom code.

#Jira Work Items

Becomes

Stays as it is

Support

Reported only

Capable has no Jira query macro.



Native beats a macro, where native will do.