Posts

This post is in the _posts directory.

Edit and rebuild the side to see changes with bundle exec jekyll serve which launches a web server and auto-regenerates your site when a file is updated.

New Posts

To add new posts, add a file in the _posts directory that follows the convention YYYY-MM-DD-name-of-post.md and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.

Code Snippets

function f(): string {
    return "hello";
}

console.log(f())

Info on how to get the most out of Jekyll on Jekyll docs.

File all bugs/feature requests at Jekyll’s GitHub repo.

Ask questions on Jekyll Talk.

This is the base Jekyll theme. You can find out more info about customizing your Jekyll theme, as well as basic Jekyll usage documentation at jekyllrb.com

You can find the source code for Minima at GitHub: jekyll / minima

You can find the source code for Jekyll at GitHub: jekyll / jekyll

GitHub Setups

GitHub Software Installed on docs runner

Local Testing

Check Ubuntu version

lsb_release -a

On Windows:

Using WSL2 with Ubuntu 24

Launch The Server

With the following installed, launch the server

cd docs

bundle install

bundle exec jekyll serve

Notes for Ubuntu 24

Install WSL

(On Windows 11, open Powershell as administrator and run wsl --install)

Get Ubuntu 24.04 LTS from the Microsoft Store.

Ubuntu 24 comes with ruby 3.

Install ruby

gpg --keyserver keyserver.ubuntu.com --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB \curl -sSL https://get.rvm.io | bash -s stable

rvm install "ruby-3.3.5"

rvm list known

rvm use ruby-3.3.5

Check Versions

ruby -v

gem -v

gcc -v

g++ -v

make -v

Install jekyll

Install Jekyll on Ubuntu

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

gem install jekyll bundler