Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Navigate to Settings > Manage apps > Github Macros for Confluence. Then, click Configure to open the app configuration page.
  •  Select Or, select Github Macro for Confluence Configuration under Atlassian Marketplace in the panel on the left.

...

Enter a name for the token and click Create new Link. An intermediate page is then displayed.

Image Modified

Check the address of the Atlassian cloud instance and token name. After verifying the details, press Start workflow. You are then redirected to the Github authorization page.

Image Modified


Click Authorize and the token page is now displayed. After the authentication is completed, you can enter the number or a number range of the code lines to be displayed in the Github File macro. 

Note
titleAbout the Limit the number of lines parameter:
  • If you want to display only certain lines of code, specify the limit of the code lines to be displayed and click Submit. You can specify range or number of maximum lines to be displayed. For example: 5, 2-25.

  • This parameter in the global configuration page is applicable only for the Github File macro. 
  • You can hide the line numbers displayed in code block. To hide go to GitHub file macro and select the Hide line numbers of code block checkbox.
  • The Limit the number of lines parameter set in the macro editor has higher precedence than the global configuration parameter. Thus, the parameter behaves as follows:

    Is the global parameter set?Is the macro parameter set?Behaviour
    YYThe code lines limit is taken from the macro parameter and the specified number or number range of lines are displayed regardless of the value set in the global parameter.
    YNThe code lines limit is taken from the global configuration parameter and the macro displays the specified number or number range of lines.


You are now ready to get started with the macro!

Available macros

  • Github Pull Request List
  • Github Issue List
  • Github Markdown File
  • Github File Content

Using the macro

Here is an example of the Github Issue List macro filled out. The example contains details linking to a public repository so you can copy the values to try it out.

Image Removed

To use the macro, you must select your token from the dropdown. Enter the user name or the organization name, and the name of the repository to retrieve information from. 

Pull requests and issues have a query field. You can use Github's Query language to select pull requests or issues you want to displayRefer to the Macros page to learn more about the macros.