美文网首页程序员工具癖
Github Page 搭建 jekyll 博客

Github Page 搭建 jekyll 博客

作者: 05b0963bb480 | 来源:发表于2018-12-02 07:58 被阅读8次

    申请Github帐号

    点击进入Github,点击 sign up for github 就可以了

    利用gitpage 搭建静态网站

    先进入你的github主页,这里你可以查看和管理你的所有项目


    项目首页项目首页

    点击绿色New按钮,新建一个与你的github用户名相同的 项目,如agmgh.github.io的项目即可。如下图所示,xxx修改为你自己的github用户名。

    新建项目新建项目

    点击 Create repository ,你自己的站点就创建好了。(https://yourgitname.github.io)然后是下载github的客户端windows下 mac下(linux用命令行工具就不介绍了,略多不直观),安 装好后不同平台会有不同,但是基本的还是一样的.

    Windows Git客户端Windows Git客户端

    将刚刚创建好的github.io项目,clone 到本地就可以了。

    本地配置 jekyll

    安装ruby环境

    window 下这里下载ruby,安装好后顺手把rails一起安了吧~

    安装完成后记得设置环境变量, 具体就是把安装好的ruby位置放到环境变量里去。

    win+R 调出运行,然后输入cmd 呼出terminal,敲入gem install rails等待安装完成吧~~

    命令行输入gem install bundler等待安装完,

    命令行输入gem install jekyll等待安装完,

    接下来下载我的模板 到你clone下来 的地址,记得解压,你该看到大约是这样

    agmgh.github.ioagmgh.github.io

    其中文件夹agmgh.github.io位置应该是你的项目位置

    令行输入cd XXXXX XXXX是你的项目位置,

    命令行输入bundle install

    会自动给你安装GEMfile中提到的几个库

    这样jekyll环境就算搭建好了

    运行jekyll

    配置_config

    根据我的模板主页的readme文档设置

    注意,本地试运行先把 production_url 改为http:\localhost:4000


    博客首页博客首页
    运行jekyll

    命令行依然cd到你的项目目录,输入jekyll build,运行完了后再输入jekyll serve。 tips:没事terminal不要关。

    浏览器里输入地址http:\localhost:4000你就能看到博客主页了 (不过这个时候搜索功能无法使用)!

    可能会遇到的问题汇总

    安装github客户端时,如果网络状况不佳,可能无法通过clickone 安装github Windows 客户端,建议从网上搜索别人做好的离线安装包。

    安装ruby后,如果没有替换为 淘宝源时,会出现无法安装jekyll的情况。

    切换淘宝源:

    删除默认的官方源

    gem sources -r https://rubygems.org/

    添加淘宝源

    gem sources -a https://ruby.taobao.org/

    查看当前源

    gem sources -l # https://ruby.taobao.org

    安装我的模板时,需要安装以下模块:

    gem install jekyll-seo-tag

    gem install jekyll-feed

    gem install jekyll-sitemap

    执行gem install bundler 时出现ssl 证书验证错误。

    点击下载cacert.pem ,将文件放在C盘根目录下

    set SSL_CERT_FILE=C:\cacert.pem

    相关文章

      网友评论

        本文标题:Github Page 搭建 jekyll 博客

        本文链接:https://www.haomeiwen.com/subject/mhalcqtx.html