aboutsummaryrefslogtreecommitdiffstats
path: root/docs/content/doc/development
diff options
context:
space:
mode:
authorHesterG <hestergong@gmail.com>2023-05-26 00:01:01 +0800
committerGitHub <noreply@github.com>2023-05-25 16:01:01 +0000
commitaa2b317e081615830522ca072ac703aa0487eea3 (patch)
treea5122a8fd9272d7550319d227bbfdc51167a7825 /docs/content/doc/development
parent19722cf12cfee317a56921120d13aeac90e8004e (diff)
downloadgitea-aa2b317e081615830522ca072ac703aa0487eea3.tar.gz
gitea-aa2b317e081615830522ca072ac703aa0487eea3.zip
Add Chinese docs for help, contribution and development (#24925)
Diffstat (limited to 'docs/content/doc/development')
-rw-r--r--docs/content/doc/development/integrations.zh-cn.md46
-rw-r--r--docs/content/doc/development/migrations.zh-cn.md40
2 files changed, 86 insertions, 0 deletions
diff --git a/docs/content/doc/development/integrations.zh-cn.md b/docs/content/doc/development/integrations.zh-cn.md
new file mode 100644
index 0000000000..694a9d5616
--- /dev/null
+++ b/docs/content/doc/development/integrations.zh-cn.md
@@ -0,0 +1,46 @@
+---
+date: "2023-05-25T17:29:00+08:00"
+title: "集成"
+slug: "integrations"
+weight: 65
+toc: false
+draft: false
+aliases:
+ - /zh-cn/integrations
+menu:
+ sidebar:
+ parent: "development"
+ name: "集成"
+ weight: 65
+ identifier: "integrations"
+---
+
+# 集成
+
+Gitea拥有一个出色的第三方集成社区,以及在其他各种项目中的一流支持。
+
+我们正在[awesome-gitea](https://gitea.com/gitea/awesome-gitea)上整理一个列表来跟踪这些集成!
+
+如果你正在寻找[CI/CD](https://gitea.com/gitea/awesome-gitea#user-content-devops),
+一个[SDK](https://gitea.com/gitea/awesome-gitea#user-content-sdk),
+甚至一些额外的[主题](https://gitea.com/gitea/awesome-gitea#user-content-themes),
+你可以在[awesome-gitea](https://gitea.com/gitea/awesome-gitea)中找到它们的列表!
+
+## 预填新文件名和内容
+
+如果你想打开一个具有给定名称和内容的新文件,
+你可以使用查询参数来实现:
+
+```txt
+GET /{{org}}/{{repo}}/_new/{{filepath}}
+ ?filename={{filename}}
+ &value={{content}}
+```
+
+例如:
+
+```txt
+GET https://git.example.com/johndoe/bliss/_new/articles/
+ ?filename=hello-world.md
+ &value=Hello%2C%20World!
+```
diff --git a/docs/content/doc/development/migrations.zh-cn.md b/docs/content/doc/development/migrations.zh-cn.md
new file mode 100644
index 0000000000..8e3d73417d
--- /dev/null
+++ b/docs/content/doc/development/migrations.zh-cn.md
@@ -0,0 +1,40 @@
+---
+date: "2023-05-25T17:29:00+08:00"
+title: "迁移界面"
+slug: "migrations-interfaces"
+weight: 55
+toc: false
+draft: false
+aliases:
+ - /zh-cn/migrations-interfaces
+menu:
+ sidebar:
+ parent: "development"
+ name: "迁移界面"
+ weight: 55
+ identifier: "migrations-interfaces"
+---
+
+# 迁移功能
+
+完整迁移功能在Gitea 1.9.0版本中引入。它定义了两个接口,用于支持从其他Git托管平台迁移存储库数据到Gitea,或者在将来将Gitea数据迁移到其他Git托管平台。
+
+目前已实现了从GitHub、GitLab和其他Gitea实例的迁移。
+
+首先,Gitea在包[modules/migration](https://github.com/go-gitea/gitea/tree/main/modules/migration)中定义了一些标准对象。它们是`Repository`、`Milestone`、`Release`、`ReleaseAsset`、`Label`、`Issue`、`Comment`、`PullRequest`、`Reaction`、`Review`、`ReviewComment`。
+
+## 下载器接口
+
+要从新的Git托管平台迁移,需要进行两个步骤的更新。
+
+- 您应该实现一个`Downloader`,用于获取存储库信息。
+- 您应该实现一个`DownloaderFactory`,用于检测URL是否匹配,并创建上述的`Downloader`。
+ - 您需要在`init()`中通过`RegisterDownloaderFactory`注册`DownloaderFactory`。
+
+您可以在[downloader.go](https://github.com/go-gitea/gitea/blob/main/modules/migration/downloader.go)中找到这些接口。
+
+## 上传器接口
+
+目前,只实现了`GiteaLocalUploader`,因此我们只能通过此Uploader将下载的数据保存到本地的Gitea实例。目前不支持其他上传器。
+
+您可以在[uploader.go](https://github.com/go-gitea/gitea/blob/main/modules/migration/uploader.go)中找到这些接口。