From 28f3b260d92434d9a48150afa13f9b0e39036b8d Mon Sep 17 00:00:00 2001 From: Sebastian 'gonX' Jensen Date: Wed, 2 Sep 2026 11:26:57 +0200 Subject: [PATCH 1/4] Unify OpenTabletDriver .NET version to single reference Simplifies maintenance when upstream .NET versions inevitably change --- site/_config.yml | 2 ++ site/_sections/Framework.md | 12 ++++++++---- site/_wiki/Install/Windows.md | 2 +- 3 files changed, 11 insertions(+), 5 deletions(-) diff --git a/site/_config.yml b/site/_config.yml index bfe9f413..bd2ca9b2 100644 --- a/site/_config.yml +++ b/site/_config.yml @@ -23,6 +23,8 @@ description: >- # this means to ignore newlines until "baseurl:" OpenTabletDriver is an open source, cross-platform, low latency, user-mode tablet driver. baseurl: "" # webserver path, blank for GitHub pages url: https://opentabletdriver.net # full URI to website +# the .NET runtime version used by OpenTabletDriver. Used for user-facing content and download links +otd_dotnet_version: 8.0 sass: sass_dir: _sass diff --git a/site/_sections/Framework.md b/site/_sections/Framework.md index 378a9171..66ec23b8 100644 --- a/site/_sections/Framework.md +++ b/site/_sections/Framework.md @@ -2,15 +2,19 @@ title: Frameworks --- +# .NET Desktop Runtime + +OpenTabletDriver currently uses .NET {{ site.otd_dotnet_version }}. + ## Windows -[x64](https://aka.ms/dotnet/8.0/windowsdesktop-runtime-win-x64.exe) +[x64](https://aka.ms/dotnet/{{ site.otd_dotnet_version }}/windowsdesktop-runtime-win-x64.exe) ## MacOS -[arm64](https://aka.ms/dotnet/8.0/dotnet-runtime-osx-arm64.pkg) +[arm64](https://aka.ms/dotnet/{{ site.otd_dotnet_version }}/dotnet-runtime-osx-arm64.pkg) -[x86-64/x64 (Intel based)](https://aka.ms/dotnet/8.0/dotnet-runtime-osx-x64.pkg) +[x86-64/x64 (Intel based)](https://aka.ms/dotnet/{{ site.otd_dotnet_version }}/dotnet-runtime-osx-x64.pkg) ## Linux @@ -18,4 +22,4 @@ See the [official Linux installation documentation](https://docs.microsoft.com/e ## Uncommon builds -[Windows arm64](https://aka.ms/dotnet/8.0/windowsdesktop-runtime-win-arm64.exe) +[Windows arm64](https://aka.ms/dotnet/{{ site.otd_dotnet_version }}/windowsdesktop-runtime-win-arm64.exe) diff --git a/site/_wiki/Install/Windows.md b/site/_wiki/Install/Windows.md index 498a6d39..ed7b7cca 100644 --- a/site/_wiki/Install/Windows.md +++ b/site/_wiki/Install/Windows.md @@ -5,7 +5,7 @@ hide_from_auto_list: true ## Dependencies {#dependencies} -1. Install the [.NET 8 Desktop Runtime x64]({% link _sections/Framework.md %}) +1. Install the [.NET {{ site.otd_dotnet_version }} Desktop Runtime x64]({% link _sections/Framework.md %}) If you were previously using the standalone installer/updater (before v0.6), switch to the new method for installing OpenTabletDriver below. From be3f7dda41ce489e2458aa4c3901f66f6da560ff Mon Sep 17 00:00:00 2001 From: Sebastian 'gonX' Jensen Date: Wed, 2 Sep 2026 11:34:05 +0200 Subject: [PATCH 2/4] sections/Framework: Move all headings 1 level up (for linting) --- site/_sections/Framework.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/site/_sections/Framework.md b/site/_sections/Framework.md index 66ec23b8..570ab986 100644 --- a/site/_sections/Framework.md +++ b/site/_sections/Framework.md @@ -2,24 +2,24 @@ title: Frameworks --- -# .NET Desktop Runtime +## .NET Desktop Runtime OpenTabletDriver currently uses .NET {{ site.otd_dotnet_version }}. -## Windows +### Windows [x64](https://aka.ms/dotnet/{{ site.otd_dotnet_version }}/windowsdesktop-runtime-win-x64.exe) -## MacOS +### MacOS [arm64](https://aka.ms/dotnet/{{ site.otd_dotnet_version }}/dotnet-runtime-osx-arm64.pkg) [x86-64/x64 (Intel based)](https://aka.ms/dotnet/{{ site.otd_dotnet_version }}/dotnet-runtime-osx-x64.pkg) -## Linux +### Linux See the [official Linux installation documentation](https://docs.microsoft.com/en-us/dotnet/core/install/linux). -## Uncommon builds +### Uncommon builds [Windows arm64](https://aka.ms/dotnet/{{ site.otd_dotnet_version }}/windowsdesktop-runtime-win-arm64.exe) From 9d25f87912c77a53346c8b70342e44698d32faea Mon Sep 17 00:00:00 2001 From: Sebastian 'gonX' Jensen Date: Wed, 2 Sep 2026 11:56:07 +0200 Subject: [PATCH 3/4] workflows/linter: Rewrite markdowncli ignore_files to allow more files later Apparently there is an official way to do this, so this commit moves the ignore file list to that spec. This should also ensure that local invocations of markdownlint-cli has expected behavior. --- .github/workflows/linter.yml | 1 - .markdownlintignore | 1 + 2 files changed, 1 insertion(+), 1 deletion(-) create mode 100644 .markdownlintignore diff --git a/.github/workflows/linter.yml b/.github/workflows/linter.yml index 3fd3c2f5..455b02e5 100644 --- a/.github/workflows/linter.yml +++ b/.github/workflows/linter.yml @@ -29,4 +29,3 @@ jobs: with: files: . dot: true - ignore_files: site/_includes/ # needs special treatment, ignore for now diff --git a/.markdownlintignore b/.markdownlintignore new file mode 100644 index 00000000..357c1dcc --- /dev/null +++ b/.markdownlintignore @@ -0,0 +1 @@ +site/_includes/ From d10766608a5fb64df0fe70fd6e9a6648a8448248 Mon Sep 17 00:00:00 2001 From: Sebastian 'gonX' Jensen Date: Wed, 2 Sep 2026 12:05:42 +0200 Subject: [PATCH 4/4] markdownlintignore: Ignore Framework section It fails linter checks because it contains URL fragments with Liquid tags inside of them --- .markdownlintignore | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.markdownlintignore b/.markdownlintignore index 357c1dcc..4363b8a5 100644 --- a/.markdownlintignore +++ b/.markdownlintignore @@ -1 +1,5 @@ +# FIXME: Issue #126, markdowncli checks markdown before Liquid tags are rendered +# https://github.com/OpenTabletDriver/opentabletdriver.github.io/issues/126 +# This file shouldn't be necessary once the above issue is solved site/_includes/ +site/_sections/Framework.md