Posted by : at

Category : jekyll


This guide will help you setup devlopr-jekyll theme in your blog. I have created a starter template for making the process easier.

Step 1. Install the Requirements:

Let’s first set up our development environment, You might need to install the following tools:

  1. Git
  2. Ruby and Bundler
  3. VSCode

We need ruby and bundler to build our site locally. After installation check if its working:

For ruby :

$ ruby -v
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux-gnu]

For bundler :

$ bundler -v
Bundler version 2.0.1

Step 2. Clone the starter template (locally):

For making our blog changes locally, lets clone the devlopr-starter template:

Open a new terminal and copy the command below :

$ git clone https://github.com/sujaykundu777/devlopr-starter.git yourusername.github.io

or Clone manually from the website :

Step 3. Make changes Locally

   $ cd yourusername.github.io
   $ code .

Open the files using VSCode and edit _config.yml and edit with your details:

  • _config.yml file - replace with your own details
  • _posts - Add your blog posts here
  • _includes - You can replace the contents of the files with your data. (contains widgets)
  • _assets/img - Add all your images here

Install the gem dependencies by running the following command

 $ bundle update
 $ bundle install

Serve the site locally by running the following command below:

 $ bundle exec jekyll serve

Visit http://localhost:4000

Once happy with your blog changes. Push your changes to GitHub

 $ git add .
 $ git commit -m "my new blog"
 $ git push origin master

Step 4. Deploy your Blog using any methods below :

There are various ways to deploy your blog. Follow the guide for which you want to deploy your blog with :

  • Deploy your jekyll blog using Github Pages and Travis CI
  • Deploy your jekyll blog using Github Pages and Github Actions
  • Deploy your jekyll blog using Netlify
  • Deploy your jekyll blog using Zeit Now
  • Deploy your jekyll blog using CloudCannon
  • Deploy your jekyll blog using AWS Amplify

Step 5. Connect a CMS to your blog

There are many 3rd party CMS ( Content Management Systems ) available for easy management of your blog. Follow the guide for which CMS you like to use with your Blog :

  • Blogging with Jekyll using Forestry
  • Blogging with Jekyll using Netlify CMS
  • Blogging with Jekyll using Contentful
  • Blogging with Jekyll using Siteleaf
  • Blogging with Jekyll using Storyblock

Step 6. Connect a Domain to your blog

If you want to connect a custom domain for your blog, follow the below tutorials

  • Connect a Custom Domain to your Jekyll Blog (Github Pages)
  • Connect a Custom Domain to your Jekyll Blog (Netlify)
  • Connect a Custom Domain to your Jekyll Blog (Zeit)
  • Connect a Custom Domain to your Jekyll Blog (Cloud Cannon)
  • Connect a Custom Domain to your Jekyll Blog (AWS Amplify)