Alexander/mykb
1
0
Fork 0
mirror of https://github.com/AlexBocken/mykb.git synced 2024-09-19 14:55:13 +02:00
Code Issues Packages Projects Releases Wiki Activity

add initial neomutt

Browse Source
This commit is contained in:
Alexander Bocken 2022-01-16 11:32:58 +01:00
parent 2a17f8f933
commit 287bd24257
Signed by: Alexander
GPG Key ID: 1D237BE83F9B05E8
2 changed files with 70 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
index.md
View File

@ -5,12 +5,13 @@ Happy to accept pull requests for new topics!
# Programs
- [qutebrowser](docs/qutebrowser.md)
A highly customizable keyboard focused webbrowser using vim bindings
highly customizable keyboard focused webbrowser using vim bindings
- [vimwiki](docs/vimwiki.md)
A wiki script for vim
- [weechat](docs/weechat.md) A TUI client for matrix
wiki script for vim
- [weechat](docs/weechat.md) TUI client for matrix
- [ssh](docs/ssh.md) ssh configuration
- [GIT](docs/GIT.md) A version control software
- [GIT](docs/GIT.md) version control software
- [neomutt](neomutt.md) highly customizable TUI email client
# Admin

65
neomutt.md Normal file
View File

@ -0,0 +1,65 @@
# Neomutt
## Markdown to HTML rendering
To write more normie-friendly emails, non-plain-text emails are probably better.
For this, a conversion from Markdown to HTML with Mathjax support seems best.
It supports all the bells and whistles of markdown (images, links, code, italics, bold) as well as mathemtical formulas in LaTex notation using Mathjax.
### Configuration
The conversion is done via pandoc using templates.
Ensure `pandoc` is installed. (`which pandoc || sudo pacman -S pandoc`)
Add to your muttrc (either in `~/.mutt/muttrc` or `~/.config/mutt/muttrc`. From now on assuming `~/.config/mutt` as config folder)
```
macro compose m \
"<enter-command>set pipe_decode<enter>\
<pipe-message>pandoc -f gfm -t plain -o /tmp/msg.txt<enter>\
<pipe-message>pandoc -s -f gfm --self-contained -o /tmp/msg.html --resource-path ~/.config/mutt/templates/ --template email<enter>\
<enter-command>unset pipe_decode<enter>\
<attach-file>/tmp/msg.txt<enter>\
<attach-file>/tmp/msg.html<enter>\
<tag-entry><previous-entry><tag-entry><group-alternatives>" \
"Convert markdown to HTML5 and plaintext alternative content types"
```
Create a folder called `templates`: `mkdir -p ~/.config/mutt/templates`
and create a file called `email.html` in this folder with the following content:
```html
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="$lang$" xml:lang="$lang$"$if(dir)$ dir="$dir$"$endif$>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<style>
$styles.html()$
</style>
$for(css)$
<link rel="stylesheet" href="$css$" />
$endfor$
<!--[if lt IE 9]>
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
<![endif]-->
$for(header-includes)$
$header-includes$
$endfor$
</head>
<body>
$body$
$for(include-after)$
$include-after$
$endfor$
</body>
</html>
```
TODO: Proper Mathjax support
TODO: delete plaintext attachment after HTML creation
### Usage
To use this, write your email as usual and afterwards, press `m` on the created file in neomutt.
This will generate a combined file for plaintext fallback in case of unsupported HTML rendering.
For now, also delete the still present plaintext file with `D`.
Your email should now be ready to be sent.