Macros

Owned by Smita Nair
Last updated: Mar 01, 2024Version comment
4 min read

This page contains information about the macros available with the app and the parameters available in each.

Overview of the macros

Macro name :

Description

How does it look?

(The images shown here are mainly from the cloud version and are similar in the server version.)

How would it appear on my page?

Macro name :

Description

How does it look?

(The images shown here are mainly from the cloud version and are similar in the server version.)

How would it appear on my page?

Github Issue List Macro :

Displays a list of issues from a specified repository.

gitH_cld_macro_IssuesList.png

 

gitH_cld_macro_ex_IssuesList.png

 

Github Pull Request List Macro :

Displays a list of pull requests from a specified repository based on a query, if given.

 

 

Github Markdown Macro :

Displays the contents of a Markdown file located in a specific repository.

 

 

Github File Macro :

Displays the contents of a file located in a specific repository.

 

 

Parameters

This section lists the parameters available in the macros. Unless there are any differences between the server and cloud versions, the mentioned parameters are common to both.

Common parameters

All parameters, except Query, are mandatory.

Parameter name

Description

Parameter name

Description

Github Token

Select the token to be used from the dropdown list. Contact your administrator if an error occurs or if you are unable to connect to the repository. For more information, see more in the Configuration page for server and/or cloud.

User

Enter the user name required to access the relevant repository.

In Github Markdown Macro (cloud), this parameter is available on the Enter Repository Settings tab labelled as Username/Organization Username.

Repository

Enter the repository name to be accessed.

Query

Enter a query to access the required pull requests or issues. Use the Github's Query language to choose the pull requests or issues that you wish to display.

  • This parameter is available only in the Github Issues List Macro and Github Pull Request List Macro in both, server and cloud, versions.

  • The following attributes are supported:

    • state=open : fetches all PRs which are open

    • state=closed : fetches all PRs which are closed

    • state=all : fetches all PRs

    • state=merged : fetches all PRs which are closed and merged (available only in Github Pull Request List Macro)

    • state=closed,unmerged : fetches all PRs which are closed but not merged (available only in Github Pull Request List Macro)

Other parameters

The following parameters are available to specific macros:

Parameter name

Available in which macros?

Description

Parameter name

Available in which macros?

Description

URL

Github Markdown Macro (cloud)

Enter the URL of the Markdown file to be accessed. Click the Check button to verify the file path.

Branch or Commit Hash

Github Markdown Macro (both versions; in cloud, under Enter Repository Settings tab)

Github File Mmacro (both versions)

Enter the branch or commit code to be accessed.

Examples: master, develop, 1.0.0 for a tag, or, 9b81f3072b6fc207c8b65d553a9c5422c757b5f5 for a specific commit.

File Path

Github Markdown Macro (both versions; in cloud, under Enter Repository Settings tab)

Github File Macro (both versions)

Enter the actual path of the Markdown file to be displayed.

Hide line numbers of code block (server)

Hide line numbers (cloud)

Github File Macro (both versions)

Enable this option to hide line numbers of the code block from being displayed.

Lines of code

Github File Macro (both versions)

Enter a line number or a range of lines to be displayed through the macro.

Example: 10 or 1-25.

Â