alexei.dolgolyov
b7d25231b9
docs: add modular usage guide and fix GITEA_TOKEN warning
...
- Added table showing which sections to use per project type
- Fixed stale warning: "Do NOT use DEPLOY_TOKEN" → "Do NOT use GITEA_TOKEN"
2026-03-25 15:09:28 +03:00
alexei.dolgolyov
4788bdf59d
docs: add TrueNAS Docker network fix and package linking notes
...
- Docker address pool 0.0.0.0 causes unreachable gateway on TrueNAS 25.10
- Gitea requires manual package-repo linking on first push
2026-03-25 15:07:36 +03:00
alexei.dolgolyov
985200691d
fix: rename GITEA_TOKEN to DEPLOY_TOKEN
...
GITEA_TOKEN is a reserved name in Gitea — the UI and API reject it
when creating secrets. Use DEPLOY_TOKEN instead.
2026-03-25 14:37:26 +03:00
alexei.dolgolyov
c435a5cf0a
docs: add shared build logic pattern and expanded size optimization
...
- Section 4.3: expanded with NumPy submodule removal, zeroconf cleanup,
debug symbol stripping, .py source removal, dependency replacement tip
- Section 5.2: new "Shared Build Logic" documenting build-common.sh
pattern for deduplicating Windows/Linux build scripts
2026-03-25 14:08:32 +03:00
alexei.dolgolyov
c65dd349f7
docs: add Gitea duplicate asset prevention pattern
...
Gitea silently appends duplicate asset names on re-triggered releases.
Added upload_asset helper that deletes existing assets before uploading.
2026-03-25 13:19:38 +03:00
alexei.dolgolyov
0a9c270c6b
docs: add version management and in-app auto-update sections
...
- Section 10: Single source of truth via pyproject.toml + importlib.metadata,
CI version stamping, Docker build args, updated fallback chain
- Section 11: Release provider abstraction, PEP 440 version normalization,
install type detection, update service pattern, NSIS silent install,
portable ZIP/tarball swap scripts, API endpoints, frontend integration
2026-03-25 12:51:07 +03:00
alexei.dolgolyov
01c8f71fee
fix: add f-string prefix to release body template
2026-03-24 14:26:17 +03:00
alexei.dolgolyov
294c50a2eb
docs: expand CI/CD guide with NSIS launch function, VBS fallback, and local build testing
...
- Replace MUI_FINISHPAGE_RUN_PARAMETERS with RUN_FUNCTION (fixes quoting)
- Add embedded Python fallback to VBS hidden launcher
- Add .onInit file-lock detection for running instances
- Add section 11: local Windows build testing with NSIS
- Expand troubleshooting table with common build/install issues
2026-03-24 12:46:38 +03:00
alexei.dolgolyov
e32cf5fe58
docs: add VBS hidden launcher pattern to CI/CD guide
...
Document the VBS wrapper approach for launching Windows apps
without console window flash. Update NSIS example to prefer
VBS over direct bat execution.
2026-03-23 13:53:19 +03:00
alexei.dolgolyov
bf7631b7e4
docs: add NSIS finish page launch option to CI/CD guide
...
Add optional MUI_FINISHPAGE_RUN pattern for launching the app
after installation completes.
2026-03-23 13:41:41 +03:00
alexei.dolgolyov
f17ff30c11
docs: add release fallback logic and troubleshooting section
...
Add ::warning:: annotation and fallback to fetch existing release
when tag already has a release. Add troubleshooting section for
re-triggering failed release workflows. Fix markdown lint warnings.
2026-03-23 02:47:57 +03:00
alexei.dolgolyov
f22e3fabe6
docs: add Gitea Python CI/CD guide
...
Reusable reference extracted from wled-screen-controller covering:
- Lint/test and release workflows for Gitea Actions
- Cross-building Windows from Linux (embedded Python + wheels)
- NSIS installer packaging
- Docker multi-stage builds with Gitea registry
- Version detection, pre-release handling, size optimization
2026-03-23 01:17:28 +03:00