Day 9:使用 Typora 发表你的第一篇 Hexo 文章

今天我们正式要使用 Markdown 撰写你的第一篇部落格文章啦!

用指令建立文章或草稿 .md 档

首先,打开 Git 输入以下指令:

# 指定部落格目录
cd 部落格目录

# 建立文章 .md 档
hexo new "文章名称(网址用)"
# 建立草稿 .md 档
hexo new draft "文章名称(网址用)"

hexo new

照着 Git 回传的路径(基本上会放置在 ./source/_post 内 ),回到 VScode 查看左侧目录列表,就可以看到档案已经新增,并且有附上一些文章必备资讯。

VScode 目录

至於若是建立草稿(文章与页面都可),可以看到建立的 .md 档会放置在 ./source/_drafts 内,存放在 _drafts 目录内的档案不会被建立成文章或是页面,因此如果你想先建立档案但不一定要先发布,可以先建立成草稿,等到要发布时,在移动到 _post 目录内或是独立建成一个页面。(页面部分会於明天说明)

建立草稿文章

使用 Typora 撰写文章

届时我们可以利用 Typora 开启这个 .md 档,利用专门的 Markdown 编辑器可以帮助我们更省力於文章撰写上。

使用 Typora 撰写文章

设定文章资讯

再来我们可以看到预设档案建立之後,会附带一些资讯,预设有常见的 titledate 以及 tags,而我自己还会再加上 categories,那分别代表什麽呢?

  • title 文章标题
  • date 文章建立日期 / 时间,预设会抓档案建立日期
  • tags 文章标签
  • categories 文章分类

至於文章网址则会抓你的档案名称,所以如果你希望网址是英文呈现的话,就要想个英文名称。

设定范例

---
title: 我的第一篇文章
date: 2021-08-27 14:30:40 <!-- 预设即可 -->
tags:
- [文章标签一]
- [文章标签二]
categories:
- [文章分类]
---

标签与文章分类我建议都使用 - [] 包覆,因为其中分类有加中括号跟没加会有不一样的效果,这部分我们会於日後篇章再来说明这部分的差异。

开始撰写文章啦!

关於一般文章会使用到的 Markdown 撰写可搭配昨天篇章「Day 8:先别急着撰写文章,你听过 Markdown 吗?」一起服用,双重享受(?

所以今天这篇文章就到这里结束了(不是这样的吧 XD)好啦还有,接下来的部分就会比较着重在 Typora 本身功能的设定,只要能够善用,就能够提升文章撰写的效率。

挑选一个顺眼的编辑器主题

撰写一篇文章需要花费时间大约是一至两个小时,一个顺眼的编辑器绝对相当重要啊!就如同许多编辑器都有提供多种不同的编辑器主题,Typora 本身也内建立了五个主题可让我们做切换选择,我自己平常是使用 Night 这个主题,图下图所示。大家也可以找个顺眼的主题看看。

编辑器主题

选取文字范围按右键

选取文字范围按右键

选取文字范围按右键後,可以看到许多类似像所见即所得的工具列选项,当你点击「B」,所选取文字范围就会变成粗体。由左上到右下总共分别有:

  • B 粗体
  • I 斜体
  • </> 程序码区块
  • ? 链结
    • 必须先复制一个链结,按下它後所选取范围就会产生链结
  • 双逗号:引用区块
  • 有序清单(有标数字的清单)
  • 无序清单(本清单即使此清单)
    • [ ] 核取方块

选取文字范围按右键:段落

选取文字范围按右键:段落

这部分会自动帮我们产生出各级段落 # 字号。

右键 ---> 插入

右键 ---> 插入

这里可以插入一些像是图片、注解等等资讯,不过我自己是很少用啦,当然大家也可以玩玩看。

贴上截图产生图片

我自己做撰写时是不太使用右键插入的方式,因为当你截图并且目前已经复制那张图片时,直接在 Typora 内贴上,它就会自动产生出图片啦!

贴上截图产生图片

![提示文字](图片网址) 便是图片的 Markdown 语法,而使用此方式我们只须填上提示文字就好,档案已经进行产生。不过如果觉得这路径有点难找的话,按下上面工具列的「档案」 ---> 「偏好设定」来到设定页面,再来点选左边选单的「图片」就能够进行图片储存路径设定。

设定图片储存路径

不过我个人认为美中不足的点是它目前仅提供产生 .png 档,不然其实 .jpg 的档案大小会比较小,所以我自己都会特别用线上工具把图片档转成 .jpg 後再上传,只希望能够尽快提供副档名选项给我们选择了 QQ

至於图片空间的部分......因为我自己的方法需要使用到自己的网址比较不一样,这边我就不做分享。不过我自己在找相关资料时是有查到「[App] Typora 自动上传图片到 imgur (for Mac)」,不过我自己是没有试过,各位可以试试看。

对了,如果觉得自动化有点复杂,也是可以直接使用 Imgur 提供的图片上传平台来上传图片。至於我自己使用的方法,目前预计会分享在 31 天之後的「彩蛋篇」,大家可以期待一下!

产生文章页面

OK,当文章编辑完成後,要如何产生文章呢?其实很简单,执行 hexo g 指令产生页面就好了,然後再执行 hexo g 产生虚拟服务器就可以看到我们撰写的文章罗!

文章太长怎麽办?

产生文章後回到首页,发现整篇文章内容都显示在首页上。如果只想要显示第一段内容,其他内容则引导读者点击标题或点阅读全文进去浏览的话,该怎麽做呢?

文章太长怎麽办?

在想要截断的地方(例如第一段结束),加入以下这段语法:

<!-- more  -->

重新 hexo ghexo s 後,回到首页,就能看到首页仅显示第一段内容,并出现了「阅读全文」按钮。

加入阅读全文按钮

删除文章

如果要删除文章该怎麽办呢?也很简单,只要把文章 .md 档案删除就可以了。

後记

撰写完文章後,明天的篇章会是有关於 Hexo 文章分类、标签与自订页面建立,大家再一起加油,後天就要将部落格部署到网路上啦~

参考资料

本篇文章同步发布於我的部落格 Gui Blog


<<:  [Lesson9] Firebase

>>:  Day11:全端工程师的基本要求

观赏鱼辨识系统说明-Day 01

观赏鱼辨识系统说明-Day 01 在接下来的30天会制作一个完整的系统包含前端-手机/网页,後端-N...

Day27 - 区块链社会学读後感(下) 价值、治理

继上篇主要以区块链三个特徵叙写,下篇笔者将探讨区块链的价值、治理,这篇会是比较实用一点的生活应用面向...

[进阶指南] 严格模式( Day29 )

我们可以在开发环境中使用 <React.StrictMode>进入严格模式 严格模式帮...

vue3 Composition API 学习手册-30 实战API练习

前面文章提到许多前、後端分离的开发方式,也模拟过很多次资料来自於外部(json)的开发,今天跟大家介...

DAY17 - 第五个小范例 : 图片加浮水印

前言 今天是铁人赛的第十七天,要来做一个临时的side project : 批次在图档上加浮水印 动...