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:
parent
fe4cdff442
commit
62e19a8321
3 changed files with 108 additions and 10 deletions
|
@ -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
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
|
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).
|
|
||||||
|
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue