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
tazjin
parent
fe4cdff442
commit
62e19a8321
3 changed files with 108 additions and 10 deletions
|
|
@ -1,4 +1,4 @@
|
|||
{ config, ... }:
|
||||
{ config, depot, ... }:
|
||||
|
||||
{
|
||||
imports = [
|
||||
|
|
@ -11,10 +11,17 @@
|
|||
forceSSL = true;
|
||||
|
||||
extraConfig = ''
|
||||
# nginx is incapable of serving a single file at /, hence this hack:
|
||||
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 / {
|
||||
proxy_pass http://localhost:${toString config.services.public-inbox.http.port};
|
||||
}
|
||||
|
|
|
|||
81
web/inbox.nix
Normal file
81
web/inbox.nix
Normal 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
|
||||
'';
|
||||
}
|
||||
|
|
@ -63,6 +63,20 @@ let
|
|||
Feel free to explore the tech we have built so far, all our
|
||||
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]
|
||||
on [hackint][], which is also reachable [via XMPP][hackint-xmpp]
|
||||
at [`#tvl@irc.hackint.org`][tvl-xmpp] (sic!) and [via
|
||||
|
|
@ -78,15 +92,11 @@ let
|
|||
[tvl-matrix]: https://matrix.to/#/#tvl:hackint.org
|
||||
[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
|
||||
|
||||
Here are the most recent TVL blog posts.
|
||||
|
||||
${listPosts publishedPosts}
|
||||
|
||||
You can also follow our [atom feed](https://tvl.fyi/feed.atom).
|
||||
[public inbox]: https://inbox.tvl.su
|
||||
|
||||
----------------
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue