From 83f1eb6271cda707df6f25e47eca5f504a4cf181 Mon Sep 17 00:00:00 2001
From: Zhang Huangbin <Zhang Huangbin@localhost>
Date: Thu, 14 Jul 2016 10:16:16 +0800
Subject: [PATCH] Tip: how to share someone's mailbox as public folder.

---
 en_US/howto/enable.dnsbl.md  |  2 +-
 en_US/howto/public.folder.md | 17 +++++++++++++++++
 html/enable.dnsbl.html       |  4 ++--
 html/public.folder.html      | 13 +++++++++++++
 4 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/en_US/howto/enable.dnsbl.md b/en_US/howto/enable.dnsbl.md
index c851dd19..bc303c4e 100644
--- a/en_US/howto/enable.dnsbl.md
+++ b/en_US/howto/enable.dnsbl.md
@@ -1,6 +1,6 @@
 # Enable DNSBL service in Postfix to reduce spam
 
-!!! note "Important Note"
+!!! attention
 
     If you're running a high-traffic mail server, you'd better setup a local
     DNS server to cache DNS queries, because free RBL services like
diff --git a/en_US/howto/public.folder.md b/en_US/howto/public.folder.md
index c725e552..1a3997e0 100644
--- a/en_US/howto/public.folder.md
+++ b/en_US/howto/public.folder.md
@@ -208,6 +208,23 @@ echo 'anyone lr' >> /var/vmail/public/.TestFolder/dovecot-acl
 doveadm -D acl ...
 ```
 
+## Use someone's mailbox as public folder
+
+If you want to use someone's mailbox as public folder, here's a simplest way to
+achieve it.
+
+Let's say you want to share user `public@domain.com`'s mailbox as public folder
+`PublicMailbox`,
+and its maildir path is
+`/var/vmail/vmail1/domain.com/p/u/b/public-20160714100502/Maildir/`. What you
+need to do is just creating a symbol link to this maildir path like this:
+
+```
+ln -s /var/vmail/vmail1/domain.com/p/u/b/public-20160714100502/Maildir /var/vmail/public/.PublicMailbox
+```
+
+Note: there's a dot prepended in public mailbox name.
+
 ## References
 
 * Dovecot official documents:
diff --git a/html/enable.dnsbl.html b/html/enable.dnsbl.html
index bf59b1fa..447a75b5 100644
--- a/html/enable.dnsbl.html
+++ b/html/enable.dnsbl.html
@@ -16,8 +16,8 @@
         <span>iRedMail</span>
     </a>
     &nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="enable-dnsbl-service-in-postfix-to-reduce-spam">Enable DNSBL service in Postfix to reduce spam</h1>
-<div class="admonition note">
-<p class="admonition-title">Important Note</p>
+<div class="admonition attention">
+<p class="admonition-title">Attention</p>
 <p>If you're running a high-traffic mail server, you'd better setup a local
 DNS server to cache DNS queries, because free RBL services like
 <code>zen.spamhaus.org</code> may improperly reply if your server exceed the DNS
diff --git a/html/public.folder.html b/html/public.folder.html
index 9d7c48ef..cad62ef8 100644
--- a/html/public.folder.html
+++ b/html/public.folder.html
@@ -23,6 +23,7 @@
 <li><a href="#manage-access-control-with-doveadm">Manage Access Control with doveadm</a></li>
 <li><a href="#manage-access-control-manually">Manage Access Control manually</a></li>
 <li><a href="#troubleshooting">Troubleshooting</a></li>
+<li><a href="#use-someones-mailbox-as-public-folder">Use someone's mailbox as public folder</a></li>
 <li><a href="#references">References</a></li>
 <li><a href="#see-also">See Also</a></li>
 </ul>
@@ -207,6 +208,18 @@ permissions:</p>
 <pre><code>doveadm -D acl ...
 </code></pre>
 
+<h2 id="use-someones-mailbox-as-public-folder">Use someone's mailbox as public folder</h2>
+<p>If you want to use someone's mailbox as public folder, here's a simplest way to
+achieve it.</p>
+<p>Let's say you want to share user <code>public@domain.com</code>'s mailbox as public folder
+<code>PublicMailbox</code>,
+and its maildir path is
+<code>/var/vmail/vmail1/domain.com/p/u/b/public-20160714100502/Maildir/</code>. What you
+need to do is just creating a symbol link to this maildir path like this:</p>
+<pre><code>ln -s /var/vmail/vmail1/domain.com/p/u/b/public-20160714100502/Maildir /var/vmail/public/.PublicMailbox
+</code></pre>
+
+<p>Note: there's a dot prepended in public mailbox name.</p>
 <h2 id="references">References</h2>
 <ul>
 <li>