Just Add+ for Confluence (Formatting)

Capable recognises 5 Just Add+ formatting macros: 4 convert, 2 of them in part, and AsciiDoc is reported without being changed.


#About the app

Just Add+ is a Modus Create app that renders content in Confluence from text, a page attachment or a web address.

Besides diagrams and Markdown it has macros for Swagger / OpenAPI specs, LaTeX, HTML and AsciiDoc, plus Markdown from URL, GitHub, GitLab and Bitbucket links.

#How Capable is different

  • Swagger / OpenAPI becomes Capable Swagger from the same web address, typed spec or attachment on the same page.

  • LaTeX equations become Capable LaTeX, block or inline; full LaTeX documents and web address sources stay as they are.

  • HTML becomes Capable HTML; content from a web address or attachment is copied in once and no longer updates.

  • Scripts in HTML run only once an admin turns on JavaScript in the Capable HTML macro.

  • AsciiDoc and attachments held on another page have no Capable equivalent: they stay on the page untouched and are listed in the report.


#At a glance

Macro

In Capable

Support

Swagger / OpenAPI

Capable Swagger

Converted

LaTeX

Capable LaTeX, block or inline; full LaTeX documents stay as they are

Partly converted

HTML

Capable HTML; web address and attachment content copied in once

Partly converted

Markdown from URL / GitHub URL / GitLab URL / Bitbucket URL

Capable Markdown reading the same file

Converted

AsciiDoc

Not converted, left in place

Reported only

#New in this release

  • On a copied page, an HTML, Swagger or LaTeX attachment now converts when the copy holds an identical file of the same name.

  • An attachment held on another page is no longer copied into the new macro: the macro stays as it is and is reported.

  • Migrated macros inside a classic Section or Column macro are moved out, so they show live instead of a static export; an option in the migration settings turns this off.


#What each one does

#Swagger / OpenAPI

Becomes

Capable Swagger

Support

Converted

Carried over

  • A spec typed in as YAML or JSON

  • A web address, still read live

  • An attachment on the same page

Not carried over

  • A forced dark or light theme

  • Attachments on another page: the macro stays and is reported

Before: Just Add+

An OpenAPI spec typed into Just Add+ as YAML.

After: Capable

Capable Swagger listing the same operations.
Capable Swagger listing the same operations.

#LaTeX

Becomes

Capable LaTeX, block or inline

Support

Partly converted

Equations typed into the macro or held in an attachment on the same page convert; a macro inside a line of text becomes inline LaTeX.

Carried over

  • The equation

  • Block or inline placement

Not carried over

  • Full LaTeX documents (document class, packages, sections) stay as they are and are reported

  • Web address sources stay and are reported

  • Attachments on another page stay and are reported

  • A forced dark or light theme

#HTML

Becomes

Capable HTML

Support

Partly converted

Content from a web address or an attachment on the same page is copied in once and no longer updates.

Carried over

  • The HTML

  • A leading style block, as the macro's CSS

  • Scripts, which run once an admin turns on JavaScript in the HTML macro

Not carried over

  • Live updates from a web address or attachment

  • Relative links and images from a web address

  • Attributes on the html and body tags

  • Attachments on another page: the macro stays and is reported

  • A forced dark or light theme

Before: Just Add+

HTML typed into Just Add+, shown in the browser's default serif font.

After: Capable

Capable HTML with the same cards and text, in the page font with smaller headings.
Capable HTML with the same cards and text, in the page font with smaller headings.

#Markdown from URL / GitHub URL / GitLab URL / Bitbucket URL

Becomes

Capable Markdown reading the same file

Support

Converted

Carried over

  • The web address, still read live

  • GitHub, GitLab and Bitbucket file links

Not carried over

  • Access to private repositories: files load without sign-in

  • A forced dark or light theme

Before: Just Add+

Just Add+ Markdown from URL showing a public README.

After: Capable

Capable Markdown showing the same README, including its logo; table headers are centred.
Capable Markdown showing the same README, including its logo; table headers are centred.

#Detected but not converted

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

#AsciiDoc

Becomes

Not converted, left in place

Support

Reported only

Capable has no AsciiDoc macro.



Native beats a macro, where native will do.