GitHub Macros for Confluence (Appfire)

Capable recognises 4 macros from GitHub Macros for Confluence (Appfire): 2 convert, and 2 are reported and left as they are.


#About the app

GitHub Macros for Confluence is an Appfire app that shows content from GitHub on Confluence pages.

Authors can show a file, a rendered Markdown file, a list of issues or a list of pull requests from a repository.

#How Capable is different

  • GitHub File and GitHub Markdown become the Capable Git macro, pointing at the same repository, path and branch, tag or commit.

  • The hide line numbers setting carries over.

  • A GitHub File set to show only some lines is left unchanged and reported, because Capable shows the whole file.

  • Access tokens saved with the app do not carry over: for private repositories, each person connects GitHub in Capable.

  • Issue lists and pull request lists have no Capable equivalent and stay as they are.


#At a glance

Macro

In Capable

Support

GitHub File

Capable Git file

Partly converted

GitHub Markdown

Capable Git file, rendered as Markdown

Converted

GitHub Issue List

Not converted

Reported only

GitHub Pull Request List

Not converted

Reported only

#New in this release

  • Macros saved by the current version of the app now convert, not only those on older or imported pages.

  • A GitHub Markdown macro that holds only a GitHub link now converts.

  • The hide line numbers setting is now honoured after conversion.

  • A second copy of the same macro on a page converts too.

  • A macro inside a section and column on an imported page now shows after conversion.

  • A macro with a malformed link is reported instead of stopping the rest of the page.


#What each one does

#GitHub File

Becomes

Capable Git macro showing the same file

Support

Partly converted

A file set to show only some lines is left unchanged and reported, because Capable shows the whole file.

Carried over

  • Repository, owner and file path

  • Branch, tag or commit

  • Hide line numbers

  • Syntax highlighting from the file type

Not carried over

  • Line ranges

  • Access tokens saved with the app

#GitHub Markdown

Becomes

Capable Git macro rendering the same Markdown file

Support

Converted

Carried over

  • Repository, owner and file path, or the GitHub link

  • Branch or tag

Not carried over

  • Access tokens saved with the app: for private repositories each person connects GitHub in Capable


#Detected but not converted

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

#GitHub Issue List

Becomes

Not converted

Support

Reported only

Capable has no issue list macro, so it stays as it is.

#GitHub Pull Request List

Becomes

Not converted

Support

Reported only

Capable has no pull request list macro, so it stays as it is.



Files and markdown convert. The rest is reported.