使用github搭建网站

http://blog.csdn.net/pipisorry/article/details/51707366

使用github建站

github设计了Pages功能,允许用户自定义项目首页,用来替代默认的源码列表。所以,github Pages可以被认为是用户编写的、托管在github上的静态网页。github提供模板,允许站内生成网页,但也允许用户自己编写网页,然后上传。有意思的是,这种上传并不是单纯的上传,而是会经过Jekyll程序的再处理。

Jekyll(发音/'dʒiːk əl/,"杰克尔")是一个静态站点生成器,它会根据网页源码生成静态文件。它提供了模板、变量、插件等功能,所以实际上可以用来编写整个网站。

和传统的个人博客系统不同,传统的个人博客只能提供博文的发表、评论等等,而在Github上面建站,就好比一幅油画的白纸,很纯净,很自由,人们可以自定义上面的内容,尽情挥洒自己的创意。

使用github建站思路

先在本地编写符合Jekyll规范的网站源码,然后上传到github,由github生成并托管整个网站。
这种做法的好处是:
* 免费,无限流量。
* 享受git的版本管理功能,不用担心文章遗失。
* 你只要用自己喜欢的编辑器写文章就可以了,其他事情一概不用操心,都由github处理。
它的缺点是:
* 有一定技术门槛,你必须要懂一点git和网页开发。
* 它生成的是静态网页,添加动态功能必须使用外部服务,比如评论功能就只能用disqus。
* 它不适合大型网站,因为没有用到数据库,每运行一次都必须遍历全部的文本文件,网站越大,生成时间越长。

皮皮blog



轻松使用github.io搭建个人网站

{绝对是最简单的建站方式,一个用户只能创建一个}

安装了git,并且有github账户。

创建一个新库,名称必须为:username.github.io。#username是你的github用户名。

创建好之后,将其Clone到本地。

在Clone出来的本地目录下建立一个index.html,保存,上传。

打开浏览器,在地址栏处输入你的username.github.io。就可以看到刚刚上传的html网页了。

修改indel.html文件后有时需要好久才能看到效果。

Note: index.html中是可以调用javascript和css文件的。

皮皮blog



使用github建站

{github建站方式2}

安装了git,并且有github账户。

第一步,创建项目

在你的电脑上,建立一个目录,作为项目的主目录。我们假定,它的名称为pipi_ghpages。

  $ mkdir pipi_ghpages

对该目录进行git初始化。

  $ cd pipi_ghpages

  $ git init

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

  $ git checkout --orphan gh-pages

以下所有动作,都在该分支下完成。

第二步,创建设置文件

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

$ vi _config.yml

  baseurl: /pipi_ghpages

目录结构变成:

  /pipi_ghpages

    |-- _config.yml

第三步,创建模板文件

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

  $ mkdir _layouts

           cd !$

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

$ vi default.html

<!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 }}表示文章内容,更多模板变量请参考官方文档

目录结构变成:

  /pipi_ghpages
    |-- _config.yml
    |-- _layouts
    |   |-- default.html

第四步,创建文章

回到项目根目录,创建一个_posts目录,用于存放blog文章。

        $ cd ..

  $ mkdir _posts

        $ cd !$

进入该目录,创建第一篇文章。文章就是普通的文本文件,文件名假定为2016-06-18-hello-world.html。(注意,文件名必须为"年-月-日-文章标题.后缀名"的格式。如果网页代码采用html格式,后缀名为html;如果采用markdown格式,后缀名为md。)

在该文件中,填入以下内容:(注意,行首不能有空格)

$ vi 2016-06-18-hello-world.html

---
layout: default
title: 你好,世界
---
<h2>{{ page.title }}</h2>
<p>我的第一篇文章</p>
<p>{{ page.date | date_to_string }}</p>

yaml文件头:每篇文章的头部,必须有一个yaml文件头,用来设置一些元数据。它用三根短划线"---",标记开始和结束,里面每一行设置一种元数据。三根短划线前面,是不能有空格的!如果你用windows,必须确认保存文件的时候不带BOM。

"layout:default",表示该文章的模板使用_layouts目录下的default.html文件;

"title: 你好,世界",表示该文章的标题是"你好,世界",如果不设置这个值,默认使用嵌入文件名的标题,即"hello world"。

在yaml文件头后面,就是文章的正式内容,里面可以使用模板变量。{{ page.title }}就是文件头中设置的"你好,世界",{{ page.date }}则是嵌入文件名的日期(也可以在文件头重新定义date变量),"| date_to_string"表示将page.date变量转化成人类可读的格式。

目录结构变成:

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

第五步,创建首页

有了文章以后,还需要有一个首页。

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

$ cd ..

$ vi 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>

它的Yaml文件头表示,首页使用default模板,标题为"我的Blog"。然后,首页使用了{% for post in site.posts %},表示对所有帖子进行一个遍历。这里要注意的是,Liquid模板语言规定,输出内容使用两层大括号,单纯的命令使用一层大括号。至于{{site.baseurl}}就是_config.yml中设置的baseurl变量。

目录结构变成:

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

第六步,发布内容

现在,这个简单的Blog就可以发布了。先把所有内容加入本地git库。

$ git add .

$ git commit -m "first post"

然后,前往github网站创建一个名为pipi_ghpages的库。接着,再将本地内容推送到github上你刚创建的库。注意,下面命令中的username,要替换成你的username。

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

$ git push origin gh-pages

Note: 要想git push成功,至少要先配置一下github。[Git版本控制教程 - Git远程仓库 :Git远程仓库ssh设置]

上传成功之后,等10分钟左右,访问http://pipilove.github.com/pipi_ghpages/就可以看到Blog已经生成了(将username换成你的用户名)。

第七步,绑定域名(optional)

如果你不想用http://username.github.com/pipi_ghpages/这个域名,可以换成自己的域名。

具体方法是在repo的根目录下面,新建一个名为CNAME的文本文件,里面写入你要绑定的域名,比如example.com或者xxx.example.com。

如果绑定的是顶级域名,则DNS要新建一条A记录,指向204.232.175.78。如果绑定的是二级域名,则DNS要新建一条CNAME记录,指向username.github.com(请将username换成你的用户名)。此外,别忘了将_config.yml文件中的baseurl改成根目录"/"。

至此,最简单的Blog就算搭建完成了。进一步的完善,请参考Jekyll创始人的示例库,以及其他用Jekyll搭建的blog

[搭建一个免费的,无限流量的Blog----github Pages和Jekyll入门]

from: http://blog.csdn.net/pipisorry/article/details/51707366

ref: https://help.github.com/categories/github-pages-basics/

[从零开始搭建论坛(1):Web服务器与Web框架]

[http://www.0101520.com/post/2017/03/jekyll-introduction.html]

用github + hexo + next主题建了一个新网站[我将会换一个平台写技术类文章]


  • 4
    点赞
  • 25
    收藏
    觉得还不错? 一键收藏
  • 3
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值