今天我们正式要使用 Markdown 撰写你的第一篇部落格文章啦!
用指令建立文章或草稿 .md 档
首先,打开 Git 输入以下指令:
# 指定部落格目录
cd 部落格目录
# 建立文章 .md 档
hexo new "文章名称(网址用)"
# 建立草稿 .md 档
hexo new draft "文章名称(网址用)"
照着 Git 回传的路径(基本上会放置在 ./source/_post
内 ),回到 VScode 查看左侧目录列表,就可以看到档案已经新增,并且有附上一些文章必备资讯。
至於若是建立草稿(文章与页面都可),可以看到建立的 .md 档会放置在 ./source/_drafts
内,存放在 _drafts
目录内的档案不会被建立成文章或是页面,因此如果你想先建立档案但不一定要先发布,可以先建立成草稿,等到要发布时,在移动到 _post 目录内或是独立建成一个页面。(页面部分会於明天说明)
使用 Typora 撰写文章
届时我们可以利用 Typora 开启这个 .md 档,利用专门的 Markdown 编辑器可以帮助我们更省力於文章撰写上。
设定文章资讯
再来我们可以看到预设档案建立之後,会附带一些资讯,预设有常见的 title
、date
以及 tags
,而我自己还会再加上 categories
,那分别代表什麽呢?
至於文章网址则会抓你的档案名称,所以如果你希望网址是英文呈现的话,就要想个英文名称。
---
title: 我的第一篇文章
date: 2021-08-27 14:30:40 <!-- 预设即可 -->
tags:
- [文章标签一]
- [文章标签二]
categories:
- [文章分类]
---
标签与文章分类我建议都使用 - []
包覆,因为其中分类有加中括号跟没加会有不一样的效果,这部分我们会於日後篇章再来说明这部分的差异。
开始撰写文章啦!
关於一般文章会使用到的 Markdown 撰写可搭配昨天篇章「Day 8:先别急着撰写文章,你听过 Markdown 吗?」一起服用,双重享受(?
所以今天这篇文章就到这里结束了(不是这样的吧 XD)好啦还有,接下来的部分就会比较着重在 Typora 本身功能的设定,只要能够善用,就能够提升文章撰写的效率。
撰写一篇文章需要花费时间大约是一至两个小时,一个顺眼的编辑器绝对相当重要啊!就如同许多编辑器都有提供多种不同的编辑器主题,Typora 本身也内建立了五个主题可让我们做切换选择,我自己平常是使用 Night 这个主题,图下图所示。大家也可以找个顺眼的主题看看。
选取文字范围按右键後,可以看到许多类似像所见即所得的工具列选项,当你点击「B」,所选取文字范围就会变成粗体。由左上到右下总共分别有:
这部分会自动帮我们产生出各级段落 # 字号。
这里可以插入一些像是图片、注解等等资讯,不过我自己是很少用啦,当然大家也可以玩玩看。
我自己做撰写时是不太使用右键插入的方式,因为当你截图并且目前已经复制那张图片时,直接在 Typora 内贴上,它就会自动产生出图片啦!
![提示文字](图片网址)
便是图片的 Markdown 语法,而使用此方式我们只须填上提示文字就好,档案已经进行产生。不过如果觉得这路径有点难找的话,按下上面工具列的「档案」 ---> 「偏好设定」来到设定页面,再来点选左边选单的「图片」就能够进行图片储存路径设定。
不过我个人认为美中不足的点是它目前仅提供产生 .png 档,不然其实 .jpg 的档案大小会比较小,所以我自己都会特别用线上工具把图片档转成 .jpg 後再上传,只希望能够尽快提供副档名选项给我们选择了 QQ
至於图片空间的部分......因为我自己的方法需要使用到自己的网址比较不一样,这边我就不做分享。不过我自己在找相关资料时是有查到「[App] Typora 自动上传图片到 imgur (for Mac)」,不过我自己是没有试过,各位可以试试看。
对了,如果觉得自动化有点复杂,也是可以直接使用 Imgur 提供的图片上传平台来上传图片。至於我自己使用的方法,目前预计会分享在 31 天之後的「彩蛋篇」,大家可以期待一下!
产生文章页面
OK,当文章编辑完成後,要如何产生文章呢?其实很简单,执行 hexo g
指令产生页面就好了,然後再执行 hexo g
产生虚拟服务器就可以看到我们撰写的文章罗!
文章太长怎麽办?
产生文章後回到首页,发现整篇文章内容都显示在首页上。如果只想要显示第一段内容,其他内容则引导读者点击标题或点阅读全文进去浏览的话,该怎麽做呢?
在想要截断的地方(例如第一段结束),加入以下这段语法:
<!-- more -->
重新 hexo g
、hexo s
後,回到首页,就能看到首页仅显示第一段内容,并出现了「阅读全文」按钮。
删除文章
如果要删除文章该怎麽办呢?也很简单,只要把文章 .md 档案删除就可以了。
後记
撰写完文章後,明天的篇章会是有关於 Hexo 文章分类、标签与自订页面建立,大家再一起加油,後天就要将部落格部署到网路上啦~
参考资料
本篇文章同步发布於我的部落格 Gui Blog
观赏鱼辨识系统说明-Day 01 在接下来的30天会制作一个完整的系统包含前端-手机/网页,後端-N...
继上篇主要以区块链三个特徵叙写,下篇笔者将探讨区块链的价值、治理,这篇会是比较实用一点的生活应用面向...
我们可以在开发环境中使用 <React.StrictMode>进入严格模式 严格模式帮...
前面文章提到许多前、後端分离的开发方式,也模拟过很多次资料来自於外部(json)的开发,今天跟大家介...
前言 今天是铁人赛的第十七天,要来做一个临时的side project : 批次在图档上加浮水印 动...