nim js -r --port:1234 main: open in browser a template html that calls generated js, use livereload server etc; ditto with nim doc -r

[timotheecour]

• refs: nim -r option must be valid only when compiling nim-lang/Nim#13974 (comment)

• refs: nim doc --backend:js, nim doc --doccmd:-d:foo, nim r --backend:js, --doccmd:skip + other improvements nim-lang/Nim#14278 (comment)

• make --usenimcache default for nim doc ; IMO that's the best resolution for doc2 outputs in current work dir nim-lang/Nim#6583; any -o or --outdir would override --usenimcache anyway

• nim r doc --port:1234 main will save the html under nimcache (because -r implies --usenimcache), and setup (on 1st call) a livereload server (see https://chrome.google.com/webstore/detail/livereload/jnihajbhpnppcggbcgedagnkighmdlei?hl=en) so that the html opens in the same tab and auto-refreshes

• nim r -b:js --port:1234 (-d:nimbrowser) main will create a template html file that simply links against the generated js file so you can see it running in a browser, it will also use the livereload server to auto-refresh the same tab; this avoids setting up a server manually just to see how nim js code runs in a browser

links

• we need a way to test for nim js -d:nimbrowser · Issue #197 · timotheecour/Nim