I am a user of Jekyll 4.2.0 using theme 'just-the-docs" 0.3.3 under Windows 10 (my laptop). The completed website will be hosted in GitHub.com.
I was trying to write a procedure for me and my colleagues could create a Jekyll site with just-the-docs from scratch with no errors in the bundle update.
I edited my Gemfile.lock file and made changed the rouge entry (the main one, not a subordinate one) to this value:
rouge (>= 1.7, < 4)
Why? I thought I was being helpful - let it decide which version it likes. I had read on a website that I now forget that the rouge version might have been an issue for me.
Unfortunately, when I ran âbundle updateâ I got this error message:
âYour lockfile is unreadable. Run ârm Gemfile.lockâ and then âbundle installâ to generate a new lockfile.â
The file Gemfile.lock of course was still perfectly readable.
It took me many hours, but I finally worked out this error message really means âSyntax errorâ or something like that.
I changed the entry in my Gemfile.lock file to this:
rouge (~> 3.0)
Suddenly, the Gemfile.lock is readable and the bundle update worked fine. I decided that rouge was not an issue for me, and it had all been unnecessary.
My reason for raising this issue is to ask - could someone change this error message so it says âSyntax error in Gemfile.lock - line xxxâ? Is this a sensible question to ask (say at the Jekyll repo on GitHub.com)? I want to check here first in case this is a known problem.
The error wording I suggested would be much more helpful and would have saved me many hours of time.