这是小苏写的第一个博客,写的不好见谅哈,有问题可以留言呦,小苏会第一时间进行修改😄
前言
毕竟是第一篇博客,需要先介绍一下该如何在Hexo个人静态博客中使用MarkDown来编写,有哪些注意事项,方便在之后写博客的时候有个参考,也希望能够给新博主一些帮助!
本篇使用的Typora编写的MarkDown,Hexo的主题是Matery,其实不同的主题都是基于Hexo,相差不是很大。
1.了解文章存放的位置
说明:之后文章中提到的主目录都是你搭建个人博客的目录,如我的为blog目录
系统生成的文章和你的文章都会存放在主目录source文件夹下的**_posts**中,此处是我的存放目录: E:\blog\source\_posts
说明:
- 将来文章会有很多,可以在_post目录下创建多级文件夹,系统是自动识别,便于分类
2. 创建文章
2.1方法一:使用命令创建
在主目录下右键,选择Git Bash Here进入命令行,输入
hexo n 你的文章名
之后,_post目录下就会出现你的文件名.md文件,在文件中书写保存即可
好处:Hexo会帮助你一些配置,名为Front-matter,在后面会提到
2.2方法二:将md文件复制粘贴
直接将写到的md文件复制粘贴到_post文件夹中即可
3.文章的配置Front-matter
当我们使用命令创建md文章,Hexo会帮助我们生成一些配置信息(Front-matter):
---
title: typora-vue-theme主题介绍
date: 2018-09-07 09:25:00
---
复制粘贴插入配置信息的方法:右键文章的空白处,插入,YAML Front-matter
3.1Front-matter配置详情信息
这些主要是关于这篇文章的配置,这些所有的配置都是非必填项,不过最好将title和date值填写上,以下是关于配置的详情介绍:
配置选项 | 默认值 | 描述 |
---|---|---|
title | Markdown 的文件标题 |
文章标题,强烈建议填写此选项 |
date | 文件创建时的日期时间 | 发布时间,强烈建议填写此选项,且最好保证全局唯一 |
author | 根 _config.yml 中的 author |
文章作者 |
img | featureImages 中的某个值 |
文章特征图,推荐使用图床(腾讯云、七牛云、又拍云等)来做图片的路径.如: http://xxx.com/xxx.jpg |
top | true |
推荐文章(文章是否置顶),如果 top 值为 true ,则会作为首页推荐文章 |
cover | false |
v1.0.2 版本新增,表示该文章是否需要加入到首页轮播封面中 |
coverImg | 无 | v1.0.2 版本新增,表示该文章在首页轮播封面需要显示的图片路径,如果没有,则默认使用文章的特色图片 |
password | 无 | 文章阅读密码,如果要对文章设置阅读验证密码的话,就可以设置 password 的值,该值必须是用 SHA256 加密后的密码,防止被他人识破。前提是在主题的 config.yml 中激活了 verifyPassword 选项 |
toc | true |
是否开启 TOC,可以针对某篇文章单独关闭 TOC 的功能。前提是在主题的 config.yml 中激活了 toc 选项 |
mathjax | false |
是否开启数学公式支持 ,本文章是否开启 mathjax ,且需要在主题的 _config.yml 文件中也需要开启才行 |
summary | 无 | 文章摘要,自定义的文章摘要内容,如果这个属性有值,文章卡片摘要就显示这段文字,否则程序会自动截取文章的部分内容作为摘要 |
categories | 无 | 文章分类,本主题的分类表示宏观上大的分类,只建议一篇文章一个分类 |
tags | 无 | 文章标签,一篇文章可以多个标签 |
keywords | 文章标题 | 文章关键字,SEO 时需要 |
reprintPolicy | cc_by | 文章转载规则, 可以是 cc_by, cc_by_nd, cc_by_sa, cc_by_nc, cc_by_nc_nd, cc_by_nc_sa, cc0, noreprint 或 pay 中的一个 |
注意:
关于Front-matter的演示:
最简配置:
---
title: typora-vue-theme主题介绍
date: 2018-09-07 09:25:00
---
最全配置:
---
title: typora-vue-theme主题介绍
date: 2020-06-18 13:30:00
author: 小苏
img: /source/images/xxx.jpg
top: true
cover: true
coverImg: /images/1.jpg
password: 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92
toc: false
mathjax: false
summary: 这是你自定义的文章摘要内容,如果这个属性有值,文章卡片摘要就显示这段文字,否则程序会自动截取文章的部分内容作为摘要
categories: Markdown
tags:
- Typora
- Markdown
---
3.2修改默认文章配置
在每次创建文章只有title和date,如果想要再设置其他属性还需要翻看文档,有些麻烦,因此我们可以设置常用的属性作为默认配置。
只要去主目录下找到scaffolds
文件夹下找到一个post.md 文件修改即可,这里是我的目录 E:\blog\scaffolds
以下是我的配置:
# 标题
title: {{ title }}
date: {{ date }}
author: 小苏
# 简述
summary:
# 使用自定义封面
img:
# 是否置顶true,或者去掉
top:
# 轮播
cover:
# 轮播图
coverImg:
# 标签
tags:
# 分类
categories:
# 是否加密文章,SHA256加密
password:
4.在Typora中插入图片
由于使用原先的复制粘贴图片时,图片的地址会是本地地址,上传到网络就导致文章的图片加载不出来,于是我们可以采取将图片上传到图床上,再将图床的地址加入到文章中即可,此方法就是Typora集成PicGo图床的方法
感谢励心大佬的文章,解决了我的问题
4.1第一步:关于什么是图床,如何搭建
引用励心大佬的文章
4.1.1 基于Github图床的搭建
4.1.2 基于Gitee图床的搭建
4.2 第二步:设置PicGo
点击PicGo设置、开启Server,监听地址不用进行更改,监听端口的值设置为36677,这个值可以在Typora软件中获取到,一般默认值都是36677
4.3第三步:设置Typora
关于Typora软件的安装很简单,傻瓜式安装,打开typora软件,依次打开步骤为:文件 -> 偏好设置 -> 图像,具体配置参考下面的图中的配置:上传服务选择app即可,不需要使用core,路径就是你的PicGo.exe的路径
4.4第四步:验证配置是否正确
点击上一步的验证图片上传选项
,看看是否上传成功,成功会出现以下界面:
出现错误,请看文章最后的错误分析
4.5使用方法
4.5.1 可以将图片直接拖拽文章中,Typora会自动上传
4.5.2 复制粘贴
4.5.3 使用快捷键Ctrl + Shift + I,选择图片路径即可
4.6 错误分析
4.6.1 {“success”,false}
原因:是文件名冲突了,如果你上传过一张image1.jpg的图片,再上传名称一样的图片就会失败,log日志中也会写道。
解决方法:打开picgo设置,将【时间戳重命名】打开,再上传图片是重命名即可,或者将图床中重名图片删掉
原因:本地部署没有断开,ctrl+c断开hexo s的部署
解决方法:断开部署后重新上传
4.6.2 Failed to fetch
原因:一般是因为端口不一致而导致的,Typora监听的端口号为36677,有时在于端口冲突,如果你打开了多个picgo程序,就会端口冲突,picgo自动帮你把36677端口改为366771端口,导致错误。
解决方法:打开PicGo软件,然后依次打开PicGo设置、设置Server,查看当前的端口号,如果不是36677,则将监听端口号修改为36677即可。
4.6.3 please config path for picgo(app) in preferences panel
原因:有可能设置了之后还没有生效
解决方法:将Typora写的文章关闭后重新打开,尝试上传图片
4.7 友情提醒
PicGo的日志(log)文件是个好东西,如果出现报错,图片上传不成功的情况,大家可以打开日志看看,根据日志输出,然后自己尝试解决,百度是个好东西!
5.在Typora中插入多媒体
插入多媒体可以使用直接插入或者使用插件插入,这里只介绍直接插入:
直接插入:不需要安装插件,简单,但有的浏览器不支持
插件插入:支持所有,但是配置有些麻烦
5.1 插入音乐
音乐链接获取(网易云音乐为例)
将音乐代码粘贴到markdown中即可,注意长宽尺寸
5.2 插入视频
注意:插入的视频必须是视频的原URL
注意加上width(宽),height(长),长宽可以是视频分辨率