petermllrr / portfolio

My portfolio on GitHub Pages

Portfolio

My portfolio on GitHub Pages.

Installing and Running

Follow the official Jekyll documentation for the installation procedure.

Note 1: Homebrew's gem path is different than mentioned in the documentation:

Docs (wrong): $HOME/.gem/ruby/X.X.0/bin:$PATH

Actual: $HOME/.local/share/gem/ruby/3.0.0/bin:$PATH

Note 2: When working with Jekyll and having a Ruby version > 3.0.0, you need to require the gem webrick for starting Jekyll's server. This is only mentioned here briefly at the bottom: Jekyll Quickstart.

Note 3: Sometimes bundle update won't work because the gemfile.lock defines that an older version of bundler that was used in this repo previously. The easiest way to resolve this is to delete the gemfile.lock and run bundle install again to install the latest versions of all gems.

Keeping gems up to date

Regulary check if a new GitHub pages gem is available at GitHub pages: Dependency versions and update the line in the _config.yml accordingly. Run bundle install to install the new version.

Useful commands

After closing the repo, install all gems first:

bundle install

To update all gems, run:

bundle update

Serve your site on your localhost

bundle exec jekyll serve

Build the site. You will find the output in the _site directory:

bundle exec jekyll build

If you set a baseurl in the config file, serve your site locally without baseurl messing up your links:

bundle exec jekyll serve --baseurl ''

Libraries used

• Static site generator: Jekyll
• Configuration: GitHub Pages Gem
• HTML/CSS framework: HTML5 Boilerplate
• Iconfont: Fontello
• Masonry layout helper: Masonry
• Image preloader: Images Loaded