看著草稿夾有七篇文章等待我撰寫，就知道有一陣子沒有在update近況

感覺好久沒打文章了，我應該神隱一陣子了

我成功用Hugo架出我的網站，並部屬到Github上

這是我的新網站: minayu.site

還有許多功能還沒Ready，不過大致上已經做好根基了

該是寫文章來分享一下

由於上班之後，能夠做自己的事的時間很少，在動工之前，我找了兩三周的資料

就是不希望我又像 上次衝動租Bluehost ，架好網站後發現苗頭不對，所以趕緊搬回這邊XD

雖然找了很多網站，但是真正施工時，又遇上不少問題

此篇分享從Wordpress搬家到Hugo並部屬到Gituhb上

找尋資料

對於Hugo還一無所知，Hugo與Wordpress這種CMS是不太一樣的系統
我前後參考了幾了網站來了解Hugo是一個 靜態網站生產器
一開始覺得很不靠鋪，我也是wordpress用戶，少了資料庫的靜態網頁生產器怎麼能媲美功能美滿的CMS呢?
後來我錯了, 架好Hugo後，我發現我可以離開Wordpress的限制，自由的改動網站的外觀，以及添加任何我想要的功能

非常的自由，但要有一個認知就是

從此之後想要甚麼都要自己手動做qq

所以我看了些比對的文章，像是選個最好的靜態網頁生產器, Jekyll vs Hugo
首先也要記得參觀Hugo官網,選主題時你會常常在主題頁面中停留
用Hugo怎能不看Hugo官網呢?
再來我擔心沒有後台我就變成了不會寫文章的手殘
所以我找到了跟Hugo與Github相容的CMS: Forestry
(可是我昨天實際用過Forestry，不可否認很好用，但我現在卻正在調查她是不是造成我的網頁掛掉的兇手 …，等我查明後才會推薦，這讓我的心情很鬱悶)
有機會分下個文章跟大家分享

架設Hugo

我找了一堆網站，來輔助我架設Hugo

等到我真的開始實作後，我發現完全架不起來

這份簡報是我歷經千辛萬苦，架了幾十次，跟著架才成功的指南

讚

請服用

我是使用Mac

首先安裝Hugo

$ brew install hugo

如果沒有brew，可以試試看 這篇文章 裝一下

＊註： brew 就是mac系統的套件管理系統 Homebrew, 若是沒有 homebrew，可以找尋安裝指南，幾行指令就搞定!

新建一個網站

hugo new site mysite

此時您的網站已經初始生成

進入網站資料夾

cd mysite

內部的資料夾包刮 content, theme, layout, ….

安裝Theme

接著就去Hugo官網挑挑你愛的主題吧!
我是挑 Tranquilpeak
每個主題點進Download都會進到該主題的Github
那我們就用Git指令把主題裝到我們的網站資料夾內

進到主題資料夾安裝

$ cd themes

這邊以Tranquilpeak為例

$ git clone https://github.com/kakawait/hugo-tranquilpeak-theme.git

裝好後利用ls指令會看到hugo-Tranquilpeak-theme資料夾在您眼前

$ ls
hugo-Tranquilpeak-theme

接著看你要使用編譯器，還是手動拉

將一些相關文件從theme複製到你的根目錄

將你的主題theme資料夾內 “archetyps” 內的檔案複製到你的"archetyps"

這邊是用hugo-Tranquilpeak-theme 主題

將hugo-Tranquilpeak-theme/archetyps/內容移動至 mysite/archetyps/內

將你的主題theme資料夾內 exampleSite 內的檔案, 直接取代根目錄的檔案

忘記在哪邊看到，在簡報中是沒有看到這個部分

要順利先將主題的頁面刻出來，就將 exampleSite 內像是content, static 都直接複製取代掉你的mysite/ 中的content 及 static

將你的主題theme資料夾內 exampleSite 內的config.toml, 直接取代掉根目錄的config.toml

就是取代mysite/config.toml 中

接下來回到根目錄

將hugo run 起來 就能看到完整的主題頁面

$ hugo server

先求有再求好

接下來就是您的工作囉~

打開根目錄的config.toml 檔案, 將參數改一改，改成你要的

將Wordpress文章輸出, 轉為，並放入Hugo

當初要實作時，我參考了一個網站，發現完全不work

我也實際參觀Hugo migrations的頁面，照著上面的一些功能，也是不work xD

後來參照from wordpre to hugo 的文章後，使用了Exitwp ，才順利把文章從xml 轉到md檔

Wordpress後台 Export 你的文章 .xml

[你的wordpress url]/wp-admin/

可以進到wordpress的管理員後台

點選 Tools > Export

可以進去Export文章的網頁

＊若沒有Export 要去 Plugin 安裝，wordpress.com都會有，Wordpress.org可能要安裝套件Plugin

選擇免費的 Start Export

開始把你的部落格點匯出，完成的檔案會寄信到您的信箱

用外部套件將Wordpress XML 轉為Hugo 使用md

參考網站: from wordpre to hugo,  Exitwp

將 exitwp 下載下來

git clone https://github.com/thomasf/exitwp.git

將 wordpress xml 放進 wordpress-xml 資料夾中

＊請注意這個套件的環境為python 2.7

pip install pip_requirements.txt

或者

pip install

• html2text
• PyYAML
• Beautiful soup

驅動python程式來轉檔

python exitwp.py

幸運沒報錯的話，就可以進build資料夾領取md囉~

將轉出的.md檔放進hugo內

這個部分老實說要看不同的主題會有不同的要求，主要看你的 網站資料夾 內的 “archetyps” / themes/你的主題/archetyps/內的.md檔怎麼定義一篇部落格

將輸出的.md檔放進Hugo, 通常會是這幾個資料夾，取決於你的theme/exampleSite/content 內容

content/blog
content/post
content/posts

確認一下每篇md檔有沒有和archetyps 內.md規範符合

至少要有archetyps 內.md 內規定的幾個元素

有可能是

title
layout

注意一下是 yaml 還是toml

－－－－－－

－－－－－－

或

＋＋＋＋＋

＋＋＋＋＋

最後，到根目錄跑一次建置，進入 1313 看一下網頁有沒有問題，就可以準備部署囉!

hugo server

部屬至Github

將網頁建在哪都可以，AWS, GCP 或其他平台，而我看大部分的人都部屬在github上

這部分我自己做的也不是很好，沒辦法建議甚麼qq

2019.05.19

跟大家說個福音，那就是, 隨著我後來的功力大增，我終於知道怎麼好好的部署至Github啦！！！！

傳送門在此: [BLOG] 如何在GITHUB上架設HUGO網站

當然還是可以繼續往下讀，只是當時不怎麼會弄寫得不怎麼好就是XD

你可以參考hugo本身的網站

但我用的方法:這位部落格主提供的方法

在github分成兩個repo，一個是放你build網站的程式資料夾(當然你也可以選擇不存)

另外一個則是取名為

你的帳號名稱.github.io

這個指令會生成public資料夾

hugo

cd public

接著再按照新開的repo上有指南，把git init 後，往github repo 推送

應該不用幾分後，進入你的網站

[使用者名稱].github.io

就可以看到你的網站囉!

問題大哉問

除了注意一下環境要是python2.7外，若想使用python3執行

我想可以試試看在exitwp.py 程式裡，把print 換成 print() 語法

我有試過，但我忘了有沒有成功

＊exitwp系統說缺少yaml，可是我執行 pip install yaml 卻說沒有這個套件?

正確的套件是 PyYAML

pip install PyYAML

＊theme 內只有theme.toml 沒有 config.toml?

theme 內的 config.toml 在 範例網站的資料夾內

應該會有個 exampleSite 的demo 網站\，裡面有demo用的config.toml

＊為什麼我hugo server後畫面是空白的?

很多教學文章都是說將theme clone下來後，把config.toml檔改一改就好了

但實際上需要把 exampleSite 內的 archetyps, static 及 content 最好都取代根目錄的資料

(注意不要把exampleSite 內的content/post內容取代掉你的文章)

確認主題可以顯示後，再把你的部落格文章.md檔放進 content內

＊為什麼我把我的文章放進content後跑不出來？

我想這要參考一下 theme 內的 archetyps 怎麼定義為一篇文章

以上大致上是我架站時發生的一些問題

原先以為調查兩三周後可以順利實作，但真正到了實作時又遇上了一些困難，但我的網頁初版還是用了我半天的時間內完成

只不過我昨天手賤 去使用了第三方的網站來讀取我的github 直接做操作

在我歡樂愉悅的沉浸在這美麗又舒服的操作時，發現他把我很多網頁都搞壞了

偏偏這假日忘了帶電腦回來， 好鬱悶阿 …..