With the escalation of jekyll version, but I also want to reconstruct my older blog theme, so I did reconstruction and added some features recently. My new blog theme will still be stored in this repository. I will also use this theme in the future. Now I have done basically, then I will focus on issues that users opend to make theme better.
My Blog Url: [blog.ljyslyc.club] (http://blog.ljyslyc.club/). If you like this theme, you can give me a star to encourage me. Welcome everyone to use it.
Index page show 5 posts excerpt as a default. Readers can click article title or read more button to see full post. There are recent posts area, categories area and tags area at the right part of the index page. You can also add an area at this part, if you change the file index.html
.
Archive post according to the year.
Show posts according to the category.
Show posts according to the tags.
The user can collect their favorite article links with markdown
syntax.
I use Masonry to rewrite the waterfall responsive layout. Better interactive experience.
The user can write some introduction about theirselves and their site with markdown
syntax.
This theme supports both disqus and 多说评论 duoshuo comments. It's very easy to config your comments module.
The only thing you need do is to change the short_name
in the file _config.yml
. As follows.
# comments
# two ways to comment, only choose one, and use your own short name
duoshuo_shortname: #xxx
disqus_shortname: xxx
The post contents is fixed at the right side while page is scrolling. There will be a scroll bar on contents while it is outside the window height.
While the jekyll is update to 3.x.x, you can use github flavored markdown to write code.
You can see the white shadow on the current item in the navbar. I call this light shadow.
Of course, I have done a very good mobile adaptation.
This theme supports Google Analytics and Baidu Statistics, you can just config the id in the file _config.yml
, as follows.
# statistic analysis 统计代码
# 百度统计 id,将统计代码替换为自己的百度统计id,即
# hm.src = "//hm.baidu.com/hm.js?xxxxxxxxxxxx";
# xxxxx字符串
baidu_tongji_id: xxxxxxxxxxxx
google_analytics_id: UA-xxxxxxxx # google 分析追踪id
Welcome everyone to use this theme, this part shows introduction to use.
This step and Step 5 mainly talk to you how to launch blog at local. If you don't want to launch at local, you can ignore these 2 steps. But I still strongly suggest to do this. Ensure there is nothing wrong before pushing to the github.
The Windows users can directly use RubyInstaller to install ruby environment. Follow the prompts while installing.
Install jekyll commands:
gem install jekyll
For more details, you can view the jekyll official website. https://jekyllrb.com/
There may be something wrong at mac OS X El Capitan, you can see the solution at https://jekyllrb.com/docs/troubleshooting/#jekyll-amp-mac-os-x-1011.
If you are interesting in jekyll, you can see the jekyll source code at https://github.com/jekyll/jekyll.
You can clone, download or fork this repo.
Mainly change the parameters at file _config.yml
and use your own favicon.ico
.
Shows at site header part.
# Site settings
title: LJY
brief-intro: Front-end Dev Engineer
baseurl: "" # the subpath of your site, e.g. /blog
url: "http://ljyslyc.github.io" # the base hostname & protocol for your site
Mainly shows at the footer of the site.
# other links
twitter_username:
facebook_username:
github_username: ljyslyc
email: ljyslyc@yeah.net
weibo_username: 5561024899
zhihu_username: jia-er-lu-shi-di-yu-pao-xiao-56
linkedIn_username: 刘大哥
dribbble_username:
description_footer: 大学生活的点点滴滴
Get your own short_name
:
Visit https://disqus.com/ or http://duoshuo.com/. And follow the prompts at the site.
# comments
# two ways to comment, only choose one, and use your own short name
duoshuo_shortname: #ljyslyc
disqus_shortname: xxxx
When you done, you can also see the comments info at disqus or duoshuo admin console.
Get Google Analytics id or Baidu Statistics id:
Visit https://www.google.com/analytics/ or http://tongji.baidu.com/. And follow the prompts at the site.
Of course, if you don't want any statistical and analysis info, you can type nothing at id position.
# statistic analysis 统计代码
# 百度统计 id,将统计代码替换为自己的百度统计id,即
# hm.src = "//hm.baidu.com/hm.js?xxxxxxxxxxxx";
# xxxxx字符串
baidu_tongji_id: cf850xxxxxxxxxxxxxxxx
google_analytics_id: UA-7xxxxxx-4 # google 分析追踪id
When you done, you can see UV, PV, location etc. info at your own Google Analytics or Baidu Statistic console.
You can write posts at folder _posts
. At the beginning of the post, you should declare layout、title、date、categories、tags、author(optional) info、mathjax(optional,click here for more detail about Mathjax
).
---
layout: post
title: "对这个 jekyll 博客主题的改版和重构"
date: 2016-03-12 11:40:18 +0800
categories: jekyll
tags: jekyll 端口 markdown Foxit RubyGems HTML CSS
author: Haoyang Gao
mathjax: true
---
These follow code is for making contents.
* content
{:toc}
You can use 4 wraps as a excerpt separator. The words before separator as excerpt show in the index page. When you enter the post page, you can read full article.
The wraps config is in the file _config.yml
, as follows:
# excerpt
excerpt_separator: "\n\n\n\n"
You should use markdown syntax to write article, just like write readme in github.
You can use 3 ``` to write code block.
use command:
jekyll s
Terminal shows:
Configuration file: E:/GitWorkSpace/blog/_config.yml
Source: E:/GitWorkSpace/blog
Destination: E:/GitWorkSpace/blog/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 6.33 seconds.
Please add the following to your Gemfile to avoid polling for changes:
gem 'wdm', '>= 0.1.0' if Gem.win_platform?
Auto-regeneration: enabled for 'E:/GitWorkSpace/blog'
Configuration file: E:/GitWorkSpace/blog/_config.yml
Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.
Visit localhost:4000 to see your blog!!!
If there is nothing wrong, push code to your github!