nprasad2077/docs
1
1
Fork 0
mirror of https://gitea.com/gitea/docs.git synced 2026-09-20 04:58:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fix more links and problems (#3)

Browse Source 
Reviewed-on: https://gitea.com/gitea/docs/pulls/3
This commit is contained in:
Lunny Xiao
2024-06-14 08:53:10 +00:00
parent 9a8396aa29
commit ab2cdde840
45 changed files with 83 additions and 174 deletions
Download Patch File Download Diff File Expand all files Collapse all files
i18n/zh-cn/docusaurus-plugin-content-docs/version-1.19/help/faq.md
+25 -28
View File
@@ -1,10 +1,7 @@
---
date: "2023-05-25T16:00:00+02:00"
title: "常见问题"
slug: "faq"
sidebar_position: 5
toc: false
draft: false
aliases:
- /zh-cn/faq
menu:
@@ -15,11 +12,11 @@ menu:
identifier: "faq"
---
# 常见问题 <!-- omit in toc -->
# 常见问题
本页面包含一些常见问题和答案。
有关更多帮助资源，请查看所有[支持选项](help/seek-help.md)。
有关更多帮助资源，请查看所有[支持选项](seek-help.md)。
## 1.x和1.x.x下载之间的区别
@@ -113,7 +110,7 @@ Gitea的自定义模板必须将其添加到正确的位置，否则Gitea将无
如果找不到，请尝试`echo $GITEA_CUSTOM`。
2. 如果仍然找不到，默认值可以被[计算](help/faq.md#where-does-gitea-store-what-file)
2. 如果仍然找不到，默认值可以被[计算](faq.md#Gitea存储文件的位置)
3. 如果仍然找不到路径，则可以参考[自定义Gitea](../administration/customizing-gitea.md)页面，将模板添加到正确的位置。
## Gitea是否有"GitHub/GitLab Pages"功能？
@@ -155,7 +152,7 @@ Gitea不提供内置的Pages服务器。您需要一个专用的域名来提供
1. 通过设置电子邮件域名的白名单或黑名单。
2. 通过设置一些域名或者OpenID白名单（见下文）。
3. 在您的`app.ini`中将`ENABLE_CAPTCHA`设置为`true`，并正确配置`RECAPTCHA_SECRET`和 `RECAPTCHA_SITEKEY`。
4. 将`DISABLE_REGISTRATION`设置为`true`，并通过 [CLI](../administration/command-line.md)、[API](development/api-usage.md) 或 Gitea 的管理界面创建新用户。
4. 将`DISABLE_REGISTRATION`设置为`true`，并通过 [CLI](../administration/command-line.md)、[API](../development/api-usage.md) 或 Gitea 的管理界面创建新用户。
### 仅允许/阻止特定的电子邮件域名
@@ -212,7 +209,7 @@ Gitea还提供了自己的SSH服务器，用于在SSHD不可用时使用。
请确保Gitea具有足够的权限来写入其主目录和数据目录。
参见[AppDataPath 和 RepoRootPath](help/faq.md#where-does-gitea-store-what-file)
参见[AppDataPath 和 RepoRootPath](faq.md#Gitea存储文件的位置)
**适用于Arch用户的注意事项：**在撰写本文时，Arch软件包的systemd文件包含了以下行：
@@ -244,7 +241,7 @@ Gitea还提供了自己的SSH服务器，用于在SSHD不可用时使用。
如果连接成功，您应该会收到以下错误消息：
```
```bash
Hi there, You've successfully authenticated, but Gitea does not provide shell access.
If this is unexpected, please log in with password and setup Gitea under another user.
```
@@ -256,7 +253,7 @@ If this is unexpected, please log in with password and setup Gitea under another
### SSH 常见错误
```
```bash
Permission denied (publickey).
fatal: Could not read from remote repository.
```
@@ -284,7 +281,7 @@ fatal: Could not read from remote repository.
认证成功，但是其他设置导致 SSH 无法访问正确的
存储库。
```
```bash
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
@@ -306,13 +303,13 @@ and the repository exists.
- 推送标签到存储库：
```
```bash
git push --tags
```
- 在 Gitea 中重新同步所有存储库的标签：
```
```bash
gitea admin repo-sync-releases
```
@@ -320,7 +317,7 @@ gitea admin repo-sync-releases
针对涉及 LFS 数据上传的问题
```
```bash
batch response: Authentication required: Authorization error: <GITEA_LFS_URL>/info/lfs/objects/batch
Check that you have proper access to the repository
error: failed to push some refs to '<GIT_REPO_URL>'
@@ -346,7 +343,7 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库，然后您
- 转到您的`站点管理 -> 用户账户`页面并编辑用户。
- 使用[管理 CLI 命令](../administration/command-line.md#admin)。
请注意，大多数命令还需要一个[全局标志](../administration/command-line.md#global-options)来指向正确的配置。
请注意，大多数命令还需要一个[全局标志](../administration/command-line.md#全局选项)来指向正确的配置。
- 作为**用户**，您可以更改密码...
- 在您的账户的`设置 -> 账户`页面（此方法**需要**您知道当前密码）。
- 使用`忘记密码`链接。
@@ -367,18 +364,18 @@ Gitea 提供了一个子命令`gitea migrate`来初始化数据库，然后您
> `ORM engine initialization failed: migrate: do migrate: Error: 1118: Row size too large...`
请运行`gitea convert`或对数据库中的每个表运行`ALTER TABLE table_name ROW_FORMAT=dynamic;`。
请运行 `gitea convert` 或对数据库中的每个表运行 `ALTER TABLE table_name ROW_FORMAT=dynamic;`。
潜在问题是默认行格式分配给每个表的索引空间
太小。Gitea 要求其表的`ROWFORMAT`为`DYNAMIC`。
太小。Gitea 要求其表的 `ROWFORMAT` 为 `DYNAMIC`。
如果收到包含`Error 1071: Specified key was too long; max key length is 1000 bytes...`
如果收到包含 `Error 1071: Specified key was too long; max key length is 1000 bytes...`
的错误行，则表示您正在尝试在使用 ISAM 引擎的表上运行 Gitea。尽管在先前版本的 Gitea 中可能是凑巧能够工作的，但它从未得到官方支持，
您必须使用 InnoDB。您应该对数据库中的每个表运行`ALTER TABLE table_name ENGINE=InnoDB;`。
如果您使用的是 MySQL 5，另一个可能的修复方法是：
```mysql
```SQL
SET GLOBAL innodb_file_format=Barracuda;
SET GLOBAL innodb_file_per_table=1;
SET GLOBAL innodb_large_prefix=1;
@@ -390,7 +387,7 @@ SET GLOBAL innodb_large_prefix=1;
他们创建了一个名为 `utf8mb4`的字符集和校对规则，允许存储 Emoji，但使用
utf8 字符集的表和连接将不会使用它。
请运行 `gitea convert` 或对数据库运行`ALTER DATABASE database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`
请运行 `gitea convert` 或对数据库运行 `ALTER DATABASE database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`
并对每个表运行
`ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`。
@@ -398,7 +395,7 @@ utf8 字符集的表和连接将不会使用它。
## 为什么 Emoji 只显示占位符或单色图像
Gitea 需要系统或浏览器安装其中一个受支持的 Emoji 字体，例如 Apple Color Emoji、Segoe UI Emoji、Segoe UI Symbol、Noto Color Emoji 和 Twemoji Mozilla。通常，操作系统应该已经提供了其中一个字体，但特别是在 Linux 上，可能需要手动安装它们。
Gitea 需要系统或浏览器安装其中一个受支持的 Emoji 字体，例如 `Apple Color Emoji`、`Segoe UI Emoji`、`Segoe UI Symbol`、`Noto Color Emoji` 和 `Twemoji Mozilla`。通常，操作系统应该已经提供了其中一个字体，但特别是在 Linux 上，可能需要手动安装它们。
## SystemD 和 Docker 上的标准输出日志
@@ -406,7 +403,7 @@ SystemD 上的标准输出默认会写入日志记录中。您可以尝试使用
类似地，Docker 上的标准输出可以使用`docker logs <container>`来查看。
要收集日志以进行帮助和问题报告，请参阅[支持选项](help/seek-help.md)。
要收集日志以进行帮助和问题报告，请参阅[支持选项](seek-help.md)。
## 初始日志记录
@@ -423,13 +420,13 @@ SystemD 上的标准输出默认会写入日志记录中。您可以尝试使用
有时，在迁移过程中，旧列和默认值可能在数据库架构中保持不变。
这可能会导致警告，例如：
```
```bash
2020/08/02 11:32:29 ...rm/session_schema.go:360:Sync2() [W] Table user Column keep_activity_private db default is , struct default is 0
```
可以安全地忽略这些警告，但您可以通过让 Gitea 重新创建这些表来停止这些警告，使用以下命令：
```
```bash
gitea doctor recreate-table user
```
@@ -438,13 +435,13 @@ gitea doctor recreate-table user
您可以使用以下命令要求 Gitea 重新创建多个表：
```
```bash
gitea doctor recreate-table table1 table2 ...
```
如果您希望 Gitea 重新创建所有表，请使用以下命令：
```
```bash
gitea doctor recreate-table
```
@@ -463,6 +460,6 @@ gitea doctor recreate-table
- 您还可以在`<ROOT_URL>/admin/config`中检查存储库根路径。
- 确保存在要采用存储库的用户/组织。
- 作为管理员，转到`<ROOT_URL>/admin/repos/unadopted`并搜索。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#repository-repository) 获得类似的权限。
- 用户也可以通过配置[`ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES`](../administration/config-cheat-sheet.md#仓库) 获得类似的权限。
- 如果上述步骤都正确执行，您应该能够选择要采用的存储库。
- 如果没有找到存储库，请启用[调试日志记录](../administration/config-cheat-sheet.md#repository-repository)以检查是否有特定错误。
- 如果没有找到存储库，请启用[调试日志记录](../administration/config-cheat-sheet.md#仓库)以检查是否有特定错误。
i18n/zh-cn/docusaurus-plugin-content-docs/version-1.19/help/seek-help.md
+1 -2
View File
@@ -1,6 +1,5 @@
---
date: "2017-01-20T15:00:00+08:00"
title: "需要帮助"
slug: "seek-help"
sidebar_position: 20
toc: false
@@ -13,7 +12,7 @@ menu:
identifier: "seek-help"
---
## 需要帮助?
# 需要帮助？
如果您在使用或者开发过程中遇到问题，请到以下渠道咨询：