cover

Hexo 新增文章:從 hexo new 到發布上線

hexo new "文章標題" 然後就可以開始寫了——但如果你想讓這篇文章被人找到,還有幾件事要做。

先講結論

hexo 新增文章

新增文章的完整流程:hexo new → 填好 frontmatter(特別是 description 和 keywords)→ 確認 category_map / tag_map 沒有中文殘留 → 寫文章 → hexo g -d 部署。

hexo new:建立文章骨架

hexo new "你的文章標題"

這會在 source/_posts/ 下產生一個 Markdown 檔案。打開來長這樣:

---
title: "你的文章標題"
date: 2024-09-08 16:18:42
tags: []
categories: []
description: ""
keywords: ""
---
 
正文開始...

上面那段 --- 包起來的東西叫 frontmatter,是文章的 metadata。接下來教你怎麼填。

Frontmatter:SEO 的命脈

大部分人 hexo new 完就直接寫正文了。但 frontmatter 沒填好,搜尋引擎根本不知道你這篇在講什麼。

必填的幾個欄位:

  • description:一兩句話描述文章內容。這會顯示在 Google 搜尋結果的摘要裡。不寫的話 Google 會自己抓,抓出來通常很醜
  • keywords:跟文章相關的關鍵字,用逗號隔開
  • categories:文章分類,建議用英文或搭配 category_map
  • tags:標籤,比分類更細
---
title: "React Hooks 入門指南"
date: 2024-09-08
description: "從 useState 到 useEffect,用實際範例帶你搞懂 React Hooks 的核心概念。"
keywords: "React, Hooks, useState, useEffect, 前端開發"
categories:
    - 前端
tags:
    - react
    - hooks
---

別忘了 category_map

如果你的 categories 用中文(像上面的「前端」),記得在 _config.yml 裡做映射:

category_map:
    前端: frontend
tag_map:
    前端: frontend

不然 URL 會出現 %E5%89%8D%E7%AB%AF 這種亂碼。問我怎麼知道的?因為我踩過

寫完了,部署吧

hexo g -d

部署完之後,記得做三件事:

  1. 檢查線上頁面:確認排版沒跑掉、圖片有正常顯示
  2. 確認 sitemap 有更新:到 /sitemap.xml 看看新文章有沒有出現
  3. 到 Google Search Console 提交 URL:如果想要更快被收錄的話

不用每篇都手動提交——sitemap 會自動通知搜尋引擎。但新站初期,手動提交可以加快收錄速度。


寫了一篇教人怎麼寫文章的文章,然後發現自己 frontmatter 忘記填 description