From c29796288b12cd5ffb9ef91c49893b704eb17e28 Mon Sep 17 00:00:00 2001 From: Caesar Schinas Date: Tue, 25 Jul 2023 12:14:37 +0100 Subject: [PATCH] rearrange sections --- README.md | 29 ++++++++++++++++++----------- 1 file changed, 18 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 2b17bb3..825d05a 100644 --- a/README.md +++ b/README.md @@ -14,12 +14,12 @@ A curated list of delightful [Forgejo](https://forgejo.org/)-related projects an - [Public instances](#public-instances) - [Packaging](#packaging) - [Forgejo Actions runners](#forgejo-actions-runners) -- [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) - [References](#references) @@ -27,11 +27,13 @@ A curated list of delightful [Forgejo](https://forgejo.org/)-related projects an - [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/) @@ -45,23 +47,23 @@ Resources maintained as part of the primary Forgejo project. ## Documentation - In addition to [![][forgejo] Forgejo's official documentation](https://forgejo.org/docs/latest/), 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 - - [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/). + ## 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. - [KaKi's git](https://git.kaki87.net) - free and open, run by a French web developer. + ## Packaging Platform-specific packages to easily install and update Forgejo on your system. These are generally maintained either by distro packagers or by community volunteers. @@ -93,19 +95,13 @@ Also see [forgejo package versions on Repology](https://repology.org/project/for - **YunoHost** - [YunoHost package](https://github.com/YunoHost-Apps/forgejo_ynh) - install Forgejo quickly and simply on a YunoHost server + ## Forgejo actions runners - [![][forgejo] 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-hetzer-runner](https://codeberg.org/pierreprinetti/forgejo-hetzner-runner) - Deploy Forgejo Actions runners on Hetzner infrastructure -## 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 @@ -118,6 +114,13 @@ Also see [forgejo package versions on Repology](https://repology.org/project/for ## 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`) @@ -129,8 +132,12 @@ Also see [forgejo package versions on Repology](https://repology.org/project/for ## 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