Configuring Apache to support Universal DocMoto links
As of version 5 DocMoto supports a new link type known as universal.
A universal link uses an http or https prefix, so is universally accepted by third party applications.
Universal links should be used in preference to the older x-docmoto links.
Setting up Universal Link Support
To support universal links requires a small change to your Apache server configuration as follows:
- Check that the Apache module mod_rewrite is enabled in /etc/apache2/httpd.conf by removing any # symbol from the start of the line
LoadModule rewrite_module libexec/apache2/mod_rewrite.so
- Create a file called docmoto-link.conf, add the contents below, then move the file to /etc/apache2/other/
- Restart apache by typing
sudo apachectl restart
# Enable x-docmoto linking in Apache2 # # Copy this into /etc/apache2/other/ # and run: # sudo apachectl restart # Redirect x-docmoto links RedirectMatch "^/x-docmoto/(.*)" "x-docmoto://$1" # Disable Rewrite rules from overriding the Redirect <IfModule rewrite_module> RewriteRule ^x-docmoto - [L,NC] </IfModule>
Testing a Universal Link
- Open a version 5 DocMoto client and highlight a file.
- From the File menu select Copy Link to Clipboard and select Universal.
- Copy the link into an application of your choice, eg Word.
- Close the DocMoto client
- Click on the link, the DocMoto client will be opened via your browser, and the file highlighted.