使用github搭建网站

ゞ浴缸里的玫瑰 2022-09-21 11:50 175阅读 0赞

http://[blog.csdn.net/pipisorry/article/details/51707366][blog.csdn.net_pipisorry_article_details_51707366]

## 使用github建站    ##

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

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

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

### 使用github建站思路 ###

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

[皮皮blog][Link 2]

# 轻松使用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][Link 2]

# 使用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的设置文件，我们在里面填入如下内容，其他设置都可以用默认选项，具体解释参见[官方网页][Link 3]。

$ 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模板语言][Liquid]，\{ \{ page.title \}\}表示文章标题，\{ \{ content \}\}表示文章内容，更多模板变量请参考[官方文档][Link 4]。

目录结构变成：

> 　　/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变量转化成人类可读的格式。

目录结构变成：

### 第五步，创建首页 ###

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

回到根目录，创建一个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变量。

目录结构变成：

### 第六步，发布内容 ###

现在，这个简单的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_ - Git_] :Git远程仓库ssh设置\]

上传成功之后，等10分钟左右，访问[http://pipilove.github.com/pipi\_ghpages/][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创始人的[示例库][Link 5]，以及其他用Jekyll搭建的[blog][]。

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

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

ref: [https://help.github.com/categories/github-pages-basics/][https_help.github.com_categories_github-pages-basics]

\[[从零开始搭建论坛][Link 6]（1）：Web服务器与Web框架\]

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

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

[blog.csdn.net_pipisorry_article_details_51707366]: http://blog.csdn.net/pipisorry/article/details/51707366
[Pages]: http://pages.github.com/
[Link 1]: https://help.github.com/articles/creating-pages-with-the-automatic-generator
[Jekyll]: http://jekyllrb.com/
[Link 2]: http://blog.csdn.net/pipisorry
[git]: http://git-scm.com/book/en/Getting-Started-Installing-Git
[github]: https://github.com/
[Link 3]: https://github.com/mojombo/jekyll/wiki/Configuration
[Liquid]: https://github.com/shopify/liquid/wiki/liquid-for-designers
[Link 4]: https://github.com/mojombo/jekyll/wiki/Template-Data
[markdown]: http://daringfireball.net/projects/markdown/
[Git_ - Git_]: http://blog.csdn.net/pipisorry/article/details/44671529
[http_pipilove.github.com_pipi_ghpages]: http://pipilove.github.com/pipi_ghpages/
[Link 5]: https://github.com/mojombo/tpw
[blog]: https://github.com/mojombo/jekyll/wiki/Sites
[Blog----github Pages_Jekyll]: http://www.ruanyifeng.com/blog/2012/08/blogging_with_jekyll.html
[https_help.github.com_categories_github-pages-basics]: https://help.github.com/categories/github-pages-basics/
[Link 6]: http://python.jobbole.com/85874/
[http_www.0101520.com_post_2017_03_jekyll-introduction.html]: https://wx.qq.com/cgi-bin/mmwebwx-bin/webwxcheckurl?requrl=http%3A%2F%2Fwww.0101520.com%2Fpost%2F2017%2F03%2Fjekyll-introduction.html&skey=%40crypt_49a55ef0_4c69c2a734e418db5d778dab3045cc0a&deviceid=e469442644899387&pass_ticket=E%252F5g1mVBFbtzr3eLnltBzPJF5KbM2Qvl4zEKgZGmxu5fRJITYydnbtjsEP81c5Fj&opcode=2&scene=1&username=@74a1c37c49dd4fec9a10134dd34499381f51dd3d1bc18e24a22d133a4079269e
[Link 7]: http://www.jianshu.com/p/ef67988ab1d5?utm_campaign=haruki&utm_content=note&utm_medium=reader_share&utm_source=weixin