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