From db4291695913a22c5ee2c6579c3a447cc10d19c4 Mon Sep 17 00:00:00 2001
From: Dandaedre
Date: Sat, 14 Nov 2026 18:08:56 +0100
Subject: [PATCH] Use absolute Gitea file links in README
---
README.md | 70 +++++++++++++-------------
docs/ascii-names/changelog.md | 2 +
docs/exporter/changelog.md | 2 +
docs/media-player-classic/changelog.md | 2 +
docs/midra-layout/changelog.md | 2 +
docs/pptx-reporter/changelog.md | 2 +
docs/rundown-converter/changelog.md | 2 +
7 files changed, 47 insertions(+), 35 deletions(-)
diff --git a/README.md b/README.md
index 4613583..0e37d98 100644
--- a/README.md
+++ b/README.md
@@ -9,11 +9,11 @@
- Portable releases ·
+ Portable releases ·
Quick start ·
- Documentation ·
- What's new ·
- Development
+ Documentation ·
+ What's new ·
+ Development
## Choose your tool
@@ -21,64 +21,64 @@
## Quick start
-**Start with a portable app:** see [release bundles and platform instructions](docs/development/releases.md).
+**Start with a portable app:** see [release bundles and platform instructions](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/releases.md).
For PPTX Reporter, extract the ZIP and open `pptx-reporter-gui.exe` on Windows
or run `./pptx-reporter-gui` on macOS 13+. Choose the macOS archive for
-[Apple Silicon or Intel](docs/development/releases.md#macos). Keep the bundled FFprobe beside the app.
+[Apple Silicon or Intel](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/releases.md#macos). Keep the bundled FFprobe beside the app.
Drop a presentation or video folder into the reporter, choose report formats,
-and generate. The [illustrated guide](docs/pptx-reporter/visual-guide.md) walks through each step;
-a [Windows quick start](docs/pptx-reporter/windows-quickstart.txt) is also available.
+and generate. The [illustrated guide](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/pptx-reporter/visual-guide.md) walks through each step;
+a [Windows quick start](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/pptx-reporter/windows-quickstart.txt) is also available.
Run from source — Rust apps and Python exporter
@@ -102,7 +102,7 @@ python3 tools/exporter.py presentation.pptx --output pdf,images
The reporter needs FFprobe; PDF generation is built in. The exporter needs
DeckCraft for PPTX or PdfCraft for PDF input. CLI tools support `--help`.
-See [development setup](docs/development/README.md) for prerequisites and checks.
+See [development setup](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/README.md) for prerequisites and checks.
@@ -115,12 +115,12 @@ Ready-made canvases with two named 16:9 layers. Choose a size, then a format.
These starter files contain two named 16:9 layers on an exact pixel canvas.
-- **Full HD — 1920 × 1080:** [SVG](docs/templates/midra-layout/midra-layout-1080p-2-layers.svg) · [draw.io](docs/templates/midra-layout/midra-layout-1080p-2-layers.drawio) · [JSON](docs/templates/midra-layout/midra-layout-1080p-2-layers.json) · [CSV](docs/templates/midra-layout/midra-layout-1080p-2-layers.csv) · [DXF](docs/templates/midra-layout/midra-layout-1080p-2-layers.dxf) · [HTML](docs/templates/midra-layout/midra-layout-1080p-2-layers.html) · [PPTX](docs/templates/midra-layout/midra-layout-1080p-2-layers.pptx) · [Figma FIG](docs/templates/midra-layout/midra-layout-1080p-2-layers.fig) · [Illustrator AI](docs/templates/midra-layout/midra-layout-1080p-2-layers.ai)
-- **UHD 4K — 3840 × 2160:** [SVG](docs/templates/midra-layout/midra-layout-4k-2-layers.svg) · [draw.io](docs/templates/midra-layout/midra-layout-4k-2-layers.drawio) · [JSON](docs/templates/midra-layout/midra-layout-4k-2-layers.json) · [CSV](docs/templates/midra-layout/midra-layout-4k-2-layers.csv) · [DXF](docs/templates/midra-layout/midra-layout-4k-2-layers.dxf) · [HTML](docs/templates/midra-layout/midra-layout-4k-2-layers.html) · [PPTX](docs/templates/midra-layout/midra-layout-4k-2-layers.pptx) · [Figma FIG](docs/templates/midra-layout/midra-layout-4k-2-layers.fig) · [Illustrator AI](docs/templates/midra-layout/midra-layout-4k-2-layers.ai)
+- **Full HD — 1920 × 1080:** [SVG](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.svg) · [draw.io](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.drawio) · [JSON](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.json) · [CSV](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.csv) · [DXF](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.dxf) · [HTML](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.html) · [PPTX](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.pptx) · [Figma FIG](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.fig) · [Illustrator AI](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-1080p-2-layers.ai)
+- **UHD 4K — 3840 × 2160:** [SVG](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.svg) · [draw.io](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.drawio) · [JSON](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.json) · [CSV](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.csv) · [DXF](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.dxf) · [HTML](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.html) · [PPTX](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.pptx) · [Figma FIG](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.fig) · [Illustrator AI](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/templates/midra-layout/midra-layout-4k-2-layers.ai)
PPTX and FIG samples contain an editable slide/frame; AI samples were generated with
VectorCraft 0.24.1. Midra imports/exports Illustrator AI using an optional
-local VectorCraft CLI. See [formats, dependencies and licensing builds](docs/interfaces/midra-layout-exchange.md#optional-native-document-codecs-and-licensing-builds).
+local VectorCraft CLI. See [formats, dependencies and licensing builds](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/interfaces/midra-layout-exchange.md#optional-native-document-codecs-and-licensing-builds).
@@ -128,8 +128,8 @@ local VectorCraft CLI. See [formats, dependencies and licensing builds](docs/int
| Resource | Links |
| --- | --- |
-| Updates | [Per-tool changelogs](docs/changelogs.md) |
-| Build and contribute | [Development](docs/development/README.md) · [CI and coverage](docs/development/ci.md) · [Cross builds and releases](docs/development/releases.md) |
-| Desktop integration | [App icons and launchers](docs/development/releases.md#application-artwork) |
-| Midra internals | [Project format](docs/interfaces/midra-layout.md) · [Device checks](docs/midra-layout/device-check.md) · [Plan](docs/midra-layout/plan.md) |
-| What's next | [Ideas](Ideas.md) · [Program task list](docs/planning/program-task-list.md) |
+| Updates | [Per-tool changelogs](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/changelogs.md) |
+| Build and contribute | [Development](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/README.md) · [CI and coverage](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/ci.md) · [Cross builds and releases](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/releases.md) |
+| Desktop integration | [App icons and launchers](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/development/releases.md#application-artwork) |
+| Midra internals | [Project format](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/interfaces/midra-layout.md) · [Device checks](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/midra-layout/device-check.md) · [Plan](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/midra-layout/plan.md) |
+| What's next | [Ideas](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/Ideas.md) · [Program task list](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools/src/branch/main/docs/planning/program-task-list.md) |
diff --git a/docs/ascii-names/changelog.md b/docs/ascii-names/changelog.md
index e31c8d2..a18babb 100644
--- a/docs/ascii-names/changelog.md
+++ b/docs/ascii-names/changelog.md
@@ -4,6 +4,8 @@
## Unreleased
+- Use absolute Gitea main-branch URLs for repository file links in the root README; verify linked files exist.
+
## v0.6.0 — 2026-11-14
- Synchronize the shared Cargo package version with the v0.6.0 milestone tag; see the [release notes](../releases/v0.6.0.md).
diff --git a/docs/exporter/changelog.md b/docs/exporter/changelog.md
index 37ade09..3a76a4b 100644
--- a/docs/exporter/changelog.md
+++ b/docs/exporter/changelog.md
@@ -4,6 +4,8 @@
## Unreleased
+- Use absolute Gitea main-branch URLs for repository file links in the root README; verify linked files exist.
+
## v0.6.0 — 2026-11-14
- Group the guide and supporting documentation in this tool’s folder; update portal, cross-document and packaging links for the new paths.
diff --git a/docs/media-player-classic/changelog.md b/docs/media-player-classic/changelog.md
index dd956ed..03a09f7 100644
--- a/docs/media-player-classic/changelog.md
+++ b/docs/media-player-classic/changelog.md
@@ -4,6 +4,8 @@
## Unreleased
+- Use absolute Gitea main-branch URLs for repository file links in the root README; verify linked files exist.
+
## v0.6.0 — 2026-11-14
- Add ImageGen application artwork in PNG, Windows ICO and macOS ICNS formats. Artwork is available for shortcuts and documentation; the tool remains hosted by its terminal or Companion.
diff --git a/docs/midra-layout/changelog.md b/docs/midra-layout/changelog.md
index 24ce132..7ffad27 100644
--- a/docs/midra-layout/changelog.md
+++ b/docs/midra-layout/changelog.md
@@ -4,6 +4,8 @@
## Unreleased
+- Use absolute Gitea main-branch URLs for repository file links in the root README; verify linked files exist.
+
## v0.6.0 — 2026-11-14
- Synchronize the shared Cargo package version with the v0.6.0 milestone tag; see the [release notes](../releases/v0.6.0.md).
diff --git a/docs/pptx-reporter/changelog.md b/docs/pptx-reporter/changelog.md
index 31e661b..32fdedc 100644
--- a/docs/pptx-reporter/changelog.md
+++ b/docs/pptx-reporter/changelog.md
@@ -4,6 +4,8 @@
## Unreleased
+- Use absolute Gitea main-branch URLs for repository file links in the root README; verify linked files exist.
+
## v0.6.0 — 2026-11-14
- Synchronize the shared Cargo package version with the v0.6.0 milestone tag; see the [release notes](../releases/v0.6.0.md).
diff --git a/docs/rundown-converter/changelog.md b/docs/rundown-converter/changelog.md
index 0cb46cc..13dbd63 100644
--- a/docs/rundown-converter/changelog.md
+++ b/docs/rundown-converter/changelog.md
@@ -4,6 +4,8 @@
## Unreleased
+- Use absolute Gitea main-branch URLs for repository file links in the root README; verify linked files exist.
+
## v0.6.0 — 2026-11-14
- Synchronize the shared Cargo package version with the v0.6.0 milestone tag; see the [release notes](../releases/v0.6.0.md).