feat: add gitea workflow

2025-10-13 14:05:11 +02:00
parent 7bd7a317f3
commit 45a002fd47
4 changed files with 317 additions and 35 deletions
--- a/README.md
+++ b/README.md
@@ -1,2 +1,122 @@
-# zed-packager
+# Zed Editor Packager

+Automated packaging system for [Zed Editor](https://zed.dev/) for Debian/Ubuntu.
+
+## Description
+
+This project automatically creates `.deb` packages of Zed Editor from official GitHub releases and publishes them to a Gitea repository.
+
+## Features
+
+- **Automatic version detection**: Fetches the latest stable version from GitHub
+- **DEB package building**: Creates a ready-to-install Debian package
+- **CI/CD with Gitea Actions**: Automated workflow that:
+  - Checks daily for new versions
+  - Builds the package only if a new version is available
+  - Creates a Gitea release with the package
+  - Publishes the package to the Gitea Debian repository
+
+## Local Usage
+
+### Prerequisites
+
+```bash
+sudo apt-get install wget curl jq dpkg-dev
+```
+
+### Manual Building
+
+```bash
+# Build the package
+make
+
+# Or step by step
+make download   # Download the archive
+make extract    # Extract the archive
+make deb        # Create the .deb package
+
+# Clean up
+make clean
+```
+
+### Installation
+
+```bash
+# Install the locally created package
+sudo dpkg -i build/zed-editor_*.deb
+```
+
+## Gitea Workflow
+
+The [`.gitea/workflows/build-and-release.yml`](.gitea/workflows/build-and-release.yml) workflow runs:
+
+- **Automatically**: Every day at 2 AM (cron)
+- **Manually**: Via the Gitea interface (workflow_dispatch)
+- **On push**: On every push to the `main` branch
+
+### Required Configuration
+
+To publish to the Gitea Debian repository, create a `PACKAGE_PUB_TOKEN` secret:
+
+1. Generate a personal access token on Gitea with package permissions
+2. Add it as a secret in the repository settings: `PACKAGE_PUB_TOKEN`
+
+### Workflow Behavior
+
+1. **Version check**: Compares the latest GitHub version with the latest Gitea release
+2. **Early exit**: If versions match, the workflow stops immediately
+3. **Build**: If a new version is detected, builds the .deb package
+4. **Publishing**:
+   - Creates a Gitea release with the version tag
+   - Uploads the .deb file to the release assets
+   - Publishes the package to the Gitea Debian repository
+
+## Package Structure
+
+The package installs Zed in the following locations:
+
+```
+/opt/zed/                                    # Main application
+/opt/zed/bin/zed                             # Main binary
+/opt/zed/libexec/zed-editor                  # Editor binary
+/opt/zed/lib/                                # Shared libraries
+/usr/bin/zed                                 # Symbolic link
+/usr/share/applications/zed.desktop          # Desktop file
+/usr/share/icons/hicolor/*/apps/zed.png      # Icons
+```
+
+## Installation from Gitea Repository
+
+Once the repository is configured:
+
+```bash
+# Add the repository (adapt according to your Gitea instance)
+echo "deb https://git.rawleenc.dev/api/packages/YOUR_USERNAME/debian stable main" | sudo tee /etc/apt/sources.list.d/zed-editor.list
+
+# Install
+sudo apt update
+sudo apt install zed-editor
+```
+
+## Makefile
+
+The Makefile supports the following targets:
+
+| Target     | Description                                 |
+|------------|---------------------------------------------|
+| `all`      | Build the complete package (default target) |
+| `download` | Download the archive from GitHub            |
+| `extract`  | Extract the archive                         |
+| `deb`      | Create the .deb package                     |
+| `clean`    | Clean up temporary files                    |
+| `help`     | Display help                                |
+
+## License
+
+This project is a packaging tool. Zed Editor itself is subject to its own license.
+
+## Notes
+
+- The created packages are **unofficial**
+- Binaries come directly from official Zed releases
+- The packaging only adds system integration (desktop files, etc.)