zoukankan      html  css  js  c++  java
  • GitHub Pages 搭建流程-基于jekyll-bootstrap

    GitHub Pages 搭建流程-基于jekyll-bootstrap

     

    我写这篇文章的目的是记录本博客的搭建过程,自己从零开始逐步搭建起来了GitHub Pages,其中借鉴了很多的博客和模版,稍后会在后面列出,也为没有用过gihub和jekyll的童鞋提供一点帮助。

    学习使用github网页的最好办法就是clone别人的代码,看懂他们的代码,并修改成自己喜欢的样子。这篇文章介绍了windows下从最初安装软件到使用的过程。

    下面开始一步步讲解Github Pages的使用流程:

    一、安装git工具

    下载安装 Git for Windows(选择下载类似于 Git-1.7.*-preview.exe 的文件)
    打开安装好的 Git Bash,依次输入:
    git config --global user.name "your username"
    git config --global user.email "username@email.com"

    请确保 name 和 email 信息与在 GitHub 注册时的信息相符。
    紧接着创建一个 SSH Public Keys,输入:
    ssh-keygen -t rsa -C "username@email.com"
    回车后,你会看到类似画面:

    Generating public/private rsa key pair.
    Enter file in which to save the key (/c/Users/Tekkub/.ssh/id_rsa):
    Enter passphrase (empty for no passphrase):
    Enter same passphrase again:
    Your identification has been saved in /c/Users/Tekkub/.ssh/id_rsa.
    Your public key has been saved in /c/Users/Tekkub/.ssh/id_rsa.pub.
    The key fingerprint is:
    e8:ae:60:8f:38:c2:98:1d:6d:84:60:8c:9e:dd:47:81 tekkub@gmail.com
    

    此时,你需要的 SSH Public Keys 就保存在 id_rsa.pub 文件中,找到并打开它,将里面的代码复制到Account Settings 的相应区域。
    后面就轻松多了,因为,除非重装系统或换新机器,你都不必再重复操作以上步骤。

    二、在windows下安装ruby环境

    1). 下载并安装 RubyInstaller for Windows

    版本可以选择2.0或者1.9.3都可以。

    双击安装,安装时选中“Add Ruby executables to your PATH”前的框将ruby添加到环境变量中。

    安装完成后,在 Windows 命令行窗口中执行以下命令,检查ruby是否已经加到PATH中: ruby --version

    2).  安装 DevKit 

    请根据主页上的描述下载对应的DevKit版本,下载后直接解压到没有空格的路径(例如 E:DevKit),然后在Windows的命令行窗口中执行以下命令:

    E: 
    cd E:DevKit 
    ruby dk.rb init 
    ruby dk.rb install
    
    3). 安装Jekyll和相关的包。

    安装完成Ruby和DevKit 后继续安装jekyll,执行如下命令安装:

    gem install jekyll

    等待安装完成即可。

    三、创建git版本库

    登录到自己的Github账户,选择New repository,Project Name命名为:”你的用户名”.github.com,例如我的就叫“lslvxy.github.com”。

    完成后在本地克隆jekyll-bootstrap模版,运行命令:

    git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com

    将jekyll-bootstrap模版克隆到本地USERNAME.github.com文件夹下。

    然后cd到文件夹内运行命令:

    jekyll serve

    成功后打开浏览器输入地址:

    http://localhost:4000 即可浏览本地生成的页面。

    四、关于jekyll-bootstrap模版

    jekyll-bootstrap是一个搭建好的模版框架,里面提供了常用的插件等内容,包括google analytics 、disqus等。使用jekyll-bootstrap可以加快个人博客的搭建。

    类似的模版还有Octopress ,不过Octopress 安装使用较jekyll-bootstrap要麻烦许多,所以我就使用了jekyll-bootstrap。

    jekyll-bootstrap的目录结构分析:

    其中includes文件夹下内容为包含文件,其他页面可以直接引用。包含了常用的页面和主题等,jekyll-bootstrap是支持更更换主题的。

    layouts文件夹内为布局文件,在每个页面的头部都需要指定使用的布局:

    ---
    layout: page
    header : Post Archive
    group: navigation
    ---
    

    ---之前不能包含空格等。

    posts文件夹为自己写的文章,文件格式必须按照“年-月-日-文章名”进行命名。

    _config.yml 文件为必须配置项。

    首页为index.md文件。

    可以根据自己的实际情况进行修改,可以自定义主题和页面布局等。

    五、关于jekyll使用过程中的问题

    jekyll是不支持中文编码的,若需要添加中文的话需要修改部分代码:

    找到ruby的安装目录,比如我本机的地址:D:Ruby200lib ubygems2.0.0gemsjekyll-1.2.1libjekyll

    下的convertible.rb文件,用记事本打开修改第31行代码为:

    self.content = File.read(File.join(base, name), :encoding => "utf-8")

    打开D:Ruby200lib ubygems2.0.0gemsjekyll-1.2.1libjekyll ags目录下的include.rb文件,

    修改第58行代码为:

       source = File.read(File.join(includes_dir, @file), :encoding => "utf-8")

    这样在include模版中也支持中文格式了。

    六、附加插件

    由于gitHub只支持静态页面,所以评论内容需要借助外部插件,可以使用jekyll-bootstrap提供的disqus,disqus是国外最流行的一个评论系统。国内的可以使用多说、友言等。

    代码高亮插件可以使用

    用js插件:DlHightLightGoogle Code Prettify

    gist:强烈推荐菜鸟使用,省心省事,支持语言多

    pygment:要安装python以及python的包管理软件,又是个大坑,不建议菜鸟使用,尤其是使用windows的

    分享插件:国内的jiathis和国外的addthis

    图片:国内的yupoo 、poco,国外的Flickrimgur

    访问量统计可以使用CNZZ

    七、其他内容

    博客想要做的漂亮并且访问量足够的话是需要下很多功夫的,计划着博客中添加Google+,文章搜索等内容现在还没有添加进去,页面效果这些都需要比较扎实的html和css基础。这些就需要靠自己提高了。

    暂时先写这么多吧,以后在慢慢添加,如果有什么问题的话可以Q我活着给我Email都可以的哦!

    最后附上我搭建博客时参照的网站:

    Github Pages极简教程

    使用Github Pages建独立博客

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

    Jekyll QuickStart

    --本篇完--

    宝剑锋从磨砺出,梅花香自苦寒来。

  • 相关阅读:
    filter和listener
    JSP、EL和JSTL
    cookie和session
    xml添加约束和解析
    测试用例设计的原则是什么?目前主要的测试用例设计方法有哪些?
    您是否了解以往所工作的企业的软件开发过程?如果了解,请试述一个完整的开发过程需要完成哪些工作?分别由哪些不同的角色来完成这些工作?您在以往的测试工作中都曾经具体从事过哪些工作?其中最擅长哪部分工作?
    HttpWatch
    URL
    什么是渲染引擎
    一份测试计划应该包括哪些内容?
  • 原文地址:https://www.cnblogs.com/Leo_wl/p/3402935.html
Copyright © 2011-2022 走看看