首页 如何发布一篇文章
文章
取消

如何发布一篇文章

假如,这个站点又是许久不更新了,突然有一天,想写点什么,那么,就可以按照下面的步骤,发布一篇文章。

直接在 _post 中写

将站点的仓库克隆到本地,然后在本地的仓库_posts目录下,创建一个新的文件,文件名为yyyy-MM-dd-title.md,其中yyyy-MM-dd为当前日期,title为文章标题,中间用-连接。

项目下有一个VSCode用的代码片段,使用new_post自动提示,用于生成文章头部的内容,可以直接使用。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "New post": {
    "scope": "markdown",
    "prefix": "new_post",
    "body": [
      "---",
      "title: ${1:title}",
      "date: $CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE $CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND +0800",
      "categories: [${2:TOP_CATEGORIE}]",
      "tags: [${3:TAG}]     # TAG names should always be lowercase",
      "---"
    ],
    "description": "Create a new post"
  }
}

在文件头部的---之后,就是文章的内容了,可以使用Markdown语法编写。

使用 Jekyll-Compose

该站点已经集成 Jekyll-Compose 插件,可以直接使用该插件来发布文章。
在站点根目录,执行下面命令,安装 Jekyll-Compose 插件。

1
$ bundle

下面的命令,将在 _draft 目录下面新建一个草稿文件,无需在文件名称上添加日期,因为后面在 publish 时,会自动带上日期。

1
$ bundle exec jekyll draft "My new draft"

下面的命令,将启动本地的 Jekyll 服务,可以在本地预览草稿文章的效果

1
$ bundle exec jekyll s --watch --drafts

待草稿编写完成,可以使用下面的命令,将草稿转变为正式文章。该动作,会将草稿文件移动到 _posts 目录下,并且在文件名前面添加日期。同时,正文中也会增加日期信息。

1
$ bundle exec jekyll publish _drafts/my-new-draft.md

如何添加图片

参见:使用 Markdown Image 插件简化 VSCode 插入图片

发布

提交代码后,将自动部署。稍后即可在 https://mikeooye.github.io/ 看到新发布的文章。

参考

本文由作者按照 CC BY 4.0 进行授权

从瓴里离职

Jekyll blog 的评论功能