Windows平台配置Jekyll环境并与GitHub连接


1.安装所需要的软件


2.安装完后生成SSH并导入到Github网站

  • 生成SSH

    Railsinstaller安装(默认安装)完后软件提示输入name 其实是Github的用户名 , 输入完后提示输入邮箱 github注册使用的邮箱

    以上操作完后会在 C:\Users\用户名\.ssh文件夹\下生成密钥与公钥 id_rsa(密钥) 与 id_rsa.pub(公钥)

  • 导入SSH公钥到GigHub网站

    (作用是使用git提交时可以使用 git@github.com:comtu/comtu.github.io.git 的地址,直接 push 数据到github网站,无需要使用Https链接每次push数据输入用户名密码)

    公钥使用文本方式打开复制里面的所有内容(ctrl+A ->ctrl+C 包括空格和新行)–> 登录Gighub网站 –> settings(设置) –> SSH keys –> Add SSH key –> 输入Title(可随便填写,但建议编写有意义的名字) –> 粘贴内容到Key中 –> Add key


3.测试Git连接是否正常

运行Git Bash (开始菜单--> RailsInstaller --> Git Bash) 安装Railsinstaller后会默认在C盘根目录创建一个Sites目录 , 运行的GitBash也会自动定位到Sites目录

  • 测试Git连接是否正常输入:ssh -T git@github.com

运行会提示:
The authent icity of host ‘github.com(204.232.175.90)’ can’t be established .
RSA key fingerprint is ……
Ary you sure you want to continue connecting (yes/no)?

输入
yes

之后会显示
Warning: Permanently added ‘github.com.204.232.175.90’ (RSA) to the list of known hosts .
Permission denied (publickey).


4.修改配置避免jekyll在windows下字符集错误

4.1.修改bash的字符集

Win7系统中(C:\Users\用户名),Xp系统中(C:\Documents and Settings\用户名)下,
找到.bash_profile文件,在其内容里增加如下内容
    set LC_ALL=en_US.UTF-8
    set LANG=en_US.UTF-8
注意:
    在Windows系统下没有办法创建.xxx的文件名,所以可以借用git bash命令行来创建:
    1. 输入 echo 'set LC_ALL=en_US.UTF-8' > .bash_profile 命令创建一个内容为''内容的文件
        comtu@CN-CS-PC73 /C/Sites
        $ echo 'set LC_ALL=en_US.UTF-8' > .bash_profile
    2.文件管理器打开文件目录C:\Sites 将文件.bash_profile使用文本编辑器的方式打开在内容里面
    增加成如下内容保存
        set LC_ALL=en_US.UTF-8
        set LANG=en_US.UTF-8
        还有一个行空行
    3.将.bash_profile文件拷贝到Win7系统中(C:\Users\用户名),
    Xp系统中(C:\Documents and Settings\用户名)下.

4.2.所有文档使用UTF-8无BOM格式

在windows下新建的文本文件默认为ANSI格式,而Jekyll只认UTF-8,可以使用第三方文本编辑器进行格式转换如,
    notepad++中转换
        格式-->转为UTF-8无BOM格式
    EditPlus中转换
        文件-->另存为-->编码(UTF-8)-->选择目录-->保存

4.3.使用Unix换行符

在notepad++中,可以开启“显示所有字符”选项,这样就可以看出文档用的是Windows的换行符还是Unix的换行符。
在这种模式下,Windows的换行符显示的是CR LF,Unix的换行符显示的是LF , MAC 的换行符显示的是CR
    notepad++中转换
        编辑-->档案格式转换-->转换为Unix格式
使用是使用Notepad++文档编辑器则可以在创建的时候就默认为Unix格式
    设置-->首选项-->新建-->格式-->Unix
                   编码-->UTF-8(无BOM)

4.4.注意YAML头部的格式

模板文件的元数据以YAML的格式展现,YAML头部经常会出现三个问题:
    1.三短线前面不能有空格;
    2.“名: 值”对里冒号后面要有空格;
    3.回车后不要有Tab符;
    4.示数组成员开始的-号后面要有空格

5.安装jekyll和相关的包

在国内需要配置gem数据源地址,翻墙或者在国外则无需设置
    输入以下两条命令:
        命令: gem sources --remove http://rubygems.org/
        命令: gem sources -a http://ruby.taobao.org/
    然后用 命令: gem sources -l 看看现在源列表
        *** CURRENT SOURCES ***
        http://ruby.taobao.org
    如果显示如上信息则可以进行安装Jekyll了 
        命令: gem install jekyll
    Jekyll需要用到directory_watcher、liquid、open4、maruku和classifier这几个包,用上面的命令可以自动安装。
    Jekyll默认用maruku来解析markdown语言,你也可以用别的程序来解析,比如rdiscount或kramdown,都给装上吧:
        命令: gem install rdiscount kramdown

    以上命令涉及到gem install的时候,如果你用的是linux系统,就要用sudo gem install代替。
  • 参考资料:

Github Pages极简教程
【译文】用Jekyll构建静态网站 原文Building Static Sites with Jekyll
为 Jekyll 添加多说评论系统
在 Windows 上安装 Jekyll
Jekyll 中的语法高亮:Pygments
Jekyll 扩展的 Liquid 设计 原文Liquid for Designers

热评文章