feat(web/inbox): add landing page for inbox.tvl.su

This landing page explains how to use the public-inbox.

Change-Id: I37d74decad5173ab35051970593f1d28001af2b4
Reviewed-on: https://cl.tvl.fyi/c/depot/+/7645
Tested-by: BuildkiteCI
Reviewed-by: flokli <flokli@flokli.de>
This commit is contained in:
Vincent Ambo 2022-12-27 14:53:15 +03:00 committed by tazjin
parent fe4cdff442
commit 62e19a8321
3 changed files with 108 additions and 10 deletions

View file

@ -1,4 +1,4 @@
{ config, ... }: { config, depot, ... }:
{ {
imports = [ imports = [
@ -11,10 +11,17 @@
forceSSL = true; forceSSL = true;
extraConfig = '' extraConfig = ''
# nginx is incapable of serving a single file at /, hence this hack:
location = / { location = / {
return 302 https://inbox.tvl.su/depot; index /landing-page;
} }
location = /landing-page {
types { } default_type "text/html; charset=utf-8";
alias ${depot.web.inbox};
}
# rest of requests is proxied to public-inbox-httpd
location / { location / {
proxy_pass http://localhost:${toString config.services.public-inbox.http.port}; proxy_pass http://localhost:${toString config.services.public-inbox.http.port};
} }

81
web/inbox.nix Normal file
View file

@ -0,0 +1,81 @@
# landing page for inbox.tvl.su
{ depot, ... }:
depot.web.tvl.template {
title = "TVL's public inbox";
# not hosted on whitby, so we need /latest
staticUrl = "https://static.tvl.su/latest";
extraHead = ''
<link rel="alternate" type="application/atom+xml" href="https://inbox.tvl.su/depot/new.atom" />
'';
content = ''
TVL's public inbox
==================
This is the [public-inbox][] for [The Virus Lounge][TVL]. It is
essentially like a pull-based mailing list, where we discuss
anything related to our software or organisation, as well as
receive patches from external users.
## Posting to the inbox
Anyone can send messages to the inbox by emailing
**depot@tvl.su**.
## Accessing the inbox
There are several ways to access the inbox, depending on what is
most convenient for your personal email workflow.
### Web browser
Go to [`/depot/`][inbox-html] to read the inbox in your web
browser. This is the easiest way to access messages, and with an
email client supporting `mailto:` links you can respond to
messages from there, too.
### IMAP
The inbox is available via IMAP:
**Server:** `inbox.tvl.su`
**Port:** `993` (TLS enabled)
**Inbox:** `su.tvl.depot.0` (auto-discoverable)
You can use *any* credentials to log in, for example the username
`anonymous` with the password `kittens`. The server will just
ignore it.
TIP: There is a wrapper script in `//tools/fetch-depot-inbox` in
the TVL depot which you can use to synchronise the maildir to your
computer, which works for email clients like `notmuch`.
### Atom feed
An Atom feed [is available][feed] and should work with your
favourite feed reader.
### NNTP
News readers can access the inbox via NNTP:
**Server:** `inbox.tvl.su`
**Port:** `563` (TLS enabled)
**Group:** `su.tvl.depot.0` (auto-discoverable)
No credentials are required to access the server.
[public-inbox]: https://public-inbox.org/README.html
[TVL]: https://tvl.fyi
[inbox-html]: https://inbox.tvl.su/depot/
[feed]: https://inbox.tvl.su/depot/new.atom
'';
}

View file

@ -63,6 +63,20 @@ let
Feel free to explore the tech we have built so far, all our Feel free to explore the tech we have built so far, all our
systems are linked in the footer. systems are linked in the footer.
----------------
## Blog
Here are the most recent TVL blog posts.
${listPosts publishedPosts}
You can also follow our [atom feed](https://tvl.fyi/feed.atom).
----------------
## Getting in touch
We mostly hang out on IRC. You can find us in [`#tvl`][tvl-irc] We mostly hang out on IRC. You can find us in [`#tvl`][tvl-irc]
on [hackint][], which is also reachable [via XMPP][hackint-xmpp] on [hackint][], which is also reachable [via XMPP][hackint-xmpp]
at [`#tvl@irc.hackint.org`][tvl-xmpp] (sic!) and [via at [`#tvl@irc.hackint.org`][tvl-xmpp] (sic!) and [via
@ -78,15 +92,11 @@ let
[tvl-matrix]: https://matrix.to/#/#tvl:hackint.org [tvl-matrix]: https://matrix.to/#/#tvl:hackint.org
[tvl-webchat]: https://webirc.hackint.org/#ircs://irc.hackint.org/#tvl [tvl-webchat]: https://webirc.hackint.org/#ircs://irc.hackint.org/#tvl
---------------- Discussions of our software, patches, and anything else really
can also be sent to us via email to **depot@tvl.su**. You can
see the mails submitted to that list in our [public inbox][].
## Blog [public inbox]: https://inbox.tvl.su
Here are the most recent TVL blog posts.
${listPosts publishedPosts}
You can also follow our [atom feed](https://tvl.fyi/feed.atom).
---------------- ----------------