search

jkosem / jk-portfolio

The portfolio of design, research and strategy for Jim Kosem.
https://jkosem.github.io/jk-portfolio/
MIT License
2 stars 0 forks source link

readme

README

This portfolio site is a work in progress. Hopefully you should gather that. It's all open source, so mind the license and give credit, although in this case maybe not much is deserved, where it's due.

Dependencies

Ruby 2.6 and above (to get this version working at any rate)

Jekyll 4.1 and above

All the hosting is done on the Github page. Link over up there on the right with the URL.

How to use

  1. Have everything installed like above, namely Ruby and Jekyll
  2. Make sure there's not an update that already isn't installed by Ruby on Mac that is supposed to fix the errors that would otherwise get
  3. Need to build jekyll build to release
  4. Can also, whilst developing, use jekyll serve --livereload which will upon saving, reload the file in browser at http://localhost:4000/
  5. Need to git add ., git commit -m <message> and git push to get it to GitHub to get it to be available at URL
  6. Check deployments at https://github.com/jkosem/jk-portfolio/deployment
  7. If you screw around with both the gem files and/or trying to go back to old versions, and end up getting tons of Ruby errors and that, it's a lot of times easier to just start a new Jekyll project and copy things into it. This can be done either by jekyll <project> new which does the minimal base install with the Minima theme, or jekyll <project> new --blank which creates the extensive folders which is more or less complete.

Links, reference, etc.

A lot of the things here worked

This page was also helpful

This tutorial was probably the easiest to follow

Navigation

Issues with directories and CSS not showing up properly

This guy has a good post on How to Make a Jekyll Site/Blog

I nicked a lot of things on how to do posts from here.

I'm rubbish at doing menus properly from memory, so the classic float menu at W3C

This tutorial on How to Set up GoDaddy Domain with GitHub Pages worked like a charm. It took a bit (2 hours?) for the HTTPS to update, but once that was done it was cool.

This page showed how to sort out the SSH keys thing fairly easily.