Document how to run locally

[egmontkob]

It's really not obvious to me how to run the skin viewer locally. Let's figure it out and document.

First, copy over the skins and update skins.json, by following the relevant steps from .github/workflows/static.yml's run section.

Then navigate the browser to file://[...]/index.html.

Chromium: You need to launch with --allow-file-access-from-files and then it works.

Firefox: In about:config you need to set security.fileuri.strict_origin_policy to false. But then it still doesn't work. In its console it complains that

XML Parsing Error: not well-formed
Location: file:///home/egmont/src/mc-skins/src/skins/electricblue256.ini?REV_SE-REV_MC
Line Number 1, Column 2:

XML Parsing Error: not well-formed
Location: file:///home/egmont/src/mc-skins/src/skins.json?REV_SE-REV_MC
Line Number 1, Column 1:

I don't understand this, why would it assume they are xml? It works on the web (so could perhaps be related to missing mime type locally) but also for skins.json the code clearly passes a 'json' parameter to $.get(), which I assume means the type of the data.

Do we know how to work this around for Firefox? If we don't then I'm perfectly fine with having to use Chrome, just let's document it. :)

[zyv]

Hmmm, I actually ran it from Idea, so I didn't have any of those issues. But maybe python -m http.server 8000 would be an acceptable option for you?

[egmontkob]

But maybe python -m http.server 8000 would be an acceptable option for you?

Absolutely! It's a great idea that didn't occur to me.

[zyv]

I'm glad to hear that. The issue with file:/// protocol is that it’s a bottomless pit of problems which all differ between browsers, but handling of local webservers is at least halfway standardized by now. So instead of opening this can of worms, I would recommend running a local web server if at all practical...