自架部落格(5) 寫一篇文章

發表於 更新於 分類於
寫一篇文章剛開始主要就是注意 front-matter 的設定，其他就是用 Markdown 寫文章了。

寫一篇文章剛開始主要就是注意 front-matter 的設定，其他就是用 Markdown 寫文章了。

Markdown 的工具有很多，例如直接使用 Visual Studio Code、HackMD 等。像我就使用 Notion，不用打語法，修改樣式時搭配快捷鍵，匯出時選 Markdown，然後再稍微調整一下就好，方便好用。

建立文章

指令

要建立一篇文章的檔案，可以輸入指令依照範本產生

layout：這個是填入範本的名稱，不填的話預設是 post，位置在專案目錄下的 scaffolds。當然你也可以客製化自己的範本，會一些節省時間。這個可以在 _config.yml 的 default_layout 裡指定預設的範本。

title：標題名稱

1
hexo new [layout] <title>

建立好之後就會在 source/_posts 中產生一個同 title 的 .md 檔案，裡面會有依照 post 範本產生的 front-matter

1
2
3
4
5
---
title: 剛剛輸入的標題
date: 產生檔案的時間，格式：yyyy:MM:dd HH:mm:ss (2022-07-03 15:42:25)
tags:
---

front-matter 設定

front-matter 其實是 YAML 或 JSON 在檔案開頭的區塊，用來設定文章的一些設定值。

這裡列出一些常用的設置，其實全部的設置也不多。

title：標題

data：建立日期

description：描述、簡介，這個和文章列表顯示的內容有關。加了這個之後，就會在文章列表的標題下面顯示這裡的內容。當然你也可以在文章內使用 <!— more —> 這個語法來直接顯示標記前的內容，但是進入文章後網址會有 https://example.com/yourtitle#more，而且畫面會從這個標記開始顯示。

categories：文章的分類，有兩種分法

第一種：同一個層級。

-Sports
-Basketball

1
2
3
categories: 
- Sports
- Basketball

第二種：一個分類底下有多個分類。

-Sports
　-Baseball

-MLB
　-American League
　　-Boston Red Sox

-MLB
　-American League
　　-New York Yankees

1
2
3
4
categories: 
- [Sports, Baseball]
- [MLB, American League, Boston Red Sox]
- [MLB, American League, New York Yankees]

tags：標籤。可以設定多個。

1
2
3
4
tags:
- Sports
- Baseball
- MLB

comments：是否允許留言，預設 true。

前面的 NexT 主題設定中，我們在 menu 中加入了 tags 和 categories，這時候我們也要在文章中加入才有效果。

參考