Rsclub2_2/kst4contest
1
0
Fork 0
mirror of https://github.com/praktimarc/kst4contest.git synced 2026-08-24 19:17:07 +02:00
Code Issues Packages Projects Releases Wiki Activity

website-manual download refactored

Browse Source
This commit is contained in:
Marc Froehlich
2026-07-20 23:58:47 +02:00
parent 0b6120defc
commit 039e64eea0
2 changed files with 99 additions and 66 deletions
Download Patch File Download Diff File Expand all files Collapse all files
website/src/_data/downloads.js
+69 -29
View File
@@ -1,31 +1,69 @@
const REPO = "praktimarc/kst4contest";
const API = `https://api.github.com/repos/${REPO}`;
const FALLBACK_TAG = "v1.41.1";
const LATEST_RELEASE_URL = `https://github.com/${REPO}/releases/latest`;
async function fetchLatestReleaseTag() {
const headers = { Accept: "application/vnd.github+json" };
if (process.env.GITHUB_TOKEN) {
headers.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
}
try {
const res = await fetch(`${API}/releases/latest`, { headers });
if (!res.ok) {
throw new Error(`GitHub API /releases/latest failed: ${res.status}`);
throw new Error(
`GitHub API /releases/latest failed: ${res.status}`
);
}
const release = await res.json();
return release.tag_name || FALLBACK_TAG;
if (!release.tag_name) {
throw new Error(
"GitHub API response did not contain a release tag"
);
}
return release.tag_name;
} catch (err) {
console.warn(`[downloads] Could not load latest release tag, falling back to ${FALLBACK_TAG}: ${err.message}`);
return FALLBACK_TAG;
console.warn(
`[downloads] Could not load the latest release tag. ` +
`Download buttons will open the latest release page instead: ${err.message}`
);
return null;
}
}
// Builds the download list from the latest GitHub release tag so it never
// drifts out of sync with what tagged-release.yml actually published.
/**
* Creates a direct link to an asset from the latest Stable release.
*
* If the GitHub API was unavailable during the build, the function deliberately
* returns the generic latest-release page instead of using a hard-coded and
* increasingly outdated fallback version.
*/
function createAssetUrl(latestTag, filenameTemplate) {
if (!latestTag) {
return LATEST_RELEASE_URL;
}
const filename = filenameTemplate.replace(/\{tag\}/g, latestTag);
return `https://github.com/${REPO}/releases/download/${latestTag}/${filename}`;
}
/**
* Builds the download list from the latest Stable GitHub release.
*
* The filenames must remain aligned with the artifacts produced by
* .github/workflows/tagged-release.yml.
*/
module.exports = async function () {
const latestTag = await fetchLatestReleaseTag();
const base = `https://github.com/${REPO}/releases/download/${latestTag}`;
const assetUrl = (filenameTemplate) =>
createAssetUrl(latestTag, filenameTemplate);
return [
{
@@ -33,80 +71,82 @@ module.exports = async function () {
format: "ZIP x64",
icon: "🪟",
recommended: true,
note: "Best choice for most Windows users.",
url: `${base}/praktiKST-${latestTag}-windows-x64.zip`
note: "Extract the complete archive, then start praktiKST.exe. No separate Java installation is required.",
url: assetUrl("praktiKST-{tag}-windows-x64.zip")
},
{
os: "Linux",
format: "Flatpak (.flatpakref)",
icon: "🐧",
recommended: true,
note: "Recommended for most Linux users. Open the file with GNOME Software / Discover, or run: flatpak install de.x08.KST4Contest.flatpakref",
url: `${base}/de.x08.KST4Contest.flatpakref`
note: "Installs through Flatpak and can be updated through Flatpak or the desktop software centre.",
url: assetUrl("de.x08.KST4Contest.flatpakref")
},
{
os: "Linux",
format: "AppImage x86_64",
icon: "🐧",
recommended: false,
note: "Portable Linux build without package installation.",
url: `${base}/KST4Contest-${latestTag}-linux-x86_64.AppImage`
note: "Portable build without package installation. Make the downloaded file executable before the first launch.",
url: assetUrl("KST4Contest-{tag}-linux-x86_64.AppImage")
},
{
os: "Debian / Ubuntu",
format: "DEB amd64",
icon: "📦",
recommended: false,
note: "Native package for Debian and Ubuntu based systems.",
url: `${base}/KST4Contest-${latestTag}-debian-amd64.deb`
note: "Native package for Debian, Ubuntu and distributions based on them.",
url: assetUrl("KST4Contest-{tag}-debian-amd64.deb")
},
{
os: "Fedora",
format: "RPM x86_64",
icon: "📦",
recommended: false,
note: "Native package for Fedora/RPM based systems.",
url: `${base}/KST4Contest-${latestTag}-fedora-x86_64.rpm`
note: "Native package built for Fedora and compatible RPM-based systems.",
url: assetUrl("KST4Contest-{tag}-fedora-x86_64.rpm")
},
{
os: "Arch Linux",
format: "pkg.tar.zst",
icon: "📦",
recommended: false,
note: "Package build for Arch Linux users.",
url: `${base}/KST4Contest-${latestTag}-archlinux-x86_64.pkg.tar.zst`
note: "Release package for direct installation with pacman. AUR alternatives are described in the installation guide.",
url: assetUrl(
"KST4Contest-{tag}-archlinux-x86_64.pkg.tar.zst"
)
},
{
os: "macOS Apple Silicon",
format: "DMG arm64",
icon: "🍎",
recommended: false,
note: "For Apple Silicon Macs.",
url: `${base}/KST4Contest-${latestTag}-macos-arm64.dmg`
note: "Best-effort build for Apple Silicon Macs. The application is not currently notarized by Apple.",
url: assetUrl("KST4Contest-{tag}-macos-arm64.dmg")
},
{
os: "macOS Intel",
format: "DMG x86_64",
icon: "🍎",
recommended: false,
note: "For Intel-based Macs.",
url: `${base}/KST4Contest-${latestTag}-macos-x86_64.dmg`
note: "Best-effort build for Intel Macs. The application is not currently notarized by Apple.",
url: assetUrl("KST4Contest-{tag}-macos-x86_64.dmg")
},
{
os: "Manual English",
format: "PDF",
icon: "📘",
recommended: false,
note: "English PDF manual.",
url: `${base}/KST4Contest-${latestTag}-manual-en.pdf`
note: "English PDF manual included with the Stable release.",
url: assetUrl("KST4Contest-{tag}-manual-en.pdf")
},
{
os: "Manual German",
format: "PDF",
icon: "📘",
recommended: false,
note: "German PDF manual.",
url: `${base}/KST4Contest-${latestTag}-manual-de.pdf`
note: "German PDF manual included with the Stable release.",
url: assetUrl("KST4Contest-{tag}-manual-de.pdf")
}
];
};
};