跳转到主要内容

书籍

Forgejo 用户指南（英文原版）

Forgejo 是轻量的自托管 Git 代码托管平台。本书（英文）面向使用者，介绍创建仓库、议题与合并请求协作、分支与标签保护、Actions 持续集成、软件包仓库、代码搜索、API 和访问令牌等用法。

10 章70 页更新于 18 小时前

开始阅读
CC BY-SA 4.0

目录70

  1. 01 Forgejo User Guide These documents are targeted to people who are using Forgejo but are not involved in running it on their ma... 9 小时前
  2. 第 1 章 Getting started 5 页
    1. 1.1 Your First Repository Almost everything on Forgejo happens in a repository. Think of a repository as a home for your project, whe... 9 小时前
    2. 1.2 The Basics of Issue Tracking Issues are an important means of communication on Forgejo. Besides their original purpose - reporting bugs ... 9 小时前
    3. 1.3 Integrated Wiki A wiki is a collaborative space on the web. It is a common practice to use wikis to collect knowledge and s... 9 小时前
    4. 1.4 Email Settings By default, Forgejo will send notifications to your registered email addresses. This section only concerns ... 18 小时前
    5. 1.5 Getting started Your first steps on Forgejo. 18 小时前
  3. 第 2 章 Collaborating with Others 8 页
    1. 2.1 Repository Activity For each repository, the Activity tab displays insights about the recent changes. It helps figure out how l... 9 小时前
    2. 2.2 Pull requests and Git flow Benefits of a pull-request-based workflow TLDR: Keep an eye on your repository and organization permissions... 9 小时前
    3. 2.3 Labels You can use labels to classify issues and pull requests and to improve your overview of them. Labels can be... 9 小时前
    4. 2.4 Repository Permissions When you invite collaborators to join your repository or when you create teams for your organization, you h... 9 小时前
    5. 2.5 Projects A project is a kanban board to organize issues. Card previews images If the card preview in the project is ... 9 小时前
    6. 2.6 Automatically Linked References in Issues, Pull Requests, and Commit Messages When an issue, pull request, or comment is posted, the text description is parsed in search of references. ... 9 小时前
    7. 2.7 Blocking a user Blocking another user is desirable if they are acting maliciously or are spamming your repository (for inst... 9 小时前
    8. 2.8 Profile customization By default, the profile page of a user (or an organization) is the list of repositories they own. It is pos... 9 小时前
  4. 第 3 章 Working with repositories 8 页
    1. 3.1 Tags and Releases What are tags? Tags are a feature in Git that can be used to make a snapshot of a repository from a point i... 9 小时前
    2. 3.2 Branch and tag protection Protected branches Protected branches enforce restrictions such as force pushing or merging unless a given ... 9 小时前
    3. 3.3 Blame File View Forgejo supports viewing the line-by-line revision history for a file, also known as blame view. You can al... 9 小时前
    4. 3.4 README badges If the badges service is enabled, Forgejo makes it possible to add badges - transparently generated by a se... 9 小时前
    5. 3.5 Issue and Pull Request Templates Some projects have a standard list of questions that users need to answer when creating an issue or pull re... 18 小时前
    6. 3.6 Merge Message Templates File Names Possible file names for PR (Pull Request) default merge message templates: .forgejo/default_merg... 18 小时前
    7. 3.7 Webhooks Forgejo supports webhooks for repository events. This can be configured on the settings page /:username/:r... 9 小时前
    8. 3.8 Programming language detection Forgejo tries to detect the languages used in a repository, for each file, to use this information in a num... 9 小时前
  5. 第 4 章 Actions CI 11 页
    1. 4.1 Forgejo Actions | User guide Forgejo Actions is a Continuous Integration system built into Forgejo. It lets you automatically build, lin... 9 小时前
    2. 4.2 Forgejo Actions | Quick start guide This guide explains how to set up a simple Forgejo Actions workflow. The basic concepts are all mentioned h... 9 小时前
    3. 4.3 Forgejo Actions | Basic concepts This page explains the basic concepts you'll encounter when using Forgejo Actions. All Forgejo Actions work... 9 小时前
    4. 4.4 Forgejo Actions | Advanced features This page covers the more advanced features of Forgejo Actions. pre-commit hook A pre-commit hook is provi... 7 小时前
    5. 4.5 Forgejo Actions | Using Actions Actions are reusable pieces of code that you can use in your CI workflows. Using Actions For example, to ch... 9 小时前
    6. 4.6 Forgejo Actions | Security Forgejo Actions is a very flexible CI/CD system. It lets you write workflows that execute arbitrary code, w... 9 小时前
    7. 4.7 Forgejo Actions | Security of Pull Requests A pull request may contain code that changes what is run by Forgejo Actions, for instance if it modifies a ... 9 小时前
    8. 4.8 Forgejo Actions | Security OpenID Connect Forgejo Actions allows for workflows to request OpenID Connect compatible JWT ID tokens from Forgejo to exc... 9 小时前
    9. 4.9 Forgejo Actions | GitHub Actions If you are familiar with GitHub Actions, you'll likely recognize many things in Forgejo Actions. Forgejo Ac... 9 小时前
    10. 4.10 Forgejo Actions | Reference This page contains the complete reference for Forgejo Actions workflow files. For a more information on wha... 9 小时前
    11. 4.11 Forgejo Actions | Troubleshooting When a workflow or an action fails to run as expected, the following steps may help to figure out where to ... 9 小时前
  6. 第 5 章 Search 2 页
    1. 5.1 Code Search Forgejo supports code search through an indexer and git-grep as a fallback when REPO_INDEXER_ENABLED is d... 9 小时前
    2. 5.2 Issue Search Since v11, Issue search on Forgejo replaced its previously dropdown-defined behavior of searches with a que... 18 小时前
  7. 第 6 章 API 3 页
    1. 6.1 API Usage The Forgejo API for all versions that have the same major number (e.g. the major number of Forgejo 7.0.0 is... 9 小时前
    2. 6.2 Forgejo numbering scheme The Forgejo versions look like X.Y.Z+gitea-A.B.C (e.g., 7.0.0+gitea-1.22.0). The Forgejo version is the fi... 18 小时前
    3. 6.3 API Forgejo's API is documented via Swagger/OpenAPI v2, the raw JSON file can be accessed via https://next.forg... 18 小时前
  8. 第 7 章 Git CLI 3 页
    1. 7.1 AGit Workflow Usage Forgejo ships with limited support for AGit-Flow. Similarly to Gerrit's workflow, this workflow provides a ... 18 小时前
    2. 7.2 Push Options Push To Create Push to create is a feature that allows you to push to a repository that does not yet exist ... 18 小时前
    3. 7.3 Git CLI Forgejo supports git push and git pull, but you can do more with the git command. Creating pull requests... 9 小时前
  9. 第 8 章 Authentication 2 页
    1. 8.1 Access Token Scope Forgejo supports scoped access tokens, which allow users to restrict tokens to operate only on selected URL... 9 小时前
    2. 8.2 OAuth2 provider Forgejo supports acting as an OAuth2 provider to allow third party applications to access its resources wit... 9 小时前
  10. 第 9 章 Packages 24 页
    1. 9.1 Package Registry Supported package managers The following package managers are currently supported: Name Language Package cl... 9 小时前
    2. 9.2 Alpine Packages Repository Publish Alpine packages for your user or organization. Requirements To work with the Alpine registry, you n... 9 小时前
    3. 9.3 ALT Package Registry Publish ALT packages for your user or organization. Requirements To work with the ALT registry, you need to... 18 小时前
    4. 9.4 Arch Package Registry Forgejo has a Arch Linux package registry, which can act as a fully working Arch linux mirror and connected... 18 小时前
    5. 9.5 Cargo Package Registry Publish Cargo packages for your user or organization. Requirements To work with the Cargo package registry,... 9 小时前
    6. 9.6 Chef Package Registry Publish Chef cookbooks for your user or organization. Requirements To work with the Chef package registry, ... 18 小时前
    7. 9.7 Composer Package Registry Publish Composer packages for your user or organization. Requirements To work with the Composer package reg... 9 小时前
    8. 9.8 Conan Package Registry Publish Conan packages for your user or organization. Requirements To work with the Conan package registry,... 9 小时前
    9. 9.9 Conda Package Registry Publish Conda packages for your user or organization. Requirements To work with the Conda package registry,... 18 小时前
    10. 9.10 Container Registry Publish Open Container Initiative compliant images for your user or organization. The container registry fo... 9 小时前
    11. 9.11 CRAN Package Registry Publish R packages to a CRAN-like registry for your user or organization. Requirements To work with the CRA... 18 小时前
    12. 9.12 Debian Package Registry Publish Debian packages for your user or organization. Requirements To work with the Debian registry, you n... 9 小时前
    13. 9.13 Generic Package Registry Publish generic files, like release binaries or other output, for your user or organization. Authenticate t... 9 小时前
    14. 9.14 Go Package Registry Publish Go packages for your user or organization. Publish a package To publish a Go package perform a HTTP... 18 小时前
    15. 9.15 Helm Chart Registry Publish Helm charts for your user or organization. Requirements To work with the Helm Chart registry use a ... 9 小时前
    16. 9.16 Maven Package Registry Publish Maven packages for your user or organization. Requirements To work with the Maven package registry,... 9 小时前
    17. 9.17 npm Package Registry Publish npm packages for your user or organization. Requirements To work with the npm package registry, you... 9 小时前
    18. 9.18 NuGet Package Registry Publish NuGet packages for your user or organization. The package registry supports the V2 and V3 API proto... 9 小时前
    19. 9.19 Pub Package Registry Publish Pub packages for your user or organization. Requirements To work with the Pub package registry, you... 9 小时前
    20. 9.20 PyPI Package Registry Publish PyPI packages for your user or organization. Requirements To work with the PyPI package registry, y... 9 小时前
    21. 9.21 RPM Package Registry Publish RPM packages for your user or organization. Requirements To work with the RPM registry, you need to... 18 小时前
    22. 9.22 RubyGems Packages Repository Publish RubyGems packages for your user or organization. Requirements To work with the RubyGems package reg... 9 小时前
    23. 9.23 Swift Packages Repository Swift Packages Repository Publish Swift packages for your user or organization. Requirements To work with t... 9 小时前
    24. 9.24 Vagrant Packages Repository Publish Vagrant packages for your user or organization. Requirements To work with the Vagrant package regis... 9 小时前
  11. 第 10 章 Advanced Usage 3 页
    1. 10.1 Comment on issues and pull requests via email NOTE: This feature is not enabled by default; the [email.incoming].ENABLED setting must be set. When recei... 7 小时前
    2. 10.2 Repository Mirrors Repository mirroring allows for the mirroring of repositories to and from external sources. You can use it ... 9 小时前
    3. 10.3 Forgejo Next https://next.forgejo.org, also known as Forgejo Next, is Forgejo's official testing and demonstration insta... 18 小时前