Versions Compared

Key

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

...

Priority givenURL typeDescription
1Application links

If the given URL is linked to a specific application like Bitbucket or Jira, the macro does not require any user credentials, and processes and renders the given file. Refer to this article for information about application links.

2ProfilesIf Profile is specified, the macro appends the URL given here with the URL specified in the profile configuration, and accesses the location to render the required file.
3Simple URLsLastly, if no application links or profiles were given, the URLs are processed as-is and the required file is rendered.

...

Note
  • Here, the profile is to be linked with GitLab and the base URL of the application is taken automatically in the URL field. This URL is editable and can be changed according to your requirement.
  • In the given screenshot, an Access token is provided whereas the User and Password parameters are left empty. This is because the access token works almost like a direct link to the specified URL and thus, does not require user credentials. See the profile configuration documentation for more information about access tokens.
  • See the Additional links section for more information about profile creation. 

...

  1. Create or edit a page, add the Html-bobswift macro (for this example), and edit to open the macro editor.

  2. Select the relevant profile in Profile.
  3. Enter a relative path (partial URL) to access the required file in Location to HTML data.

    Note

    As mentioned, the macro appends the relative path in the Location of HTML data with the base URL given in the profile. If this absolute path is valid, the specified file is read and the HTML content is displayed, else, a network error is displayed.


  4. Save the macro and publish the page to see the content.

...