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/development
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
api-usage.en-us.md Harmonize title formatting in `docs/content/doc/development/api-usage.en-us.md` (#24529) 2 years ago
api-usage.zh-cn.md Refactor docs (#23752) 2 years ago
hacking-on-gitea.en-us.md Move public asset files to the proper directory (#25907) 2 years ago
hacking-on-gitea.zh-cn.md Unify doc links to use paths relative to doc folder (#24979) 2 years ago
integrations.en-us.md Refactor docs (#23752) 2 years ago
integrations.zh-cn.md Add Chinese docs for help, contribution and development (#24925) 2 years ago
integrations.zh-tw.md Refactor docs (#23752) 2 years ago
migrations.en-us.md Refactor docs (#23752) 2 years ago
migrations.zh-cn.md Add Chinese docs for help, contribution and development (#24925) 2 years ago
migrations.zh-tw.md Change branch name from master to main in some documents' links (#25126) 2 years ago
oauth2-provider.en-us.md Redesign Scoped Access Tokens (#24767) 2 years ago
oauth2-provider.zh-cn.md Refactor docs (#23752) 2 years ago
oauth2-provider.zh-tw.md Refactor docs (#23752) 2 years ago