Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 51 additions & 0 deletions Makefile
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Makefile for managing the Swift website with container

# Define the container runtime. Default to `container`.
# Can be overridden from the command line, e.g., `make CONTAINER=docker website`
CONTAINER ?= container

.PHONY: help build run-build website stop clean

help:
@echo "Usage:"
@echo " make build Build the swift-website-builder container image"
@echo " make run-build Build the Jekyll website"
@echo " make website Run the Jekyll development server"
@echo " make stop Stop the running website container"
@echo " make clean Stop the container and remove the build output"
@echo ""
@echo "To use a different container runtime (e.g. podman), run:"
@echo " make CONTAINER=podman build"

# Build the primary container image
build:
$(CONTAINER) build --tag swift-website-builder --file Dockerfile .

# Run a one-off Jekyll build
run-build:
@mkdir -p ./.output
$(CONTAINER) run --rm \
-v "$(CURDIR)":/srv/jekyll \
-v "$(CURDIR)/.output":/output \
swift-website-builder \
/bin/bash -cl "bundle check && bundle exec jekyll build --source /srv/jekyll --destination /output"

# Run the development web server
website:
@mkdir -p ./.output
$(CONTAINER) run -d --rm --name swift-website \
-p 4000:4000 \
-v "$(CURDIR)":/srv/jekyll \
-v "$(CURDIR)/.output":/output \
swift-website-builder \
/bin/bash -cl "bundle check && bundle exec jekyll serve --source /srv/jekyll --destination /output --host 0.0.0.0 --watch"
@echo "Website is running at http://localhost:4000"

# Stop the development server
stop:
$(CONTAINER) stop swift-website

# Clean up build artifacts
clean: stop
@echo "Removing .output directory..."
@rm -rf ./.output
20 changes: 20 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,26 @@ npm install
npm run prettify
```

### Running with Apple Container

On macOS 26 and later, you can use the [Apple Container](https://github.com/apple/container) tool to host and run the website.

First install and run `container`:

```shell
brew install container
brew services start container
```

Then build and run the site:

```shell
make build
make website
```

The website will be available at `http://localhost:4000`

### Running in Docker

First build the site with Docker Compose:
Expand Down
2 changes: 1 addition & 1 deletion _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ url: https://swift.org
title: Swift.org
description: "Swift is a general-purpose programming language built using a modern approach to safety, performance, and software design patterns."
timezone: America/Lower_Princes
exclude: ["README.md", "config.ru", "Gemfile", "Gemfile.lock", "Procfile", "vendor", "get-started/storybook"]
exclude: ["README.md", "config.ru", "Gemfile", "Gemfile.lock", "Procfile", "vendor", "get-started/storybook", "Makefile"]
safe: false
future: true

Expand Down
29 changes: 28 additions & 1 deletion _data/authors.yml
Original file line number Diff line number Diff line change
Expand Up @@ -243,6 +243,10 @@ parkera:
github: parkera
about: "Tony Parker manages teams at Apple working on Foundation, Swift packages, and the Swift Standard Library."

android-workgroup:
name: The Android workgroup
about: "The Android workgroup works toward furthering Swift on Android."

diversity-workgroup:
name: The Diversity in Swift workgroup
about: "The Diversity in Swift workgroup is a group of volunteers working to make our community more approachable and inclusive."
Expand Down Expand Up @@ -560,11 +564,29 @@ mitchellallison:
github: mitchellallison
about: "Mitchell Allison works on Distributed Systems in Swift at Apple."

kelvin:
name: Tien Quoc (Kelvin) Bui
email: tien-quoc.bui@epita.fr
github: tienquocbui
about: "Kelvin is a Google Summer of Code 2025 code contributor, where he worked on improving the console output for Swift Testing."

stmontgomery:
name: Stuart Montgomery
email: smontgomery@apple.com
github: stmontgomery
about: "Stuart is a member of the Testing Workgroup and manages the Swift Testing Frameworks team at Apple."

ahmedelrefaey:
name: Ahmed Elrefaey
email: a7med.mahmoud2004@gmail.com
github: a7medev
about: "Ahmed is a software developer at Luciq. During Google Summer of Code 2025, he worked on improving the display of Swift documentation during code completion in SourceKit-LSP and VS Code."

mads:
name: Mads Odgaard
email: mads@madsodgaard.com
github: madsodgaard
about: Mads is a Tech Lead at Frameo. During Google Summer of Code 2025, he worked on bringing JNI support to the jextract tool which is part of the Swift Java interoperability project.
about: "Mads is a Tech Lead at Frameo. During Google Summer of Code 2025, he worked on bringing JNI support to the jextract tool which is part of the Swift Java interoperability project."

priyambada:
name: Priyambada Roul
Expand All @@ -584,3 +606,8 @@ davelester:
github: davelester
gravatar: "376decb8be2d1c50df06daf50ef3b6b5"
about: "Dave Lester is a Senior Product Manager at Apple and member of the Swift website workgroup."

doug_gregor:
name: Doug Gregor
github: DougGregor
about: "Doug Gregor is a member of the Language Steering Group and works on the Swift compiler and runtime."
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/amazonlinux2-aarch64.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-amazonlinux2-aarch64.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-amazonlinux2-aarch64.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-amazonlinux2-aarch64.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/amazonlinux2.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-amazonlinux2.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-amazonlinux2.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-amazonlinux2.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/debian12-aarch64.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-debian12-aarch64.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-debian12-aarch64.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-debian12-aarch64.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/debian12.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-debian12.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-debian12.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-debian12.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/fedora39-aarch64.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-fedora39-aarch64.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-fedora39-aarch64.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-fedora39-aarch64.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/fedora39.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-fedora39.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-fedora39.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-fedora39.tar.gz
Expand Down
6 changes: 6 additions & 0 deletions _data/builds/swift-6_2-branch/static-sdk.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
- checksum: c44f15dfe7d5a9c83593b4226a59bd72885b711113f7d48a6d8b16c626d079f8
date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a_static-linux-0.0.1.artifactbundle.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a_static-linux-0.0.1.artifactbundle.tar.gz.sig
name: Swift Static SDK Development Snapshot
- checksum: 890dfa620fd60b48ecdaaedf5c2f2d2860ed97b4af34a6b7c4fba692468e7094
date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/ubi9-aarch64.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubi9-aarch64.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubi9-aarch64.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-ubi9-aarch64.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/ubi9.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubi9.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubi9.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-ubi9.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/ubuntu2204-aarch64.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubuntu22.04-aarch64.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubuntu22.04-aarch64.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-ubuntu22.04-aarch64.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/ubuntu2204.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubuntu22.04.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubuntu22.04.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-ubuntu22.04.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/ubuntu2404-aarch64.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubuntu24.04-aarch64.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubuntu24.04-aarch64.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-ubuntu24.04-aarch64.tar.gz
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/ubuntu2404.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubuntu24.04.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-ubuntu24.04.tar.gz.sig
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-ubuntu24.04.tar.gz
Expand Down
6 changes: 6 additions & 0 deletions _data/builds/swift-6_2-branch/wasm-sdk.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
- checksum: 46f3aa096d1b62d3ebb60e502dfffa13be5c60a7a2ec29194784cb6a52f1aecb
date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a_wasm.artifactbundle.tar.gz
download_signature: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a_wasm.artifactbundle.tar.gz.sig
name: Swift Wasm SDK Development Snapshot
- checksum: af999295b5dfebd39958942c5ed52650e6431ed3eefe4487278efac22aaef307
date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
Expand Down
4 changes: 4 additions & 0 deletions _data/builds/swift-6_2-branch/windows10-arm64.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-windows10-arm64.exe
name: Windows 10 Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-windows10-arm64.exe
Expand Down
4 changes: 4 additions & 0 deletions _data/builds/swift-6_2-branch/windows10.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
- date: 2025-11-14 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-windows10.exe
name: Windows 10 Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-windows10.exe
Expand Down
5 changes: 5 additions & 0 deletions _data/builds/swift-6_2-branch/xcode.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
- date: 2025-11-14 10:10:00-06:00
debug_info: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-osx-symbols.pkg
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a
download: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-14-a-osx.pkg
name: Swift Development Snapshot
- date: 2025-11-05 10:10:00-06:00
debug_info: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a-osx-symbols.pkg
dir: swift-6.2-DEVELOPMENT-SNAPSHOT-2025-11-05-a
Expand Down
2 changes: 1 addition & 1 deletion _data/new-data/install/windows/releases.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ latest-release:
Install Swift via the Windows Package Manager (also known as WinGet).
after-code-text: |
First, install Windows platform dependencies:
<pre><code>winget install --id Microsoft.VisualStudio.2022.Community --exact --force --custom "--add Microsoft.VisualStudio.Component.Windows11SDK.22000 --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.VC.Tools.ARM64"</code></pre>
<pre><code>winget install --id Microsoft.VisualStudio.2022.Community --exact --force --custom "--add Microsoft.VisualStudio.Component.Windows11SDK.22621 --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.VC.Tools.ARM64"</code></pre>
<br />
Next, install Swift and other dependencies:
<br /><br />
Expand Down
Loading