From 17ff2c6a13f93d0099345ae0bf9c196eb34a49aa Mon Sep 17 00:00:00 2001 From: silverwind Date: Thu, 6 May 2021 21:44:46 +0200 Subject: [PATCH 1/3] Improve logo customization docs --- .../doc/advanced/customizing-gitea.en-us.md | 22 ++++++++----------- 1 file 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 9d94e75058fca..27f16e6721df4 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 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, one can attempt to convert a raster image using tools like [this](https://www.aconvert.com/image/png-to-svg/). ## Customizing Gitea pages and resources From f48929df94f8618448a219d3bdb7a6c145fc6365 Mon Sep 17 00:00:00 2001 From: silverwind Date: Thu, 6 May 2021 21:47:21 +0200 Subject: [PATCH 2/3] Update docs/content/doc/advanced/customizing-gitea.en-us.md --- docs/content/doc/advanced/customizing-gitea.en-us.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/doc/advanced/customizing-gitea.en-us.md b/docs/content/doc/advanced/customizing-gitea.en-us.md index 27f16e6721df4..5495cd5876bee 100644 --- a/docs/content/doc/advanced/customizing-gitea.en-us.md +++ b/docs/content/doc/advanced/customizing-gitea.en-us.md @@ -69,7 +69,7 @@ To build a custom logo clone the source repository, replace `assets/logo.svg` an - `public/img/avatar_default.png` - Used as the default avatar image - `public/img/apple-touch-icon.png` - Used on iOS devices for bookmarks -In case the source image is not in vector format, one can attempt to convert a raster image using tools like [this](https://www.aconvert.com/image/png-to-svg/). +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 From c9e35a49740020ffd2a3f30fbae7d213fa596c0a Mon Sep 17 00:00:00 2001 From: silverwind Date: Thu, 6 May 2021 21:48:39 +0200 Subject: [PATCH 3/3] Update docs/content/doc/advanced/customizing-gitea.en-us.md --- docs/content/doc/advanced/customizing-gitea.en-us.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/doc/advanced/customizing-gitea.en-us.md b/docs/content/doc/advanced/customizing-gitea.en-us.md index 5495cd5876bee..7a8e01d356072 100644 --- a/docs/content/doc/advanced/customizing-gitea.en-us.md +++ b/docs/content/doc/advanced/customizing-gitea.en-us.md @@ -60,7 +60,7 @@ the url `http://gitea.domain.tld/image.png`. ## Changing the logo -To build a custom logo clone the source repository, replace `assets/logo.svg` and run +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` - Used for favicon, site icon, app icon