Github Pages起步
2021/07/09
我需要先說，網路上都寫說教你在五分鐘內建立網頁，我至少花了五個小時，所以其實慢慢來不用急的。
另外我完全不會在電腦上使用Git指令，所以全部的內容都是在Github網站上完成的。
我今天透過 GitHub Pages 建立了個人網頁，而這個網頁是透過 Jekyll 生成的，這是我的第一篇文章。
就來講講這個網頁是如何建立的吧!
為何選用這個方法是因為Jekyll是我在網路上看到很多人使用Github寫網頁的方法，而且有很多的模板可以套用 (雖然我選最簡單的模板但還是研究了很久)
首先在Github裡面建立一個repository，然後命名就叫帳號名.github.io，在裡面點擊Settings > Pages，然後選擇Change theme，這樣Github應該會主動幫你建立一個branch稱作gh-pages，在同一個頁面還會跳出一個網址，應該是https://你的帳號.github.io ，例如我的就是https://lloydychuang.github.io，到前面這步在很多網頁上都有教學，所以我就不多寫了。
重點在於，很多教學網站在後面寫得很模糊，而且很多操作都要用到電腦指令，所以我就把我摸索出來用Github網頁就可以完成網頁的方法寫下來，一開始在repo裡面只會看到兩個檔案，分別為_config.yml以及index.md，沒關係，一切都從這兩個檔案開始。
_config.yml
這是有關你的網頁style，因為我現在還不會自己寫style，所以我使用Github提供的Jekyll模板cayman，一開始看到裡面只有短短的一行字
theme: jekyll-theme-cayman
這時候就發現網頁什麼都沒有，所以我們要幫他加上標題及敘述，變成這樣即可
theme: jekyll-theme-cayman
title: "土壤、統計以及一點沉思"
description: "Soil, statistic, and a little bit of meditation"
index.md
這個index將會成為你的主頁，是別人進入你的網頁看到的第一頁，只要輸入你想要的東西就好，當作自己的首頁，但其實我還不太熟悉這種操作方式。
簡而言之，Jekyll可以把我們用markdown語法所編寫的內容都轉換成html並且發布在Github上面，因此對於我這種不太懂的人是很適合的入門方式，這個部落格教會我很多事情，而且可以直接看他的Github學習。另外英文比較好的也可以閱讀這個部落格。
另外，我嘗試在我的首頁加上我的文章列表，這是複製了Jekyll官網的文章，可以直接複製code貼在index裡面，就可以產出一個文章列表。
<ul>
{% for post in site.posts %}
<li>
<a href="{{ post.url }}">{{ post.title }}</a>
</li>
{% endfor %}
</ul>
還有最重要的文章呢?
要發布文章，首先要在repo底下建立一個資料夾_posts，一個字都不能改，建立資料夾的方式就是在建立新檔案時在輸入_post/檔案名稱即可創立新資料夾，而檔案名稱也不能亂取，要叫做yyyy-mm-dd-名稱.md，前面要輸入年月日共8碼，例如我這篇文章就命名叫2021-07-09-first-post.md。
檔案建立好後，要在檔案的開頭加上一段YAML程式碼，我還不太了解但應該是有關於這個頁面的一些資訊，其中layout比較麻煩一點因為我選擇的Cayman主題只附有default layout所以我就設定成default，之後我會再詳細寫該如何自己更改layout
---
layout: default
title: "標題"
---
然後就可以在這個檔案裡面自由編寫你要的內容，成功發布第一篇文章吧!