更新文章

我希望在PC 和 MAC端都可以随时写文章,更新博客
而且在推送内容至正式服务器前,我可以预览效果
翻查一下原来Jekyll 系统非常友好,它是基于一个叫Ruby 开发的项目
我们只需要在系统安装好有关的程序包
就能启动一个服务器
通过服务器的编译,我们就可以预览文章效果啦


部署服务器

下面记录一下PC和MAC端的设置方法

PC端

打开Start Command Prompt with Rugy
利用cd 指令跳转到网站在本地的文件夹
现在网站的文件夹在C:\Users\motio\Documents\GitHub\motioneri.github.io
输入一下cd 指令

cd Documents\GitHub\motioneri.github.io

这时候指令会变成

C:\Users\aaaaaa\Documents\GitHub\motioneri.github.io>

我们已经跳转到网站所在的文件夹了
接下来我们需要安装一些套件
输入

bundle install

这句命令是安装一些套件的
过程需要蛮久的,先放着不管去忙别的
我每次都需要等个20分钟左右
完成后会提示安装了一堆套件
然后我们需要激活服务器服务,输入下面的指令

bundle exec jekyll serve

一旦成功,会看到以下提示

Server address: http://127.0.0.1:4000/

Server running... press ctrl-c to stop.

我们可以点击服务器连接进入网站 http://127.0.0.1:4000

正常情况下应该能看到网站了


MAC端

MAC 端也是一样的操作
打开Terminal,输入bundle install
之后Terminal 会开始安装一大堆东西,过程需时,耐心等待完成
之后输入下面指令开始服务器

bundle exec jekyll serve

成功后会显示 服务器地址 http://127.0.0.1:4000

Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.


文章存放位置

_posts

我所使用的Jekyll 模板文章所存放的位置在_posts文件夹

只要在里面储存好markdown格式的文档

服务器会自动将里面的文档编译为静态网页

如果有十个文档,那网站里就有十篇文章


文章格式和命名规范

文档需要为Markdown格式

后缀名为.md

档案命名规范为:YEAR-MONTH-DAY-title.MARKUP

之前没有意识到这个问题,随意命名文档,结果网站怎么都不显示内容

后来花了一整天排查错误,最后发现原来是命名出问题导致系统无法识别已存在文件夹里的文章

教学出处在这里:

https://jekyllrb.com/docs/posts/


可以开始写文章了

文章的排版按照markdown的规范书写即可

最后网站会根据markdown渲染效果

完成了~