Versions Compared

Old Version 10

changes.mady.by.user Smita Nair

Saved on

compared with

New Version 11

changes.mady.by.user Smita Nair

Saved on

Key

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

Description

This article illustrates how to create a profile using a URL to be used with any of the HTML for Confluence macros.

Info

Before you begin:

  • Before you enter the URL for a repository, ensure that it 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 http://www.contoso.com/articles/recent.aspx, the raw URL is /articles/recent.aspx. 

    Tip

    Paste the file link into your browser's address bar. If the actual code is displayed in the browser, it is considered to be invalid or in an incorrect format. If the file downloads to your system, the macros can process the file and its contents.


  • Know what is a complete URL.

    • A typical path for the raw file on Bitbucket looks like:
      /projects/:id/repository/files/:file_path/raw

    • The host address (base URL) begins with:
      https://bitbucket.workspace.com

    • The complete URL, in this example, looks like: 
      https://bitbucket.workspace.com/projects/:id/repository/files/:file_path/raw?ref=master

  • For illustrative purposes, we have used a public Bitbucket repository. Use URLs to add to profiles and in macros as per your requirement and your instance. The process for adding a profile and using it in macros remains the same for other repositories and external sources.

...

There are two ways to work with URLs where you can use:

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
html_57_HowTo_CompleteURL
html_57_HowTo_CompleteURL
Using an absolute URL in a profile

You can create a profile by providing the complete URL in the macro editor.

...

  1. Add the Html-bobswift macro or edit an existing macro on the page.
  2. Select the newly created profile from the Profile list and then, click Save.
            

Anchor
html_57_HowTo_FixedURL
html_57_HowTo_FixedURL
Using a partial URL in a profile

You can create a profile by providing a partial URL to access the remote location and entering the relative path to the relevant file in the macro editor.

...