diff --git a/.editorconfig b/.editorconfig deleted file mode 100644 index f2acc17..0000000 --- a/.editorconfig +++ /dev/null @@ -1,15 +0,0 @@ -# https://editorconfig.org - -# top-most EditorConfig file -root = true - -[*] -charset = utf-8 -end_of_line = lf -indent_size = 2 -indent_style = tab -insert_final_newline = true -trim_trailing_whitespace = true - -[*.md] -trim_trailing_whitespace = false diff --git a/README.md b/README.md index d5f79e7..906d595 100644 --- a/README.md +++ b/README.md @@ -10,66 +10,42 @@ A curated list of delightful [Forgejo](https://forgejo.org/)-related projects an ## Contents - [Official resources](#official-resources) - [Documentation](#documentation) - - [Tutorials](#tutorials) - [Public instances](#public-instances) - [Packaging](#packaging) -- [Forgejo Actions](#forgejo-actions) - - [Actions runners](#actions-runners) - - [Actions runner deployment tools](#actions-runner-deployment-tools) - - [Actions](#actions) +- [Infrastructure as Code](#infrastructure-as-code) +- [Monitoring](#monitoring) - [Clients](#clients) - [Mobile](#mobile) - [Command-line](#command-line) - [Tools](#tools) - - [Infrastructure as Code](#infrastructure-as-code) - - [Monitoring](#monitoring) - [Bots](#bots) - - [Scripts](#scripts) - - [Package deployment](#package-deployment) - - [API client libraries](#api-client-libraries) -- [References](#references) - [Maintainers](#maintainers) - [Contributors](#contributors) - [License](#license) -Emoji for each entry provide additional information on project status: -- ![][forgejo] = official Forgejo resources -- 👻 = inactive for over a year, or officially abandoned - - - ## Official resources Resources maintained as part of the primary Forgejo project. -- [![][forgejo] Forgejo website](https://forgejo.org/) -- [![][forgejo] Forgejo documentation](https://forgejo.org/docs/latest/) -- [![][forgejo] Forgejo issue tracker](https://codeberg.org/forgejo/forgejo) -- [![][forgejo] Forgejo releases](https://forgejo.org/releases) ([RSS feed](https://forgejo.org/releases/rss.xml); [Release notes](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/RELEASE-NOTES.md)) -- [![][forgejo] Forgejo runner](https://code.forgejo.org/forgejo/runner) -- [![][forgejo] Forgejo container images](https://codeberg.org/forgejo/-/packages/container/forgejo/versions) -- [![][forgejo] Forgejo Mastodon account](https://floss.social/@forgejo) -- [![][forgejo] Forgejo identity proofs (Keyoxide)](https://keyoxide.org/contact@forgejo.org) +- [Forgejo website](https://forgejo.org/) +- [Forgejo documentation](https://forgejo.org/docs/latest/) +- [Forgejo Releases](https://forgejo.org/releases) ([RSS feed](https://forgejo.org/releases/rss.xml); [Release notes](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/RELEASE-NOTES.md)) +- [Forgejo runner](https://code.forgejo.org/forgejo/runner) +- [Container images](https://codeberg.org/forgejo/-/packages/container/forgejo/versions) +- [Forgejo Mastodon account](https://floss.social/@forgejo) +- [Forgejo identity proofs (Keyoxide)](https://keyoxide.org/contact@forgejo.org) ## Documentation -In addition to [![][forgejo] Forgejo's official documentation](https://forgejo.org/docs/latest/), the following resources may be useful. + +In addition to Forgejo's official documentation, the following resources may be useful. - [Codeberg documentation](https://docs.codeberg.org/) - contains some Codeberg-specific parts but is mostly applicable to every Forgejo instance. - [Gitea documentation](https://docs.gitea.io/) - mostly applicable to Forgejo as well as Gitea. - -### Tutorials -- [Setting up a Self-Hosted Forgejo Actions Runner with Docker Compose](https://linus.dev/posts/setting-up-a-self-hosted-forgejo-actions-runner-with-docker-compose/). -- [Forgejo in a nutshell](https://devforum.roblox.com/t/forgejo-in-a-nutshell/2505867) - guide to setup Forgejo. -- [Forgejo with LFS behind a VPN](https://blog.gibson.sh/2023/05/28/server-with-wireguard-and-forgejo/) - guide to set up a Linux web server running Forgejo, Git-LFS, and a Wireguard VPN. -- [UberLab installation guide](https://lab.uberspace.de/guide_forgejo/) - Forgejo installation guide for [Uberspace](https://uberspace.de/). - +- [UberLab installation guides](https://lab.uberspace.de/guide_forgejo/) - Forgejo installation guide for [Uberspace](https://uberspace.de/). ## Public instances Forgejo instances with open registration. - [Codeberg](https://codeberg.org) - free and open *for FOSS projects only*, run by a German non-profit organization. Also provides hosted Woodpecker (CI) and Weblate (localisation). -- [Disroot](https://disroot.org/en/services/git) - a platform providing online services based on principles of freedom, privacy, federation and decentralization. Also provides many other free hosted services. -- [pub.solar](https://git.pub.solar) - Register/Login via [pub.solar ID](https://auth.pub.solar), run by a German tech collective with the goal to enable more people to use free software, have secure digital communications, and to take control over their private data. -- [KaKi's git](https://git.kaki87.net) - free and open, run by a French web developer. ## Packaging @@ -81,16 +57,16 @@ Platform-specific packages to easily install and update Forgejo on your system. Also see [forgejo package versions on Repology](https://repology.org/project/forgejo/versions). - **Alpine** - - [Alpine edge/testing `forgejo` package](https://pkgs.alpinelinux.org/packages?name=forgejo) + - [unofficial `forgejo-alpine` package](https://codeberg.org/Eragon/forgejo-alpine) - **Arch Linux** - - [Arch extra `forgejo` package](https://archlinux.org/packages/extra/x86_64/forgejo) + - [Arch community `forgejo` package](https://archlinux.org/packages/community/x86_64/forgejo/) - [AUR `forgejo-git` package](https://aur.archlinux.org/packages/forgejo-git) - **Debian/Ubuntu** - - [unofficial `forgejo-deb` packages + repo](https://codeberg.org/forgejo-contrib/forgejo-deb) + - [Unofficial packages](https://codeberg.org/crystal/forgejo-deb) - **Fedora** - [RPM copr repo](https://copr.fedorainfracloud.org/coprs/nalika/gitea/) - **FreeBSD** - - [Port `www/forgejo` / package `forgejo`](https://www.freshports.org/www/forgejo) - binary packages available in latest and quarterly 2024Q2 or newer. + - [ports tree patch](https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=269065) - A patch to add Forgejo to the FreeBSD ports tree, should eventually be added to the official ports tree - **Gentoo** - [Gentoo GURU `www-apps/forgejo` package](https://gitweb.gentoo.org/repo/proj/guru.git/tree/www-apps/forgejo) - **Kubernetes** @@ -99,79 +75,39 @@ Also see [forgejo package versions on Repology](https://repology.org/project/for - **NixOS** - [NixOS master](https://github.com/NixOS/nixpkgs/blob/master/pkgs/applications/version-management/forgejo) - [NixOS unstable](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/applications/version-management/forgejo/default.nix) -- **Snapcraft** [![forgejo](https://snapcraft.io/forgejo/badge.svg)](https://snapcraft.io/forgejo) - - [unofficial `forgejo` snap package](https://codeberg.org/forgejo-contrib/snap) - currently building in [launchpad](https://launchpad.net/~popey/forgejo-snap/+snap/forgejo-snap) -- **Termux (Android)** - - [`forgejo` package](https://github.com/termux/termux-packages/tree/master/packages/forgejo) -- **Void Linux** - - [unofficial `forgejo` package template](https://github.com/tranzystorekk/void-packages/tree/forgejo/srcpkgs/forgejo) - **YunoHost** - [YunoHost package](https://github.com/YunoHost-Apps/forgejo_ynh) - install Forgejo quickly and simply on a YunoHost server -- **Cloudron** - - [Cloudron package](https://codeberg.org/bart/forgejo-app) - Install Forgejo on a Cloudron server + +## Forgejo actions runners +- [Forgejo runner](https://code.forgejo.org/forgejo/runner) supports LXC & Docker with binaries for GNU/Linux (amd64, arm64) +- [act runner](https://gitea.com/gitea/act_runner) supports Docker & shell with binaries for GNU/Linux (amd64, arm64, arm[567]), FreeBSD, Windows, MacOS -## Forgejo Actions -Learn about Forgejo actions in the [![][forgejo] Actions admin guide](https://forgejo.org/docs/latest/admin/actions/) and [![][forgejo] Actions user guide](https://forgejo.org/docs/latest/user/actions/). - -### Actions runners -- [![][forgejo] Forgejo runner](https://code.forgejo.org/forgejo/runner) - supports LXC & Docker & shell with binaries for GNU/Linux (amd64, arm64) -- [act runner](https://gitea.com/gitea/act_runner) - supports Docker & shell with binaries for GNU/Linux (amd64, arm64, arm[567]), FreeBSD, Windows, MacOS - -### Actions runner deployment tools -- [forgejo-hetzner-runner](https://codeberg.org/pierreprinetti/forgejo-hetzner-runner) - Deploy Forgejo Actions runners on Hetzner infrastructure -- [helm-chart](https://codeberg.org/wrenix/helm-charts/src/branch/main/forgejo-runner) - Deploy a Forgejo Actions runner on the specified Forgejo instance - -### Actions -- [trust-self-signed-cert](https://code.forgejo.org/Seltsamsel/trust-self-signed-cert) - Trust a self-signed SSL certificate for future operations (e.g. checkout action). +## Infrastructure as Code +- [Ansible playbook](https://lab.enough.community/main/infrastructure/-/tree/master/playbooks/forgejo) - Deploy Forgejo & Woodpecker, depends on related [Enough Community](https://enough.community) playbooks. +- [Terraform & Ansible playbook](https://forgejo.dev/forgejo.dev/infrastructure-as-code/) - Deploy Forgejo, Minio, Nginx & Woodpecker in the cloud via [Docker Compose](https://docs.docker.com/compose/), depends on related [geerlingguy](https://github.com/geerlingguy) playbooks. +## Monitoring +- [Monitoring plugin to check Forgejo instance upgrade status](https://gitea.zionetrix.net/bn8/check_forgejo_upgrade) has the sources and is published in the [Icinga exchange repository](https://exchange.icinga.com/brenard/check_forgejo_upgrade). ## Clients ### Mobile - [GitNex](https://gitnex.com/) ([repo](https://codeberg.org/gitnex/GitNex)) - Android client for Forgejo and Gitea (`Android – GPL`) -- 👻 [GitTouch](https://github.com/git-touch/git-touch) - Mobile client for Forgejo, Gitea, GitHub, GitLab, Bitbucket (`Android, iOS – Apache`) +- [GitTouch](https://github.com/git-touch/git-touch) - Mobile client for Forgejo, Gitea, GitHub, GitLab, Bitbucket (`Android, iOS – Apache`) ### Command-line -- [![][forgejo] forgejo-curl](https://code.forgejo.org/forgejo/forgejo-curl) - a thin curl wrapper that helps with Forgejo authentication - [tea](https://gitea.com/gitea/tea) - the official Gitea CLI client, works with Forgejo (`cross-platform – MIT`) ## Tools -### Infrastructure as Code -- [Ansible playbook](https://lab.enough.community/main/infrastructure/-/tree/master/playbooks/forgejo) - Deploy Forgejo & Woodpecker, depends on related [Enough Community](https://enough.community) playbooks. -- [Terraform & Ansible playbook](https://forgejo.dev/forgejo.dev/infrastructure-as-code/) - Deploy Forgejo, Minio, Nginx & Woodpecker in the cloud via [Docker Compose](https://docs.docker.com/compose/), depends on related [geerlingguy](https://github.com/geerlingguy) playbooks. - -### Monitoring -- [Monitoring plugin to check Forgejo instance upgrade status](https://gitea.zionetrix.net/bn8/check_forgejo_upgrade) has the sources and is published in the [Icinga exchange repository](https://exchange.icinga.com/brenard/check_forgejo_upgrade). - ### Bots - [gitcat](https://git.mastodont.cat/spla/gitcat) - Python script that allows sign-up to a Forgejo instance to all local users of a Mastodon server. (`Python - GPLv3`) - [Renovate](https://docs.renovatebot.com/modules/platform/gitea/#gitea-and-forgejo) - Dependency update tool (similar to dependabot) with Forgejo support. (`TypeScript - AGPLv3`) -- [Codeijika](https://codeberg.org/kita/codeijika) - A Discord bot that retrieves various information from a Forgejo instance like Codeberg. (`Python - AGPLv3`) ### Scripts - [github2gitea/github2forgejo](https://github.com/maxkratz/github2gitea-mirror) - Bash script that creates mirrors for various GitHub resources like orgs, users and starred repos (incl. private repos). (`Bash - AGPLv3`) -- [Enhancements for Forgejo](https://git.kaki87.net/KaKi87/userscripts/src/branch/master/enhancementsForForgejo/README.md) - Violentmonkey userscript that adds minor UX improvements to the web UI. (`JavaScript - MIT`) - -### Package deployment -- [lein-forgejo-wagon](https://codeberg.org/rome-user/lein-forgejo-wagon) - Leiningen plugin for deployment and downloading of JARs in Maven repositories hosted on Forgejo packages. - -### API client libraries -- [Cyborus/forgejo-api](https://codeberg.org/Cyborus/forgejo-api) - Rust crate to interact with the Forgejo API (`Rust - Apache or MIT`) -- [harabat/pyforgejo](https://codeberg.org/harabat/pyforgejo) - Python client library to interact with the Forgejo API (`Python - MIT`) -- [mvdkleijn/forgejo-sdk](https://codeberg.org/mvdkleijn/forgejo-sdk) - Go client library to interact with the Forgejo API (fork of [gitea/go-sdk](https://gitea.com/gitea/go-sdk)) (`Go - MIT`) - -## References -Noteworthy news, articles and information about Forgejo. - -### Articles -- [Wikipedia DE](https://de.wikipedia.org/wiki/Forgejo) -- [Wikidata](https://www.wikidata.org/wiki/Q115962387) - -### Videos -- [Brodie Robertson on the Open Letter](https://www.youtube.com/watch?v=Oc3cEfhpp08) - a 15-minute video about the Open Letter that led to the creation of Forgejo a few weeks later ## Maintainers @@ -181,6 +117,7 @@ an [Issue](https://codeberg.org/forgejo-contrib/delightful-forgejo/issues) in ou - [`@caesar`](https://codeberg.org/caesar) - [`@crystal`](https://codeberg.org/crystal) +- [`@Ryuno-Ki`](https://codeberg.org/Ryuno-Ki) ## Contributors @@ -193,6 +130,3 @@ With delight we present you some of our [delightful contributors](delightful-con [![CC0](https://mirrors.creativecommons.org/presskit/buttons/88x31/svg/cc-zero.svg)](https://creativecommons.org/publicdomain/zero/1.0/) To the extent possible under law, the [maintainers](#maintainers) and other [contributors](delightful-contributors.md) have waived all copyright and related or neighboring rights to this work. - - -[forgejo]: https://codeberg.org/forgejo-contrib/delightful-forgejo/media/branch/main/resources/forgejo-20.svg diff --git a/delightful-contributors.md b/delightful-contributors.md index 8321586..d4c9335 100644 --- a/delightful-contributors.md +++ b/delightful-contributors.md @@ -13,10 +13,3 @@ These fine people brought us delight by adding their gems of freedom to this del - [Rychart Redwerkz](https://redwerkz.codeberg.page/) (codeberg: [@redwerkz](https://codeberg.org/redwerkz)) - [Earl Warren](https://codeberg.org/earl-warren) - [meissa GmbH](https://meissa.de/) (codeberg: [@meissa](https://codeberg.org/meissa), fediverse: [@team@social.meissa-gmbh.de](https://social.meissa-gmbh.de/@team)) -- [KaKi87](https://git.kaki87.net/KaKi87) (codeberg: [@KaKi87](https://codeberg.org/KaKi87), fediverse: [@KaKi87@mamot.fr](https://mamot.fr/@KaKi87)) -- [tranzystorek-io](https://tranzystorek-io.codeberg.page/) (codeberg: [@tranzystorek-io](https://codeberg.org/tranzystorek-io), fediverse: [@tranzystorek_io@fosstodon.org](https://fosstodon.org/@tranzystorek_io)) -- [Bart Mathijssen](https://bartmathijssen.com/) (codeberg: [@bart](https://codeberg.org/bart), fediverse: [@bart@bartmathijssen.com](https://mastodon.bartmathijssen.com/@bart)) -- [domske](https://codeberg.org/domske) -- [Darren Nathanael](https://darrennathanael.com) -- [Stefan Bethke](stb@lassitu.de) -- [Ikuyo Kita](https://kita.codeberg.page) (codeberg: [@kita](https://codeberg.org/kita), fediverse: [@kitacat@wetdry.world](https://wetdry.world/@kitacat)) diff --git a/resources/forgejo-20.svg b/resources/forgejo-20.svg deleted file mode 100644 index 265e03b..0000000 --- a/resources/forgejo-20.svg +++ /dev/null @@ -1,40 +0,0 @@ - - - - - Forgejo logo - Caesar Schinas - - - - - - - - - - - - -