Return to homepage
work technology

Jekyll Setup

Steps

  1. Install prerequisites
  2. Install bundler
  3. Install gems
  4. Install local bootstrap
  5. Start local server

Commands

$ sudo apt-get install ruby-full build-essential # ruby install
$ ruby -v
> ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x86_64-linux-gnu]
$ gem -v
> 3.3.15
$ make -v
> GNU Make 4.3
$ sudo gem install jekyll bundler
> Successfully installed bundler-2.5.6
# Change to working directory for local theme
$ bin/bootstrap
> Bundle complete! 1 Gemfile dependency, 32 gems now installed.
$ bin/start
> Configuration file: /home/blake/dev/github/blakejacobus.com/_config.yml
>             Source: /home/blake/dev/github/blakejacobus.com
>        Destination: /home/blake/dev/github/blakejacobus.com/_site
>  Incremental build: disabled. Enable with --incremental
>       Generating... 
>        Jekyll Feed: Generating feed for posts
>                     done in 0.256 seconds.
>  Auto-regeneration: enabled for '/home/blake/dev/github/blakejacobus.com'
>     Server address: http://127.0.0.1:4000
>   Server running... press ctrl-c to stop.

Reference

Troubleshooting

Depending on the OS you install bundler on, you may run into permissions issues when executing the bootstrap script from Moonwalk:

Bundler::PermissionError
There was an error while trying to write to `/var/lib/gems/3.1.0/
It is likely that you need to grant write permissions for that path.
 Built using GitHub Pages, Jekyll, and Moonwalk