gitea/docs/content/doc/administration
wxiaoguang faa28b5a44
Move public asset files to the proper directory (#25907)
Move `public/*` to `public/assets/*`

Some old PRs (like #15219) introduced inconsistent directory system.

For example: why the local directory "public" is accessed by
`http://site/assets`? How to serve the ".well-known" files properly in
the public directory?

For convention rules, the "public" directory is widely used for the
website's root directory. It shouldn't be an exception for Gitea.

So, this PR makes the things consistent:

* `http://site/assets/foo` means `{CustomPath}/public/assets/foo`.
* `{CustomPath}/public/.well-known` and `{CustomPath}/public/robots.txt`
can be used in the future.

This PR is also a prerequisite for a clear solution for:
* #21942
* #25892 
* discourse.gitea.io: [.well-known path serving custom files behind
proxy?](https://discourse.gitea.io/t/well-known-path-serving-custom-files-behind-proxy/5445/1)

This PR is breaking for users who have custom "public" files (CSS/JS).
After getting approvals, I will update the documents.

----

## ⚠️ BREAKING ⚠️

If you have files in your "custom/public/" folder, please move them to
"custom/public/assets/".

---------

Co-authored-by: 6543 <6543@obermui.de>
Co-authored-by: Giteabot <teabot@gitea.io>
2023-07-18 18:06:43 +02:00
..
_index.en-us.md
_index.zh-cn.md
_index.zh-tw.md
adding-legal-pages.en-us.md
adding-legal-pages.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
backup-and-restore.en-us.md
backup-and-restore.zh-cn.md
backup-and-restore.zh-tw.md
cmd-embedded.en-us.md Move public asset files to the proper directory (#25907) 2023-07-18 18:06:43 +02:00
cmd-embedded.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
command-line.en-us.md Document creating an API key from the CLI (#25504) (#25510) 2023-06-26 05:13:20 +00:00
command-line.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
config-cheat-sheet.en-us.md Move public asset files to the proper directory (#25907) 2023-07-18 18:06:43 +02:00
config-cheat-sheet.zh-cn.md Fix all possible setting error related storages and added some tests (#23911) 2023-06-14 11:42:38 +08:00
customizing-gitea.en-us.md Move public asset files to the proper directory (#25907) 2023-07-18 18:06:43 +02:00
customizing-gitea.zh-cn.md Change branch name from master to main in some documents' links (#25126) 2023-06-08 07:35:55 +00:00
email-setup.en-us.md
email-setup.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
environment-variables.en-us.md
environment-variables.zh-cn.md
external-renderers.en-us.md Move public asset files to the proper directory (#25907) 2023-07-18 18:06:43 +02:00
external-renderers.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
fail2ban-setup.en-us.md
fail2ban-setup.zh-cn.md
git-lfs-support.en-us.md
git-lfs-support.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
https-support.en-us.md
https-support.zh-cn.md
logging-config.en-us.md
logging-config.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
mail-templates.en-us.md
mail-templates.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
repo-indexer.en-us.md
repo-indexer.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
reverse-proxies.en-us.md Remove reference to caddy v1 in docs (#24962) 2023-05-28 08:39:16 +00:00
reverse-proxies.zh-cn.md
search-engines-indexation.en-us.md
search-engines-indexation.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00
signing.en-us.md
signing.zh-cn.md `zh-cn` translation for administration docs (#24881) 2023-05-24 10:35:43 +08:00