Versions Compared

Key

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

...

This article illustrates how to create a profile using a URL in 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 public repository. 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.

...

Info

For this example, let's consider using profiles with the HTML 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

...