Bootstrap-4-Jekyll-Theme

Bootstrap-4-Jekyll-Theme

Simple Bootstrap 4 theme for Jekyll

Bootstrap 4 Jekyll Theme

Simple Bootstrap 4 theme for Jekyll

Features

✓ Command-line workflow, using GitHub.com to create, customize and post to your blog
✓ Fully responsive and mobile optimized base theme (Demo or auther's website)
✓ Free hosting on your GitHub Pages user site
✓ Very light weight. It loads very fast even in 2G connections.
✓ Markdown blogging

✘ No installing dependencies
✘ No need to set up local development
✘ No configuring plugins
✘ No need to spend time on theming

Quick start

Step 1) Fork this theme to your user repository

Fork this repository, then rename the repository to your-username.github.io or your favorite name.

Step 2) Enable Github Pages

Go to Settings --> Github Pages --> Source

Choose master branch and enable Github Pages.

Your Jekyll blog will be viewable at http://your-username.github.io or http://your-username.github.io/your-favorite-name.

Step 2) Customize and view your site

Edit site info by editing the _config.yml file. Change baseurl to your repository's name. If it is your-username.github.io then set it empty.

There are 2 different ways that you can make changes to your blog's files:

  1. Edit files within your new repository in the browser at gitHub.com (easiest).
  2. Clone down your repository and make updates locally, then push them to your GitHub repository.

Step 3) Publish your first blog post

Go to /_posts/ and create a markdown file in this format: year-month-day-title.md to publish your first blog post.

Step 4) Necessary manual setup

  • You have to create <new category name>.html with the following content in the category folder when you create a new category.
---
layout: category
title: new category name
category: new-category-name
---

Additional Tips

  • set hideTnPost in post if you want to hide your post thumbnail.
  • set google_analytics in _config.yml if you want to log traffic on your site.
  • embed a youtube video by {% include youtubePlayer.html id="video-id" %}.

Local Development

Install Ruby and Gem

gem install jekyll bundler
bundle install
bundle exec jekyll serve # start development server
  • Note: if you have changed _config.yml, you have to restart the development server

  • Note: When you use baseurl, the home page might not work on your local machine. In that case, just put / at the end and it will work. This problem will not occur on GitHub Pages.

How to import from wordpress

  1. Install "WordPress to Jekyll Exporter"
  2. Tools -> Export to Jekyll
  3. Unzip the exported file and copy _posts, wp-content, and any .md files in the root to your repo.
  4. Copy part of exported _config.yml to _config.yml
cd ./_posts
# replace image links
find . -name '*.md' -print0 | xargs -0 sed -i "" "s/http:\/\/www.yourwebsite.com\/wp-content\/uploads/{{ site.baseurl }}/wp-content/uploads/g"
# replace code pre tags
find . -name '*.md' -print0 | xargs -0 sed -i "" "s/<pre>/<pre><code class=\"bash\">/g"
find . -name '*.md' -print0 | xargs -0 sed -i "" "s/<\/pre>/<\/code><\/pre>/g"