How to install Jekyll
THE GREAT JEKYLL TUTORIAL - PART I - HOW TO INSTALL JEKYLL
Share this post:
WHAT'S COVERED IN THIS TUTORIAL
WHAT IS JEKYLL?
WHO SHOULD USE JEKYLL.
HOW TO INSTALL JEKYLL.
What is Jekyll?Jekyll is a Doctor who occasionally feels he is battling between the good and evil within himself revealing his alter ego "Hyde"....No? Wrong Jekyll?
Who is Jekyll for?Well as you probably guess Jekyll is tailor made for bloggers. However there are many themes (more on theme’s in the future) that the community have available to suit any needs you would have for a static webpage.
So then who isn’t Jekyll for?>Like stated above Jekyll is a “static site generator” that means that it really is only for static websites. That means if you have a site that has a user base or you are running an e-commerce site; Jekyll isn’t for you.
HOW TO INSTALL JEKYLL
Make sure that you have Ruby installed on your system.
If Ruby isn’t installed then you really can’t be installing Ruby gems, now can you?
If you find you don’t have it installed here is a great tutorial from the source: Install Ruby If you do have it installed go ahead and move on to the next step.
Open up your terminal and type in the following command:
All of Jekyll’s gem dependencies are automatically installed by the above command, so you won’t have to worry about them at all.
So now that Jekyll is on your system, I'm assuming you'll want to make an app and run it.
Below I’ve compiled a list of common command lines you should familiarize yourself with running Jekyll. Keep in mind that if you want to run your website locally you will need to run a server.
$ jekyll new
# => jekyll will create a new web app in the current folder.
# => make sure to add the name of your project directly after "new"
$ jekyll build
# => The current folder will be generated into ./site
$ jekyll build --destination
# => The current folder will be generated into destination
$ jekyll build --source --destination
# => The folder will be generated into destination
$ jekyll build --watch
# => The current folder will be generated into ./site,
# => watched for changes, and regenerated automatically.
$ jekyll serve
# => A development server will run at http://localhost:4000/
# Auto-regeneration: enabled. Use `--no-watch` to disable.
$ jekyll serve --detach
# => Same as `jekyll serve` but will detach from the current terminal.
# If you need to kill the server, you can `kill -9 1234` where "1234" is the PID.
# If you cannot find the PID, then do, `ps aux | grep jekyll` and kill the instance.
$ jekyll serve --no-watch
# => Same as `jekyll serve` but will not watch for changes.