您的位置:首页 > 其它

第38篇 如何搭建免费博客

2017-06-01 23:25 387 查看
原文地址:http://blog.laofu.online/2017/05/31/how-use-jekyll/

对于经常写博客的人,都很想拥有一个属于自己的独立博客,但一个独立的博客可能需要以下几个东西:


域名

一个前端的模板

一个后台的管理

一个数据库

部分的统计和其它模块


这样的话,我们的精力可能都了要放到博客的管理上面,而不是博客的内容。 随着github的出现,这样问题出现了改观,使用gitbub提供的github pages功能可以提供一个独立的站点供我们使用。结合相关的域名配置,我们就可以很方便的搭建属于自己的博客平台。

github Pages的使用

概述

对于开发者来说github是很熟悉的,是一个托管代码和开源的网站.如果你想找一个开源的项目,首先看到的可能是一个源码的列表,这样对于项目的展示不够直观,github pages就是为也解决这个问题而出现,允许开发者自定义一个展示页面,来替代原有的代码列表。

具体的规则

在github的项目中,创建一个gh-pages的分支,分支创建完成后就可以使用http://{userName}.github.io/{projectName}来进行访问。更详细参见:github Pages

一个实例

创建一个项目,并对项目进行初始化,运行以下命令

mkdir gitDemo #创建一个目录

cd gitDemo

git init  #git 初始化

git checkout  --orphan gh-pages # 创建gh-pages分支。


  

进行gitDemo文件夹,添加一个html文件,index.html,添加如下内容:

<h1>Hello github Pages!!</h1>


在github上面添加一个Repositories,名为blogTest

把项目推送到分支,执行以下命令:

git add .

git commit -m 'first'

git remote add origin https://github.com/{userName}/blogTest 
git push origin gh-pages


  

      大约等待2min后,访问https://{userName}.github.io/blogTest/index.html,看到如下效果:

      



总结一下

对于上面所述的github Pages(以下称gh-Pages)是github给用户提供一个“静态页面的web服务器”,我们可以根据需要把页面上传到指定的仓库中,可以通过github的规则来完成访问。到这里,不禁有一个疑问,gh-Pages虽然给了一个可以展示html平台,写博客如果全部都写html,那我们还要精力去调整样式和布局的问题.再者博客也要有评论功能,这两个问题如何解决?

jekyll 模板

jekyll 是基于ruby来编写的一个博客模板生成工具,也就是说我们可以根据相关的规则来生成对应的html文件,当然这份工作github也能帮你去做。详细介绍参见jekyll官方文档

jekyll安装

jekyll的安装可以参见

windows安装Jekylllinux和MacOS安装Jekyll

jekyll使用

jekyll 安装是否成功,首先看下jekyll的版本,执行:

jekyll --version




创建jekyll的指定目录

mkdir _posts

mkdir _layout

echo  >>_config.yml


在_layout下创建一个default.html,作为一个网站的模板,添加如下内容(此处代码中的所有的{ {中间都有一个空格,为了不让jekyll去解析,拷贝的时候请注意):

<!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 for Designers

进入_posts创建一个markdown文件或者是html文件,文件名格式必须是:年-月-日-xxxx.md

 ---
  layout: default
  title: Hello Jekyll
  ---
  <h2>{ { page.title } }</h2>
   <h3> Hello jekyll </h3>


创建首页,首页是为了显示文章列表的网页,我们需要做的是遍历_post文件夹中的所有文章,然后展现出来,添加简单的代码如下:

    ---
  layout: default
  title: My 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>


编译和运行,一切都准备好后,开始编译和生成我们的网站:

jekyll build   # 生成_site目录

jekyll server  # 生成并启动一个server,127.0.0.1:4000可以访问本地的目录。


在浏览器中打开127.0.0.1:4000可以看到刚刚生成的网站:





到这里,我们使用jekyll根据我们写的模板生成了对应的静态页面,下面我们把数据传入到github的gh-pages下面。

           

git add .   
git commit -m 'myblog'
git push origin gh-pages


  

等待2min后,github 会根据我们上传的模板把数据生成到对应的分支上面. 开始你的博客之旅!
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: