Rename custom/conf/app.ini.sample to custom/conf/app.example.ini for better syntax light on editor (#11926)
* Rename custom/conf/app.ini.sample to custom/conf/app.sample.ini for better syntax light on editor * rename to app.example.ini * per @6543 's comment, update all references on docs Co-authored-by: techknowlogick <techknowlogick@gitea.io>
This commit is contained in:
parent
6c81b738f7
commit
03ba974481
9 changed files with 9 additions and 9 deletions
2
.gitignore
vendored
2
.gitignore
vendored
|
@ -53,7 +53,7 @@ coverage.all
|
||||||
/custom/*
|
/custom/*
|
||||||
!/custom/conf
|
!/custom/conf
|
||||||
/custom/conf/*
|
/custom/conf/*
|
||||||
!/custom/conf/app.ini.sample
|
!/custom/conf/app.example.ini
|
||||||
/data
|
/data
|
||||||
/indexers
|
/indexers
|
||||||
/log
|
/log
|
||||||
|
|
|
@ -23,7 +23,7 @@ or any corresponding location. When installing from a distribution, this will
|
||||||
typically be found at `/etc/gitea/conf/app.ini`.
|
typically be found at `/etc/gitea/conf/app.ini`.
|
||||||
|
|
||||||
The defaults provided here are best-effort (not built automatically). They are
|
The defaults provided here are best-effort (not built automatically). They are
|
||||||
accurately recorded in [app.ini.sample](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.ini.sample)
|
accurately recorded in [app.example.ini](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.example.ini)
|
||||||
(s/master/\<tag|release\>). Any string in the format `%(X)s` is a feature powered
|
(s/master/\<tag|release\>). Any string in the format `%(X)s` is a feature powered
|
||||||
by [ini](https://github.com/go-ini/ini/#recursive-values), for reading values recursively.
|
by [ini](https://github.com/go-ini/ini/#recursive-values), for reading values recursively.
|
||||||
|
|
||||||
|
@ -470,7 +470,7 @@ set name for unique queues. Individual queues will default to
|
||||||
|
|
||||||
- `ENABLED`: **true**: Enable this to allow uploading attachments.
|
- `ENABLED`: **true**: Enable this to allow uploading attachments.
|
||||||
- `PATH`: **data/attachments**: Path to store attachments.
|
- `PATH`: **data/attachments**: Path to store attachments.
|
||||||
- `ALLOWED_TYPES`: **see app.ini.sample**: Allowed MIME types, e.g. `image/jpeg|image/png`.
|
- `ALLOWED_TYPES`: **see app.example.ini**: Allowed MIME types, e.g. `image/jpeg|image/png`.
|
||||||
Use `*/*` for all types.
|
Use `*/*` for all types.
|
||||||
- `MAX_SIZE`: **4**: Maximum size (MB).
|
- `MAX_SIZE`: **4**: Maximum size (MB).
|
||||||
- `MAX_FILES`: **5**: Maximum number of attachments that can be uploaded at once.
|
- `MAX_FILES`: **5**: Maximum number of attachments that can be uploaded at once.
|
||||||
|
|
|
@ -15,7 +15,7 @@ menu:
|
||||||
|
|
||||||
# 配置说明
|
# 配置说明
|
||||||
|
|
||||||
这是针对Gitea配置文件的说明,你可以了解Gitea的强大配置。需要说明的是,你的所有改变请修改 `custom/conf/app.ini` 文件而不是源文件。所有默认值可以通过 [app.ini.sample](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.ini.sample) 查看到。如果你发现 `%(X)s` 这样的内容,请查看 [ini](https://github.com/go-ini/ini/#recursive-values) 这里的说明。标注了 :exclamation: 的配置项表明除非你真的理解这个配置项的意义,否则最好使用默认值。
|
这是针对Gitea配置文件的说明,你可以了解Gitea的强大配置。需要说明的是,你的所有改变请修改 `custom/conf/app.ini` 文件而不是源文件。所有默认值可以通过 [app.example.ini](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.example.ini) 查看到。如果你发现 `%(X)s` 这样的内容,请查看 [ini](https://github.com/go-ini/ini/#recursive-values) 这里的说明。标注了 :exclamation: 的配置项表明除非你真的理解这个配置项的意义,否则最好使用默认值。
|
||||||
|
|
||||||
## Overall (`DEFAULT`)
|
## Overall (`DEFAULT`)
|
||||||
|
|
||||||
|
|
|
@ -35,7 +35,7 @@ Again `gitea help` will allow you review this variable and you can override it u
|
||||||
`--config` option on the `gitea` binary.
|
`--config` option on the `gitea` binary.
|
||||||
|
|
||||||
- [Quick Cheat Sheet](https://docs.gitea.io/en-us/config-cheat-sheet/)
|
- [Quick Cheat Sheet](https://docs.gitea.io/en-us/config-cheat-sheet/)
|
||||||
- [Complete List](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.ini.sample)
|
- [Complete List](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.example.ini)
|
||||||
|
|
||||||
If the `CustomPath` folder can't be found despite checking `gitea help`, check the `GITEA_CUSTOM`
|
If the `CustomPath` folder can't be found despite checking `gitea help`, check the `GITEA_CUSTOM`
|
||||||
environment variable; this can be used to override the default path to something else.
|
environment variable; this can be used to override the default path to something else.
|
||||||
|
|
|
@ -22,7 +22,7 @@ Gitea 引用 `custom` 目录中的自定义配置文件来覆盖配置、模板
|
||||||
`custom/conf/app.ini` 当中。在发行版中可能会以 `/etc/gitea/` 的形式为 `custom` 设置一个符号链接,查看配置详情请移步:
|
`custom/conf/app.ini` 当中。在发行版中可能会以 `/etc/gitea/` 的形式为 `custom` 设置一个符号链接,查看配置详情请移步:
|
||||||
|
|
||||||
- [快速备忘单](https://docs.gitea.io/en-us/config-cheat-sheet/)
|
- [快速备忘单](https://docs.gitea.io/en-us/config-cheat-sheet/)
|
||||||
- [完整配置清单](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.ini.sample)
|
- [完整配置清单](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.example.ini)
|
||||||
|
|
||||||
如果您在 binary 同目录下无法找到 `custom` 文件夹,请检查您的 `GITEA_CUSTOM`
|
如果您在 binary 同目录下无法找到 `custom` 文件夹,请检查您的 `GITEA_CUSTOM`
|
||||||
环境变量配置, 因为它可能被配置到了其他地方(可能被一些启动脚本设置指定了目录)。
|
环境变量配置, 因为它可能被配置到了其他地方(可能被一些启动脚本设置指定了目录)。
|
||||||
|
|
|
@ -96,7 +96,7 @@ Both the LDAP via BindDN and the simple auth LDAP share the following fields:
|
||||||
the LDAP server. The default period is every 24 hours but that can be
|
the LDAP server. The default period is every 24 hours but that can be
|
||||||
changed in the app.ini file. See the *cron.sync_external_users* section in
|
changed in the app.ini file. See the *cron.sync_external_users* section in
|
||||||
the [sample
|
the [sample
|
||||||
app.ini](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.ini.sample)
|
app.ini](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.example.ini)
|
||||||
for detailed comments about that section. The *User Search Base* and *User
|
for detailed comments about that section. The *User Search Base* and *User
|
||||||
Filter* settings described above will limit which users can use Gitea and
|
Filter* settings described above will limit which users can use Gitea and
|
||||||
which users will be synchronized. When initially run the task will create
|
which users will be synchronized. When initially run the task will create
|
||||||
|
|
|
@ -75,7 +75,7 @@ Windows, on architectures like amd64, i386, ARM, PowerPC, and others.
|
||||||
- MSSQL
|
- MSSQL
|
||||||
- TiDB (experimental, not recommended)
|
- TiDB (experimental, not recommended)
|
||||||
- Configuration file
|
- Configuration file
|
||||||
- [app.ini](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.ini.sample)
|
- [app.ini](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.example.ini)
|
||||||
- Admin panel
|
- Admin panel
|
||||||
- Statistics
|
- Statistics
|
||||||
- Actions
|
- Actions
|
||||||
|
|
|
@ -70,7 +70,7 @@ Le but de ce projet est de fournir de la manière la plus simple, la plus rapide
|
||||||
- MSSQL
|
- MSSQL
|
||||||
- [TiDB](https://github.com/pingcap/tidb) (expérimental)
|
- [TiDB](https://github.com/pingcap/tidb) (expérimental)
|
||||||
- Fichier de configuration
|
- Fichier de configuration
|
||||||
- Voir [ici](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.ini.sample)
|
- Voir [ici](https://github.com/go-gitea/gitea/blob/master/custom/conf/app.example.ini)
|
||||||
- Panel d'administration
|
- Panel d'administration
|
||||||
- Statistiques
|
- Statistiques
|
||||||
- Actions
|
- Actions
|
||||||
|
|
Reference in a new issue