Hacker News new | past | comments | ask | show | jobs | submit login
Readme in Static Site (RISS) (cj.rs)
30 points by carlesfe on Nov 22, 2021 | hide | past | favorite | 7 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 :)




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: