csci-1301 / csci-1301.github.io

CSCI 1301: Principles of Computer Programming I course resources
https://csci-1301.github.io/
Creative Commons Attribution 4.0 International
3 stars 14 forks source link

Improve web design #164

Open aubertc opened 5 months ago

aubertc commented 5 months ago

There is a lot to do to improve the navigability of this site.

This may need to separate the .md files differently, but should not prevent the user from downloading all the resources as a single document.

aubertc commented 5 months ago

We should probably look at existing solutions for our CMS.

Options include:

and we can have a look at https://github.com/b-long/awesome-static-hosting-and-cms and https://whatcms.org/Technologies/Static-Site-Generator

I can work with pretty much anything, but it must have:

and it should have:

jweeks2023 commented 5 months ago

I can't find the specific website Mark suggested, but the concept was primarily based on Digital Gardens. Here is an example of such.

aubertc commented 5 months ago

^ I have no idea what this website uses (and neither does https://whatcms.org/?s=notes.nikolamilekic.com%2FWelcome%21 )

jweeks2023 commented 5 months ago

I believe it's some obsidian hosting thing (maybe Obsidian Publish), which would be a complete swap from GitHub Pages. I'd treat the previous link as more inspiration if anything. I will continue my search and hopefully report back with more results!

jweeks2023 commented 5 months ago

New resource Mark found: https://quartz.jzhao.xyz/ Looks very promising and very pretty.

aubertc commented 5 months ago

This looks amazing. A missing feature (as far as I can tell) is "integrate source code from source file", but it's not critical. Other than that it looks perfect. I'll probably play with it a bit but I think we (well, @Marknoodle actually) found a perfect solution.