teal-language / tl

The compiler for Teal, a typed dialect of Lua
MIT License
2.16k stars 111 forks source link

Official website? #163

Open pdesaulniers opened 4 years ago

pdesaulniers commented 4 years ago

Somewhat related: https://github.com/teal-language/tl/pull/20

Of course, this is not really a must, but I think it would be fun if Teal had an official website.

I tried to deploy the docs/ folder as a GitHub pages site, and I believe it looks pretty cute by default:

2023-11-07-18:04:18

In order to select a theme, I created a file called docs/_config.yml with the following content:

theme: jekyll-theme-cayman
hishamhm commented 4 years ago

Oh, that looks nice! As does #20, which was created before we had a name/logo/color — I ended up dropping the ball on #20 because of the figuring out of the deployment/tooling/etc involved.

I do enjoy fiddling with the graphic design aspect of things every now and then (I did the looks for the https://gobolinux.org website a few years ago (and also its past incarnations)) but dealing with web frontend stuff is not really something I'd like to take on right now.

What you proposed sounds like a lightweight-enough solution that would require little to no management, I like that!

I hope my dear friend @darrenjennings doesn't mind if we go down this direction :)

(btw, I just happened to secure the teal-language.org domain this week :grin: )

euclidianAce commented 4 years ago

It would be neat if the website used something like fengari to run the Teal compiler on the frontend and have a little demo area for people to try it out. This is probably a little out of scope as the website would need a backend or cdn (or something, I'm definitly not a webdev) to serve the compiler and fengari, but could be neat in the future.

pdesaulniers commented 4 years ago

That would be neat!

This is probably a little out of scope as the website would need a backend or cdn (or something, I'm definitly not a webdev) to serve the compiler and fengari

Using GitHub pages, we can deliver the libraries straight from the git repo.

darrenjennings commented 4 years ago

I don’t mind! Jekyll is a easy enough setup, I worry about adding advanced features (like js teal playground). Was really interested in trying eleventy. It has the “simple static site generator” approach, similar to Jekyll. I also am keeping an eye on vite because of how fast and easy it is, but I’m always looking to invest in the vue ecosystem 🤗

lenscas commented 4 years ago

It would be neat if the website used something like fengari to run the Teal compiler on the frontend and have a little demo area for people to try it out. This is probably a little out of scope as the website would need a backend or cdn (or something, I'm definitly not a webdev) to serve the compiler and fengari, but could be neat in the future.

bit late, but people already managed to compile the lua vm to wasm. I already have used it once to run some lua code in the browser and although (back then) it didn't have any way to modify the dom that was years ago and isn't really needed anyway. Just capture the print output which was already possible and show it.

The biggest problem is with infinite loops as that gets the browser stuck, but its probably possible to work around it using webworkers and/or use https://www.lua.org/pil/23.2.html to kill the program if it looks like it entered an infinite loop/takes too long.

I don't mind giving it a try in the future.

pdesaulniers commented 4 years ago

It would be neat if the website used something like fengari to run the Teal compiler on the frontend and have a little demo area for people to try it out.

In the meantime, this fengari-based playground was made: https://teal-playground.netlify.app/

I guess what we need right now is a website in which to embed this playground?