fix: add mail docs

2 files changed, 79 insertions, 0 deletions

diff --git a/src/SUMMARY.md b/src/SUMMARY.md
index e34d5f8..a73ce19 100644
--- a/src/SUMMARY.md
+++ b/src/SUMMARY.md
@@ -9,6 +9,7 @@
 - [Rust](./install/rust.md)
 - [Tools](./install/tools.md)
   - [Editor](./install/editor.md)
+  - [Mail](./install/mail.md)
   - [Password Store](./install/tools/password-store.md)
   - [Yubikey](./install/tools/yubikey.md)
   <!-- TODO: DE/WM (Wayland/Sway) -->
diff --git a/src/install/mail.md b/src/install/mail.md
new file mode 100644
index 0000000..e65bc1f
--- /dev/null
+++ b/src/install/mail.md
@@ -0,0 +1,78 @@
+# Mail
+
+Basic setup for receiving, managing, and viewing emails. This really just boils
+down to installing the packages, as the configurate (like in most of this book)
+is contained within my dotfiles.
+
+## Mail Submission Agent
+
+Sending mail is the least complex part of this setup, and is entirely handled by
+`msmtp`.
+
+```console
+pacman -S msmtp
+```
+
+## Mail Retrieval Agent
+
+Install isync (provides `mbsync`) for actually syncing to imap server,
+goimapnotify to only run mbsync when new mail is available,
+
+```console
+pacman -S isync goimapnotify notify-send
+```
+
+### Notifications
+
+The `maildir-notify` script can provide notification for new mail and can be
+enabled via the `maildir-notify.service` user unit (both from my dotfiles).
+
+The notification script requires `notify-send`.
+
+```console
+pacman -S libnotify
+```
+
+## Mail User Agent
+
+Provided that both the MSA and MRA are both configured, aerc can provide a nice
+front-end for composing mail and interacting with the maildir.
+
+```console
+pacman -S aerc
+```
+
+### Optionally install handlers for various content types
+
+While the aerc package provides a set of various formatters that work pretty
+well out of the box, a few content types can be rendered with better results via
+3rd party tools.
+
+The formatters provided by aerc, as well as the following 3rd party ones, are
+already configured in the `aerc.conf` contained in my dotfiles.
+
+#### HTML
+
+HTML can be rendered using w3d. `socksify`, provided by dante, is used to
+prevent emails from phoning home.
+
+```console
+pacman -S dante w3d
+```
+
+#### Documents
+
+`pdftotext` (provided by poppler) and `docx2txt` can be used to render PDFs and
+word documents, respectively.
+
+```console
+pacman -S poppler docx2txt
+```
+
+#### Misc
+
+`bat` is used for most everything else
+
+```console
+pacman -S bat
+```