This guide provides instructions for setting up your development environment using rbenv to manage Ruby versions, specifically for the Rubycon project.
Before you begin, ensure you have rbenv installed. If not, you can follow the official rbenv installation guide: https://github.com/rbenv/rbenv#installation
-
Install Ruby 3.4.5: The Rubycon project requires Ruby version
3.4.5. Userbenvto install it:rbenv install 3.4.5
If you encounter issues, ensure your
rbenvenvironment is correctly set up and that you have necessary build tools (likeopenssl,readline, etc.) installed via Homebrew or your system's package manager. -
Set Local Ruby Version: Navigate to the project's root directory (
/Users/ricc/git/rubycon.it) and set Ruby 3.4.5 as the local version for this project. This will create or update the.ruby-versionfile in the project root.rbenv local 3.4.5 -
Rehash rbenv: After installing a new Ruby version or installing gems with executables, you need to rehash
rbenvto ensure it picks up the new executables:rbenv rehash
-
Install Bundler: Bundler is used to manage the project's Ruby gem dependencies. Install it if you haven't already for this specific Ruby version:
gem install bundler
-
Install Project Dependencies: Finally, install all the gems required by the Rubycon project. Make sure you are in the project's root directory when running this command:
bundle install --gemfile=rubycon.it/Gemfile
This command tells Bundler to look for the
Gemfileinside therubycon.it/subdirectory.
Once all dependencies are installed, you can run the Jekyll server locally using the just command:
just run-local-p4002Then, open your browser to http://localhost:4002 (or the specific page you want to view, e.g., http://localhost:4002/2025/11/14/marco-roth.html).