Review pkp-docs README local preview instructions #1074
Comments
|
Hi @amandafrench, sorry for the hassle. To be honest, I'm not that familiar with ruby so I always have trouble debugging bundle issues like this. It looks like the error message you are getting is because a dependency is not compatible with Ruby 3.2: The proper fix would be to correct the dependencies, but I'm hesitant to tinker with this until we have a proper resource to manage the docs hub. That's because a) it's not a tech stack our team very familiar with and b) @AhemNason is the only one on the team that builds the docs hub for production and I don't want to make a change that forces him into hours of debugging his system. In my experience, the version of Ruby that's being used seems to make a big difference. In the past I've used rvm to jump between Ruby versions. Here's the version I'm running now: $ ruby -v
ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x86_64-linux-gnu]I also noticed that I have local changes in my diff --git a/Gemfile b/Gemfile
index 4609b002e..e67f0d866 100644
--- a/Gemfile
+++ b/Gemfile
@@ -8,3 +8,5 @@ group :jekyll_plugins do
gem 'jekyll-readme-index'
gem 'jekyll-sitemap'
end
+
+gem "webrick", "~> 1.7"
diff --git a/Gemfile.lock b/Gemfile.lock
index b62839875..df37c7a80 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -68,6 +68,7 @@ GEM
terminal-table (1.8.0)
unicode-display_width (~> 1.1, >= 1.1.1)
unicode-display_width (1.8.0)
+ webrick (1.7.0)
PLATFORMS
ruby
@@ -80,6 +81,7 @@ DEPENDENCIES
jekyll-seo-tag
jekyll-sitemap
jekyll-titles-from-headings
+ webrick (~> 1.7)
BUNDLED WITH
2.1.4No idea why these are necessary (or why Mike doesn't need them to build). Hope that helps a little bit. |
|
That helps a lot, @NateWr! I'll give that a try. And if it doesn't work I'll probably just resign myself to using the existing preview of the docs site or maybe finally installing the GitHub desktop client instead of doing everything from the Terminal. |
The README on this repository gives instructions for setting up a local docs preview, but I haven't been able to get it to work, possibly just because I am not sure of the localhost address for the preview. The Usage section reads
I've installed Ruby, bundler, and Jekyll. The messages I get when I run
bundle exec jekyll serveare as follows. Could be that I shouldn't have installed Ruby on my M1 Mac using homebrew?The text was updated successfully, but these errors were encountered: