zwz-team.github.io: An HTML repository from ZWZTeam

Start

启动

npm run watch

说明文档

开始
各组成部分
评论与 Google/Baidu Analytics
- 评论
- 网站分析
高级部分

配置

你可以通用修改 _config.yml文件来轻松的开始搭建自己的博客: Jekyll官方网站还有很多的参数可以调，比如设置文章的链接形式...网址在这里：Jekyll - Official Site 中文版的在这里：Jekyll中文修改_config.yml

# Site settings
title:  Blog             # 你的博客网站标题
SEOTitle:  Blog			# 在后面会详细谈到
description: "Cool Blog"    # 随便说点，描述一下

# SNS settings      
github_username: xx     # 你的github账号
weibo_username: xx      # 你的微博账号，底部链接会自动更新的。

# Build settings
# paginate: 10              # 一页你准备放几篇文章

write-posts

要发表的文章一般以markdown的格式放在这里_posts/ 生成blog模板命令：

rake post title="Hello 2015" subtitle="Hello World, Hello Blog"

yaml 头文件长这样:

---
layout:     post
title:      "Hello 2015"
subtitle:   "Hello World, Hello Blog"
date:       2015-01-29 12:00:00
author:     "xx"
header-img: "img/post-bg-2015.jpg"
tags:
    - Life
---

SideBar

长这样:

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

# Sidebar settings
sidebar: true  #添加侧边栏
sidebar-about-description: "简单的描述一下你自己"
sidebar-avatar: /img/avatar-.jpg     #你的大头贴，请使用绝对地址.

侧边栏是响应式布局的，当屏幕尺寸小于992px的时候，侧边栏就会移动到底部。具体请见bootstrap栅格系统 <//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: A tag will be featured if the size of it is more than this condition value. （也不知道是想表达什么意思，请作者解答）

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

Friends

好友链接部分。这会在全部页面显示。

设置是在 _config.yml文件里面的Friends那块，自己加吧。

# Friends
friends: [
    {
        title: "Foo Blog",
        href: "//foo.github.io/"
    },
    {
        title: "Bar Blog",
        href: "//bar.github.io"
    }
]

Keynote Layout

HTML5幻灯片的排版：

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

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

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

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

Analytics

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

# Baidu Analytics
ba_track_id: 4cc1f2d8f3067386cc5cdb626a202900

# Google Analytics
ga_track_id: 'UA-49627206-1'            # Format: UA-xxxxxx-xx
ga_domain: huangxuan.me

致谢

这个模板是从这里IronSummitMedia/startbootstrap-clean-blog-jekyll forked 的。感谢这个作者
感谢@BrucZhaoR的中文翻译
感谢 Jekyll、Github Pages 和 Bootstrap!

zwz-team/zwz-team.github.io