Skip to main content

WebDAV Access to your Paligo Instance Folders

With Web Distributed Authoring and Versioning (WebDAV), you can access the XSLT customizations that were built for you by Paligo. If you have the necessary knowledge and skills, you can modify the customizations.

Be aware that:

  • Access via WebDAV is only available if you are on the Enterprise plan.

  • You should only use WebDAV if you have a good understanding of XSLT or Schematron and DocBook 5.0.

  • On Windows, you will need to use a Third-Party client, such as Cyberduck, to access WebDAV. The customization folders are not shown if you try to use the native Windows client.

  • You can only use WebDAV to modify customizations and custom Schematron rules.

Note

You cannot use WebDAV to change the XSLT that Paligo uses to generate your outputs (HTML5 Help Center, HTML, etc.)

To access the folders in your Paligo instance using WebDAV on an Apple Mac computer:

  1. Run Apple's Finder application on your computer.

  2. Select Go in the menu at the top.

  3. Select Connect to Server.

    Connect to server dialog shows a URL has been added. The URL is https://acme.mount.paligoapp.com
  4. Enter the URL for connecting via webDAV:

    <your paligo domain name>.mount.paligoapp.com

    For example, https://acme.mount.paligoapp.com

    Note

    You have to include .mount in the URL, between your domain name and paligoapp.com.

  5. Select Connect.

  6. Select Registered user and then enter the user name and password for your Paligo user account.

    Name and password prompt. It has the registered user option selected and there are fields to enter the name and password. These need to be set to match the name and password of your Paligo login.
  7. Select Connect.

    If your log in credentials are correct and you have Paligo on the Enterprise plan, a window appears showing you the folders for your Paligo instance.

    Finder view showing the folders in your Paligo instance. The only folders you should upload content to are xsl and schematron.

    The only folders you should use are:

    • xsl - The xsl folder contains any customizations for your instance, and it also has a custom folder which contains your layouts.

    • schematron - If you use schematron to provide your own custom rules, you will need to upload your schematron into the edit folder inside the schematron folder.

    You can download files and upload files as needed, but we strongly recommend that you do not edit files in WebDAV as this can result in problems with permissions. Instead, you should use WebDAV to download a file, edit the file locally, and then use WebDAV to upload the changes.

Note

Paligo will only validate against the rules in your Schematron file if you enable Schematron validation for your topics (see Turn Validation On or Off).

To access the folders in your Paligo instance using WebDAV on a Windows computer:

  1. Run Windows File Explorer.

  2. Install a Third-Party client application on your computer, such as Cyberduck (other client applications are available).

  3. Run the client application and open a new network connection.

  4. Enter the connection details:

    • URL

      Enter the URL for your Paligo domain. For WebDAV connections, it needs to include ".mount" in the URL, between your domain name and paligoapp.com, like this:

      https://acme.mount.paligoapp.com
    • Connection type

      Choose WebDAV https.

    • Port

      Use the default port, which is 443.

    • Username

      Enter your username for logging in to your Paligo instance.

    • Password

      Enter your password for logging in to your Paligo instance.

If your log in credentials are correct and you have Paligo on the Enterprise plan, a window appears showing you the folders for your Paligo instance.

Folders shown when WebDAV connection is made.

The only folders you should use are:

  • xsl - The xsl folder contains any customizations for your instance, and it also has a custom folder which contains your layouts.

  • schematron - If you use schematron to provide your own custom rules, you will need to upload your schematron into the edit folder inside the schematron folder.

You can download files and upload files as needed, but we strongly recommend that you do not edit files in WebDAV as this can result in problems with permissions. Instead, you should use WebDAV to download a file, edit the file locally, and then use WebDAV to upload the changes.

Note

Paligo will only validate against the rules in your Schematron file if you enable Schematron validation for your topics (see Turn Validation On or Off).