diff options
| author | silverwind <me@silverwind.io> | 2023-09-27 04:05:49 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-09-26 22:05:49 -0400 |
| commit | c5247eff73ea0be33affb97d666c9d222aabcc37 (patch) | |
| tree | b5b7a5613e3c54518755be89e923c86840e9f744 /docs | |
| parent | 6967c13ad2de927f4d9bad65930db5fb383ca1d4 (diff) | |
| download | gitea-c5247eff73ea0be33affb97d666c9d222aabcc37.tar.gz gitea-c5247eff73ea0be33affb97d666c9d222aabcc37.zip | |
Enable production source maps for index.js, fix CSS sourcemaps (#27291)
Previously, the production build never output sourcemaps. Now we emit
one file for `index.js` because it is the most likely one where we need
to be able to better debug reported issues like
https://github.com/go-gitea/gitea/issues/27213. This will currently
increase the binary size of gitea by around 700kB which is what the
gzipped source map file has.
Also, I fixed the CSS sourcemap generation which was broken since the
introduction of lightningcss.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/content/installation/from-source.en-us.md | 10 | ||||
| -rw-r--r-- | docs/content/installation/from-source.zh-cn.md | 10 |
2 files changed, 16 insertions, 4 deletions
diff --git a/docs/content/installation/from-source.en-us.md b/docs/content/installation/from-source.en-us.md index ef720f0824..f6a95e8d0c 100644 --- a/docs/content/installation/from-source.en-us.md +++ b/docs/content/installation/from-source.en-us.md @@ -128,8 +128,6 @@ If pre-built frontend files are present it is possible to only build the backend TAGS="bindata" make backend ``` -Webpack source maps are by default enabled in development builds and disabled in production builds. They can be enabled by setting the `ENABLE_SOURCEMAP=true` environment variable. - ## Test After following the steps above, a `gitea` binary will be available in the working directory. @@ -260,3 +258,11 @@ GOARCH=amd64 \ TAGS="bindata sqlite sqlite_unlock_notify" \ make build ``` + +## Source Maps + +By default, gitea generates reduced source maps for frontend files to conserve space. This can be controlled with the `ENABLE_SOURCEMAP` environment variable: + +- `ENABLE_SOURCEMAP=true` generates all source maps, the default for development builds +- `ENABLE_SOURCEMAP=reduced` generates limited source maps, the default for production builds +- `ENABLE_SOURCEMAP=false` generates no source maps diff --git a/docs/content/installation/from-source.zh-cn.md b/docs/content/installation/from-source.zh-cn.md index 260ccbee3c..74f76652db 100644 --- a/docs/content/installation/from-source.zh-cn.md +++ b/docs/content/installation/from-source.zh-cn.md @@ -100,8 +100,6 @@ TAGS="bindata sqlite sqlite_unlock_notify" make build TAGS="bindata" make backend ``` -在开发构建中，默认启用 Webpack 源映射，在生产构建中禁用。可以通过设置`ENABLE_SOURCEMAP=true`环境变量来启用它们。 - ## 测试 按照上述步骤完成后，工作目录中将会有一个`gitea`二进制文件。可以从该目录进行测试，或将其移动到带有测试数据的目录中。当手动从命令行启动 Gitea 时，可以通过按下`Ctrl + C`来停止程序。 @@ -221,3 +219,11 @@ GOARCH=amd64 \ TAGS="bindata sqlite sqlite_unlock_notify" \ make build ``` + +## 源映射 + +默认情况下，gitea 会为前端文件生成精简的源映射以节省空间。 这可以通过“ENABLE_SOURCEMAP”环境变量进行控制： + +- `ENABLE_SOURCEMAP=true` 生成所有源映射，这是开发版本的默认设置 +- `ENABLE_SOURCEMAP=reduced` 生成有限的源映射，这是生产版本的默认设置 +- `ENABLE_SOURCEMAP=false` 不生成源映射 |