josdejong
Make live demos on the website working for node.js examples
Where http://mathjs.org/examples/advanced/custom_argument_parsing.js.html Custom argument parsing File: custom_argument_parsing.js (click for a live demo)
Thanks for bringing this up.
The "live demo" link currently only works for the browser examples. We should either turn this link off for the node.js examples like custom_argument_parsing.js, or link it to a real live demo on RunKit or CodeSandbox or something like that.
Sounds fun. What would you think about adding the interactive code demos to the examples page itself (the table of contents at the top of the page links to individual sections below), so visitors could play with all the demos right there? We could even include the relevant portions of the JS which visitors can edit in a small window, and see the results immediately. Then next to that is a link to the full JS/HTML like there is now.
I've looked at a few code snippet hosting providers. JSFiddle has a nice, clean interface for embedded fiddles (https://docs.jsfiddle.net/embedding-fiddles) but they are not editable. Codepen can do editable embedded pens but it requires a pro account. Codesandbox can supposedly do it but I couldn't figure out how to make it work. Have any of you had any luck with anything else? We could do our own but it seems like it might take a lot of work.
I think it is okay do not allow support editing embedded snippets. As long is folk can click a link to get to an editable one.
Alternatively, I think runkit allows editable embedded snippets: https://runkit.com/docs/embed
Some more options (I don't know if / how well they support embedding):
- ~https://codepen.io~ doesn't support node.js
- https://frontarm.com/demoboard/
Another suggestion:
- https://repl.it/languages/nodejs
- https://codesandbox.io/pricing
👍 I guess we should summarize pros/cons of the alternatives and pick a suitable one.
A very small team and I are looking into this now! Was there ever internal discussion on which embedded node platform sounds best? One that I found while investigating was https://glitch.com, which seems to have a free tier that supports our needs and allows embedding.
Also, it looks like just the files in /examples and /examples/advanced need updating, does that sound right? I want to make sure there's no actual website code that needs updating in addition to these examples.
o nice, thanks👌
Yes, we'll have to see what a suitable solution is for embedded node.js examples. https://runkit.com can be interesting too, that's used by npm.
Also, it looks like just the files in
/examplesand/examples/advancedneed updating, does that sound right?
That is correct