You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.md 6.6 kB

11 years ago
11 years ago
10 years ago
10 years ago
11 years ago
11 years ago
11 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116
  1. [简体中文](README_ZH.md)
  2. <h1> <img src="https://raw.githubusercontent.com/go-gitea/gitea/master/public/img/gitea-192.png" alt="logo" width="30" height="30"> Gitea - Git with a cup of tea</h1>
  3. [![Build Status](https://drone.gitea.io/api/badges/go-gitea/gitea/status.svg)](https://drone.gitea.io/go-gitea/gitea)
  4. [![Join the Discord chat at https://discord.gg/NsatcWJ](https://img.shields.io/discord/322538954119184384.svg)](https://discord.gg/NsatcWJ)
  5. [![](https://images.microbadger.com/badges/image/gitea/gitea.svg)](https://microbadger.com/images/gitea/gitea "Get your own image badge on microbadger.com")
  6. [![codecov](https://codecov.io/gh/go-gitea/gitea/branch/master/graph/badge.svg)](https://codecov.io/gh/go-gitea/gitea)
  7. [![Go Report Card](https://goreportcard.com/badge/code.gitea.io/gitea)](https://goreportcard.com/report/code.gitea.io/gitea)
  8. [![GoDoc](https://godoc.org/code.gitea.io/gitea?status.svg)](https://godoc.org/code.gitea.io/gitea)
  9. [![GitHub release](https://img.shields.io/github/release/go-gitea/gitea.svg)](https://github.com/go-gitea/gitea/releases/latest)
  10. [![Help Contribute to Open Source](https://www.codetriage.com/go-gitea/gitea/badges/users.svg)](https://www.codetriage.com/go-gitea/gitea)
  11. [![Become a backer/sponsor of gitea](https://opencollective.com/gitea/tiers/backers/badge.svg?label=backers&color=brightgreen)](https://opencollective.com/gitea)
  12. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
  13. [![Crowdin](https://badges.crowdin.net/gitea/localized.svg)](https://crowdin.com/project/gitea)
  14. ## Purpose
  15. The goal of this project is to make the easiest, fastest, and most
  16. painless way of setting up a self-hosted Git service.
  17. Using Go, this can be done with an independent binary distribution across
  18. **all platforms** which Go supports, including Linux, macOS, and Windows
  19. on x86, amd64, ARM and PowerPC architectures.
  20. Want to try it before doing anything else?
  21. Do it [with the online demo](https://try.gitea.io/)!
  22. This project has been
  23. [forked](https://blog.gitea.io/2016/12/welcome-to-gitea/) from
  24. [Gogs](https://gogs.io) since 2016.11 but changed a lot.
  25. ## Building
  26. From the root of the source tree, run:
  27. TAGS="bindata" make build
  28. or if sqlite support is required:
  29. TAGS="bindata sqlite sqlite_unlock_notify" make build
  30. More info: https://docs.gitea.io/en-us/install-from-source/
  31. ## Using
  32. ./gitea web
  33. NOTE: If you're interested in using our APIs, we have experimental
  34. support with [documentation](https://try.gitea.io/api/swagger).
  35. ## Contributing
  36. Expected workflow is: Fork -> Patch -> Push -> Pull Request
  37. NOTES:
  38. 1. **YOU MUST READ THE [CONTRIBUTORS GUIDE](CONTRIBUTING.md) BEFORE STARTING TO WORK ON A PULL REQUEST.**
  39. 2. If you have found a vulnerability in the project, please write privately to **security@gitea.io**. Thanks!
  40. ## Further information
  41. For more information and instructions about how to install Gitea, please look
  42. at our [documentation](https://docs.gitea.io/en-us/). If you have questions
  43. that are not covered by the documentation, you can get in contact with us on
  44. our [Discord server](https://discord.gg/NsatcWJ),
  45. or [forum](https://discourse.gitea.io/)!
  46. ## Authors
  47. * [Maintainers](https://github.com/orgs/go-gitea/people)
  48. * [Contributors](https://github.com/go-gitea/gitea/graphs/contributors)
  49. * [Translators](options/locale/TRANSLATORS)
  50. ## Backers
  51. Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/gitea#backer)]
  52. <a href="https://opencollective.com/gitea#backers" target="_blank"><img src="https://opencollective.com/gitea/backers.svg?width=890"></a>
  53. ## Sponsors
  54. Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/gitea#sponsor)]
  55. <a href="https://opencollective.com/gitea/sponsor/0/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/0/avatar.svg"></a>
  56. <a href="https://opencollective.com/gitea/sponsor/1/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/1/avatar.svg"></a>
  57. <a href="https://opencollective.com/gitea/sponsor/2/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/2/avatar.svg"></a>
  58. <a href="https://opencollective.com/gitea/sponsor/3/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/3/avatar.svg"></a>
  59. <a href="https://opencollective.com/gitea/sponsor/4/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/4/avatar.svg"></a>
  60. <a href="https://opencollective.com/gitea/sponsor/5/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/5/avatar.svg"></a>
  61. <a href="https://opencollective.com/gitea/sponsor/6/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/6/avatar.svg"></a>
  62. <a href="https://opencollective.com/gitea/sponsor/7/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/7/avatar.svg"></a>
  63. <a href="https://opencollective.com/gitea/sponsor/8/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/8/avatar.svg"></a>
  64. <a href="https://opencollective.com/gitea/sponsor/9/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/9/avatar.svg"></a>
  65. ## FAQ
  66. **How do you pronounce Gitea?**
  67. Gitea is pronounced [/ɡɪ’ti:/](https://youtu.be/EM71-2uDAoY) as in "gi-tea" with a hard g.
  68. **Why is this not hosted on a Gitea instance?**
  69. We're [working on it](https://github.com/go-gitea/gitea/issues/1029).
  70. ## License
  71. This project is licensed under the MIT License.
  72. See the [LICENSE](https://github.com/go-gitea/gitea/blob/master/LICENSE) file
  73. for the full license text.
  74. ## Screenshots
  75. Looking for an overview of the interface? Check it out!
  76. |![Dashboard](https://dl.gitea.io/screenshots/home_timeline.png)|![User Profile](https://dl.gitea.io/screenshots/user_profile.png)|![Global Issues](https://dl.gitea.io/screenshots/global_issues.png)|
  77. |:---:|:---:|:---:|
  78. |![Branches](https://dl.gitea.io/screenshots/branches.png)|![Web Editor](https://dl.gitea.io/screenshots/web_editor.png)|![Activity](https://dl.gitea.io/screenshots/activity.png)|
  79. |![New Migration](https://dl.gitea.io/screenshots/migration.png)|![Migrating](https://dl.gitea.io/screenshots/migration.gif)|![Pull Request View](https://image.ibb.co/e02dSb/6.png)
  80. ![Pull Request Dark](https://dl.gitea.io/screenshots/pull_requests_dark.png)|![Diff Review Dark](https://dl.gitea.io/screenshots/review_dark.png)|![Diff Dark](https://dl.gitea.io/screenshots/diff_dark.png)|