diff options
| author | silverwind <me@silverwind.io> | 2021-05-07 08:32:29 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-05-07 02:32:29 -0400 |
| commit | 9b5185d3cc0bd63d7387655bedaeea6340695d95 (patch) | |
| tree | acdb6967fa09515d93c8d04f7a7140e5065587e4 | |
| parent | 114c85e6ef96b318dc5938863d29980273a7fdc1 (diff) | |
| download | gitea-9b5185d3cc0bd63d7387655bedaeea6340695d95.tar.gz gitea-9b5185d3cc0bd63d7387655bedaeea6340695d95.zip | |
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>
| -rw-r--r-- | docs/content/doc/advanced/customizing-gitea.en-us.md | 22 |
1 files changed, 9 insertions, 13 deletions
diff --git a/docs/content/doc/advanced/customizing-gitea.en-us.md b/docs/content/doc/advanced/customizing-gitea.en-us.md index 9d94e75058..7a8e01d356 100644 --- a/docs/content/doc/advanced/customizing-gitea.en-us.md +++ b/docs/content/doc/advanced/customizing-gitea.en-us.md @@ -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 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 -these customizable logo files which you can then place in `$GITEA_CUSTOM/public/img` on your server: +To build a custom logo clone the Gitea source repository, replace `assets/logo.svg` and run +`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.png` -- `public/img/favicon.png` -- `public/img/avatar_default.png` -- `public/img/apple-touch-icon.png` +- `public/img/logo.svg` - Used for favicon, site icon, app icon +- `public/img/logo.png` - Used for Open Graph +- `public/img/favicon.png` - Used as fallback for browsers that don't support SVG favicons +- `public/img/avatar_default.png` - Used as the default avatar image +- `public/img/apple-touch-icon.png` - Used on iOS devices for bookmarks -## Changing the default avatar - -Either generate it via above method or place the png image at the following path: - -- `$GITEA_CUSTOM/public/img/avatar_default.png` +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/). ## Customizing Gitea pages and resources |