4 ms·
Readme in Static Site (RISS)
- lifthrasiir 5y agoSo 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 https://en.wikipedia.org/wiki/Conditional_comment
- southerntofu 5y agoI never really understood the idea to have a separate README and index page. Glad to see i'm not the only one :)
- captn3m0 5y agoThis 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/js/github.js https://github.com/captn3m0/captn3m0.github.com/blob/master/... [1]: https://github.com/captn3m0/captn3m0.github.com/blob/master/projects/hackertray.md https://github.com/captn3m0/captn3m0.github.com/blob/master/... [2]: https://github.com/captn3m0/captn3m0.github.com/blob/master/_layouts/repo.html https://github.com/captn3m0/captn3m0.github.com/blob/master/...
- tyingq 5y agoMore on what github does with passed "Accept:" media types here: https://docs.github.com/en/rest/overview/media-types https://docs.github.com/en/rest/overview/media-types
- vhodges 5y agoAlso 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