Skip to content

Readme in Static Site (RISS)

cj.rs
30 pointscarlesfe7 comments
On HN

Comments

This is neat. Another option is to just ask GitHub to render your README:

    curl  -H "Accept:application/vnd.github.v3.html"  https://api.github.com/repos/captn3m0/hackertray/readme
If your repo is public, you can do this in the browser as well with a single line of jQuery[0] without any authentication. On my blog, the page itself[1] is just a placeholder for the repo URL, and the layout[2] does the rest. Obviously, this isn't static so all the usual caveats apply (SEO/perf/accessibility).

[0]: https://github.com/captn3m0/captn3m0.github.com/blob/master/...

[1]: https://github.com/captn3m0/captn3m0.github.com/blob/master/...

[2]: https://github.com/captn3m0/captn3m0.github.com/blob/master/...

More on what github does with passed "Accept:" media types here:

https://docs.github.com/en/rest/overview/media-types

Also for a public repo sticherd[0] (Disclaimer: I am the author) can pull the content from github and inject it onto the page server side. Also not static, but has caching and no need for JS.

Soupault or even Hugo can pull remote content as well.

  [0] https://stitcherd.vhodges.dev/ && https://github.com/vhodges/stitcherd

That's an interesting project, I'll add it to the readme of Riss.

Thanks! I haven't had much time to work on it lately but I have a use for it at $DAYJOB so hopefully I can get back to it at some point.

So it is sort of conitional comments [1] in the olden MSIE! A small but good idea, I like how simple riss.awk is.

[1] https://en.wikipedia.org/wiki/Conditional_comment

I never really understood the idea to have a separate README and index page. Glad to see i'm not the only one :)

AboutSource Built by g1lg1l

Hackerly is an independent reader for Hacker News, built on the public HN API. Not affiliated with Y Combinator.