Skip to content

Commit

Permalink
blog: simplify Jekyll installation instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
César Román committed Oct 25, 2021
1 parent b313770 commit 29e0cb8
Showing 1 changed file with 20 additions and 33 deletions.
53 changes: 20 additions & 33 deletions _posts/2020-08-31-welcome.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ layout: post
title: Welcome
subtitle: Or getting started with Jekyll and GitHub Pages (August 2020 Edition)
tags: [github, github-pages, guide, jekyll, macos, vscode]
last-updated: 2020-11-07 21:50 -0800
last-updated: 2021-10-25 14:56 -0700
---
In the past, I've delved in the blogging universe using Blogger, Tumblr, and even WordPress, but after a while, I fell disenchanted with what they offered.

Expand Down Expand Up @@ -75,33 +75,33 @@ Just follow these steps:
1. Check your rbenv installation

```bash
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/HEAD/bin/rbenv-doctor | bash
```

### Installing a ruby version and setting a global version with rbenv

1. List stable versions
1. If you wish to list stable versions, use the `--list` option, or `--list-all` and pipe the results to `grep` to search for a particular version

```bash
$ rbenv install --list
2.5.8
2.6.6
$ rbenv install --list-all | grep "2\.7\."
2.7.0-dev
2.7.0-preview1
2.7.0-preview2
2.7.0-preview3
2.7.0-rc1
2.7.0-rc2
2.7.0
2.7.1
2.7.2
jruby-9.2.13.0
maglev-1.0.0
mruby-2.1.2
rbx-5.0
truffleruby-20.2.0
truffleruby+graalvm-20.2.0
Only latest stable releases for each Ruby implementation are shown.
Use 'rbenv install --list-all' to show all local versions.
2.7.3
2.7.4
jruby-9.2.7.0
```

1. Install your desired version.
1. Install the latest compatible version with GitHub Pages

```bash
rbenv install 2.7.2
rbenv install 2.7.3
```

1. Once installed, list all versions
Expand All @@ -113,7 +113,7 @@ Just follow these steps:
1. Select your desired version

```bash
rbenv global 2.7.2
rbenv global 2.7.3
rbenv rehash
```

Expand All @@ -123,23 +123,10 @@ And you're all set!
After installing Xcode and Ruby, let's go straight to installing Jekyll.

{: .box-note}
As of this writing, the latest version for Jekyll is 4.1.1, which is not yet supported by GitHub Pages (check [here](https://pages.github.com/versions/){:target="_blank"} for up-to-date dependencies), that's why we specify version `3.9.0`.
To Install Jekyll we need to run the following commands:
```bash
gem install bundler
gem install jekyll -v 3.9.0
```
To verify, run the following commands:
To install everything you need, and be compliant with `gem` versions used by GitHub Pages (found [here](https://pages.github.com/versions/){:target="_blank"}), simply run the following command:

```bash
$ which jekyll
/Users/thecesrom/.rbenv/shims/jekyll
$ bundle exec jekyll --version
jekyll 3.9.0
gem install github-pages
```

Now that we're ready, let's find a theme!
Expand Down

0 comments on commit 29e0cb8

Please sign in to comment.