mirrors/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2025-12-25 15:48:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

README-emscripten: Added some initial notes about customizing index.html.

Browse Source 
Fixes #14485.
This commit is contained in:
Ryan C. Gordon
2025-11-21 10:25:34 -05:00
parent 62a7ac507a
commit 029746a3d4
1 changed files with 16 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/README-emscripten.md
View File

@@ -344,6 +344,22 @@ all has to live in memory at runtime.
gives other options and details, and is worth a read.
## Customizing index.html
You don't have to use the HTML that Emscripten produces; the above examples
use `emcc -o index.html`, but you can `-o index.js` instead to just output
code without an HTML page, and then provide your own. This is desirable for
shipping products, even though the Emscripten-provided HTML is fine for
prototyping. Certain things _must_ be in the HTML file or your program will
not function correctly (or function at all). The specifics are beyond the
scope of this document, but it's likely best to start with the Emscripten HTML
and customize it, instead of starting from scratch.
The `<canvas>` element in the HTML _must not_ have a border or padding, or
things will break in unexpected ways. This can be surprising when customizing
the page's look. Plan accordingly.
## Debugging
Debugging web apps is a mixed bag. You should compile and link with