about summary refs log tree commit diff
diff options
context:
space:
mode:
-rw-r--r--ops/modules/www/inbox.tvl.su.nix11
-rw-r--r--web/inbox.nix81
-rw-r--r--web/tvl/default.nix26
3 files changed, 108 insertions, 10 deletions
diff --git a/ops/modules/www/inbox.tvl.su.nix b/ops/modules/www/inbox.tvl.su.nix
index a9af18e3481b..38db5d2a8eda 100644
--- a/ops/modules/www/inbox.tvl.su.nix
+++ b/ops/modules/www/inbox.tvl.su.nix
@@ -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};
         }
diff --git a/web/inbox.nix b/web/inbox.nix
new file mode 100644
index 000000000000..4bbf56300dc4
--- /dev/null
+++ b/web/inbox.nix
@@ -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
+  '';
+}
diff --git a/web/tvl/default.nix b/web/tvl/default.nix
index 044d2791d68e..8bbc7d566ab7 100644
--- a/web/tvl/default.nix
+++ b/web/tvl/default.nix
@@ -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
 
-      ----------------
-
-      ## Blog
-
-      Here are the most recent TVL blog posts.
+      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][].
 
-      ${listPosts publishedPosts}
-
-      You can also follow our [atom feed](https://tvl.fyi/feed.atom).
+      [public inbox]: https://inbox.tvl.su
 
       ----------------