Repository guidance

Repository guidance

Build and preview

Run Jekyll from the repository root with the repository’s Ruby 3.1.3 environment:

LANG=en_US.UTF-8 \
LC_ALL=en_US.UTF-8 \
PATH=/Users/kevin/.rubies/ruby-3.1.3/bin:$PATH \
GEM_HOME=/Users/kevin/.gem/ruby/3.1.3 \
GEM_PATH=/Users/kevin/.gem/ruby/3.1.3 \
bundle exec jekyll build --destination /tmp/bsr-site

Serve the generated site with:

python3 -m http.server 4002 \
  --bind 127.0.0.1 \
  --directory /tmp/bsr-site

Preview URLs:

  • Homepage: http://127.0.0.1:4002/
  • BSR page: http://127.0.0.1:4002/projects/bsr/

For automatic rebuilding while editing, run:

LANG=en_US.UTF-8 \
LC_ALL=en_US.UTF-8 \
PATH=/Users/kevin/.rubies/ruby-3.1.3/bin:$PATH \
GEM_HOME=/Users/kevin/.gem/ruby/3.1.3 \
GEM_PATH=/Users/kevin/.gem/ruby/3.1.3 \
bundle exec jekyll serve --host 127.0.0.1 --port 4002