Radish alpha
r
radicle.xyz
rad:z371PVmDHdjJucejRoRYJcDEvD5pp
Radicle website including documentation and guides
Radicle
Git
Commits › 5dbf9b0
Add releases page
Alexis Sellier committed 2 years ago
commit 5dbf9b0987562bb7c0e927af8dabe1bffa36a620
parent 82c6757
3 files changed +166 -6
modified _layouts/page.html
@@ -4,7 +4,7 @@
  {% include meta.html %}

  <link rel="stylesheet" type="text/css" href="{{ "/assets/css/page.css" | relative_url }}"/>

</head>
- 
<body>
+ 
<body class="{{ page.variant }}">

  {% include header.html %}

  <main>

    {{ content }}
added _pages/releases.md
@@ -0,0 +1,127 @@
+ 
---
+ 
title: Radicle Releases
+ 
subtitle: Download a Radicle release
+ 
layout: page
+ 
variant: wide
+ 
---
+ 
This is Radicle's <strong class="highlight">releases</strong> page.
+ 
Radicle uses a [reproducible build][rb] pipeline to ensure that anyone can
+ 
reproduce the binaries on this page from source.
+
+ 
[rb]: https://reproducible-builds.org/
+
+ 
<p id="release" class="loading">
+ 
  <span class="release-loader"></span>
+ 
  <span>
+ 
    <h2 id="release-name">Latest release</h2>
+ 
    <p id="release-info"><!-- Dynamic --></p>
+ 
  </span>
+ 
</p>
+
+ 
<noscript>
+ 
  <p>
+ 
    Browse the latest release at
+ 
    <a href="https://files.radicle.xyz/releases/latest">https://files.radicle.xyz/releases/latest</a>
+ 
  </p>
+ 
</noscript>
+
+ 
<table class="loading" id="releases">
+ 
  <thead>
+ 
    <th scope="col">OS</th>
+ 
    <th scope="col">Arch</th>
+ 
    <th scope="col">File</th>
+ 
    <th scope="col">Signature</th>
+ 
    <th scope="col">Checksum</th>
+ 
  </thead>
+ 
  <tr data-release-arch="x86_64" data-release-binary="unknown-linux-musl">
+ 
    <th scope="row" rowspan="2">Linux</th>
+ 
    <td class="release-arch">Loading…</td>
+ 
    <td>💾 <a class="release-url">Loading…</a></td>
+ 
    <td><a class="release-sig">Loading…</a></td>
+ 
    <td><a class="release-checksum">Loading…</a></td>
+ 
  </tr>
+ 
  <tr data-release-arch="aarch64" data-release-binary="unknown-linux-musl">
+ 
    <td class="release-arch">Loading…</td>
+ 
    <td>💾 <a class="release-url">Loading…</a></td>
+ 
    <td><a class="release-sig">Loading…</a></td>
+ 
    <td><a class="release-checksum">Loading…</a></td>
+ 
  </tr>
+ 
  <tr data-release-arch="x86_64" data-release-binary="apple-darwin">
+ 
    <th scope="row" rowspan="2">macOS</th>
+ 
    <td class="release-arch">Loading…</td>
+ 
    <td>💾 <a class="release-url">Loading…</a></td>
+ 
    <td><a class="release-sig">Loading…</a></td>
+ 
    <td><a class="release-checksum">Loading…</a></td>
+ 
  </tr>
+ 
  <tr data-release-arch="aarch64" data-release-binary="apple-darwin">
+ 
    <td class="release-arch">Loading…</td>
+ 
    <td>💾 <a class="release-url">Loading…</a></td>
+ 
    <td><a class="release-sig">Loading…</a></td>
+ 
    <td><a class="release-checksum">Loading…</a></td>
+ 
  </tr>
+ 
</table>
+
+ 
## Verification
+
+ 
Release tarballs are signed using the following SSH public key:
+
+ 
    ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIL460KIEccS4881p7PPpiiQBsxF+H5tgC6De6crw9rbU
+
+ 
The key's fingerprint is:
+
+ 
    SHA256:iTDjRHSIaoL8dpHbQ0mv+y0IQqPufGl2hQwk4TbXFlw
+
+ 
After you've downloaded the archive (`ARCHIVE.tar.xz` in the examples below),
+ 
verify the signature using the `.sig` file and `ssh-keygen`. The output must
+ 
match exactly, including the key fingerprint:
+
+ 
    $ ssh-keygen -Y check-novalidate -n file -s ARCHIVE.tar.xz.sig < ARCHIVE.tar.xz
+ 
    Good "file" signature with ED25519 key SHA256:iTDjRHSIaoL8dpHbQ0mv+y0IQqPufGl2hQwk4TbXFlw
+
+ 
To verify the checksum, download the `.sha256` file, and run:
+
+ 
    $ sha256sum -c ARCHIVE.tar.xz.sha256
+ 
    ARCHIVE.tar.xz: OK
+
+ 
The output must correspond to the above.
+
+ 
## Installation
+
+ 
To install, simply extract the files to a location in your `PATH`, for example:
+
+ 
    $ tar -xvJf ARCHIVE.tar.xz --overwrite --strip-components=1 -C /usr/local/
+
+ 
This will place binaries in `/usr/local/bin` and manuals in `/usr/local/man`,
+ 
and overwrite any existing Radicle binaries.
+
+ 
<script>
+ 
  fetch("https://files.radicle.xyz/releases/latest/radicle.json")
+ 
    .then(res => res.json())
+ 
    .then(data => {
+ 
      const version = data.version;
+ 
      const commit = data.commit;
+ 
      const release = document.getElementById("release");
+ 
      const releaseName = document.getElementById("release-name");
+ 
      const releaseInfo = document.getElementById("release-info");
+
+ 
      document.querySelectorAll("#releases [data-release-binary]").forEach((row) => {
+ 
        const arch = row.dataset.releaseArch;
+ 
        const binary = row.dataset.releaseBinary;
+ 
        const archive = `radicle-${version}-${arch}-${binary}.tar.xz`;
+ 
        const url = `https://files.radicle.xyz/releases/latest/${archive}`;
+
+ 
        row.querySelector(".release-arch").innerText = arch;
+ 
        row.querySelector(".release-url").innerText = archive;
+ 
        row.querySelector(".release-sig").innerText = ".sig";
+ 
        row.querySelector(".release-checksum").innerText = ".sha256";
+
+ 
        row.querySelector(".release-url").href = url;
+ 
        row.querySelector(".release-sig").href = `${url}.sig`;
+ 
        row.querySelector(".release-checksum").href = `${url}.sha256`;
+ 
      });
+
+ 
      release.classList.remove("loading");
+ 
      releaseName.innerText = `Radicle ${version}`;
+ 
      releaseInfo.innerHTML = `Built from commit <strong>${commit}</strong> on ${new Date(data.timestamp * 1000).toUTCString()}.`;
+ 
    });
+ 
</script>
modified assets/css/page.css
@@ -64,7 +64,7 @@ h2#evolvable--extensible::after {
  content: "";

}
- 
p, ul, nav, pre, #install {
+ 
p, ul, nav, pre.diagram, #install {

  margin-left: 2rem;

}
@@ -101,14 +101,43 @@ code {
}



pre {
+ 
  margin-left: 4rem;

  font-family: var(--font-family-code-alt);
- 
  overflow-x: hidden;
- 
  text-overflow: hidden;
- 
  color: var(--color-fg-dim);
+ 
  overflow-x: scroll;
+ 
}
+
+ 
pre code {
+ 
  color: var(--color-fg-highlight-tertiary);

}



pre.diagram {

  line-height: 1;
+ 
  color: var(--color-fg-dim);
+ 
}
+
+ 
th {
+ 
  font-weight: bold;
+ 
}
+
+ 
td, th {
+ 
  padding: 0.5rem 1rem;
+ 
  text-align: left;
+ 
}
+
+ 
thead {
+ 
  border-bottom: 1px solid var(--color-border-default);
+ 
}
+
+ 
tbody tr:nth-child(even) td {
+ 
  background-color: var(--color-bg-highlight);
+ 
}
+
+ 
table {
+ 
  margin-left: 2rem;
+ 
  margin-bottom: 2rem;
+ 
  width: 100%;
+ 
  border-collapse: collapse;
+ 
  border: 1px dashed var(--color-border-hint);

}



strong.highlight {
@@ -116,7 +145,7 @@ strong.highlight {
}



h2 em {
- 
  color: vaR(--color-fg-contrast);
+ 
  color: var(--color-fg-contrast);

  font-weight: normal;

}
@@ -180,6 +209,10 @@ body > main {
  max-width: 96ch;

}
+ 
body.wide > main {
+ 
  max-width: 112ch;
+ 
}
+ 


body > header {

  position: relative;

  color: var(--color-fg-low-contrast);