chore: add sethLabels deployment-fork scaffold

Adds Seth's homelab convention files on top of upstream glabels-qt master:
CLAUDE.md (project instructions), IDEA.md (brief), DECISIONS.md (decision
log, empty), and the kickoff handoff under .claude/handoffs/. Appends a
clearly-marked sethLabels section to .gitignore for .backup/, the
GITEA_API.md symlink, .env files, and handoff drafts.

This is the only non-upstream commit on main. All preceding history is
authored by the glabels.org team (Jaye Evins et al.) and untouched.
Future upstream merges should fast-forward or rebase cleanly since the
scaffold lives in distinct files at repo root.

No source-code changes. License unchanged (GPL-3.0).

.claude/handoffs/2026-04-29-125823-scaffold-only.md

@@ -0,0 +1,73 @@
+# Handoff: sethLabels scaffolded — no code yet
+
+## Session Metadata
+
+- Created: 2026-04-29 12:58:23 UTC
+- Project: /home/claude/bin/sethLabels
+- Branch: n/a (no git repo yet)
+- Session duration: ~5 min
+- Live URL: n/a
+
+## Handoff Chain
+
+- **Continues from:** None — this is the project's first handoff.
+- **Supersedes:** None.
+
+## Current State Summary
+
+Project directory scaffolded per `~/bin/CREATE_PROJECT.md` as a deployment fork of upstream [glabels-qt](https://github.com/j-evins/glabels-qt). No code has been pulled, no git repo initialized, no Gitea repo created. Only the `~/bin/`-convention files exist:
+
+```
+sethLabels/
+├── CLAUDE.md           durable project instructions
+├── DECISIONS.md        empty decision log (template-derived, header set)
+├── GITEA_API.md        symlink → ~/bin/GITEA_API.md
+├── IDEA.md             plain-language brief
+└── .claude/handoffs/
+    └── 2026-04-29-125823-scaffold-only.md   (this file)
+```
+
+Phase: **ideation**. Nothing is running anywhere. No upstream commit pinned. No build attempted.
+
+## Architecture Overview
+
+This is a *deployment fork* — the discipline is to keep the diff against `j-evins/glabels-qt` master surgical so we can rebase periodically without pain. Anything we add should be additive (new files: deploy scripts, packaging recipes, Seth-specific templates) rather than invasive edits to upstream source. If we need to patch upstream code, prefer a thin patch series we can replay.
+
+Stack is Qt + CMake + C++ (GPL-3.0). Target host is **steel141** (Debian 13). A future option is a headless print-server CT, but that's not part of this scaffold's scope.
+
+## Critical Files
+
+| File | Purpose | Relevance |
+|------|---------|-----------|
+| `~/bin/sethLabels/IDEA.md` | Plain-language brief — why this fork exists | Read first if upstream choice or scope feels unclear |
+| `~/bin/sethLabels/CLAUDE.md` | Durable project instructions | Loaded every session |
+| `~/bin/sethLabels/DECISIONS.md` | Empty — populate as architectural choices land | Write to when locking in upstream-pin strategy, Qt5-vs-Qt6, etc. |
+| `~/bin/CREATE_PROJECT.md` | Recipe used to scaffold this | Reference if future projects need the same shape |
+
+## Suggested Next Steps (ordered)
+
+The user said *just scaffold + handoff* — none of this was attempted. Pick up here next session:
+
+1. **Decide upstream-tracking strategy.** Options:
+   - (a) Clone `j-evins/glabels-qt` into this dir, push to Gitea as `sethLabels`, add upstream as a remote, merge from `upstream/master` periodically.
+   - (b) Keep upstream as a git submodule and layer deployment glue around it.
+   Record the choice in `DECISIONS.md` before pulling code.
+2. **Verify upstream is alive.** Check `j-evins/glabels-qt` for last commit date + open issues; this is a fork of mate-desktop's glabels lineage and forks-of-forks have a tendency to bitrot. If `j-evins` is stale, the real upstream might be elsewhere — re-evaluate before forking.
+3. **Confirm Qt version.** Upstream's `CMakeLists.txt` will say Qt5 or Qt6. Debian 13 ships both — pick whichever upstream targets.
+4. **Build it once on steel141** to establish the known-good build recipe. Capture exact `apt install` deps and CMake invocation in a `BUILD.md` (or in `CLAUDE.md` if short).
+5. **Initialize git + push to Gitea.** `gitea create sethLabels` → `gitea remote sethLabels` → `gitea push`. Use a descriptive commit message like `init: scaffold + import upstream glabels-qt @ <sha>`.
+6. **Only then** start any deployment-specific work (templates, packaging, install scripts).
+
+## Open Questions
+
+- Is `j-evins/glabels-qt` actually the right upstream, or should we be tracking a different fork? (See "verify upstream is alive" above.)
+- Does Seth want a `.deb` package, an AppImage, or just a built binary in `/usr/local/bin`?
+- Is there a printer model or label-stock library we should pre-load as default templates?
+
+These don't block scaffolding — they block the *first real coding session*. Ask before implementing.
+
+## Risks / Watch-outs
+
+- Upstream is GPL-3.0. Any code we add that links against it must also be GPL-3.0-compatible. Don't accidentally relicense.
+- "Deployment fork" failure mode: scope creep into a real fork. If we find ourselves writing >100 lines of upstream-source patches, that's a signal to either upstream the change or rethink whether we actually want a fork.
+- glabels-qt is one of those projects with multiple competing forks (j-evins, jimevins-original, mate-desktop's glabels-3, etc.). Pin the upstream we choose explicitly in `DECISIONS.md` so we don't drift.

.gitignore

@@ -40,3 +40,16 @@ TEST-DATA
 SAV*
 OLD*
 
+# === sethLabels (deployment fork) additions ===
+# Local backup snapshots (per ~/.claude/CLAUDE.md safety rule)
+.backup/
+
+# Local-only symlink to ~/bin/GITEA_API.md (target is outside the repo)
+GITEA_API.md
+
+# Secrets / env
+.env
+.env.*
+
+# Handoff drafts (operator scratch — final handoffs ARE committed)
+.claude/handoffs/*.draft.md

CLAUDE.md

@@ -0,0 +1,27 @@
+# sethLabels
+
+> Deployment fork of glabels-qt — Qt label designer/printer, packaged for Seth's homelab.
+
+## Start Here
+
+**Read the latest handoff first:** `.claude/handoffs/` (most recent file).
+It has session state, in-progress work, and ordered next steps.
+
+Then check `IDEA.md` for the project brief and `DECISIONS.md` for settled choices.
+
+## Project Identity
+
+sethLabels is a thin deployment fork of [glabels-qt](https://github.com/j-evins/glabels-qt). Upstream is the real project — this fork's job is to keep a known-good build recipe, any deployment glue (packaging, install paths, default templates), and any local patches in one place, while staying close enough to upstream `master` that periodic rebases stay cheap.
+
+## Current State
+
+- **Phase:** ideation (just scaffolded — no code, no upstream pull yet)
+- **Repo:** not yet (will live at `git.sethpc.xyz/Seth/sethLabels` once first commit lands)
+- **Deploy target:** steel141 (Debian 13) — primary; CT for headless print serving optional/later
+- **Upstream:** https://github.com/j-evins/glabels-qt (GPL-3.0, Qt + CMake + C++)
+
+## Conventions
+
+- This is a **fork**, not a from-scratch rewrite. Pull upstream first; only patch what we need to change. Keep diffs surgical.
+- Preserve upstream license (GPL-3.0) and copyright headers.
+- See `~/bin/CLAUDE.md` for global homelab conventions (gitea CLI, conventional commits, credentials handling).

DECISIONS.md

@@ -0,0 +1,12 @@
+# DECISIONS.md — sethLabels Decision Log
+
+Project-specific decisions. For global/cross-cutting decisions, see `~/bin/DECISIONS.md`.
+
+Format: `YYYY-MM-DD: <decision> — <why>`
+
+## Architecture
+
+## Implementation
+
+## Deferred / Rejected
+<!-- Decisions NOT to do something are just as valuable -- prevents re-proposing rejected ideas -->

IDEA.md

@@ -0,0 +1,20 @@
+# IDEA.md — Project Idea
+
+## What is this?
+
+sethLabels is a deployment fork of [glabels-qt](https://github.com/j-evins/glabels-qt) — a Qt-based desktop application for designing and printing labels, business cards, and similar small-format documents (with CSV mail-merge and barcode support).
+
+The fork exists to layer Seth's deployment-specific concerns (packaging, install paths, default templates, branding, any local patches) on top of upstream without forking the whole project lifecycle. Goal is to keep the diff small enough to rebase onto upstream `master` periodically.
+
+## Problem it solves
+
+Need a reliable, scriptable label designer/printer for homelab + household use (shipping labels, equipment tags, drive labels for the tank pool, cable labels, etc.). Upstream glabels-qt is solid but has no published Debian 13 / current-Ubuntu binaries and the build needs some hand-holding. This fork bakes a known-good build recipe + any local templates + deployment scripts into one repo.
+
+## Constraints / preferences
+
+- **Upstream:** https://github.com/j-evins/glabels-qt (track this, don't drift)
+- **Stack:** Qt (5 or 6 — TBD based on upstream's current state), CMake, C++
+- **Target hosts:** steel141 primarily (Debian 13). Maybe a CT for headless print serving later.
+- **Branding/customization:** minimal — this is for personal use, not a product
+- **License:** glabels-qt is GPL-3.0 — preserve it; any contributions stay GPL-3.0
+- **Repo:** Gitea at `git.sethpc.xyz/Seth/sethLabels` (TBD until first push)

README.md

@@ -34,13 +34,14 @@ There are currently no official releases of gLabels 4.
 
 Currently there are no self-hosted binary snapshot releases available.  I plan to make these available again once 4.0 is more imminent.  In the mean time, I encourage you to try building the code yourself.
 
-Some third-party packages may be available available:
+Some third-party packages may be available:
 
 
 | Platform  | Files                                                                                | Notes                                                         |
 |:----------|:-------------------------------------------------------------------------------------|:--------------------------------------------------------------|
-| Archlinux | [Archlinux User Repository Page](https://aur.archlinux.org/packages/glabels-qt-git/) | Maintained by [Mario Blättermann](https://github.com/mariobl) |
+| Archlinux | [Archlinux User Repository Page](https://aur.archlinux.org/packages/glabels-qt-git/) | Maintained by [Maud Spierings](https://github.com/SpieringsAE) |
 | Ubuntu    | [PPA Page](https://code.launchpad.net/~krisives/+archive/ubuntu/glabels-qt)          | Maintained by [Kristopher Ives](https://github.com/krisives)  |
+| Fedora    | [Copr Repository Page](https://copr.fedorainfracloud.org/coprs/mariobl/glabels-qt/)  | Maintained by [Mario Blättermann](https://github.com/mariobl) |
 
 
 

backends/barcode/Backends.cpp

@@ -1,6 +1,6 @@
 //  Backends.cpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/barcode/Backends.hpp

@@ -1,6 +1,6 @@
 //  Backends.hpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/barcode/GnuBarcode.cpp

@@ -1,6 +1,6 @@
 //  GnuBarcode.cpp
 //
-//  Copyright (C) 2017  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2017-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/barcode/GnuBarcode.hpp

@@ -1,6 +1,6 @@
 //  GnuBarcode.hpp
 //
-//  Copyright (C) 2017  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2017-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/barcode/QrEncode.cpp

@@ -1,6 +1,6 @@
 //  QrEncode.cpp
 //
-//  Copyright (C) 2017  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2017-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/barcode/QrEncode.hpp

@@ -1,6 +1,6 @@
 //  QrEncode.hpp
 //
-//  Copyright (C) 2017  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2017-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/barcode/Style.cpp

@@ -1,6 +1,6 @@
 //  Style.cpp
 //
-//  Copyright (C) 2013  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/barcode/Style.hpp

@@ -1,6 +1,6 @@
 //  Style.hpp
 //
-//  Copyright (C) 2013  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/barcode/Zint.cpp

@@ -1,6 +1,6 @@
 //  Zint.cpp
 //
-//  Copyright (C) 2017  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2017-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/barcode/Zint.hpp

@@ -1,6 +1,6 @@
 //  Zint.hpp
 //
-//  Copyright (C) 2017  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2017-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/Factory.cpp

@@ -1,6 +1,6 @@
 //  Merge/Factory.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/Factory.hpp

@@ -1,6 +1,6 @@
 //  Merge/Factory.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/Merge.cpp

@@ -1,6 +1,6 @@
 //  Merge/Merge.cpp
 //
-//  Copyright (C) 2015-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2015-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/Merge.hpp

@@ -1,6 +1,6 @@
 //  Merge/Merge.hpp
 //
-//  Copyright (C) 2015-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2015-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/None.cpp

@@ -1,6 +1,6 @@
 //  Merge/None.cpp
 //
-//  Copyright (C) 2015-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2015-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/None.hpp

@@ -1,6 +1,6 @@
 //  Merge/None.hpp
 //
-//  Copyright (C) 2015-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2015-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/Record.cpp

@@ -1,6 +1,6 @@
 //  Merge/Record.cpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/Record.hpp

@@ -1,6 +1,6 @@
 //  Merge/Record.hpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/Text.cpp

@@ -1,6 +1,6 @@
 //  Merge/Text.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/Text.hpp

@@ -1,6 +1,6 @@
 //  Merge/Text.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextColon.cpp

@@ -1,6 +1,6 @@
 //  Merge/TextColon.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextColon.hpp

@@ -1,6 +1,6 @@
 //  Merge/TextColon.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextColonKeys.cpp

@@ -1,6 +1,6 @@
 //  Merge/TextColonKeys.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextColonKeys.hpp

@@ -1,6 +1,6 @@
 //  Merge/TextColonKeys.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextCsv.cpp

@@ -1,6 +1,6 @@
 //  Merge/TextCsv.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextCsv.hpp

@@ -1,6 +1,6 @@
 //  Merge/TextCsv.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextCsvKeys.cpp

@@ -1,6 +1,6 @@
 //  Merge/TextCsvKeys.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextCsvKeys.hpp

@@ -1,6 +1,6 @@
 //  Merge/TextCsvKeys.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextSemicolon.cpp

@@ -1,6 +1,6 @@
 //  Merge/TextSemicolon.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextSemicolon.hpp

@@ -1,6 +1,6 @@
 //  Merge/TextSemicolon.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextSemicolonKeys.cpp

@@ -1,6 +1,6 @@
 //  Merge/TextSemicolonKeys.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextSemicolonKeys.hpp

@@ -1,6 +1,6 @@
 //  Merge/TextSemicolonKeys.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextTsv.cpp

@@ -1,6 +1,6 @@
 //  Merge/TextTsv.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextTsv.hpp

@@ -1,6 +1,6 @@
 //  Merge/TextTsv.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextTsvKeys.cpp

@@ -1,6 +1,6 @@
 //  Merge/TextTsvKeys.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

backends/merge/TextTsvKeys.hpp

@@ -1,6 +1,6 @@
 //  Merge/TextTsvKeys.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

docs/CONTRIBUTING.md

@@ -26,7 +26,7 @@ How To Contribute to gLabels
 
 ### Would you like to submit new product templates?
 
-* Before submitting, please read [PRODUCT-TEMPLATES.md](PRODUCT-TEMPLATES.md) located in this directory.
+* Before submitting, please read [PRODUCT-TEMPLATES.md](PRODUCT-TEMPLATES.md) and [TEMPLATE-STYLE.md](TEMPLATE-STYLE.md) located in this directory.
 
 * [Open an issue](https://github.com/j-evins/glabels-qt/issues/new) and attach your completed product template file(s).
 

docs/PRODUCT-TEMPLATES.md

@@ -1,7 +1,9 @@
 Manually Creating Product Templates
 ===================================
 
-This document is a reference for manually creating *gLabels* product templates.
+This document is a reference for manually creating *gLabels* product templates.  See
+[TEMPLATE-STYLE.md](TEMPLATE-STYLE.md) located in this directory for style guidelines
+for product template submissions.
 
 *gLabels* searches for templates in several locations as described here:</p>
 
@@ -83,7 +85,7 @@ Property       | Type     | Description
 *_description* | string   | Translatable description of stationery product. Used in predefined labels instead of description.
 *width*        | distance | Page width. Only valid if `size="other"` or `size="roll"`.
 *height*       | distance | Page height. Only valid if `size="other"`.  Value is ignored if `size="roll"`.
-*equiv*        | string   | Equivalent part number.  If this property is present, the template is a clone of another template of the same brand.  The template will inherit all properties, except brand and name from the other template. This equiv property must refer to a previously defined template - *gLabels* does not currently support forward references.
+*equiv*        | string   | Equivalent part number.  If this property is present, the template is a clone of another template of the same brand.  The template will inherit all properties, except *part* from the other template. This equiv property must refer to a previously defined template - *gLabels* does not currently support forward references.
 
 ### Guidelines for Creating Product Descriptions
 

docs/TEMPLATE-STYLE.md

@@ -0,0 +1,120 @@
+gLabels Product Template Style Guide
+====================================
+
+This file describes the prefered style for product template submissions.  See
+[PRODUCT-TEMPLATES.md](PRODUCT-TEMPLATES.md) located in this directory for detailed
+systax documentation.
+
+
+Organization
+------------
+
+Template files are located in the [templates](../templates/) directory.  The following
+is the naming convention for these files:
+
+   <pre><i>brand</i>-<i>class</i>-templates.xml</pre>
+
+Where *brand* is the lowercase brand name, and *class* is the media size class (currently
+`iso`, `us`, and `other`).
+
+Templates should be sorted in [natural order](https://en.wikipedia.org/wiki/Natural_sort_order)
+by part number within each file.  An exception to this rule is to group equivalent templates
+directly below their referenced template.  For example:
+
+```xml
+  <Template brand="Avery" part="5126" size="US-Letter" _description="Shipping labels">
+    <Meta category="label"/>
+    <Meta category="rectangle-label"/>
+    <Meta category="mail"/>
+    <Label-rectangle id="0" width="8.5in" height="5.5in" round="0in" x_waste="0in" y_waste="0in">
+      <Markup-margin size="9pt"/>
+      <Layout nx="1" ny="2" x0="0in" y0="0in" dx="0in" dy="5.5in"/>
+    </Label-rectangle>
+  </Template>
+
+  <Template brand="Avery" part="5526" equiv="5126"/>
+  <Template brand="Avery" part="8126" equiv="5126"/>
+  <Template brand="Avery" part="15516" equiv="5126"/>
+  <Template brand="Avery" part="18126" equiv="5126"/>
+
+
+  <Template brand="Avery" part="5159" size="US-Letter" _description="Address labels">...
+```
+
+When creating a new template file, it must be added to the variable template_files in
+the [CMakeLists.txt](../templates/CMakeLists.txt) file in this same directory.
+
+
+*Template* Node Attributes
+--------------------------
+
+### *brand* Attribute
+
+This is the brand name or manufacturer of the product.  It must match one of the vendors
+in the [vendors.xml](../templates/vendors.xml) file.  Add a new vendor line if it does not
+currently exist.
+
+
+### *part* Attribute
+
+This is the actual part number of the product.  This is usually a short set of numbers and/or
+letters.  This is not a description or name of the product.  The following are examples
+of part numbers:
+
+- `5160`
+- `WL-102`
+- `J8435B`
+
+Sometimes a product includes multiple label types, either as separate sheets or different
+types of labels on the same sheet.  In these cases, providing a short suffix to part number
+is acceptable.  For example:
+
+- `3274.1`, `3274.2`, and `3274.3`
+- `5931-Disc`, and `5931-Spine`
+
+
+### *_description* Attribute
+
+- Descriptions should be short. They should describe what the product is in very simple terms
+  without being too detailed.  They should not describe details such as size, quantity, layout,
+  color, or material.  The description should not include brand or part number information.
+  Size, quantity, layout, brand, and part number are described by other elements of the
+  template - do not repeat them in the description.
+
+- If at all possible, try to reuse descriptions from other templates (this keeps the
+  number of unique strings that need translation to a minimum).
+
+- Don't repeat the brand or part number in the description.
+
+- Only capitalize the first word of the description.
+
+The following are good bad descriptions:
+
+| description              | Good/Bad | Notes                                         |
+|:-------------------------|:--------:|:----------------------------------------------|
+| `Address labels`         |    ✅    |                                               |
+| `Address Labels`         |    ❌    | Capitalized second word of description.       |
+| `Business cards`         |    ✅    |                                               |
+| `Multipurpose labels`    |    ✅    |                                               |
+| `CD/DVD labels`          |    ✅    |                                               |
+| `19mm x 30mm labels`     |    ❌    | Don't include size information.               |
+| `Labels 15 per sheet`    |    ❌    | Don't include layout or quantity information. |
+| `Dymo continuous labels` |    ❌    | Don't include brand or part number.        |
+
+
+
+*Meta* Node Attributes
+----------------------
+
+### *category* Attribute
+
+- All templates should include all appropriate `<Meta category=...` nodes.
+- Categories must match one of the existing categories in the [categories.xml](../templates/categories.xml) file.  Do not add new categories!
+- All templates should include either a `<Meta category="label"/>` or `<Meta category="card"/>` node.
+
+
+### *product_url* Attribute
+
+Unfortunately, manufacturer websites are constantly being updated and rearranged, rendering such deep URLs obsolete very quickly.  Therefore,
+use of this attribute is deprecated.
+

docs/TODO.md

@@ -39,7 +39,7 @@ To Do List for gLabels 4.0 -- 2019-10-07
 
 
 
-To Do List for post gLabels 4.0 -- 2019-03-17
+To Do List for post gLabels 4.0 -- 2026-02-18
 =============================================
 
 - [ ] Create a "built-in" merge source
@@ -71,4 +71,14 @@ To Do List for post gLabels 4.0 -- 2019-03-17
   The current built-in fixed margin seems to confuse people when dealing with
   different horizontal and vertical alignments.
 
+- [ ] Add support for arbitrary DPI when defining templates.  Some label
+  printers use native units in their label specifications (e.g. pins, pixels, etc.)
+  This would look something like this
 
+  `... dpi="300" ... width="525d" height="350d" ...`
+
+  These would be converted to model::Distance when parsing.
+
+- [ ] Resurrect the evolution and vcard backends.  This would be optional based
+  on availability.
+  

docs/TRANSLATIONS.md

@@ -1,4 +1,9 @@
-## Translation management
+# Translations
 
-We manage all translations within a [transifex](https://explore.transifex.com/glabels/). Please don't send your files via Github, use only transifex.
+The translations of the user interface, the template database and the user manual (which is still under development)
+are maintained at [Fedora Weblate](https://translate.fedoraproject.org/projects/glabels-qt/). Please always use
+Weblate for translation submissions; we do not accept contributions from outside this platform. For more information about
+using Weblate, read the [documentation](https://docs.weblate.org/en/latest/).
 
+To contribute to translations, you need an account in the [Fedora Account System](https://accounts.fedoraproject.org/).
+More information about the account system can be found [here](https://docs.fedoraproject.org/en-US/fedora-accounts/).

glabels-batch/main.cpp

@@ -1,6 +1,6 @@
 //  main.cpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/AboutDialog.cpp

@@ -1,6 +1,6 @@
 //  AboutDialog.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //
@@ -43,7 +43,7 @@ namespace glabels
 
                 QString description = tr("A program to create labels and business cards.");
 
-                QString copyright = "Copyright &copy; 2018 Jaye Evins <evins@snaught.com>";
+                QString copyright = "Copyright &copy; 2016-2026 Jaye Evins <evins@snaught.com>";
 
                 QString licenseParagraph1 =
                         tr( "gLabels is free software: you can redistribute it and/or modify "

glabels/AboutDialog.hpp

@@ -1,6 +1,6 @@
 //  AboutDialog.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/BarcodeMenu.cpp

@@ -1,6 +1,6 @@
 //  BarcodeMenu.cpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/BarcodeMenu.hpp

@@ -1,6 +1,6 @@
 //  BarcodeMenu.hpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/BarcodeMenuButton.cpp

@@ -1,6 +1,6 @@
 //  BarcodeMenuButton.cpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/BarcodeMenuButton.hpp

@@ -1,6 +1,6 @@
 //  BarcodeMenuButton.hpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/BarcodeMenuItem.cpp

@@ -1,6 +1,6 @@
 //  BarcodeMenuItem.cpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/BarcodeMenuItem.hpp

@@ -1,6 +1,6 @@
 //  BarcodeMenuItem.hpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorButton.cpp

@@ -1,6 +1,6 @@
 //  ColorButton.cpp
 //
-//  Copyright (C) 2014-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorButton.hpp

@@ -1,6 +1,6 @@
 //  ColorButton.hpp
 //
-//  Copyright (C) 2014-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorHistory.cpp

@@ -1,6 +1,6 @@
 //  ColorHistory.cpp
 //
-//  Copyright (C) 2014-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorHistory.hpp

@@ -1,6 +1,6 @@
 //  ColorHistory.hpp
 //
-//  Copyright (C) 2014-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorPaletteDialog.cpp

@@ -1,6 +1,6 @@
 //  ColorPaletteDialog.cpp
 //
-//  Copyright (C) 2014-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorPaletteDialog.hpp

@@ -1,6 +1,6 @@
 //  ColorPaletteDialog.hpp
 //
-//  Copyright (C) 2014-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorPaletteItem.cpp

@@ -1,6 +1,6 @@
 //  ColorPaletteItem.cpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorPaletteItem.hpp

@@ -1,6 +1,6 @@
 //  ColorPaletteItem.hpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorSwatch.cpp

@@ -1,6 +1,6 @@
 //  ColorSwatch.cpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ColorSwatch.hpp

@@ -1,6 +1,6 @@
 //  ColorSwatch.hpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/Cursors.cpp

@@ -1,6 +1,6 @@
 //  Cursors.cpp
 //
-//  Copyright (C) 2013  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/Cursors.hpp

@@ -1,6 +1,6 @@
 //  Cursors.hpp
 //
-//  Copyright (C) 2013  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/EditVariableDialog.cpp

@@ -1,6 +1,6 @@
 //  EditVariableDialog.cpp
 //
-//  Copyright (C) 2019  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2019-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/EditVariableDialog.hpp

@@ -1,6 +1,6 @@
 //  EditVariableDialog.hpp
 //
-//  Copyright (C) 2019  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2019-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/FieldButton.cpp

@@ -1,6 +1,6 @@
 //  FieldButton.cpp
 //
-//  Copyright (C) 2019  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2019-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/FieldButton.hpp

@@ -1,6 +1,6 @@
 //  FieldButton.hpp
 //
-//  Copyright (C) 2019  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2019-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/File.cpp

@@ -1,6 +1,6 @@
 //  File.cpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/File.hpp

@@ -1,6 +1,6 @@
 //  File.hpp
 //
-//  Copyright (C) 2017  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2017-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/Help.cpp

@@ -1,6 +1,6 @@
 //  Help.cpp
 //
-//  Copyright (C) 2013  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/Help.hpp

@@ -1,6 +1,6 @@
 //  Help.hpp
 //
-//  Copyright (C) 2013  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/LabelEditor.cpp

@@ -1,6 +1,6 @@
 //  LabelEditor.cpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/LabelEditor.hpp

@@ -1,6 +1,6 @@
 //  LabelEditor.hpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/MainWindow.cpp

@@ -1,6 +1,6 @@
 //  MainWindow.cpp
 //
-//  Copyright (C) 2014-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/MainWindow.hpp

@@ -1,6 +1,6 @@
 //  MainWindow.hpp
 //
-//  Copyright (C) 2014  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2014-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/MergeTableModel.cpp

@@ -1,6 +1,6 @@
 //  MergeTableModel.cpp
 //
-//  Copyright (C) 2025  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2025-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/MergeTableModel.hpp

@@ -1,6 +1,6 @@
 //  MergeTableModel.hpp
 //
-//  Copyright (C) 2025  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2025-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/MergeView.cpp

@@ -1,6 +1,6 @@
 //  MergeView.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/MergeView.hpp

@@ -1,6 +1,6 @@
 //  MergeView.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/MiniPreviewPixmap.cpp

@@ -1,6 +1,6 @@
 //  MiniPreviewPixmap.cpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/MiniPreviewPixmap.hpp

@@ -1,6 +1,6 @@
 //  MiniPreviewPixmap.hpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/NotebookUtil.cpp

@@ -1,6 +1,6 @@
 //  NotebookUtil.cpp
 //
-//  Copyright (C) 2015  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2015-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/NotebookUtil.hpp

@@ -1,6 +1,6 @@
 //  NotebookUtil.hpp
 //
-//  Copyright (C) 2015  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2015-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ObjectEditor.cpp

@@ -1,6 +1,6 @@
 //  ObjectEditor.cpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/ObjectEditor.hpp

@@ -1,6 +1,6 @@
 //  ObjectEditor.hpp
 //
-//  Copyright (C) 2013  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/PreferencesDialog.cpp

@@ -1,6 +1,6 @@
 //  PreferencesDialog.cpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/PreferencesDialog.hpp

@@ -1,6 +1,6 @@
 //  PreferencesDialog.hpp
 //
-//  Copyright (C) 2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2016-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/Preview.cpp

@@ -1,6 +1,6 @@
 //  Preview.cpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/Preview.hpp

@@ -1,6 +1,6 @@
 //  Preview.hpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/PreviewOverlayItem.cpp

@@ -1,6 +1,6 @@
 //  PreviewOverlayItem.cpp
 //
-//  Copyright (C) 2013  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/PreviewOverlayItem.hpp

@@ -1,6 +1,6 @@
 //  PreviewOverlayItem.hpp
 //
-//  Copyright (C) 2013  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/PrintView.cpp

@@ -1,6 +1,6 @@
 //  PrintView.cpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/PrintView.hpp

@@ -1,6 +1,6 @@
 //  PrintView.hpp
 //
-//  Copyright (C) 2013-2016  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2013-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/PrinterMonitor.cpp

@@ -1,6 +1,6 @@
 //  PrinterMonitor.cpp
 //
-//  Copyright (C) 2025  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2025-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //

glabels/PrinterMonitor.hpp

@@ -1,6 +1,6 @@
 //  PrinterMonitor.hpp
 //
-//  Copyright (C) 2025  Jaye Evins <evins@snaught.com>
+//  Copyright (C) 2025-2026  Jaye Evins <evins@snaught.com>
 //
 //  This file is part of gLabels-qt.
 //