docs: tweak download page and add source tarball info

ci/subst-release-info.py

@@ -10,21 +10,23 @@ def release_to_links(rel):
     windows = None
     linux_bin = None
 
+    tag_name = "wezterm-%s" % rel["tag_name"]
+
     for asset in rel["assets"]:
         url = asset["browser_download_url"]
         name = asset["name"]
         if "-src.tar.gz" in name:
-            source = (url, name)
+            source = (url, name, tag_name)
         elif ".deb" in name:
-            ubuntu = (url, name)
+            ubuntu = (url, name, tag_name)
         elif ".tar.xz" in name:
-            linux_bin = (url, name)
+            linux_bin = (url, name, tag_name)
         elif ".rpm" in name:
-            fedora = (url, name)
+            fedora = (url, name, tag_name)
         elif "WezTerm-macos-" in name:
-            macos = (url, name)
+            macos = (url, name, tag_name)
         elif "WezTerm-windows-" in name:
-            windows = (url, name)
+            windows = (url, name, tag_name)
 
     return {
         "source": source,
@@ -35,7 +37,6 @@ def release_to_links(rel):
         "windows": windows,
     }
 
-
 def load_release_info():
     with open("/tmp/wezterm.releases.json") as f:
         release_info = json.load(f)
@@ -51,12 +52,15 @@ def load_release_info():
     nightly = release_to_links(nightly)
 
     subst = {}
-    for (kind, (url, name)) in latest.items():
+    for (kind, (url, name, dir)) in latest.items():
         subst["{{ %s_stable }}" % kind] = url
         subst["{{ %s_stable_asset }}" % kind] = name
-    for (kind, (url, name)) in nightly.items():
+        subst["{{ %s_stable_dir }}" % kind] = dir
+
+    for (kind, (url, name, dir)) in nightly.items():
         subst["{{ %s_pre }}" % kind] = url
         subst["{{ %s_pre_asset }}" % kind] = name
+        subst["{{ %s_pre_dir }}" % kind] = dir
 
     with open("docs/installation.markdown", "r") as input:
         with open("docs/installation.md", "w") as output:

docs/installation.markdown

@@ -1,5 +1,5 @@
 
-## Installing a pre-built package on Windows
+## Installing on Windows
 
 Windows 10 or later is required to run WezTerm.
 
@@ -9,7 +9,7 @@ Windows 10 or later is required to run WezTerm.
 2. Extract the zipfile and double-click `wezterm.exe` to run the UI
 3. Configuration instructions can be [found here](configuration.html)
 
-## Installing a pre-built package on macOS
+## Installing on macOS
 
 The CI system builds the package on macOS Mojave (10.14).  It may run on earlier
 versions of macOS, but that has not been tested.
@@ -23,26 +23,34 @@ versions of macOS, but that has not been tested.
 3. Subsequently, a simple double-click will launch the UI
 4. Configuration instructions can be [found here](configuration.html)
 
-## Installing a pre-built package on Ubuntu
+## Installing on Ubuntu
 
 The CI system builds a `.deb` file on Ubuntu 16.04.  It is compatible with other
 debian style systems, including Debian 9 (Stretch) and later versions.
 
 <a href="{{ ubuntu_stable }}" class="btn">Download for Ubuntu</a>
 <a href="{{ ubuntu_pre }}" class="btn">Nightly for Ubuntu</a>
-* <tt>curl -LO <a href="{{ ubuntu_stable }}">{{ ubuntu_stable }}</a></tt>
+
-* `sudo apt install -y ./{{ ubuntu_stable_asset }}`
+```bash
+curl -LO {{ ubuntu_stable }}
+sudo apt install -y ./{{ ubuntu_stable_asset }}
+```
+
 * The package installs `/usr/bin/wezterm` and `/usr/share/applications/wezterm.desktop`
 * Configuration instructions can be [found here](configuration.html)
 
-## Installing a pre-built package on Fedora
+## Installing Fedora
 
 The CI system builds an `.rpm` file on Fedora 31.
 
 <a href="{{ fedora_stable }}" class="btn">Download for Fedora</a>
 <a href="{{ fedora_pre }}" class="btn">Nightly for Fedora</a>
-* <tt>curl -LO <a href="{{ fedora_stable }}">{{ fedora_stable }}</a></tt>
+
-* `sudo dnf install -y ./{{ fedora_stable_asset }}`
+```bash
+curl -LO {{ fedora_stable }}
+sudo dnf install -y ./{{ fedora_stable_asset }}
+```
+
 * The package installs `/usr/bin/wezterm` and `/usr/share/applications/wezterm.desktop`
 * Configuration instructions can be [found here](configuration.html)
 
@@ -58,13 +66,27 @@ You will need a collection of support libraries; the [`get-deps`](https://github
 attempt to install them for you.  If it doesn't know about your system,
 [please contribute instructions!](https://github.com/wez/wezterm/blob/master/CONTRIBUTING.md)
 
-```
+If you don't plan to submit a pull request to the wezterm repo, you can
-$ curl https://sh.rustup.rs -sSf | sh -s
+download a smaller source tarball using these steps:
-$ git clone --depth=1 --branch=master --recursive https://github.com/wez/wezterm.git
+
-$ cd wezterm
+```bash
-$ git submodule update --init --recursive
+curl https://sh.rustup.rs -sSf | sh -s
-$ sudo ./get-deps
+curl -LO {{ source_stable }}
-$ cargo build --release
+tar -xzf {{ source_stable_asset }}
-$ cargo run --release -- start
+cd {{ source_stable_dir }}
+sudo ./get-deps
+cargo build --release
+cargo run --release -- start
 ```
 
+Alternatively, use the full git repo:
+
+```bash
+curl https://sh.rustup.rs -sSf | sh -s
+git clone --depth=1 --branch=master --recursive https://github.com/wez/wezterm.git
+cd wezterm
+git submodule update --init --recursive
+sudo ./get-deps
+cargo build --release
+cargo run --release -- start
+```