7 ms·

Show HN: Shite – little hot-reloadin' static site maker from shell

141 points by adityaathalye 4y ago

Or more precisely, my little site maker... It is a personal tool that I thoroughly enjoyed making, and enjoy using to write my website <https://evalapply.org https://evalapply.org>. A caveat before any more; nobody was supposed to promote this insanity. Like, terrible things have been done involving inotify and xdotool. But. It showed up on HN some months ago. That too while it was still, shall we say, fermenting. It got "done" some time thence, and of course one could not let the half-past just be. So here we are, for better or worse. Thank you HN mods for helping me repost! _\\// The README explains all, animated GIFs and whatnot. Some assorted highlights: - shite's, ah, "business logic" (except templates) is about 300 lines of Bash, written in Functional Programming style [^]. Pipeline all the things! - The innards won't surprise Perl/PHP/Shell gentleperson hackers from the last century. - The local hot reloading workflow is surprisingly nice, and occasionally hilarious! No JavaScript needed. - Full rebuilds are low performance and that's fine :) - Pandoc is great. - Sometimes sed and regex is exactly the HTML parser you need. *Very* sometimes. - stdio buffering can mess you up - jq -Rr @html # escapes HTML; what?! ... and all sorts of other stuff noted in the README and inline docs. [^] because shell ain't a bad place to FP... https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp-part-1-doug-mcilroys-pipeline/ https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp... --- P.S.The commit history stops at 3-odd months ago, because I've been using a private fork for day-to-day content drafting, publishing, and layout tweaks. The "business logic" is by and large the same as the public version linked here.

082349872349872 4y ago
One thing I enjoy about shell pipelines is that intermediate processes may terminate them. eg https://www.99-bottles-of-beer.net/language-bourne-shell-1088.html https://www.99-bottles-of-beer.net/language-bourne-shell-108...
- adityaathalye 4y ago
  In fact, I rely on that sort of early termination / circuit breaking as a feature! That is a big reason why I use functions. They help me define sane fallbacks, and/or enforce API contracts. Those, in turn, are points where I can enforce "fail and die" behaviour. Design notes: https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp-part-2-functions-as-unix-tools/index.html#use-parameter-substitutions-and-local-scope-variables https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp... Example from shite: Hard stop if mandatory front matter for posts is absent: https://github.com/adityaathalye/shite/blob/master/bin/templates.sh#L187 https://github.com/adityaathalye/shite/blob/master/bin/templ... edit: clarity
  - 082349872349872 4y ago
    nice ... and the Heredocs are a nice way to template!
    - adityaathalye 4y ago
      Right?! It was a bit of a lightbulb moment. I wanted a way to just write HTML templates. What really sealed the deal was the ability to punch content from stdin anywhere within a heredoc's scope using `$(cat -)`: https://github.com/adityaathalye/shite#templating-system https://github.com/adityaathalye/shite#templating-system
datpiff 4y ago
A+ name, no notes
- adityaathalye 4y ago
  Heh, thank you. It almost wrote itself. I was trying to cook up a clever tagline, and fell upon "static sites from shell" and my brain looped about and found the tongue twister, sort of like "She sells sea shells on the sea shore", and well all esh shounds shtarted shounding like thish. These days I like that name more because it (hopefully) alerts the Dear Reader about the quality of software they are about to visit, should they take it upon themselves to do so.
- deleted 4y ago
  [deleted]
jrm4 4y ago
Lol, funny, I dig it. Right here in real life I just do http://zim-wiki.org http://zim-wiki.org + a custom CSS Template + a few shell scripts. http://jrm4.com http://jrm4.com
- adityaathalye 4y ago
  Thanks :) Likewise, I'm basically locked into "life in plaintext", as a die-hard orgmode user. With what I have on disk, a big positive is any "system" of organisation is opt-in, post-hoc, and fungible. Like, today, shite can be seen as merely one lens into a subset of my org files, to compile that subset into a website. Tomorrow I could bring back hugo. That choice has no bearing on how any other method of organisation might use those same files (e.g. I can pull up index views using orgmode's own query feature set). And further, a single blog posts's org file can power live demos in Emacs (org-babel), and gets exported as a blog post, and as a PDF slide deck, like this: https://www.evalapply.org/posts/why-and-how-i-use-org-mode/index.html#a-pretty-good-example-of-my-usage https://www.evalapply.org/posts/why-and-how-i-use-org-mode/i...
masukomi 4y ago
This is amazing and i love it. As much as I've been enjoying hugo, I've been craving something that's much closer to this.
- adityaathalye 4y ago
  Haha thank you. I confess, I take childlike delight in every hotreload on save. Had it not worked well enough, I'd have stuck with hugo at the cost of a jankier authoring + build pipeline (org --ox-hugo--> markdown --hugo--> html).
yakshaving_jgt 4y ago
I'm assuming just about everyone is aware of the meaning of the word. https://www.urbandictionary.com/define.php?term=Shite https://www.urbandictionary.com/define.php?term=Shite Kind of depressing that people find this amusing.
- adityaathalye 4y ago
  This remark prompted me to go rewatch (make sure you have headphones on)... this bit of fry and laurie https://www.youtube.com/watch?v=cVe3fTL1cPM https://www.youtube.com/watch?v=cVe3fTL1cPM this bit by atkinson and cleese https://www.youtube.com/watch?v=OGFz9gt0-Fc https://www.youtube.com/watch?v=OGFz9gt0-Fc and this bit by atkinson alone https://www.youtube.com/watch?v=R7OxTxAvvLw https://www.youtube.com/watch?v=R7OxTxAvvLw made my day :)
- badcppdev 4y ago
  It's sad because it's not hard to pick a name for a project that isn't a swear word.
  - 082349872349872 4y ago
    I once had a gig someplace where the tradition was to name Hamming Distance 1 away from swear words. Best of both worlds?
- mrlonglong 4y ago
  Oh do one mate quit griping and get with it!
- nmeofthestate 4y ago
  I suggest a SFW rename to "connery"
  - talideon 4y ago
    You might want to look that up in French, but replace the 'y' with 'ie'...
- 4y ago
jamal-kumar 4y ago
This is really impressive, I tried making my own SSG in shell scripts after looking at all these bloated ways to do it and realizing "this is something I could literally do in ten minutes of bash". It works for my use case but you went WAY further with the concept, good stuff
- adityaathalye 4y ago
  Thank you! It most assuredly was not "ten minutes of Bash". You see, there comes a time in every self-respecting Yak-shaving programmer’s life when one is driven to render large-scale follicle trimmage unto a sizeable Yak. In my case, ‘twas and ‘tis the deceptively diminutive but in fact mighty Site-Maker-Yak that renders World Wide Web Sites publishable unto the Internet. I wager, engaging oneself in the glorious enterprise of Yak-shaving is at least as therapeutic for the trimmer as it must be to the trimmee. I wholeheartedly recommend it :)
  - jamal-kumar 4y ago
    Yeah the live reload is especially impressive, I was literally just slapping content in between a header and footer and getting away with easy clean results hahaha
bashNoIGGERob 4y ago
[dead]
dboreham 4y ago
Y'all know that's a word in Scottish English, right?
- jwdunne 4y ago
  Northern English dialect too…
  - raffraffraff 4y ago
    And Irish
    - walthamstow 4y ago
      London too
      - adityaathalye 4y ago
        A Bit of Fry and Laurie, Concerning Language https://www.youtube.com/watch?v=3MWpHQQ-wQg https://www.youtube.com/watch?v=3MWpHQQ-wQg
        mrlonglong 4y ago
        And southern too. All shite.
- satvikpendem 4y ago
  I'm pretty sure that's the joke.
- christophilus 4y ago
  > Before you get too exshited, may I warn you that the MIT license means I don't have to give a shite if this little shite maker fails to make your shite work. I don’t think they knew that.
- n8henrie 4y ago
andrewmcwatters 4y ago
Hey Aditya, you can make your command a little more unix-y if you feel so compelled by just renaming `shite.sh' to `shite' and run the shell script as a utility since it's already `chmod +x`'d. Then you can `shite(1)` anywhere you want after you put the command in your PATH and feel like a proper `git(1)`. Good `shite(1)` mate. Love it.
- adityaathalye 4y ago
  Thank you for the review! If only you knew of all the glorious plans :,) Apropos your note, may I direct you to "Unrealised Ambitions" in the README https://github.com/adityaathalye/shite#unrealised-ambitions https://github.com/adityaathalye/shite#unrealised-ambitions
  - appletrotter 4y ago
    > Apropos your note, may I direct you to "Unrealised Ambitions" in the README https://github.com/adityaathalye/shite#unrealised-ambitions https://github.com/adityaathalye/shite#unrealised-ambitions It doesn't have to be an unrealized ambition with a simple `mv` command ;)
- adityaathalye 4y ago
  Sidelight: I tend to use functions as Unix tools a lot more than scripts as Unix tools. No need for PATH twiddling, file ownership/permission setting, among other things. I wrote about it here: https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp-part-2-functions-as-unix-tools/index.html#main https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp...
  - freedomben 4y ago
    I do this too! Bash functions are incredible. They have to be the most awesome under-used function (pun intended) I know of
    - adityaathalye 4y ago
alexchantavy 4y ago
I really like the dreams and desires section and how it explains the philosophy and how you view the project
- adityaathalye 4y ago
  Thank you :) I started writing a "Goals" and "Anti-Goals" section, as I almost always do for sizeable projects [^]. But then I thought two things, "that's boring", and "waitaminute... when people say 'goals', what do they really want to achieve or fulfill? Dreams and desires.". And so it came to be. [^] e.g. https://github.com/adityaathalye/clojure-by-example#workshop-goals https://github.com/adityaathalye/clojure-by-example#workshop...
  - alexchantavy 4y ago
    Yeah, and part of defining what tool is is defining what it is not :)
maw 4y ago
Serious(-ish) question: does "And last but not least, I hereby decree that all texsht herein be read in Sean Connery voish." mean that this technically isn't FOSS?
- m_mueller 4y ago
  *FOSSH
chubot 4y ago
Nice! I also use inotifywait for hot reload when writing https://www.oilshell.org/ https://www.oilshell.org/ I never heard of the xdotool method ... although it sounds like it has some drawbacks? https://github.com/adityaathalye/shite/blob/master/bin/hotreload.sh https://github.com/adityaathalye/shite/blob/master/bin/hotre... I do it with a crappy Python web server that dynamically inserts some JavaScript. This also has bugs and drawbacks, though I don't think any fundamental ones ... At some point I would like to "make it nice", but it has been working well in practice for years I think the method is reasonable, and doesn't depend on your local desktop environment as much. I also have a Makefile for incremental rebuilds, but I would really like to replace that with Ninja. Ninja goes pretty well with shell (although it also has the issue of needing to escape $ as $$)
- adityaathalye 4y ago
  Lovely to hear from you, Andy! Thank you for sharing. It's good to know this work is in fine company :) > although it sounds like it has some drawbacks? Oh yes. The Xdotool Reload Method emulates keystrokes, so it has... drawbacks... as you put it mildly :) For my use-case, it literally does F5, or it fills out a url and hits Enter. cf. this `case` statement: https://github.com/adityaathalye/shite/blob/master/bin/hotreload.sh#L114 https://github.com/adityaathalye/shite/blob/master/bin/hotre... I wanted to keep /mandatory/ moving parts to a minimum in a hand-rolled setup. So I sort of went hardline about avoiding prerequisites like a server process, and especially a JS client. The xdotool trick worked surprisingly well (for the most part), and so I stuck with it! > it has been working well in practice for years This is the holy grail. I really hope I get years-long stability out of it. Based on my experience so far, I feel good about the long-term odds. > I also have a Makefile for incremental rebuilds, but I would really like to replace that with Ninja. I was going to write a Makefile at some point. I'll have a look at Ninja. Thanks for the tip!
rlt 4y ago
Nitpick: Generally “hot reloading” refers to reloading a single module or component in the system, while retaining the rest of the page state. But maybe this counts because it’s a static site.
andrewflnr 4y ago
I was curious how the hot-reloading works on the browser side. It looks like it starts its own Firefox window, keeps a reference to it, and somehow directly sends an F5 keypress to it? I don't quite follow how that part works.
- adityaathalye 4y ago
  xdotool emulates user actions under the X Window System (e.g. typing, mouse around, click etc.). I'm using it to send keypresses to the browser, as you rightly observe. So if I want to just reload a page, the browser gets F5. To GOTO some page, it gets a stream of keystrokes for the URL characters and then Enter. It's really that simple-minded, and it works! This case statement covers my usage: https://github.com/adityaathalye/shite/blob/master/bin/hotreload.sh#L114 https://github.com/adityaathalye/shite/blob/master/bin/hotre...
  - andrewflnr 4y ago
    Thanks for the explanation!
rcarr 4y ago
This guy also made a bash ssg, no hot reloading though as far as I’m aware: https://github.com/karlb/karl.berlin https://github.com/karlb/karl.berlin
- adityaathalye 4y ago
  Ooh, I like what they're doing. Thanks for the pointer!
ramrunner0xff 4y ago
amazing mind-link. i have also built a similar program (also called shite) only centered around plan9's rc shell and ndb, to manage my shite ;) (my use case is building a gemini+html output page with date/tag navigation from mostly plain text + minimal markdown in the form of tags and links). https://git.2f30.org/shite/files.html https://git.2f30.org/shite/files.html
- adityaathalye 4y ago
  plan9! Some day I'll try it out. Such a nicely integrated system. As an emacs user, I cracked up at the manpage for Emacs in plan9. Hilarious! > https://git.2f30.org/shite/files.html https://git.2f30.org/shite/files.html So I looked at the templating code. Have you considered here documents for templating? Being able to declare complete HTML fragments is a big advantage for debugging parts, and keeping overall HTML valid. I author HTML fragments in an HTML-mode buffer and get linting etc. to make sure my markup is OK. Then I can just copy-paste it back into the heredoc. Another thing I did was to use functions as wrappers for each HTML fragment, so that I could define guarantees in the scope of the HTML (any variable / field that must be present or must be of a certain type).
  - ramrunner0xff 4y ago
    I haven't really, because the only place where i needed valid html generated mostly by the program is on the navbar , the taglist etc. the main docu is kinda plaintext on a div when rendering html. But i will go back and investigate your idea since it would be elegant and rc supports normal here documents. for example ed $3 <<EOF g/$1/s//$2/g w EOF changes all occurrences of $1 to $2 in file $3. :)
    - adityaathalye 4y ago
      Yeah, I noticed that `ed` invocation in the rc manual. I'm tempted to find use-cases for it. That way I can lay claim to having used the one true editor :) In general, I like making programs out of declarative constructs and/or literal data, because it's so much easier to do "local reasoning" with those things, as compared to imperative procedures, or heaven forefend, live objects.
dickholesalad 4y ago
The name is just… thank you.

141 points by adityaathalye 4y ago

082349872349872 4y ago

One thing I enjoy about shell pipelines is that intermediate processes may terminate them. eg https://www.99-bottles-of-beer.net/language-bourne-shell-1088.html https://www.99-bottles-of-beer.net/language-bourne-shell-108...

adityaathalye 4y ago
In fact, I rely on that sort of early termination / circuit breaking as a feature! That is a big reason why I use functions. They help me define sane fallbacks, and/or enforce API contracts. Those, in turn, are points where I can enforce "fail and die" behaviour. Design notes: https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp-part-2-functions-as-unix-tools/index.html#use-parameter-substitutions-and-local-scope-variables https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp... Example from shite: Hard stop if mandatory front matter for posts is absent: https://github.com/adityaathalye/shite/blob/master/bin/templates.sh#L187 https://github.com/adityaathalye/shite/blob/master/bin/templ... edit: clarity
- 082349872349872 4y ago
  nice ... and the Heredocs are a nice way to template!
  - adityaathalye 4y ago
    Right?! It was a bit of a lightbulb moment. I wanted a way to just write HTML templates. What really sealed the deal was the ability to punch content from stdin anywhere within a heredoc's scope using `$(cat -)`: https://github.com/adityaathalye/shite#templating-system https://github.com/adityaathalye/shite#templating-system

datpiff 4y ago

A+ name, no notes

adityaathalye 4y ago
Heh, thank you. It almost wrote itself. I was trying to cook up a clever tagline, and fell upon "static sites from shell" and my brain looped about and found the tongue twister, sort of like "She sells sea shells on the sea shore", and well all esh shounds shtarted shounding like thish. These days I like that name more because it (hopefully) alerts the Dear Reader about the quality of software they are about to visit, should they take it upon themselves to do so.
deleted 4y ago
[deleted]

jrm4 4y ago

Lol, funny, I dig it. Right here in real life I just do http://zim-wiki.org http://zim-wiki.org + a custom CSS Template + a few shell scripts. http://jrm4.com http://jrm4.com

adityaathalye 4y ago
Thanks :) Likewise, I'm basically locked into "life in plaintext", as a die-hard orgmode user. With what I have on disk, a big positive is any "system" of organisation is opt-in, post-hoc, and fungible. Like, today, shite can be seen as merely one lens into a subset of my org files, to compile that subset into a website. Tomorrow I could bring back hugo. That choice has no bearing on how any other method of organisation might use those same files (e.g. I can pull up index views using orgmode's own query feature set). And further, a single blog posts's org file can power live demos in Emacs (org-babel), and gets exported as a blog post, and as a PDF slide deck, like this: https://www.evalapply.org/posts/why-and-how-i-use-org-mode/index.html#a-pretty-good-example-of-my-usage https://www.evalapply.org/posts/why-and-how-i-use-org-mode/i...

masukomi 4y ago

This is amazing and i love it. As much as I've been enjoying hugo, I've been craving something that's much closer to this.

adityaathalye 4y ago
Haha thank you. I confess, I take childlike delight in every hotreload on save. Had it not worked well enough, I'd have stuck with hugo at the cost of a jankier authoring + build pipeline (org --ox-hugo--> markdown --hugo--> html).

yakshaving_jgt 4y ago

I'm assuming just about everyone is aware of the meaning of the word. https://www.urbandictionary.com/define.php?term=Shite https://www.urbandictionary.com/define.php?term=Shite Kind of depressing that people find this amusing.

adityaathalye 4y ago
This remark prompted me to go rewatch (make sure you have headphones on)... this bit of fry and laurie https://www.youtube.com/watch?v=cVe3fTL1cPM https://www.youtube.com/watch?v=cVe3fTL1cPM this bit by atkinson and cleese https://www.youtube.com/watch?v=OGFz9gt0-Fc https://www.youtube.com/watch?v=OGFz9gt0-Fc and this bit by atkinson alone https://www.youtube.com/watch?v=R7OxTxAvvLw https://www.youtube.com/watch?v=R7OxTxAvvLw made my day :)
badcppdev 4y ago
It's sad because it's not hard to pick a name for a project that isn't a swear word.
- 082349872349872 4y ago
  I once had a gig someplace where the tradition was to name Hamming Distance 1 away from swear words. Best of both worlds?
mrlonglong 4y ago
Oh do one mate quit griping and get with it!
nmeofthestate 4y ago
I suggest a SFW rename to "connery"
- talideon 4y ago
  You might want to look that up in French, but replace the 'y' with 'ie'...
4y ago

jamal-kumar 4y ago

This is really impressive, I tried making my own SSG in shell scripts after looking at all these bloated ways to do it and realizing "this is something I could literally do in ten minutes of bash". It works for my use case but you went WAY further with the concept, good stuff

adityaathalye 4y ago
Thank you! It most assuredly was not "ten minutes of Bash". You see, there comes a time in every self-respecting Yak-shaving programmer’s life when one is driven to render large-scale follicle trimmage unto a sizeable Yak. In my case, ‘twas and ‘tis the deceptively diminutive but in fact mighty Site-Maker-Yak that renders World Wide Web Sites publishable unto the Internet. I wager, engaging oneself in the glorious enterprise of Yak-shaving is at least as therapeutic for the trimmer as it must be to the trimmee. I wholeheartedly recommend it :)
- jamal-kumar 4y ago
  Yeah the live reload is especially impressive, I was literally just slapping content in between a header and footer and getting away with easy clean results hahaha

bashNoIGGERob 4y ago

[dead]

dboreham 4y ago

Y'all know that's a word in Scottish English, right?

jwdunne 4y ago
Northern English dialect too…
- raffraffraff 4y ago
  And Irish
  - walthamstow 4y ago
    London too
    - adityaathalye 4y ago
      A Bit of Fry and Laurie, Concerning Language https://www.youtube.com/watch?v=3MWpHQQ-wQg https://www.youtube.com/watch?v=3MWpHQQ-wQg
      - mrlonglong 4y ago
        And southern too. All shite.
satvikpendem 4y ago
I'm pretty sure that's the joke.
christophilus 4y ago
> Before you get too exshited, may I warn you that the MIT license means I don't have to give a shite if this little shite maker fails to make your shite work. I don’t think they knew that.
n8henrie 4y ago

andrewmcwatters 4y ago

Hey Aditya, you can make your command a little more unix-y if you feel so compelled by just renaming `shite.sh' to `shite' and run the shell script as a utility since it's already `chmod +x`'d. Then you can `shite(1)` anywhere you want after you put the command in your PATH and feel like a proper `git(1)`. Good `shite(1)` mate. Love it.

adityaathalye 4y ago
Thank you for the review! If only you knew of all the glorious plans :,) Apropos your note, may I direct you to "Unrealised Ambitions" in the README https://github.com/adityaathalye/shite#unrealised-ambitions https://github.com/adityaathalye/shite#unrealised-ambitions
- appletrotter 4y ago
  > Apropos your note, may I direct you to "Unrealised Ambitions" in the README https://github.com/adityaathalye/shite#unrealised-ambitions https://github.com/adityaathalye/shite#unrealised-ambitions It doesn't have to be an unrealized ambition with a simple `mv` command ;)
adityaathalye 4y ago
Sidelight: I tend to use functions as Unix tools a lot more than scripts as Unix tools. No need for PATH twiddling, file ownership/permission setting, among other things. I wrote about it here: https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp-part-2-functions-as-unix-tools/index.html#main https://www.evalapply.org/posts/shell-aint-a-bad-place-to-fp...
- freedomben 4y ago
  I do this too! Bash functions are incredible. They have to be the most awesome under-used function (pun intended) I know of
  - adityaathalye 4y ago

alexchantavy 4y ago

I really like the dreams and desires section and how it explains the philosophy and how you view the project

adityaathalye 4y ago
Thank you :) I started writing a "Goals" and "Anti-Goals" section, as I almost always do for sizeable projects [^]. But then I thought two things, "that's boring", and "waitaminute... when people say 'goals', what do they really want to achieve or fulfill? Dreams and desires.". And so it came to be. [^] e.g. https://github.com/adityaathalye/clojure-by-example#workshop-goals https://github.com/adityaathalye/clojure-by-example#workshop...
- alexchantavy 4y ago
  Yeah, and part of defining what tool is is defining what it is not :)

maw 4y ago

Serious(-ish) question: does "And last but not least, I hereby decree that all texsht herein be read in Sean Connery voish." mean that this technically isn't FOSS?

m_mueller 4y ago
*FOSSH

chubot 4y ago

Nice! I also use inotifywait for hot reload when writing https://www.oilshell.org/ https://www.oilshell.org/ I never heard of the xdotool method ... although it sounds like it has some drawbacks? https://github.com/adityaathalye/shite/blob/master/bin/hotreload.sh https://github.com/adityaathalye/shite/blob/master/bin/hotre... I do it with a crappy Python web server that dynamically inserts some JavaScript. This also has bugs and drawbacks, though I don't think any fundamental ones ... At some point I would like to "make it nice", but it has been working well in practice for years I think the method is reasonable, and doesn't depend on your local desktop environment as much. I also have a Makefile for incremental rebuilds, but I would really like to replace that with Ninja. Ninja goes pretty well with shell (although it also has the issue of needing to escape $ as $$)

adityaathalye 4y ago
Lovely to hear from you, Andy! Thank you for sharing. It's good to know this work is in fine company :) > although it sounds like it has some drawbacks? Oh yes. The Xdotool Reload Method emulates keystrokes, so it has... drawbacks... as you put it mildly :) For my use-case, it literally does F5, or it fills out a url and hits Enter. cf. this `case` statement: https://github.com/adityaathalye/shite/blob/master/bin/hotreload.sh#L114 https://github.com/adityaathalye/shite/blob/master/bin/hotre... I wanted to keep /mandatory/ moving parts to a minimum in a hand-rolled setup. So I sort of went hardline about avoiding prerequisites like a server process, and especially a JS client. The xdotool trick worked surprisingly well (for the most part), and so I stuck with it! > it has been working well in practice for years This is the holy grail. I really hope I get years-long stability out of it. Based on my experience so far, I feel good about the long-term odds. > I also have a Makefile for incremental rebuilds, but I would really like to replace that with Ninja. I was going to write a Makefile at some point. I'll have a look at Ninja. Thanks for the tip!

rlt 4y ago

Nitpick: Generally “hot reloading” refers to reloading a single module or component in the system, while retaining the rest of the page state. But maybe this counts because it’s a static site.

andrewflnr 4y ago

I was curious how the hot-reloading works on the browser side. It looks like it starts its own Firefox window, keeps a reference to it, and somehow directly sends an F5 keypress to it? I don't quite follow how that part works.

adityaathalye 4y ago
xdotool emulates user actions under the X Window System (e.g. typing, mouse around, click etc.). I'm using it to send keypresses to the browser, as you rightly observe. So if I want to just reload a page, the browser gets F5. To GOTO some page, it gets a stream of keystrokes for the URL characters and then Enter. It's really that simple-minded, and it works! This case statement covers my usage: https://github.com/adityaathalye/shite/blob/master/bin/hotreload.sh#L114 https://github.com/adityaathalye/shite/blob/master/bin/hotre...
- andrewflnr 4y ago
  Thanks for the explanation!

rcarr 4y ago

This guy also made a bash ssg, no hot reloading though as far as I’m aware: https://github.com/karlb/karl.berlin https://github.com/karlb/karl.berlin

adityaathalye 4y ago
Ooh, I like what they're doing. Thanks for the pointer!

ramrunner0xff 4y ago

amazing mind-link. i have also built a similar program (also called shite) only centered around plan9's rc shell and ndb, to manage my shite ;) (my use case is building a gemini+html output page with date/tag navigation from mostly plain text + minimal markdown in the form of tags and links). https://git.2f30.org/shite/files.html https://git.2f30.org/shite/files.html

adityaathalye 4y ago
plan9! Some day I'll try it out. Such a nicely integrated system. As an emacs user, I cracked up at the manpage for Emacs in plan9. Hilarious! > https://git.2f30.org/shite/files.html https://git.2f30.org/shite/files.html So I looked at the templating code. Have you considered here documents for templating? Being able to declare complete HTML fragments is a big advantage for debugging parts, and keeping overall HTML valid. I author HTML fragments in an HTML-mode buffer and get linting etc. to make sure my markup is OK. Then I can just copy-paste it back into the heredoc. Another thing I did was to use functions as wrappers for each HTML fragment, so that I could define guarantees in the scope of the HTML (any variable / field that must be present or must be of a certain type).
- ramrunner0xff 4y ago
  I haven't really, because the only place where i needed valid html generated mostly by the program is on the navbar , the taglist etc. the main docu is kinda plaintext on a div when rendering html. But i will go back and investigate your idea since it would be elegant and rc supports normal here documents. for example ed $3 <<EOF g/$1/s//$2/g w EOF changes all occurrences of $1 to $2 in file $3. :)
  - adityaathalye 4y ago
    Yeah, I noticed that `ed` invocation in the rc manual. I'm tempted to find use-cases for it. That way I can lay claim to having used the one true editor :) In general, I like making programs out of declarative constructs and/or literal data, because it's so much easier to do "local reasoning" with those things, as compared to imperative procedures, or heaven forefend, live objects.

dickholesalad 4y ago

The name is just… thank you.