zengfann / jekyll-blog

🍊 ZengFan Blog

一个关于Jekyll 主题的的个人Blog,采用的是响应式设计，方便记录、管理、分享你的学习知识与生活乐趣。

📖目录

• 功能一览
• 安装
• 使用
• 经验
• 感谢
• 许可认证书

☁️功能一览

• 文章发布
• 文章目录
• 可配置全局主题颜色
• 分享生活记录(在做)
• Disqus评论

安装

Fork Fan_Blog把仓库名称改成USERNAME.github(!一定和你github用户名一致可实现github pages),然后克隆到本地：

$ git clone https://github.com/USERNAME/USERNAME.github.io.git -b master --single-branch

配置本地环境

若在本地构建运行，参考]Jekyll Doc安装Ruby、RubyGem、Bundler MacOS还需要安装GNU coreutils:

• macos

$ brew install coreutils

在文件下打开PowerShell：
进入文件主目录cd USERNAME.github.io,然后下载Jeklly gem install jekyll-paginate

$ Bundl install

bundle会自动下载安装Gemfile中指定的依赖插件

☀️使用

⚠️严格按照下列说明去运行或部署项目

初始化

在项目根目录，开始初始化：

$ jekyll build

配置文件

根据个人需求修改_config.yml文件的变量,典型的选项是：

• url
• comment
• createror

本地运行

$ jekyll serve

访问本地服务: http://localhost:4000
如果想在本地服务运行之后,修改源文件之后及时刷新服务，需要安装依赖fswatch

部署

部署开始前，把 _config.yml 的 url 改为 https://<username>.github.io(或者你的私有域名，如：https://yourdomain.com)。另外，如果你想使用 Project 类型网站，修改配置文件的 baseurl 为项目名称，以斜杠开头，如：/project

部署到Github pages

1. 根据初始修改的USERNAME.github.io仓库名，根据Github指示的地址去访问你的网站
2. 注意每次修改源文件需要$ jekyll build 再推送到github仓库，才可实现网站的刷新服务

部署到阿里云服务器

暂时还未实现

🚢经验

1. Fork 项目仓库的名字必须是你Github的USERNAME
2. 会出现webrick 缺少情况,输入$ bundle add webrick
3. bndle install中Gemfile存在下载缓慢情况(由于:door:的问题)，可以通过开相关代理或者设置TB镜像下载
4. Disqus 相关配置以及网站服务申请参考 Disqus 的坑
5. Disqus 中的 Web site 必须是http://USERNAME.github.io,不可是https
6. Disqus 中还需要将个人网站加入到 Home->Your site->configtion->Advance 加入到Trusted Domains

感谢

🔥本博客是基于Von-Jkeyll与maoyachen的修改,感谢！:heart:

许可认证书

本项目开源，基于MIT 许可。