Minimal Mistakes remote theme starter

Click Use this template button above for the quickest method of getting started with the Minimal Mistakes Jekyll theme.

Contains basic configuration to get you a site with:

• Sample posts.
• Sample top navigation.
• Sample author sidebar with social links.
• Sample footer links.
• Paginated home page.
• Archive pages for posts grouped by year, category, and tag.
• Sample about page.
• Sample 404 page.
• Site wide search.

Replace sample content with your own and configure as necessary.

---

Troubleshooting

If you have a question about using Jekyll, start a discussion on the Jekyll Forum or StackOverflow. Other resources:

• Ruby 101
• Setting up a Jekyll site with GitHub Pages
• Configuring GitHub Metadata to work properly when developing locally and avoid No GitHub API authentication could be found. Some fields may be missing or have incorrect data. warnings.

Usage (Local)

Setup

Install Ruby Version Manager rvm

Install Ruby:

rvm list known #List available ruby versions
rvm install ruby-2.7 #Install latest (change 2.7 with the latest)
rvm --default use ruby-2.7 #Set the installed version as default (change the version)
ruby -v #Check ruby version

RVM BUGFIX ruby 3.0 (check if this has been solved) rvm/rvm#5209 (comment)

rvm pkg install openssl
rvm install ruby --with-openssl-dir=/usr/share/rvm/usr
# or (depending on the installation) --with-openssl-dir=$HOME/.rvm/usr OR --with-openssl-dir=/usr/local/rvm/usr

Install some dependencies

sudo apt-get install build-essential zlib1g-dev

Optional (?) (Not sure if needed)

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs
sudo apt install gcc g++ make
gem update --system
gem -v
gem install jekyll-include-cache

Finally, install Jekyll:

gem install jekyll bundler
gem update #update the gem dep
gem update --system
bundle install

Run

In the project dir:

bundle exec jekyll serve