Welcome to Jekyll!
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())
Links
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:
Launch The Server
With the following installed, launch the server
cd docs
bundle install
bundle exec jekyll serve
Notes for Ubuntu 24
(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
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