使用 Nuxt Content 以檔案產生網站

Nuxt Content 是什麼？

Nuxt Content 是 Nuxt.js 框架的其中一個模組，能夠將 Markdown, YML, CSV, JSON 等格式的檔案直接轉換為網頁，支援語法高亮(使用 shikijs/shiki、載入時內容更新很快、在 Markdown 中支援 Slot，方便籤套內容、可以和 .Vue 檔案混用，自訂義彈性非常大。

缺點:
雖然內容可以使用 Markdown 轉換，但基本網頁的上、下、左、右欄需要自訂，還是需要研讀一下 Nuxt Content 的說明文件和檔案放置基本規則，但是大部分都可以使用 Nuxt 的功能達成。另外官網的文件沒有寫的很詳細，有些功能需要從程式碼中挖掘。

如果覺得 Nuxt Content 一開始什麼都沒有非常空曠，可以看看隔壁的 nuxt-themes/docus ，據說 Nuxt Content 有使用到 nuxt-themes/docus ，只是它下方的功能提供標記好像無法移除。

Nuxt Content 適合建立什麼網站？

首先筆者目前的網站肯定是不會使用 Nuxt Content 建立，筆者太懶了，並且又沒有什麼美感，花時間重建然後介面做更醜還不如努力多研究點新東西，再多寫幾篇文章。
那既然這樣還研究 Nuxt Content 幹嘛？筆者發現有一個地方非常適合使用 Nuxt Content 建立網站，就是不公開在網路上的內部網站！市面上有許多服務都很適合建立內容網站，例如 Google 的 blogger 就很方便，但是所有人都看的到，如果要做內部網站筆者覺得 GitHub 的 Wiki 還不錯，不過對於私有儲存庫需要收費才可以建立 Wiki，而且他方案也滿花時間，在這個前提下使用 Nuxt Content 就很方便，只要有第一個人先建立好專案，建立好頭幾個頁面，其他開發人員應該都了解基本的 Markdown ，再依樣畫葫蘆就可以慢慢的建立起內部的知識庫了！
除了基礎的注意事項、開發規範、部屬步驟等等，還可以再加上菜單...，想到就覺得很方便！

你問我那每個人都要編輯會不會很麻煩？可以使用 GitHub 建立一個專案就好了啊！那每次更新都要部屬會不會很麻煩？來來來學習一下 Jenkins ，自動部屬了解一下，可以慢慢看筆者以前的文章，如果有不了解的歡迎留言敲碗更新。
延伸閱讀：Jenkins 安裝 教學

建立 Nuxt Content 專案

建立專案沒有很困難，依照 Nuxt Content 官網的步驟 就可以建立完畢了，這裡就不浪費篇幅複製貼上了。

Nuxt Content 頁面的內容就在 Github 的 docs 資料夾內，開發時可以先拉一份下來和官網界面對照著看。不過有許多內容是使用 @nuxt/ui-pro 套件，就是付費(199 美金)的 @nuxt/ui ，所以還是有許多內容無法照抄。筆者就是花了許多時間尋找 UHeader 元件在哪裡，最才發現需要付費才能解決...

參考資料：
Nuxt Content
GitHub - nuxt/content
GitHub - nuxt-themes/docus