julianolf / jekyll-theme-8bit

👾 A Jekyll theme inspired by classic 8bit games.
https://julianolf.github.io/jekyll-theme-8bit/
MIT License
33 stars 15 forks source link

Missing kramdown-parser-gfm #28

Open mroberts1 opened 1 year ago

mroberts1 commented 1 year ago

Local install fails due to missing gem kramdown-parser-gfm, even after installing the gem. Kramdown 2.4.0 is also installed.

Tried with 3 versions of Ruby: 2.7.8, 3.1.4, 3.2.2.

julianolf commented 1 year ago

Hi @mroberts1.

It seems I've missed a couple of notifications from this repo, probably my fault, I might have accidentally marked as read. For this I apologize.

Could you please provide a few more details about the issue you are facing? For example the version of Bundler you are using, the commands you are running and the output error messages. This would really help.

It could be something in your system too. Have you tried to install it using a container to separate your system from the running environment?

To make sure it doesn't works only on my machine I did this (requires Docker installed):

Cloning into 'jekyll-theme-8bit'... remote: Enumerating objects: 313, done. remote: Counting objects: 100% (21/21), done. remote: Compressing objects: 100% (15/15), done. remote: Total 313 (delta 8), reused 13 (delta 4), pack-reused 292 Receiving objects: 100% (313/313), 127.11 KiB | 1.87 MiB/s, done. Resolving deltas: 100% (153/153), done.

* Moved inside the directory and tried to install the dependencies.
```sh
cd jekyll-theme-8bit/

bundle install

Fetching gem metadata from https://rubygems.org/..........
Resolving dependencies...
Could not find compatible versions

Because the current Bundler version (2.4.10) does not satisfy bundler ~> 2.2.0
  and Gemfile depends on bundler ~> 2.2.0,
  version solving has failed.

Your bundle requires a different version of Bundler than the one you're running.
Install the necessary version with `gem install bundler:2.2.34` and rerun bundler using `bundle _2.2.34_ install`

Fetching bundler-2.2.34.gem Successfully installed bundler-2.2.34 1 gem installed

A new release of RubyGems is available: 3.4.10 → 3.4.17! Run gem update --system 3.4.17 to update your installation.

Fetching gem metadata from https://rubygems.org/.......... Resolving dependencies....

* Then I run the server.
```sh
bundle _2.2.34_ exec jekyll serve --host 0.0.0.0

Configuration file: /app/jekyll-theme-8bit/_config.yml
            Source: /app/jekyll-theme-8bit
       Destination: /app/jekyll-theme-8bit/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
                    done in 0.383 seconds.
 Auto-regeneration: enabled for '/app/jekyll-theme-8bit'
    Server address: http://0.0.0.0:4000
  Server running... press ctrl-c to stop.

After this I could check it was working by heading to http://127.0.0.1:4000 on my web browser.

julianolf commented 1 year ago

@mroberts1 I might have been able to reproduce the error you mentioned.

After updating both Ruby and Bundler to the latest versions I also updated all dependencies and tried to run Jekyll's local server and that was when I got an error:

Dependency Error: Yikes! It looks like you don't have kramdown-parser-gfm or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. The full error message from Ruby is: 'cannot load such file -- kramdown-parser-gfm' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/!
  Conversion error: Jekyll::Converters::Markdown encountered an error while converting '_posts/2019-01-23-a-post.md':
                    kramdown-parser-gfm
             ERROR: YOUR SITE COULD NOT BE BUILT:
                    ------------------------------------
                    kramdown-parser-gfm

With some research on Internet I found an issue on Jekyll's GitHub page telling that its development server has this dependency when running on Ruby > 3.0, and the solution just required to add that gem to the Gemfile.

On my next attempt to run the server I got a new error, another required dependency, webrick, once again added to Gemfile.

This changes fixed the problem for me, maybe they will do the same for you.

I pushed those changes and I'll be publishing a new version of the theme, if you try it and still have issues let me known.