From b29563ac637cc6e8207a63d342e4ad1c825b0b71 Mon Sep 17 00:00:00 2001 From: Jason Duan Date: Thu, 2 Jul 2020 09:48:19 +0800 Subject: [PATCH] Update README --- README | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/README b/README index f94ad60..e4c6fbb 100644 --- a/README +++ b/README @@ -1,2 +1,46 @@ # nre-few f +## Purpose + +The goal of this project is to make the easiest, fastest, and most +painless way of setting up a self-hosted Git service. +Using Go, this can be done with an independent binary distribution across +**all platforms** which Go supports, including Linux, macOS, and Windows +on x86, amd64, ARM and PowerPC architectures. +Want to try it before doing anything else? +Do it [with the online demo](https://try.gitea.io/)! +This project has been +[forked](https://blog.gitea.io/2016/12/welcome-to-gitea/) from +[Gogs](https://gogs.io) since 2016.11 but changed a lot. + +## Building + +From the root of the source tree, run: + + TAGS="bindata" make build + +or if sqlite support is required: + + TAGS="bindata sqlite sqlite_unlock_notify" make build + +The `build` target is split into two sub-targets: + +- `make backend` which requires [Go 1.12](https://golang.org/dl/) or greater. +- `make frontend` which requires [Node.js 10.13](https://nodejs.org/en/download/) or greater. + +If pre-built frontend files are present it is possible to only build the backend: + + TAGS="bindata" make backend + +More info: https://docs.gitea.io/en-us/install-from-source/ + +## Using + + ./gitea web + +NOTE: If you're interested in using our APIs, we have experimental +support with [documentation](https://try.gitea.io/api/swagger). + +## Contributing + +Expected workflow is: Fork -> Patch -> Push -> Pull Request