Versions Compared

Old Version 8

changes.mady.by.user Smita Nair

Saved on

compared with

New Version 9

changes.mady.by.user Smita Nair

Saved on

Key

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

This article discusses the recommended way of using URLs, especially in correlation with profiles, in the HTML Html-bobswift and XSLT macros. This page also contains more information about the URLs that can be given, the order used to process URLs, and finally, how URLs must be used with profiles in the macros.

...

Click any of the links to know more:

Anchor
html_57_tutl_URLProfiles_types
html_57_tutl_URLProfiles_types
URLs in macros

...

URLs given in the macros are processed in the following order as explained:

Priority givenURL typeDescription
1Application links

If the given URL is linked to a specific application like Bitbucket, GitLab, or GitLab, 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.

Anchor
html_57_tutl_URLProfiles_profiles
html_57_tutl_URLProfiles_profiles
Importance of URLs with respect to profiles

...

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 macro Html-bobswift macro (for this example), and edit to open the macro editor.

  2. 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.


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

...