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.