Skip to content

Jekyll - Install & Basics

Install Jekyll

Install requirements with apt-get
1
apt-get install ruby ruby-dev build-essential

Attention !!!

Do not install gems as root user

Login as standard user and modify bash environment

Modify path for ruby gems
1
2
3
4
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME=$HOME/gems' >> ~/.bashrc
echo 'export PATH=$HOME/gems/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
Install Jekyll and dependencies
1
2
3
4
5
6
7
gem install jekyll bundler

# update jekyll or any other gem
gem update jekyll

# update Rubygems
gem update --system

Working with Jekyll

Start new website
1
jekyll new the_blog
Build website
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
jekyll build
# => The current folder will be generated into ./_site

jekyll build --destination <destination>
# => The current folder will be generated into <destination>

jekyll build --source <source> --destination <destination>
# => The <source> folder will be generated into <destination>

jekyll build --watch
# => The current folder will be generated into ./_site,
#    watched for changes, and regenerated automatically.