Description
This article illustrates how to create a profile in the macros using a URL.
Before you begin:
- Before you enter the URL for a repository, ensure that it complies with the REST standards published by GitHub or GitLab.
- Click here for more information on REST Pattern for GitLab.
- Click here for more information on REST Pattern for GitHub.
- Know what is a complete URL. A typical path for the raw file on GitLab looks like:
/projects/:id/repository/files/:file_path/raw- The host address begins with:
https://gitlab.com/api/v4- The complete URL, in this example, looks like:
https://gitlab.com/api/v4/projects/:id/repository/files/:file_path/raw?ref=master- For illustrative purposes, we have used a public Bitbucket public repository. The process for adding a profile and using it in macros remains the same for other repositories and external sources.
There are three ways to work with URLs where you can use:
- An absolute URL in a profile
- A partial URL in a profile
For this example, let's consider using profiles with the HTML macro.
Using an absolute URL in a profile
You can create a profile by providing the complete URL for the HTML/XML content.
Navigate to CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > HTML > Profiles.
Try this for newer Confluence versions
Select
> Manage apps, either search for HTML for Confluence or scroll to Bob Swift Configuration, and click HTML to view app configuration.Click Add Profile.
- Enter a unique name for the profile in the Profile name text box. For this example, enter BitURL in the text box.
- Select URL from the options in Profile type.
Enter https://bitbucket.org/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.html in the URL text box.
Click Save profile to create the profile.
To use this profile in a Confluence page:
- Add the HTML macro or edit an existing macro on the page.
- Select BitURL from the Profile list and then, click Save.
<screenshot>
Using a partial URL in a profile
You can create a profile by providing a partial URL to access the remote location and entering relative path to the relevant file in the HTML macro.
Navigate to CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > HTML > Profiles.
Try this for newer Confluence versions
Select
> Manage apps, either search for HTML for Confluence or scroll to Bob Swift Configuration, and click HTML to view app configuration.Click Add Profile.
- Enter a unique name for the profile in the Profile name text box. For this example, enter BitURL in the text box.
- Select URL from the options in Profile type.
Enter https://bitbucket.org in the URL text box.
Click Save profile to create the profile.
To use this profile in a Confluence page:
- Add the HTML macro or edit an existing macro on the page.
- Select BitURL from the Profile list in the editor.
- Enter the relative path to the /bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.html file in the Location of HTML data parameter.
- Click Save.
<screenshot>
This method allows multiple users to access a profile across pages and instances of the macros.
