Generate dynamic download links for the configuration

docs/compose/docker-compose.yml

@@ -3,7 +3,6 @@ version: '2'
 services:
 
   front:
-    # build: nginx
     image: mailu/nginx:$VERSION
     restart: always
     env_file: .env
@@ -36,7 +35,6 @@ services:
       - "$ROOT/redis:/data"
 
   imap:
-    # build: dovecot
     image: mailu/dovecot:$VERSION
     restart: always
     env_file: .env
@@ -46,7 +44,6 @@ services:
       - "$ROOT/overrides:/overrides"
 
   smtp:
-    # build: postfix
     image: mailu/postfix:$VERSION
     restart: always
     env_file: .env
@@ -55,7 +52,6 @@ services:
       - "$ROOT/overrides:/overrides"
 
   antispam:
-    # build: rspamd
     image: mailu/rspamd:$VERSION
     restart: always
     env_file: .env
@@ -64,7 +60,6 @@ services:
       - "$ROOT/overrides/rspamd:/etc/rspamd/override.d"
 
   antivirus:
-    # build: clamav
     image: mailu/$ANTIVIRUS:$VERSION
     restart: always
     env_file: .env
@@ -72,7 +67,6 @@ services:
       - "$ROOT/filter:/data"
 
   webdav:
-    # build: $WEBDAV
     image: mailu/$WEBDAV:$VERSION
     restart: always
     env_file: .env
@@ -80,7 +74,6 @@ services:
       - "$ROOT/dav:/data"
 
   admin:
-    # build: admin
     image: mailu/admin:$VERSION
     restart: always
     env_file: .env
@@ -90,7 +83,6 @@ services:
       - /var/run/docker.sock:/var/run/docker.sock:ro
 
   webmail:
-    # build: "$WEBMAIL"
     image: "mailu/$WEBMAIL:$VERSION"
     restart: always
     env_file: .env
@@ -98,7 +90,6 @@ services:
       - "$ROOT/webmail:/data"
 
   fetchmail:
-    # build: fetchmail
     image: mailu/fetchmail:$VERSION
     restart: always
     env_file: .env

docs/compose/setup.rst

@@ -15,21 +15,16 @@ Mailu will store all of its persistent data in a path of your choice
 Download the initial configuration file
 ---------------------------------------
 
-Docker Compose configuration is stored in a file named ``docker-compose.yml``.
+Docker Compose configuration is stored in a file named
-Additionally, Mailu relies on an environment file for various settings.
+:download:`docker-compose.yml`. Additionally, Mailu
-Download the proper template files from the git repository. For `stable`:
+relies on a :download:`.env` file for various settings. Download
+the proper template files from the git repository. To download the configuration
+for the "|version|" branch, use:
 
-.. code-block:: bash
+.. parsed-literal::
 
-  wget -O docker-compose.yml https://raw.githubusercontent.com/Mailu/Mailu/stable/docs/compose/docker-compose.yml.dist
+  wget https://mailu.io/|version|/_downloads/docker-compose.yml
-  wget -O .env https://raw.githubusercontent.com/Mailu/Mailu/stable/docs/compose/.env.dist
+  wget https://mailu.io/|version|/_downloads/.env
-
-For the latest version (replace with version number otherwise):
-
-.. code-block:: bash
-
-  wget -O docker-compose.yml https://raw.githubusercontent.com/Mailu/Mailu/master/docs/compose/docker-compose.yml.dist
-  wget -O .env https://raw.githubusercontent.com/Mailu/Mailu/master/docs/compose/.env.dist
 
 Then open the ``.env`` file to setup the mail server. Modify the ``ROOT`` setting
 to match your setup directory if different from ``/mailu``.
@@ -50,11 +45,11 @@ you would simply like the server to listen on all interfaces, use ``0.0.0.0``.
 Modify ``BIND_ADDRESS6`` to match the public IPv6 address assigned to your server.
 The behavior is identical to ``BIND_ADDRESS4``.
 
-Set the `TLS_FLAVOR` to one of the following
+Set the ``TLS_FLAVOR`` to one of the following
 values:
-- `cert` is the default and requires certificates to be setup manually;
+- ``cert`` is the default and requires certificates to be setup manually;
-- `letsencrypt` will use the Letsencrypt! CA to generate automatic ceriticates;
+- ``letsencrypt`` will use the Letsencrypt! CA to generate automatic ceriticates;
-- `notls` will disable TLS, this is not recommended except for testing.
+- ``notls`` will disable TLS, this is not recommended except for testing.
 
 Enable optional features
 ------------------------