~rjarry/aerc

8e700a643a84d65da56c17acd52f5b5714eb2487 — Matěj Cepl a month ago b5bfa4b wiki
configurations: add html writing guidelines

When your boss, or your fancy, demand that your next email will contain
nice fonts, lists, tables, and other HTML paraphernalia.

Signed-off-by: Matěj Cepl <mcepl@cepl.eu>
Acked-by: Robin Jarry <robin@jarry.cc>
2 files changed, 37 insertions(+), 0 deletions(-)

A configurations/htmlmail.md
M configurations/index.md
A configurations/htmlmail.md => configurations/htmlmail.md +36 -0
@@ 0,0 1,36 @@
---
title: "aerc-wiki: Writing HTML mail"
---

Although we believe that [email should be written as plain
text](https://useplaintext.email/) and `aerc` is optimized for dealing with
regular `text/plain` messages, but the things happen in life when one’s boss or
some other evil interference requires one to write an HTML message. And `aerc`
can help you even in such circumstances (and, of course, it can help you
perfectly well with [reading HTML mail](htmlquote) as well).

In the `aerc.conf` configuration file, section `[multipart-converters]` you
have to add new value for the generated format you need, so for example:

```
text/html=rst2html5 --embed-stylesheet --no-doc-title
```

For writing `text/html` messages with
[reStructuredText](https://docutils.sourceforge.io/rst.html).

Then, when reviewing a message before its sending, one can run the command

```
:multipart text/html
```

to generate `multipart/alternative` message, where one part will be `text/html`
(and the other the original `text/plain` content).

Of course, it is the best to add a binding to the `[compose:review]` section of
the `binds.conf` configuration file for speed access to the functionality:

```
H = :multipart text/html<Enter>
```

M configurations/index.md => configurations/index.md +1 -0
@@ 6,4 6,5 @@ title: "aerc-wiki: Configurations"
- [notmuch](configurations/notmuch.md)
- [style sets](configurations/stylesets.md)
- [html quoting in replies](configurations/htmlquote.md)
- [writing html mail](configurations/htmlmail.md)
- [Induce threading of forwarded messages](configurations/threadfwd.md)