Ch3nyang's blog

home

home

person

about

hive

project

collections_bookmark

mindclip

rss_feed

rss

jekyll

calendar_month 2019-12
archive 工具
tag jekyll tag blog

本文记录了jekyll 博客安装过程。

jekyll安装

jekyll是一个基于ruby的系统,为了使用jekyll,我们首先去官网下载ruby。官网上称“If you don’t know what version to install and you’re getting started with Ruby, we recommend that you use the Ruby+Devkit 2.7.X (x64) installer”,因为如果下载的是ruby3,会因为标准库的删减在后续过程中产生问题。下载完后正常安装,中途会有一些提示,请一路回车无视它们。

我们检验是否安装成功:命令行中输入ruby -vgem -v,若均正确显示了版本,则安装成功。

然后我们命令行输入

gem install jekyll

稍等片刻即可安装完成。

通常来讲我们使用git工具实现博客内容上传,如果你还没有git,请在它的官网下载并安装,本文不再赘述。

我们检验是否安装成功:右键git bash here,输入jekyll -v,若正确显示了版本,则安装成功。

接着我们新建一个博客模板并启动它:在你希望存放博客的目录下git bash here

jekyll new blog
cd blog
jekyll s
  • 这里的blog可以替换为你想要的名字

如果在启动服务时发现了大红色的Dependency Error报错提示,请按照它的提示安装缺少的gem。命令格式为

gem install 名字

如果提示缺少webrick组件,那是因为错误安装了ruby3版本,请卸载后重新安装2.7.x版本。

如果报错 /Ruby27-x64/lib/ruby/2.7.0/bundler/runtime.rb:312:in check_for_activated_spec!': You have already activated i18n 1.8.10, but your Gemfile requires i18n 1.8.9. Prepending bundle exec to your command may solve this. (Gem::LoadError),则执行命令

bundle update

如果成功运行,你在浏览器访问http://127.0.0.1:4000/就可以看到初始化界面了。

后续修改时,我们可以直接

jekyll s

进行预览。

jekyll 主题安装

jekyll拥有众多主题,你可以在这里或者这里挑选一个,如果不满意,也可以在GitHub上fork,实在不行手写一个也不是不可以。调完后下载,复制到你的博客文件夹里即可。

博客上传

你应当首先学会使用 git。

如果你是第一次上传,你需要按照如下步骤:

git checkout --orphan gh-pages
git add .
git commit -a -m "[版本名称]"
git remote add origin https://github.com/[用户名]/[用户名].github.io.git
git push origin gh-pages

同时,修改你的 GitHub pages 设置为

jekyll1

访问网址就可以看到博客了。

后续修改时,只需要

git add .
git commit -a -m "[注释]"
git push origin gh-pages

Comments

Share This Post