You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/content/administration/config-cheat-sheet.en-us.md
+1
Original file line number
Diff line number
Diff line change
@@ -430,6 +430,7 @@ The following configuration set `Content-Type: application/vnd.android.package-a
430
430
-`NAME`: **gitea**: Database name.
431
431
-`USER`: **root**: Database username.
432
432
-`PASSWD`: **_empty_**: Database user password. Use \`your password\` or """your password""" for quoting if you use special characters in the password.
433
+
-`CHARSET_COLLATION`: **_empty_**: (MySQL/MSSQL only) Gitea expects to use a case-sensitive collation for database. Leave it empty to use the default collation decided by the Gitea. Don't change it unless you clearly know what you need.
433
434
-`SCHEMA`: **_empty_**: For PostgreSQL only, schema to use if different from "public". The schema must exist beforehand,
434
435
the user must have creation privileges on it, and the user search path must be set to the look into the schema first
435
436
(e.g. `ALTER USER user SET SEARCH_PATH = schema_name,"$user",public;`).
Copy file name to clipboardExpand all lines: docs/content/contributing/guidelines-frontend.en-us.md
+2-1
Original file line number
Diff line number
Diff line change
@@ -48,11 +48,12 @@ We recommend [Google HTML/CSS Style Guide](https://google.github.io/styleguide/h
48
48
10. Avoid mixing different events in one event listener, prefer to use individual event listeners for every event.
49
49
11. Custom event names are recommended to use `ce-` prefix.
50
50
12. Gitea's tailwind-style CSS classes use `gt-` prefix (`gt-relative`), while Gitea's own private framework-level CSS classes use `g-` prefix (`g-modal-confirm`).
51
+
13. Avoid inline scripts & styles as much as possible, it's recommended to put JS code into JS files and use CSS classes. If inline scripts & styles are unavoidable, explain the reason why it can't be avoided.
51
52
52
53
### Accessibility / ARIA
53
54
54
55
In history, Gitea heavily uses Fomantic UI which is not an accessibility-friendly framework.
55
-
Gitea uses some patches to make Fomantic UI more accessible (see the `aria.js` and `aria.md`),
56
+
Gitea uses some patches to make Fomantic UI more accessible (see `aria.md` and related JS files),
56
57
but there are still many problems which need a lot of work and time to fix.
Copy file name to clipboardExpand all lines: docs/content/help/faq.en-us.md
-18
Original file line number
Diff line number
Diff line change
@@ -371,24 +371,6 @@ If you are receiving an error line containing `Error 1071: Specified key was too
371
371
then you are attempting to run Gitea on tables which use the ISAM engine. While this may have worked by chance in previous versions of Gitea, it has never been officially supported and
372
372
you must use InnoDB. You should run `ALTER TABLE table_name ENGINE=InnoDB;` for each table in the database.
373
373
374
-
If you are using MySQL 5, another possible fix is
375
-
376
-
```mysql
377
-
SET GLOBAL innodb_file_format=Barracuda;
378
-
SET GLOBAL innodb_file_per_table=1;
379
-
SET GLOBAL innodb_large_prefix=1;
380
-
```
381
-
382
-
## Why Are Emoji Broken On MySQL
383
-
384
-
Unfortunately MySQL's `utf8` charset does not completely allow all possible UTF-8 characters, in particular Emoji.
385
-
They created a new charset and collation called `utf8mb4` that allows for emoji to be stored but tables which use
386
-
the `utf8` charset, and connections which use the `utf8` charset will not use this.
387
-
388
-
Please run `gitea doctor convert`, or run `ALTER DATABASE database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`
389
-
for the database_name and run `ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`
390
-
for each table in the database.
391
-
392
374
## Why are Emoji displaying only as placeholders or in monochrome
393
375
394
376
Gitea requires the system or browser to have one of the supported Emoji fonts installed, which are Apple Color Emoji, Segoe UI Emoji, Segoe UI Symbol, Noto Color Emoji and Twemoji Mozilla. Generally, the operating system should already provide one of these fonts, but especially on Linux, it may be necessary to install them manually.
请运行 `gitea doctor convert` 或对数据库运行 `ALTER DATABASE database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`
393
-
并对每个表运行 `ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;`。
394
-
395
-
您还需要将`app.ini`文件中的数据库字符集设置为`CHARSET=utf8mb4`。
396
-
397
378
## 为什么 Emoji 只显示占位符或单色图像
398
379
399
380
Gitea 需要系统或浏览器安装其中一个受支持的 Emoji 字体,例如 Apple Color Emoji、Segoe UI Emoji、Segoe UI Symbol、Noto Color Emoji 和 Twemoji Mozilla。通常,操作系统应该已经提供了其中一个字体,但特别是在 Linux 上,可能需要手动安装它们。
Copy file name to clipboardExpand all lines: docs/content/installation/database-preparation.en-us.md
+6-2
Original file line number
Diff line number
Diff line change
@@ -61,10 +61,14 @@ Note: All steps below requires that the database engine of your choice is instal
61
61
62
62
Replace username and password above as appropriate.
63
63
64
-
4. Create database with UTF-8 charset and collation. Make sure to use `utf8mb4` charset instead of `utf8` as the former supports all Unicode characters (including emojis) beyond _Basic Multilingual Plane_. Also, collation chosen depending on your expected content. When in doubt, use either `unicode_ci` or `general_ci`.
64
+
4. Create database with UTF-8 charset and case-sensitive collation.
65
+
66
+
`utf8mb4_bin` is a common collation for both MySQL/MariaDB.
67
+
When Gitea starts, it will try to find a better collation (`utf8mb4_0900_as_cs` or `uca1400_as_cs`) and alter the database if it is possible.
68
+
If you would like to use other collation, you can set `[database].CHARSET_COLLATION` in the `app.ini` file.
65
69
66
70
```sql
67
-
CREATE DATABASE giteadb CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_unicode_ci';
71
+
CREATE DATABASE giteadb CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_bin';
|`group`| Everything, e.g. `el7`, `rocky/el9` , `test/fc38`.|
36
37
37
38
If the registry is private, provide credentials in the url. You can use a password or a [personal access token](development/api-usage.md#authentication):
0 commit comments