如何建立一个与本站版式相似的个人站:二、发布博文 木灵的炼金工作室

本站博文均需以UTF-8编码保存。注意,是UTF-8而不是UTF-8 with BOM

博文一般使用直观的Markdown语法编写,网络上全是教程,比较简单。

此处建议使用支持编码转换的VSCode编辑博文。

在编写完成之后,将博文以YYYY-MM-DD-NAME.md的名称保存并推送至远程库,待网页自动部署之后(Github需约1分钟)博文即更新。

YAML文件头

每一条/_posts中的文件均有一个YAML文件头,常用的是以下几条配置:

---
layout: post # 整个.md文件的渲染模式,在远程主题中(见之后的章节)定义,见下述
title: # 博文标题
tags: # 博文标签,可使用YAML数组或用逗号分隔的字符串
  - tag 1
  - tag 2
permalink: # 永久链接,为博文赋予一个不随其文件名改变的链接
published: true # 是一个bool值,为假则博文不在站点中显示
date: # 时间,格式是YYYY-MM-DD,会覆盖文件名中的设置
---

其中,title是一定要有的。

layout主要定义了如下的几种输出模式:

  • archive 时间线页面配置
  • comments 留言页配置
  • compress 压缩插件要求的顶层输出格式,不直接使用
  • default 带CSS样式的纯文本,用来派生其他模式
  • document 纯文本
  • home reveal.js渲染页
  • merge 打赏页面配置
  • page 具有完整主题样式的页面,与博文页面类似但是无评论区和“首部行”
  • page404 404页配置
  • post 博文页面配置,默认项
  • tags 标签页面配置

一般我们只会用到

  • home
  • page
  • post [例:本页面]

一般地,比如本文,YAML头是如下填写的:

---
title: 如何建立一个与本站版式相似的个人站:二、发布博文
tags: 
  - 个人网站搭建
---


Copyright AmachiInori 2017-2021. All Right Reserved.
Powered By Jekyll.
amachi.com.cn