Add info on STATIC_URL_PREFIX gotcha in cheat sheet (#99)

When using *STATIC_URL_PREFIX* to load assets, some UI elements will stop working, as described on the Gitea server on Discord: https://discord.com/channels/322538954119184384/322910365237248000/1305896452400218122

The fix is, to disable *ui.notification.EVENT_SOURCE_UPDATE_TIME* by setting it to *-1*.

This PR adds that information to the _configuration cheat sheet_.

The fix is needed in Gitea 1.22.3. I do not know about previous versions.

Co-authored-by: tobias.petersen <tobias.petersen@unity3d.com>
Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Reviewed-on: https://gitea.com/gitea/docs/pulls/99
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: tobiasbp <tobiasbp@noreply.gitea.com>
Co-committed-by: tobiasbp <tobiasbp@noreply.gitea.com>
This commit is contained in:
tobiasbp
2024-12-04 01:50:30 +00:00
committed by Lunny Xiao
parent e80ea3d8e7
commit 9a204d82a1

View File

@@ -303,6 +303,11 @@ The following configuration set `Content-Type: application/vnd.android.package-a
assets, or copy the manually built Gitea assets from `$GITEA_BUILD/public` to
the assets location, eg: `/var/www/assets`, make sure `$STATIC_URL_PREFIX/assets/css/index.css`
points to `/var/www/assets/css/index.css`.
:::note
You must disable `ui.notification.EVENT_SOURCE_UPDATE_TIME` by setting it to **-1**.
If you do not, some _UI_ elements will not work. You will get the following error in the
browser console `Uncaught SecurityError: Failed to construct 'SharedWorker'`.
:::
- `HTTP_ADDR`: **0.0.0.0**: HTTP listen address.
- If `PROTOCOL` is set to `fcgi`, Gitea will listen for FastCGI requests on TCP socket