You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
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>
2 years ago
..
_index.en-us.md Refactor docs (#23752) 2 years ago
_index.zh-cn.md Refactor docs (#23752) 2 years ago
_index.zh-tw.md Refactor docs (#23752) 2 years ago
adding-legal-pages.en-us.md Refactor docs (#23752) 2 years ago
adding-legal-pages.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
backup-and-restore.en-us.md Refactor docs (#23752) 2 years ago
backup-and-restore.zh-cn.md Remove unnecessary usage prefix from doc titles (#24869) 2 years ago
backup-and-restore.zh-tw.md Refactor docs (#23752) 2 years ago
cmd-embedded.en-us.md Move public asset files to the proper directory (#25907) 2 years ago
cmd-embedded.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
command-line.en-us.md Document creating an API key from the CLI (#25504) (#25510) 2 years ago
command-line.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
config-cheat-sheet.en-us.md Move public asset files to the proper directory (#25907) 2 years ago
config-cheat-sheet.zh-cn.md Fix all possible setting error related storages and added some tests (#23911) 2 years ago
customizing-gitea.en-us.md Move public asset files to the proper directory (#25907) 2 years ago
customizing-gitea.zh-cn.md Change branch name from master to main in some documents' links (#25126) 2 years ago
email-setup.en-us.md Refactor docs (#23752) 2 years ago
email-setup.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
environment-variables.en-us.md Refactor docs (#23752) 2 years ago
environment-variables.zh-cn.md Refactor docs (#23752) 2 years ago
external-renderers.en-us.md Move public asset files to the proper directory (#25907) 2 years ago
external-renderers.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
fail2ban-setup.en-us.md Refactor docs (#23752) 2 years ago
fail2ban-setup.zh-cn.md Refactor docs (#23752) 2 years ago
git-lfs-support.en-us.md Refactor docs (#23752) 2 years ago
git-lfs-support.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
https-support.en-us.md Refactor docs (#23752) 2 years ago
https-support.zh-cn.md Remove unnecessary usage prefix from doc titles (#24869) 2 years ago
logging-config.en-us.md Rewrite logger system (#24726) 2 years ago
logging-config.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
mail-templates.en-us.md Refactor docs (#23752) 2 years ago
mail-templates.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
repo-indexer.en-us.md Rewrite queue (#24505) 2 years ago
repo-indexer.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
reverse-proxies.en-us.md Remove reference to caddy v1 in docs (#24962) 2 years ago
reverse-proxies.zh-cn.md Remove unnecessary usage prefix from doc titles (#24869) 2 years ago
search-engines-indexation.en-us.md Refactor docs (#23752) 2 years ago
search-engines-indexation.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago
signing.en-us.md Refactor docs (#23752) 2 years ago
signing.zh-cn.md `zh-cn` translation for administration docs (#24881) 2 years ago