...
| Warning |
|---|
Removal notice: Please note that the URL user and URL user password parameters were removed in 5.8.5 (see Deprecation notice: URL user and URL user password parameters). We recommend using profiles to access external data. |
This article illustrates how to create a profile in the Markdown macros using a URL to be used with any of the HTML for Confluence macros.
|
|---|
| Info | ||
|---|---|---|
Before you begin:
is a raw URL. A raw URL is defined as the part of the URL following the domain information and includes the query string, if present. For example, in the URL string
|
There are three two ways to work with URLs where you can use:
An absolute URL in a profile
A partial URL in a profile
- An absolute URL directly instead of via a profile
...
| Info |
|---|
For this example, let's use the Html-bobswift macro to illustrate profile creation and usage. The screenshots illustrate where the relevant parameters are to be given. Specify information in the profile window and macro editor as per your requirement in your instance. |
| Anchor | ||
|---|---|---|
|
...
|
...
|
You can create a profile by providing the complete URL for the Markdown content.in the macro editor.
Select
> Manage apps, either search for HTML for Confluence or scroll to Bob Swift Configuration, and click HTML to view app configuration.
| Tip |
|---|
Try this for older Confluence versions! Navigate to CONFLUENCE ADMINISTRATION |
...
> Settings > ATLASSIAN MARKETPLACE > |
...
HTML > Profiles. |
Click Add Profile.
Enter a unique name for the profile in the Profile name text box.
...
Select URL from the options in Profile type.
Enter
...
an absolute URL of the location to be accessed in the URL text box.
Click Save profile to create the profile.
...
To use this profile in a Confluence page:
...
Add the Html-bobswift macro or edit an existing macro on the page.
Select the newly created profile from the Profile list and then, click Save.
...
| Anchor |
|---|
...
|
...
|
...
|
...
|
You can create a profile by providing a partial URL for the Markdown content to access the remote location and entering the relative path to the Markdown file in the markdown-url macro.relevant file in the macro editor.
Select
> Manage apps, either search for HTML for Confluence or scroll to Bob Swift Configuration, and click HTML to view app configuration.
| Tip |
|---|
Try this for older Confluence versions! Navigate to CONFLUENCE ADMINISTRATION |
...
> Settings > ATLASSIAN MARKETPLACE > |
...
HTML > Profiles. |
Click Add Profile.
Enter a unique name for the profile in the Profile name text box.
...
Select URL from the options in Profile type.
Enter
...
the base URL in the URL text box. A base URL is a part of the path that specifies the location that the macro must access.
Click Save profile to create the profile.
...
To use this profile in a Confluence page:
...
Add the
...
Html-bobswift macro or edit an existing macro on the page.
Select the newly created profile from the Profile list in the editor.
Enter the relative path
...
of the HTML file in the Location of HTML data parameter. The relative URL is appended to the base URL specified in the profile to create an absolute path to the file to be rendered.
Click Save.
| Info |
|---|
Points to remember!
|
...
You can skip creating a profile and enter the absolute URL in the URL to markdown file parameter.
- In a Confluence page, search for the Markdown from a URL macro and edit it.
- Enter https://bitbucket.org/bob_swift/gint/raw/9c1b737cf0ff28ddf7cbbd199685e533d310ce9f/README.md in the the URL to markdown file parameter.
- Click Save.
...