Preparation

Now I have time to understand how remote theme works. I’m also on a new environment, GNU/Linux Fedora. From a blank state, install gh(Github utility) and Ruby’s gem:

1
sudo dnf install gh ruby-devel

New Repository

1
gh repo create jpmrblood.github.io --clone --public

Or, go to the GH page, instead, to create the site manually.

Install Jekyll

Check on supported library section. In the time of writing, Jekyll is 3.9.5.

1
gem install jekyll -v 3.9.5

Create Site

Create site:

1
mkdir my_blog && cd my_blog
2
jekyll new --skip-bundle . --force

On Gemfile, remove jekylland minima:

1
gem "jekyll", "~> 3.9.5"
2
gem "minima", "~> 2.0"

Add:

1
gem "jekyll-include-cache", group: :jekyll_plugins
2
gem "github-pages", group: :jekyll_plugins

Change the theme with remote-theme

1
--- _config.yml.bak     2024-06-23 02:22:52.469379746 +0700
2
+++ _config.yml 2024-06-23 02:25:04.042035654 +0700
3
@@ -26,7 +26,8 @@
4

5
 # Build settings
6
 markdown: kramdown
7
-theme: minima
8
+remote_theme: "mmistakes/minimal-mistakes@4.26.2"
9
+minimal_mistakes_skin    : "sunrise"
10
 plugins:
11
   - jekyll-feed

Minimal Mistakes needs these plugins:

1
plugins:
2
  - jekyll-paginate
3
  - jekyll-sitemap
4
  - jekyll-gist
5
  - jekyll-feed
6
  - jemoji
7
  - jekyll-include-cache

Run the installer:

1
bundle install

Next, add Gemfile.lock to GIT ignore:

1
echo "Gemfile.lock" >> .gitignore

After this, I removed index.md and about.md. The posts are in the _posts directory. The rest is to have the configuration like Minimal Mistakes.