nber1994



如何基于github pages搭建blog

December 6, 2017

胡乱的记载了如何在github-pages搭建bolg

什么是github-pages

github推出pages服务时是如下所说:

GitHub Pages allow you to publish web content to a github.com subdomain named after your username. With Pages, publishing web content becomes as easy as pushing to your GitHub repository. If you create a repository named you.github.com, where you is your username, and push content to it, we’ll automatically publish that to http://you.github.com. No FTP, no scp, no rsync, nothing. Just a simple git push and you’re done. You can put anything here you like. Use it as a customizable home for your Git repos. Create a blog and spread your ideas. Whatever you want!

准备工作

挑选主题

挑选好之后,git clone 到本地,并添加远程仓库为你的XXX.github.io

jekll 框架的目录结构

-rw-r--r--@  1 jingtianyou  staff   104B  9 18 07:47 404.html
-rw-r--r--@  1 jingtianyou  staff   1.0K  9 18 07:47 LICENSE
-rw-r--r--@  1 jingtianyou  staff   375B  9 18 07:47 README.md
-rw-r--r--   1 jingtianyou  staff   365B 12  7 18:32 _config.yml
drwxr-xr-x@  3 jingtianyou  staff   102B 12  7 17:53 _data
drwxr-xr-x@  4 jingtianyou  staff   136B 12  7 20:12 _includes
drwxr-xr-x@  5 jingtianyou  staff   170B 12  7 18:16 _layouts
drwxr-xr-x@ 15 jingtianyou  staff   510B 12  7 20:42 _posts
drwxr-xr-x@  4 jingtianyou  staff   136B 12  7 18:45 _sass
drwxr-xr-x  12 jingtianyou  staff   408B 12  7 20:31 _site
drwxrwxrwx@  6 jingtianyou  staff   204B 12  7 18:45 assets
-rw-r--r--@  1 jingtianyou  staff   219B  9 18 07:47 index.html
drwxr-xr-x@  3 jingtianyou  staff   102B 12  7 18:45 me
drwxr-xr-x@  6 jingtianyou  staff   204B  9 18 07:47 categories

404.html

404页面,同样你可以使用一些公益404页面,例如腾讯404.

__config.yml

框架的配置文件,不同的框架的配置文件一般不一样,具体请参考框架文档

__includes

一般存储页眉页脚的格式html,可进行客制化的定制

__posts

你的博文都存放在这个目录下,命名方式为

2017-12-08-文章名.md

文章的开头一般是这样的,声明布局,标题,日期,tag等等,框架一般会自动帮你分类

---
title: InnoDB各类语句的加锁方式与应用
date: 2017-12-06
tags:
- mysql
tags: 
- lnmp
---
...
...

__site

jekll运行后,会将你的文字翻译成html文件,存到该目录下

assets

前端静态文件

安装本地jekll

jekll其实就是一个markdown ==> html 的翻译器,将你的markdown翻译成html

安装:

$ gem install jekyll
~ $ jekyll new my-awesome-site
~ $ cd my-awesome-site
~/my-awesome-site $ jekyll serve
# => Now browse to http://localhost:4000
 jingtianyou@jingtianyoudeMacBook-Air  ~/github/windows-95-master   master  jekyll server --future
Configuration file: /Users/jingtianyou/github/windows-95-master/_config.yml
            Source: /Users/jingtianyou/github/windows-95-master
       Destination: /Users/jingtianyou/github/windows-95-master/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
                    done in 0.868 seconds.
 Auto-regeneration: enabled for '/Users/jingtianyou/github/windows-95-master'
    Server address: http://127.0.0.1:4000//
  Server running... press ctrl-c to stop.
      Regenerating: 1 file(s) changed at 2017-12-07 20:27:57 ...done in 0.390267 seconds.
[2017-12-07 20:31:24] ERROR `/tag/lnmp/' not found.
      Regenerating: 1 file(s) changed at 2017-12-07 20:31:47 ...done in 0.328509 seconds.
[2017-12-07 20:31:53] ERROR `/20171207/如何基于github-pages搭建博客' not found.
[2017-12-07 20:31:55] ERROR `/tag/lnmp/' not found.
[2017-12-07 20:32:06] ERROR `/tag/lnmp/' not found.
      Regenerating: 1 file(s) changed at 2017-12-07 20:32:42 ...done in 0.408106 seconds.
[2017-12-07 20:32:44] ERROR `/tag/lnmp/' not found.
[2017-12-07 20:32:48] ERROR `/tag/lnmp/' not found.
      Regenerating: 1 file(s) changed at 2017-12-07 20:33:04 ...done in 0.546599 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:34:24 ...done in 0.41305 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:34:46 ...done in 0.285784 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:42:02 ...done in 0.353415 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:46:13 ...done in 0.333329 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:46:19 ...done in 0.293639 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:47:56 ...done in 0.314423 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:52:00 ...done in 0.335078 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:52:30 ...done in 0.429857 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:52:51 ...done in 0.287992 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:54:28 ...done in 0.330737 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 20:56:08 ...done in 0.328462 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 21:00:29 ...done in 0.342248 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 21:02:59 ...done in 0.343119 seconds.
      Regenerating: 1 file(s) changed at 2017-12-07 21:03:15 ...done in 0.27084 seconds.

tips:

Have Fun!