Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Improve logo customization docs #15754

Merged
merged 4 commits into from
May 7, 2021
Merged

Improve logo customization docs #15754

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
17ff2c6
Improve logo customization docs
silverwind May 6, 2021
f48929d
Update docs/content/doc/advanced/customizing-gitea.en-us.md
silverwind May 6, 2021
c9e35a4
Update docs/content/doc/advanced/customizing-gitea.en-us.md
silverwind May 6, 2021
e15fb84
Merge branch 'main' into logodocs
techknowlogick May 7, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 9 additions & 13 deletions docs/content/doc/advanced/customizing-gitea.en-us.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down