github好多年前,大家都开始玩啦,我这个菜鸟近几年才开始。github不仅可以管理项目,还可以搭建博客。技术人员,一般用的博客为博客园,CSDN多一些。看到朋友们都弄一个,我也开始弄起来,先找点资料看看,然后开始动手了。

      我的电脑是MAC的,其他系统也差不多。先看看我建博客的过程,已经成功了,而且很好用,大家可以看看我的网址https://lu-yuan.github.io .

  (1)首先在github上注册账号,可以使用github,https://github.com/join?source=header-home

这个比较简单,填写用户名,邮箱,密码等就可以了。如果有账号了,我们接着看下面。

  (2)搭建github博客,需要用的东西,github page, jekyll模板。

首先打开https://pages.github.com/,按照步骤一步一步来,

第一步,先建一个项目仓库,名称很重要,要和用户名一致。

 第二步,github客户端下载,超好用的,下载客户端,

客户端装成了,

第三步,创建index.html


<!DOCTYPE html> <html> <body> <h1>Hello World</h1> <p>I\'m hosted with GitHub Pages.</p> </body> </html>

 

第四步,先选中change部分,然后commit, 再然后sync

第五步,提交成功,浏览页面,https://username.github.io   记得username换成你的用户名

 

github pages完成了,接着jekyll模板部分。

jekyll是静态站点生成器。根据网页源码生成静态文件。提供了模板,变量,插件等功能,用来编写整个网站

第一步,创建项目,

在本地先建个文件夹,blog.

 

$ mkdir jekyll_demo

 

对该目录进行git初始化

 

$ cd blog

$ git init

 

然后,创建一个没有父节点的分支gh-pages。因为github规定,只有该分支中的页面,才会生成网页文件。

 

$ git checkout –orphan gh-pages

 

第二步,创建设置文件

在根目录下,创建一个名为_config.yml的文本文件。是jekyll的设置文件,我们在里面填入如下内容,其他设置都可以用默认选项,具体解释参见官方网页

 

baseurl: /blog

 

现在目录结构变成:

 

/blog
    |– _config.yml

 

第三步,创建模板文件,

 

在根目录下,创建一个_layouts目录,用于存放模板文件,

 

$ mkdir _layouts

 

进入该目录,创建一个default.html文件,作为Blog的默认模板。并在该文件中填入以下内容

 

  <!DOCTYPE html>

  <html>

  <head>

    <meta http-equiv=”content-type” content=”text/html; charset=utf-8″ />

    <title>{{ page.title }}</title>

  </head>

  <body>

    {{ content }}

  </body>

  </html>

 

Jekyll使用Liquid模板语言,{{ page.title }}表示文章标题,{{ content }}表示文章内容,更多模板变量请参考官方文档

现在目录变为

 

/blog
    |– _config.yml
    |– _layouts
    |   |– default.html

 

第四步,创建文章

在根目录,创建名为_posts目录,作为blog的文章。

 

$ mkdir _posts

 

进入该目录,创建第一篇文章,名为2017-04-19-hello-world.html

在该文件中,填入如下内容,注意行首不能为空格,

 


layout: default
title: 你好,世界

<h2>{{ page.title }}</h2>

<p>我的第一篇文章</p>

<p>{{ page.date | date_to_string }}</p>

 

每篇文章的头部,必须有一个yaml文件头,用来设置一些元数据。它用三根短划线”—“,标记开始和结束,里面每一行设置一种元数据.

“layout:default”,表示该文章的模板使用_layouts目录下的default.html文件;”title: 你好,世界”,表示该文章的标题是”你好,世界”.

现在目录结构变成:

 

/blog
    |– _config.yml
    |– _layouts
    |   |– default.html 
    |– _posts
    |   |– 2012-08-25-hello-world.html

 

第五步,创建首页

在根目录,创建一个index.html文件,填入以下内容

 

  —
  layout: default
  title: 我的Blog
  —

  <h2>{{ page.title }}</h2>

  <p>最新文章</p>

  <ul>

    {% for post in site.posts %}

      <li>{{ post.date | date_to_string }} <a href=”{{ site.baseurl }}{{ post.url }}”>{{ post.title }}</a></li>

    {% endfor %}

  </ul>

 

现在目录结构变成这样,

 

/blog
    |– _config.yml
    |– _layouts
    |   |– default.html 
    |– _posts
    |   |– 2012-08-25-hello-world.html
    |– index.html

 

第六步,发布内容

这个简单的blog,可以发布了,在github上创建仓库blog

 

  $ git add .

  $ git commit -m “first post”

  $ git remote add origin https://github.com/username/blog.git

  $ git push origin gh-pages

 

note: username换成你的用户名

打开生成的页面,http://username.github.com/blog/

这个时候,发现,很多年前,这样的网址是可以打开的,现在打不开了。现在github只能打开http://username.github.io

所以仓库做了下调整,

blog库下的用来看blog文章,

username.github.io库下的用来放首页,可浏览的URL, 及设置文件baseurl.

项目文件结构:我的目录结构丰富了些,你也可以做的更丰富更好看,红圈为主要内容

现在你可以使用建好的博客了,为了把页面做的更好看,可以加入CSS, IMAGE, JS等

可参考我的库来建博客,http://username.github.io 

版权声明:本文为luyuan原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/luyuan/p/6731877.html