Improve logo customization docs (#15754)

* Improve logo customization docs

* Update docs/content/doc/advanced/customizing-gitea.en-us.md

* Update docs/content/doc/advanced/customizing-gitea.en-us.md

Co-authored-by: techknowlogick <techknowlogick@gitea.io>
This commit is contained in:
silverwind 2021-05-07 08:32:29 +02:00 committed by GitHub
parent 114c85e6ef
commit 9b5185d3cc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -58,22 +58,18 @@ To make Gitea serve custom public files (like pages and images), use the folder
For example, a file `image.png` stored in `$GITEA_CUSTOM/public/`, can be accessed with For example, a file `image.png` stored in `$GITEA_CUSTOM/public/`, can be accessed with
the url `http://gitea.domain.tld/image.png`. the url `http://gitea.domain.tld/image.png`.
## Changing the default logo ## Changing the logo
To build a custom logo replace `assets/logo.svg` and run `make generate-images`. This will update To build a custom logo clone the Gitea source repository, replace `assets/logo.svg` and run
these customizable logo files which you can then place in `$GITEA_CUSTOM/public/img` on your server: `make generate-images`. This will update below output files which you can then place in `$GITEA_CUSTOM/public/img` on your server:
- `public/img/logo.svg` - `public/img/logo.svg` - Used for favicon, site icon, app icon
- `public/img/logo.png` - `public/img/logo.png` - Used for Open Graph
- `public/img/favicon.png` - `public/img/favicon.png` - Used as fallback for browsers that don't support SVG favicons
- `public/img/avatar_default.png` - `public/img/avatar_default.png` - Used as the default avatar image
- `public/img/apple-touch-icon.png` - `public/img/apple-touch-icon.png` - Used on iOS devices for bookmarks
## Changing the default avatar In case the source image is not in vector format, you can attempt to convert a raster image using tools like [this](https://www.aconvert.com/image/png-to-svg/).
Either generate it via above method or place the png image at the following path:
- `$GITEA_CUSTOM/public/img/avatar_default.png`
## Customizing Gitea pages and resources ## Customizing Gitea pages and resources