👨🏻‍💻曦息地 🔎📝->
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_includes
_layouts
_posts
css
fonts
img
js
less
pwa
.gitignore
.travis.yml
404.html
CNAME
Gruntfile.js
LICENSE
README.md
_config.yml
about.html
codecov.yml
feed.xml
index.html
offline.html
package.json
sw.js
tags.html

README.md


Build Status codebeat badge GitHub issues License MIT

使用 Jekyll 搭建个人博客详细操作

环境

如果你安装了 jekyll,那你只需要在命令行输入jekyll servejekyll s就能在本地浏览器中输入http://127.0.0.1:4000/预览主题,对主题的修改也能实时展示(需要清理浏览器的本地缓存)�。

开始

你可以通用修改 _config.yml文件来轻松的开始搭建自己的博客:

# Site settings
title: Young Area                    # 你的博客网站标题
SEOTitle: 水水的博客 | 曦息地		# SEO 标题
description: "This is my blog"	   	   # 随便说点,描述一下

# SNS settings      
github_username: yousanflics     # 你的github账号

# Build settings
# paginate: 10              # 一页你准备放的文章数目

Jekyll官方网站还有很多的参数可以调,比如设置文章的链接形式等网址在这里:Jekyll - Official Site 中文官网在这里:Jekyll中文.

撰写博文

要发表的文章一般以 Markdown 的格式放在这里_posts/,你只要看看这篇模板里的文章你就立刻明白该如何设置。

yaml 头文件长这样:

---
layout:     post
title:      博客迁移
subtitle:   "HelloWorld,Again"       #记得使用引号
date:       2018-09-20
author:     Yousanflics
header-img: img/post-bg-rwd.jpg
catalog: 	 true
tags:
    - 生活
    - 个人博客
---

侧边栏

设置是在 _config.yml文件里面的Sidebar settings那块。

# Sidebar settings
sidebar: true  #添加侧边栏
sidebar-about-description: "简单的描述一下你自己"
sidebar-avatar: /img/avatar-by.jpg     #你的个人头像,请使用绝对地址.注意:名字区分大小写!后缀名也是

侧边栏是响应式布局的,当屏幕尺寸小于992px的时候,侧边栏就会移动到底部。具体请见bootstrap栅格系统 http://v3.bootcss.com/css/

Mini About Me

Mini-About-Me 这个模块将在你的头像下面,展示你所有的社交账号。这个也是响应式布局,当屏幕变小时候,会将其移动到页面底部,只不过会稍微有点小变化,具体请看代码。

Featured Tags

看到 Medium 上的推荐标签非常的炫酷,所以我将他加了进来。 这个模块现在是独立的,可以呈现在所有页面,包括主页和发表的每一篇文章标题的头上。

# Featured Tags
featured-tags: true  
featured-condition-size: 1     # A tag will be featured if the size of it is more than this condition value

唯一需要注意的是featured-condition-size: 如果一个标签的 SIZE,也就是使用该标签的文章数大于上面设定的条件值,这个标签就会在首页上被推荐。

内部有一个条件模板 {% if tag[1].size > {{site.featured-condition-size}} %} 是用来做筛选过滤的.

Social-media Account

在下面输入的社交账号,没有的添加的不会显示在侧边框中。

# SNS settings
RSS: false
zhihu_username:     username
facebook_username:  username
github_username:    username
# weibo_username:   username

Friends

友链会在所有页面显示。

设置是在 _config.yml 文件里面的 Friends 那块,自己 DIY 就行。

# Friends
friends: [
    {
        title: "�冰霜",
        href: "https://github.com/halfrost/Halfrost-Field"
    },
    {
        title: "Apple",
        href: "https://www.apple.com/"
    }
]

Keynote Layout

HTML5幻灯片的排版:

这部分是用于占用html格式的幻灯片的,一般用到的是 Reveal.js, Impress.js, Slides, Prezi 等等.我认为一个现代化的博客怎么能少了放 html 幻灯的功能呢~

其主要原理是添加一个 iframe,在里面加入外部链接。你可以直接写到头文件里面去,详情请见下面的 yaml 头文件的写法。

---
layout:     keynote
iframe:     "http://huangxuan.me/js-module-7day/"
---

iframe在不同的设备中,将会自动的调整大小。保留内边距是为了让手机用户可以向下滑动,以及添加更多的内容。

Comment

博客仅支持 Gitalk 评论系统,支持 Markdwon 语法,cool~

Gitalk

优点:界面干净简洁,利用 Github issue API 做的评论插件,使用 Github 帐号进行登录和评论,支持 Markdown 语法,十分方便技术�人员之间的相互交流。

缺点:配置比较繁琐,每篇文章的评论都需要初始化。

使用:

可以参考左神的这篇文章:自动初始化 Gitalk 和 Gitment 评论

Analytics

网站分析,现在支持百度统计和Google Analytics。需要去官方网站注册一下,然后将返回的code贴在下面:

# Baidu Analytics
ba_track_id: 4cc1f2d8f3067386cc5cdb626a202900

# Google Analytics
ga_track_id: 'UA-49627206-1'            # 你用Google账号去注册一个就会给你一个这样的id
ga_domain: huangxuan.me			# 默认的是 auto, 这里我是自定义了的域名,你如果没有自己的域名,需要改成auto。

Customization

如果你喜欢折腾,你可以去自定义这个模板的 Code。

如果你可以理解 _include/_layouts/文件夹下的代码(这里是整个界面布局的地方),你就可以使用 Jekyll 使用的模版引擎 Liquid的语法直接修改/添加代码,来进行更有创意的自定义界面啦!

Header Image

博客每页的标题底图是可以自己选的,看看几篇示例post你就知道如何设置了。

标题底图的选取完全是看个人的审美了。每一篇文章可以有不同的底图,你想放什么就放什么,最后宽度要够,大小不要太大,否则加载慢啊。

上传的图片最好先压缩,这里推荐 imageOptim 图片压缩软件,让你的博客起飞。

但是需要注意的是本模板的标题是白色的,所以背景色要设置为灰色或者黑色,总之深色系就对了。当然你还可以自定义修改字体颜色,总之,用github pages就是可以完全的个性定制自己的博客。

SEO Title

我的博客标题是 “Young Area” 但是我想要在搜索的时候显示 “水水的博客 | 曦息地” ,这个就需要 SEO Title 来定义了。

其实这个 SEO Title 就是定义了<title>标题</title>这个里面的东西和多说分享的标题,你可以自行修改的。

关于收到"Page Build Warning"的 Email

由于jekyll升级到3.0.x,对原来的 pygments 代码高亮不再支持,现只支持一种-rouge,所以你需要在 _config.yml文件中修改highlighter: rouge.另外还需要在_config.yml文件中加上gems: [jekyll-paginate].

同时,你需要更新你的本地 jekyll 环境.

使用jekyll server的同学需要这样:

  1. gem update jekyll # 更新jekyll
  2. gem update github-pages #更新依赖的包

使用bundle exec jekyll server的同学在更新 jekyll 后,需要输入bundle update来更新依赖的包.

Note: 可以使用 jekyll -s 命令在本地实时配置博客,提高效率。详见 Jekyll.com

参考文档:using jekyll with pages & Upgrading from 2.x to 3.x

致谢

  1. 该模板 Fork 自 Hux 这里, 感谢该作者。
  2. 感谢 Jekyll、Github Pages 和 Bootstrap!
  3. 博客的搭建参考了 BY 的教程,十分感谢!

License

遵循 MIT 许可证。有关详细,请参阅 LICENSE