Release 34.2.0

Author: be5invis

.dockerignore

@@ -1,5 +1,37 @@
 ## Modifications since last major version
 
+### 34.2.0
+
+* Add Latin localization forms for Sámi languages.
+* Add IPA localization forms for Lower B and D with stroke (`ƀ`, `đ`).
+* Refine shape of the following characters:
+  - LATIN CAPITAL LETTER ENG (`U+014A`).
+  - LATIN CAPITAL LETTER TURNED M (`U+019C`).
+  - LATIN CAPITAL LETTER N WITH LONG RIGHT LEG (`U+0220`).
+  - LATIN CAPITAL LETTER SMALL Q WITH HOOK TAIL (`U+024A`).
+  - LATIN LETTER SMALL CAPITAL G (`U+0262`).
+  - LATIN LETTER SMALL CAPITAL G WITH HOOK (`U+029B`).
+  - LATIN SMALL LETTER LS DIGRAPH (`U+02AA`) ... LATIN SMALL LETTER LZ DIGRAPH (`U+02AB`).
+  - GREEK CAPITAL LETTER IOTA WITH TONOS (`U+038A`).
+  - COMBINING LATIN LETTER SMALL CAPITAL G (`U+1DDB`).
+  - GREEK CAPITAL LETTER IOTA WITH PSILI (`U+1F38`) ... GREEK CAPITAL LETTER IOTA WITH DASIA AND PERISPOMENI (`U+1F3F`).
+  - GREEK CAPITAL LETTER IOTA WITH VARIA (`U+1FDA`) ... GREEK CAPITAL LETTER IOTA WITH OXIA (`U+1FDB`).
+  - SCRIPT SMALL L (`U+2113`).
+  - TELEPHONE SIGN (`U+2121`) (#3080).
+  - FACSIMILE SIGN (`U+213B`) (#3080).
+  - LATIN CAPITAL LETTER ALPHA (`U+2C6D`).
+  - LATIN CAPITAL LETTER TURNED ALPHA (`U+2C70`).
+  - LATIN CAPITAL LETTER INSULAR R (`U+A782`).
+  - LATIN CAPITAL LETTER SCRIPT G (`U+A7AC`).
+  - LATIN CAPITAL LETTER GLOTTAL I (`U+A7BC`).
+  - LATIN SMALL LETTER M WITH CROSSED-TAIL (`U+AB3A`).
+  - MODIFIER LETTER SMALL CAPITAL G (`U+10792`).
+  - MODIFIER LETTER SMALL CAPITAL G WITH HOOK (`U+10794`).
+  - MODIFIER LETTER SMALL LS DIGRAPH (`U+10799`) ... MODIFIER LETTER SMALL LZ DIGRAPH (`U+1079A`).
+  - MATHEMATICAL DOUBLE-STRUCK CAPITAL G (`U+1D53E`).
+  - LATIN LETTER SMALL CAPITAL TURNED G (`U+1DF02`).
+
+
 ### 34.1.0
 
 * Add IPA localization forms for letters with caron (e.g. {`ď`, `Ľ`, `ľ`, `ť`} → {`d͏̌`, `L͏̌`, `l͏̌`, `t͏̌`}).

CHANGELOG.md

@@ -0,0 +1,28 @@
+* Add Latin localization forms for Sámi languages.
+* Add IPA localization forms for Lower B and D with stroke (`ƀ`, `đ`).
+* Refine shape of the following characters:
+  - LATIN CAPITAL LETTER ENG (`U+014A`).
+  - LATIN CAPITAL LETTER TURNED M (`U+019C`).
+  - LATIN CAPITAL LETTER N WITH LONG RIGHT LEG (`U+0220`).
+  - LATIN CAPITAL LETTER SMALL Q WITH HOOK TAIL (`U+024A`).
+  - LATIN LETTER SMALL CAPITAL G (`U+0262`).
+  - LATIN LETTER SMALL CAPITAL G WITH HOOK (`U+029B`).
+  - LATIN SMALL LETTER LS DIGRAPH (`U+02AA`) ... LATIN SMALL LETTER LZ DIGRAPH (`U+02AB`).
+  - GREEK CAPITAL LETTER IOTA WITH TONOS (`U+038A`).
+  - COMBINING LATIN LETTER SMALL CAPITAL G (`U+1DDB`).
+  - GREEK CAPITAL LETTER IOTA WITH PSILI (`U+1F38`) ... GREEK CAPITAL LETTER IOTA WITH DASIA AND PERISPOMENI (`U+1F3F`).
+  - GREEK CAPITAL LETTER IOTA WITH VARIA (`U+1FDA`) ... GREEK CAPITAL LETTER IOTA WITH OXIA (`U+1FDB`).
+  - SCRIPT SMALL L (`U+2113`).
+  - TELEPHONE SIGN (`U+2121`) (#3080).
+  - FACSIMILE SIGN (`U+213B`) (#3080).
+  - LATIN CAPITAL LETTER ALPHA (`U+2C6D`).
+  - LATIN CAPITAL LETTER TURNED ALPHA (`U+2C70`).
+  - LATIN CAPITAL LETTER INSULAR R (`U+A782`).
+  - LATIN CAPITAL LETTER SCRIPT G (`U+A7AC`).
+  - LATIN CAPITAL LETTER GLOTTAL I (`U+A7BC`).
+  - LATIN SMALL LETTER M WITH CROSSED-TAIL (`U+AB3A`).
+  - MODIFIER LETTER SMALL CAPITAL G (`U+10792`).
+  - MODIFIER LETTER SMALL CAPITAL G WITH HOOK (`U+10794`).
+  - MODIFIER LETTER SMALL LS DIGRAPH (`U+10799`) ... MODIFIER LETTER SMALL LZ DIGRAPH (`U+1079A`).
+  - MATHEMATICAL DOUBLE-STRUCK CAPITAL G (`U+1D53E`).
+  - LATIN LETTER SMALL CAPITAL TURNED G (`U+1DF02`).

changes/34.2.0.md

@@ -4101,6 +4101,20 @@ It is possible to create a customized TTC build by using the following method:
   - `npm run build -- ttc::IosevkaCustom`: Create TTCs from collection `IosevkaCustom`; The file will be saved into `dist/.ttc`.
   - `npm run build -- super-ttc::IosevkaCustom`: Create a single-file TTC from collection `IosevkaCustom`; The file will be saved into `dist/.super-ttc`.
 
+#### Single-Group TTCs (SGr)
+
+When your collection contains multiple groups (e.g. different spacing variants), you can also build separate TTCs for each group individually:
+
+  - `npm run build -- sgr-ttc::IosevkaCustom`: Create individual TTCs for each group in collection `IosevkaCustom`; Files will be saved into `dist/.ttc/SGr-<group>/`.
+  - `npm run build -- sgr-super-ttc::IosevkaCustom`: Create individual single-file TTCs for each group in collection `IosevkaCustom`; Files will be saved into `dist/.super-ttc/`.
+
+To build both bundled and single-group TTCs in one command:
+
+  - `npm run build -- all-ttc::IosevkaCustom`: Create both bundled and separate SGr TTCs.
+  - `npm run build -- all-super-ttc::IosevkaCustom`: Create both bundled and separate SGr Super TTCs.
+
+Note: SGR commands require the collection to have more than one group in the `from` array, since they'd otherwise be equivalent to the regular bundled TTCs.
+
 ### Baking other OpenType features
 
 There are tools tha could be used to bake other OpenType that are not configurable with TOML files (like baking localized forms). The tools include:

doc/PACKAGE-LIST.md

@@ -1,19 +1,12 @@
 FROM node:lts-slim
 
-ARG NPM_REG
-
 RUN apt-get update \
     && DEBIAN_FRONTEND=noninteractive apt-get install --no-install-recommends -y \
         ttfautohint \
+        curl \
+        ca-certificates \
     && rm -rf /var/lib/apt/lists/*
 
-# Copy source (excluding files in .dockerignore)
-COPY . /iosevka/
-
-# Install Node.js dependencies
-RUN if [ -n "$NPM_REG" ]; then npm config set registry "$NPM_REG"; fi \
-    && cd /iosevka && npm ci && npm cache clean --force
-
-COPY docker/build.sh /
+COPY --chmod=755 build.sh /
 WORKDIR /work
 ENTRYPOINT ["bash", "/build.sh"]

doc/custom-build.md

@@ -2,76 +2,117 @@
 
 ## 1. Building Docker Image
 
-Before building the font files, we'll first need to build a Docker image. This has to be done only once for a given repo version.
+Before building the font files, we'll first need to build a Docker image. This has to be done only once.
+We're going to use the image name `iosevka-builder` here, but you can set it to whatever you want.
 
-### 1.1. Clone the repo (if you haven't already)
-
-```
+```bash
 git clone --depth 1 https://github.com/be5invis/Iosevka.git
 cd Iosevka
-```
-
-If you want to use a particular version, checkout the appropriate [version tag]((../../../tags)) or branch, for example:
-```
-git checkout v34.0.0
-```
-
-### 1.2. Build the Docker Image
-
-We're going to use image name `iosevka-builder` here, but you can set it to whatever you want. To build an image, run the following from the repo root directory:
-
-```
-docker build -f docker/Dockerfile -t iosevka-builder .
+docker build -t iosevka-builder docker
 ```
 
 To confirm that the docker image now exists, you can run:
-```
+```bash
 docker images | grep iosevka-builder
 ```
 The output should be something like this:
-```
+```bash
 iosevka-builder            latest      c847d5e08886   About a minute ago   491MB
 ```
 
-#### Optional Build Arg
-`--build-arg NPM_REG=<npm repository mirror url>`
-
-Specify `NPM_REG` to use an NPM registry mirror.
+At this point, you can delete the cloned repo, because the Docker container is going to download a fresh copy of the source by default. (That is, unless you want to make the Docker container use a local copy - see below.)
 
-Example:
-```
-docker build -f docker/Dockerfile --build-arg NPM_REG=https://mirrors.huaweicloud.com/repository/npm -t iosevka-builder .
+```bash
+cd ..
+rm -rf Iosevka/
 ```
 
 ## 2. Building Font Files
 
-Once we have a docker image, we can build (and rebuild) font files like so:
-
-```
-docker run -it --rm -v $PWD:/work iosevka-builder <BUILD_ARGS>
+```bash
+docker run -it --rm [-e SOURCE=<SOURCE>] [-e NPM_REG=<URL>] -v $PWD:/work iosevka-builder [<BUILD_ARGS>]
 ```
 
+Optional environment variables include:
+- `SOURCE` - source to download (see formats below). If unset, defaults to latest release.
+- `NPM_REG` - NPM registry mirror URL, e.g. https://mirrors.huaweicloud.com/repository/npm
+
+`SOURCE` accepts several formats:
+
+| Format | Example | Meaning |
+|---|---|---|
+| `ref` | `v34.1.0`, `main`, `abc123f` | Tag, branch or commit |
+| `owner/repo@ref` | `you/YourIosevkaFork@v34.1.0` | Tag, branch or commit from a specific fork repo |
+| `owner/repo` | `you/YourIosevkaFork` | Latest release from a specific fork repo |
+
 For supported `<BUILD_ARGS>`, please refer to [Customized Build](../doc/custom-build.md).
 
-## Examples
-### Custom Build
+Note that each container run will download and unpack a source tarball and install dependencies afresh. If you want to avoid re-downloading source (e.g. when iterating on a build plan) or use a local copy of the source, you'll need to override the Docker entrypoint. Check below for examples.
+
+### Examples
+#### Default Build
+```bash
+docker run -it --rm -v $PWD:/work iosevka-builder
+```
+
+#### Custom Build
 
 This will build Iosevka `ss06` in all formats, `ss12` TTF and `ss15` webfont:
 
-```
-docker run -it --rm -v $PWD:/work iosevka-builder contents::IosevkaSS06 ttf::IosevkaSS12 webfont::IosevkaSS15
-ls -lR dist/ # Recursively list build result directories
+```bash
+docker run -it --rm -e SOURCE=v34.1.0 -v $PWD:/work iosevka-builder contents::IosevkaSS06 ttf::IosevkaSS12 webfont::IosevkaSS15
 ```
 
-### Custom Build Plans
+#### Custom Build Plans
 
 This example will:
-- Gather build plans from `myfont1.toml`, `myfont2.toml` and `myfont3.toml` to a single `private-build-plans.toml` file.
-- Build `myfont1`, `myfont2` TTF, and `myfont3` in all formats.
-```
+- Gather build plans from `myfont1.toml`, `myfont2.toml` and `myfont3.toml` into a single `private-build-plans.toml` file.
+- Build `MyFont1` and `MyFont2` as TTF, and `MyFont3` in all formats.
+```bash
 cat myfont1.toml myfont2.toml myfont3.toml > private-build-plans.toml
-docker run -it --rm -v $PWD:/work iosevka-builder ttf::myfont1 ttf::myfont2 contents::myfont3
-ls -lR dist/ # Recursively list build result directories
+docker run -it --rm -e SOURCE=v34.1.0 -v $PWD:/work iosevka-builder ttf::MyFont1 ttf::MyFont2 contents::MyFont3
+```
+
+To prepare the custom build plans, please refer to [Configuring Custom Build](../doc/custom-build.md#configuring-custom-build) or use the [Customizer](https://be5invis.github.io/Iosevka/customizer).
+
+#### Using a Fork
+
+```bash
+docker run -it --rm -e SOURCE=you/YourIosevkaFork@v34.1.0 -v $PWD:/work iosevka-builder contents::Iosevka
+```
+
+#### Interactive Mode (Downloaded Source)
+
+To keep the downloaded source between builds, override the entrypoint to get an interactive shell.
+`/build.sh` keeps track of the version used for the previous run and re-downloads only if necessary.
+
+```bash
+docker run -it --rm -v $PWD:/work --entrypoint bash iosevka-builder
+$ /build.sh ttf::MyFont
+# Make some changes and rebuild
+$ cat myfont1.toml myfont2.toml myfont3.toml > private-build-plans.toml
+$ /build.sh ttf::MyFont
+# Rebuild with a different source version
+$ SOURCE=v34.0.0 /build.sh ttf::MyFont
+$ exit
+```
+
+#### Using Local Source
+
+To build from a local Iosevka checkout, override the entrypoint like so:
+
+```bash
+docker run -it --rm -v /path/to/iosevka:/work --entrypoint bash iosevka-builder -c 'npm install && npm run build -- ttf::MyFont'
+```
+
+#### Interactive Mode (Local Source)
+
+To run repeated builds from local source in interactive mode:
+
+```bash
+docker run -it --rm -v /path/to/iosevka:/work --entrypoint bash iosevka-builder
+$ npm install
+$ npm run build -- ttf::MyFont
+$ exit
 ```
 
-To prepare the custom build plans, please refer to [Configuring Custom Build](https://github.com/be5invis/Iosevka/blob/main/doc/custom-build.md#configuring-custom-build) or use the [Customizer](https://be5invis.github.io/Iosevka/customizer).

doc/cv-influences.md

@@ -3,19 +3,22 @@ IOSEVKA_DIR="/iosevka"
 WORK_DIR="/work"
 PRIVATE_FILE="private-build-plans.toml"
 DEFAULT_ARGS="contents::Iosevka"
+REPO="be5invis/Iosevka"
+REF=""
 BUILD_ARGS="$@"
+TMP_TARGZ="/tmp/iosevka.tar.gz"
+TMP_HEADERS="/tmp/headers.txt"
 set -e
 
 [[ -z $BUILD_ARGS ]] && echo 'Usage: docker run -it --rm -v $PWD:/work <DOCKER_IMAGE> <BUILD_ARGS>'
 
 [[ -f "${WORK_DIR}/${PRIVATE_FILE}" ]] && {
     echo "Found $PRIVATE_FILE, custom build."
-    cp "${WORK_DIR}/${PRIVATE_FILE}" "${IOSEVKA_DIR}/"
     [[ -z $BUILD_ARGS ]] && {
         FONT_NAME=$(grep -m1 -Po '(?<=\[buildPlans\.)[^\]]+' ${WORK_DIR}/${PRIVATE_FILE})
         [[ -z "$FONT_NAME" ]] && {
             echo "$PRIVATE_FILE file format error!"
-            exit 1
+            exit 2
         }
         BUILD_ARGS="contents::$FONT_NAME"
     }
@@ -26,6 +29,62 @@ set -e
     }
 }
 
+# SOURCE formats: "v34.1.0", "main", "owner/repo@ref", "owner/repo"
+# If unset, defaults to latest release of REPO.
+if [[ "$SOURCE" == *@* ]]; then
+    REPO="${SOURCE%%@*}"
+    REF="${SOURCE#*@}"
+elif [[ "$SOURCE" == */* ]]; then
+    REPO="$SOURCE"
+elif [[ -n "$SOURCE" ]]; then
+    REF="$SOURCE"
+fi
+if [[ -z "$REF" ]]; then
+    REF=$(curl -fsSL -r 0-2047 "https://api.github.com/repos/${REPO}/releases/latest" | grep -Po '"tag_name":\s*"\Kv[\d\.]+') || true
+    [[ -z "$REF" ]] && { echo "Failed to fetch latest release for ${REPO}"; exit 3; }
+    echo "Latest release: ${REF}"
+fi
+# Fetch source tarball if not already downloaded using URL+ETag as unique cache ID.
+# REPO+REF wouldn't suffice - branch head could have changed since last run.
+# We could use commit SHA instead, but that would be an extra API call.
+TARGZ_URL="https://github.com/${REPO}/archive/${REF}.tar.gz"
+ETAG_FILE="$IOSEVKA_DIR/.etag"
+CURL_OPTS=(-sSL -D "$TMP_HEADERS" -o "$TMP_TARGZ" -w '%{http_code}')
+# If request URL is the same as last run, add If-None-Match header
+if [[ -f "$ETAG_FILE" ]] && read -r CACHED_URL CACHED_ETAG < "$ETAG_FILE" && [[ "$CACHED_URL" == "$TARGZ_URL" ]]; then
+    CURL_OPTS+=(-H "If-None-Match: $CACHED_ETAG")
+fi
+
+echo "Fetching ${REPO}@${REF}..."
+HTTP_CODE=$(curl "${CURL_OPTS[@]}" "$TARGZ_URL") || true
+
+if [[ "$HTTP_CODE" == "304" ]]; then
+    echo "Source unchanged (HTTP 304), skipping."
+elif [[ "$HTTP_CODE" == "200" ]]; then
+    echo "Extracting..."
+    rm -rf "$IOSEVKA_DIR"
+    mkdir -p "$IOSEVKA_DIR"
+    tar xz --strip-components=1 -C "$IOSEVKA_DIR" < "$TMP_TARGZ" || {
+        echo "Failed to extract: $TARGZ_URL"; exit 4
+    }
+    # Save ETag for future conditional requests
+    ETAG=$(grep -i '^etag:' "$TMP_HEADERS" | tail -1 | tr -d '\r' | awk '{print $2}')
+    [[ -n "$ETAG" ]] && echo "$TARGZ_URL $ETAG" > "$ETAG_FILE"
+else
+    echo "Failed to download: $TARGZ_URL (HTTP $HTTP_CODE)"; exit 5
+fi
+rm -f "$TMP_TARGZ" "$TMP_HEADERS"
+
+if [[ -d "$IOSEVKA_DIR/node_modules" ]]; then
+    echo "Dependencies already installed, skipping npm ci."
+else
+    echo "Installing npm dependencies..."
+    [[ -n "$NPM_REG" ]] && npm config set registry "$NPM_REG"
+    cd "$IOSEVKA_DIR" && npm ci
+fi
+
+[[ -f "${WORK_DIR}/${PRIVATE_FILE}" ]] && cp "${WORK_DIR}/${PRIVATE_FILE}" "${IOSEVKA_DIR}/"
+
 echo "Building fonts with: $BUILD_ARGS"
 
 cd "$IOSEVKA_DIR"