about summary refs log tree commit diff
path: root/README.md
blob: 4e05c61ab73c5026a5f4d99b672a4fc82ea24950 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# formbox

This tiny script formats an [mbox] as HTML or XML.  It is intended
for rendering email replies on websites and their [RSS] feed.

## Prerequisites

This Python package depends on [bleach] for HTML sanitising
and [markdown] for, well, rendering Markdown to HTML.  It is, however,
not designed to work with HTML emails with all those CSS and Java scripts.

## Installation

It is recommended to install this package from a downstream repository,
such as [Nix] or [IPWHL].

## Usage

```console
$ formbox --help
usage: formbox [-h] mbox id template

format mbox as HTML/XML

positional arguments:
  mbox        path to mbox file
  id          root message ID
  template    path to template

optional arguments:
  -h, --help  show this help message and exit
```

## Copying

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

[mbox]: https://en.wikipedia.org/wiki/Mbox
[RSS]: https://www.rssboard.org
[bleach]: https://bleach.readthedocs.io
[markdown]: https://python-markdown.github.io
[Nix]: https://search.nixos.org/packages?channel=unstable&query=formbox
[IPWHL]: https://man.sr.ht/~cnx/ipwhl