Log in to Paligo via a user account that has administrator permissions.

Select the avatar in the top-right corner.

Select Settings from the menu.

Select the Integrations tab.

Find the Azure Repos settings and select Add.

Paligo displays the Azure Repos integration settings:

Enter the Organization. Typically, this is your username but without the email address part, for example, if your username is jsmith@gmail.com, the Organization is likely to be jsmith.

Enter the Username for the Azure Repos account. Paligo will use this to log in to Azure Repos. It is important that the account has write permissions for the repository (these are set for the account in Azure Repos).

Enter the Personal Access Token. You can create the Personal Access Token in Azure Repos.

Select the button at the end of the Project field. Paligo connects to Azure Repos and detects the projects that you have available. Select the project that contains the repository that you want Paligo to publish to.

Select the Repository that you want Paligo to publish to.

Choose the Branch that Paligo will upload content to. Paligo detects what branches are available and you can choose the branch from the dropdown list.

Paligo does not automatically update the integration settings page while it is open. This means that if you have the integration settings page open, and some new branches are added in Azure Repos, those new branches will not appear in the Branch field. But if you select the branch button, Paligo will update the settings page with the latest branch information.

In the Destination folder field, enter the directory path for the folder that you want Paligo to upload the zip file to. This folder is inside the Azure Repos repository.

For example:

Folder 1/Folder 2/

To upload the zip file directly to the root of the repository, leave the Destination field empty.

Select Save.

Select the Change button for the Azure Repos integration.

Select Test Settings to run a connection test. If the settings are correct, Paligo will show a green success notification.

In Paligo, select the options menu ( ... ) for the publication that you want to publish, and then select Publish.

On the Publish document dialog, select the type of output you want, for example, HTML5.

Choose the layout that you want to use for publishing. The settings in the layout are applied when Paligo generates the output.

Choose the Languages to publish to. If you do not have any translations, you can only select the original/source language.

If you have set filters (Profiling attributes) on topics or elements, and/or have used variables, choose which values to use for the publication. See Filtering / Profiling and Variables to learn how to use these features.

In the Upload output section, check the Upload to Azure Repos box. By default, Paligo will upload the output to the repository and folder that are specified in the Paligo to Azure Repos integration settings.

You can publish to a different branch and/or folder if required. Select the Edit icon next to Upload to Azure Repos, and then select the branch and/or folder on the Edit dialog.

The settings you choose will only be used for this individual publishing process. Any future publishing will revert back to using the branch and folder that are defined in the integration settings.

Select Publish document.

Paligo generates the output, applying the settings from the layout and the Publication document dialog in the process. When the output is created, it is downloaded in your browser as a zip file. The zip file is also uploaded to your chosen repository branch and folder in Azure Repos.