iT邦幫忙

4

[Ting's筆記Day2] 在Github用Jekyll創建自己的blog

最近IT邦有一篇熱門文章「哪個blog寫技術文章最好用?」
有邦友開玩笑的說IT邦算嗎?

昨天貓貓工程師在我們共同的Slack群組分享他的blog,他提到是使用Jekyll(一個簡單靜態blog網站生成器)架在github上的。

於是好奇的我決定照著關鍵字來搜尋一下,如法炮製做一個出來。

這樣寫在IT邦的文章,也可以放一份到自己的Blog!
https://tingtinghsu.github.io/jekyll/update/2018/08/25/github_jekyll_blog.html

A.在你自己的Github帳號建立新資料夾 github.io

名稱必須是你的username.github.io
https://ithelp.ithome.com.tw/upload/images/20180824/20111177JLQCXuETDs.png
建好後下載這個資料夾。

補充:Github是個放程式的地方,最多只能呈現特定的靜態頁面(適合放blog/履歷表之類的內容。)
無法放搭配伺服器資料庫共同運作(例如會員登入、購物車等功能)的動態網站,!
如果想架動態網站,可以去Heroku

B. 在github.io資料夾內新增首頁

剛剛下載的資料夾,預設會儲存至本機端電腦的這個路徑(以我的Mac為例):

/Users/tingtinghsu/Documents/GitHub/tingtinghsu.github.io

在本機裡的yourusername.github.io新增空白頁面index.html,使用html語法編輯。

https://ithelp.ithome.com.tw/upload/images/20180824/201111770XolTRJGtw.png

來改一下簡單的Hello World Style程式碼:

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
  <head>
  </head>
  <body>
    <h1>Hello Ting Ting!</h1>
    <p>This is my GitHub Pages.</p>
  </body>
</html>

這時候貓貓工程師在我耳朵旁邊OS打廣告:VS code 好用!

改好後,重點來了!先 git commit to Master(儲存修改到本機),再git push(上傳將你要發佈的網頁到Github的資料夾上)

給Git新新手的連結:
常用Git指令,網路上資源非常豐富,我參考這裡部落格,

如果新手想先跳過git指令本機端的圖形介面編輯器,可以下載Github桌面版

好囉!來網址列試試看自己的blog陽春首頁會不會出現?

http://tingtinghsu.github.io/

https://ithelp.ithome.com.tw/upload/images/20180824/20111177CSwxXlpA2v.png

成功!

C.在本機上裝Jekyll

Jekyll

Jekyll是base on ruby開發的部落格網站生成器,需要的版本要ruby2.0以上。
在termimal輸入ruby -v確定一下版本:
https://ithelp.ithome.com.tw/upload/images/20180825/20111177OspMdSGx4z.png

Ruby版本沒問題,就可以輸入指令在本地安裝Jekyll

gem install jekyll

建一個新資料夾寫Blog的指令:

jekyll new myblog
cd myblog

開啟Jekyll伺服器:

jekyll serve

在網址列輸入http://localhost:4000/
應該會出現這樣的畫面:
https://ithelp.ithome.com.tw/upload/images/20180825/20111177JpBt2TiYL7.png

接下我們就可以在本地端進行完修改網頁,再用git上傳。
到你的網誌連結:http://tingtinghsu.github.io/
https://ithelp.ithome.com.tw/upload/images/20180825/20111177CyDdUoadop.png

就可以看到改好的頁面了~~

[後記:]
安裝Git這部分我卡住了一段時間,因為以前沒有相關的觀念。

感謝貓貓工程師教學:

每次上傳前的好習慣是要輸入 git status :先用git看看哪些資料夾還沒有merged

如果出現了Unmerged paths,代表本地曾經新建過的新檔案,Github上還沒備份:

  (use "git add <file>..." to mark resolution)

        added by them:   _posts/2018-08-24-my_first_jekyll_page.markdown
        both modified:   _site/feed.xml
        both modified:   _site/jekyll/update/2018/08/24/my_first_jekyll_page.html

git add .:把所有更改過的所有網頁加入暫存變更
如果只要加入某個特定網頁,就在git add後加上網頁路徑

git add _site/jekyll/update/2018/08/24/my_first_jekyll_page.html

git status: 確定一下剛剛是否已經存入暫存變更
綠色的字就是已經存入:
https://ithelp.ithome.com.tw/upload/images/20180825/2011117784pHVbSogs.png

git log:commit過的動作會進log做紀錄,-m ""加上自己的註解:commit過什麼事情
https://ithelp.ithome.com.tw/upload/images/20180825/20111177KatlWjvZCF.png

git push:記得要先commit後再push。

git pull :如果和其他人協同作一個部落格/專案,有可能GitHub上的變更會比較新,此時要先Pull下來,再push上去,才會確保是最新版本喔!

看到逐漸新增的blog文章頁面,很有成就感呢!:)

舊版型

https://ithelp.ithome.com.tw/upload/images/20181227/20111177DkmAzqdvQ9.png

新版型 (參考版型修改工程)
https://ithelp.ithome.com.tw/upload/images/20181227/20111177sGo5iGHe4p.png


0
fysh711426
iT邦研究生 4 級 ‧ 2018-08-25 21:55:52

媽!! 我上新聞了~ /images/emoticon/emoticon25.gif

目前我是推 VSTS 備份,github.io 好像也不錯,可以當另一個 Blog。

感謝分享~剛剛跑去搜尋一下如何用Visual Studio Team Services建立Team Server

話說兩個月前github被微軟買下來了呢,code生態圈後續如何發展值得關注

1
Homura
iT邦高手 1 級 ‧ 2018-08-25 22:10:19

Jekyll看起來又是個不錯的blog引擎
不過好像沒看到主題可換@@
我最近blog才從hexo轉到hugo
暫時應該不會換了
Hexohugo這邊倒是不少
https://themes.gohugo.io/
不過Hexo的東西越多運作得越慢....
偷偷貼一下自己的Blog,雖然沒什麼東西
https://homura0731.github.io/
不過最近有用龜速在寫些東西
只是都沒還沒上傳
都在忙著看動畫和玩遊戲/images/emoticon/emoticon07.gif

bater iT邦新手 5 級‧ 2018-08-25 22:26:02 檢舉

2018只有一篇XD

Homura iT邦高手 1 級‧ 2018-08-25 22:58:17 檢舉

bater
對啊!
有夠混的/images/emoticon/emoticon16.gif

Homura版大的部落格設計風格不錯耶!
謝謝提供Theme頁面,看起來很多選擇!
改次我也來試試Hugo ;)

0
bater
iT邦新手 5 級 ‧ 2018-08-25 22:24:19

好充實的一篇文章,充滿營養很有水準唷!

另外提醒一下標題的#要空一格才會生效Mrakdown的樣式喔
## 我是標題

類似這樣

感謝更正:)

謝謝Mentor貓貓,已修改
<3

0
wolfwang
iT邦新手 3 級 ‧ 2018-08-28 12:18:37

很有參考價值~

謝謝wolfwang版大鼓勵!我會繼續寫下去的~~:D

我要留言

立即登入留言