Lab Currently Closed Hours: 9am–8pm on Wednesday more »
Jekyll is a popular static website generator.
Set up rbenv:
git clone https://github.com/rbenv/rbenv.git ~/.rbenv echo 'export PATH="~/.rbenv/bin:$PATH"' >> ~/.bash_profile echo 'eval "$(rbenv init -)"' >> ~/.bash_profile source ~/.bash_profile mkdir -p "$(rbenv root)"/plugins git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
Create and enter project directory "Jekyll_project" (can replace "Jekyll_project" with any name you'd like):
mkdir Jekyll_project cd Jekyll_project
Configure ruby via rbenv, then install jekyll:
rbenv install -l | grep -v - | tail -1 | xargs rbenv install rbenv install -l | grep -v - | tail -1 | xargs rbenv local rbenv rehash gem install jekyll bundler
jekyll new .
baseurl field in _config.yml file to '/~username'
Build the site in ~/public_html (run this also to reflect the changes you make):
bundle exec jekyll build -d ~/public_html
Your site should be up at https://www.ocf.berkeley.edu/~username
We've created a default template site of the theme Minima. Let's see how to make it yours:
In the site directory ("Jekyll_project"), there is a subdirectory _posts. Blog posts go there as Markdown files. Please follow the sample post file there to make your own (note the YAML header at the top in between "---"s and the file name format).
Other than blog posts, you can also make pages (about, contact, etc.) that are linked at the top right of the site. An example is the about.md file in the site directory (note the YAML header with layout: page).
In _config.yml in the site directory are global site settings, where you can change the title of the site among others.
Please see Jekyll Docs
Here are some that might be of interest: