Skip to content

Latest commit

 

History

History
executable file
·
73 lines (72 loc) · 2.39 KB

instructions.org

File metadata and controls

executable file
·
73 lines (72 loc) · 2.39 KB

instructions for workin on wurbsite (installing, building, and running locally)

arch

(do NOT use sudo for any ruby!)

apparently, despite Jekyll saying “use ruby 2.7 or higher” does NOT mean it works on ruby 3, which is currently does not (as of 20211006)

from https://bbs.archlinux.org/viewtopic.php?id=265534

sudo pacman -Suy ruby2.7
# do not use gems
cd <WURBSITE>
bundle-2.7 install
bundle-2.7 exec jekyll serve

ubuntu

if starting from scratch, install bundle via `gem install bundler`

also, make sure ‘ruby-dev’ package installed for updating/building

also maybe ‘ruby-pkg-config’ ?

nokogiri-1.8.1 needs package ‘zlib1g-dev’

also need libgdbm-compat-dev for package dbm

packages needed 20240520

from https://jekyllrb.com/docs/installation/ubuntu/

ruby-full
build-essential
zlib1g-dev

from https://askubuntu.com/a/746622

libssl-dev
libreadline-dev
libgdbm-dev

from https://stackoverflow.com/a/9949139

libtool
libyaml-dev

collated <2024-11-18 Mon>

ruby-dev ruby-full build-essential zlib1g-dev libssl-dev libreadline-dev libgdbm-dev libgdbm-compat-dev libtool libyaml-dev

mac

install

brew install rbenv
rbenv install 3.3.6 # or whatever the latest stable is from `rbenv install -l`
rbenv local 3.3.6
rbenv shell 3.3.6 # after running `rbenv init` and adding it to the rc files
brew install node # for academic pages
# then below

update and run

rbenv shell 3.3.6
gem install bundler jekyll
gem update
bundle update
bundle exec jekyll serve

non specific

jekyll howtos

very helpful! http://joshualande.com/jekyll-github-pages-poole/ and https://ncmiller.github.io/2014/08/24/creating-jekyll-blog/ really just searching for jekyll website howtos is awesome

Jekyll or Poole? -specific things

appears you can program hrefs, or anything, that are defined in ‘_config.yml’ e.g. via `<link href=”{{ site.url }}/”/>` or just put {{ site.title }} straight in html

see http://downtothewire.io/2015/08/15/configuring-jekyll-for-user-and-project-github-pages/ for best practices

if reinstalling again, follow https://jekyllrb.com/docs/installation/ubuntu and run

`gem install jekyll bundler`

update regularly with

`gem update` `bundle update`

then serve locally on 4000 with

`bundle exec jekyll serve`