iT邦幫忙

2021 iThome 鐵人賽

DAY 10
0
Software Development

Let's blogggggggggg系列 第 11

[Day11] Let's Post!

雖然在 Day08 時已經新增過一篇文章,但因為是測試用的關係並沒有深入,今天就讓深入聊聊產出一篇文章需要注意什麼吧!

指令

文章預設都是放在 content 目錄下,所以當執行以下指令:

hugo new posts/first.md

會在 content/posts/ 下建立 first.md,當然你也可以對 content 底下的目錄進行分類,比如 content/about/,但只有在 content/posts 底下的檔案會出現在部落格首頁中,其他分類的用處我們之後會詳細說明。

Front Matter

還記得新增文章後預設會有的一些設定檔嗎?在你的 content/posts/first.md 中會看到:

---
title: "First"
date: 2021-09-25T02:10:22+08:00
draft: true
---

這些被 Hugo 稱作 Front Matter,是用來對個別的文章做一些特化的設定。

比較常用的如:

  • title:文章標題
  • description:進到文章畫面時的副標
  • summary:在文章列表頁面時的內容簡述
  • featured_image:文章的縮圖,圖片相關我們之後會說明
  • tags:用來分類文章,一篇文章可對應多個 tag
  • keyword:跟 SEO 相關,這部分也會單獨開一篇說明
  • date:文章產出的時間
  • toc:table of contents,文章目錄,同樣之後會說明
  • disable_share:用來關掉預設會存在的分享按鈕

以上幾個就足以滿足我們簡單的需求了,Front Matter 還有更多的參數可以使用,想再更深入的話,請參考官方文件

內容

文章的內容我們一般會用 Markdown,這是一種輕量級的標記式語言,可以用簡單的語法來做排版,你現在看到的這篇文章同樣也是使用 Markdown 完成的。

Markdown 是很常用而且非常方便的語法,開源專案的 README 原則上也都是用 Markdown 完成的。

結論

今天帶過新增一篇文章需要了解的知識,明天計畫用這幾天的內容完善一下部落格,讓他看起來比較像是一個部落格的樣子。


上一篇
[Day10] 聊聊 Config
系列文
Let's blogggggggggg11

尚未有邦友留言

立即登入留言