Go Back to GitHub Resources

使用既有 GitHub Pages 主題的優點

  • 零或極低設定成本:不用自己寫版型與 CSS
  • 相容 GitHub Pages:官方或主流主題,部署最穩

Theme 類型說明

  1. Built-in themes(內建主題) > ⚠️ Attention: github 幫你 deploy

    可在 _config.yml 加入

     theme: jekyll-theme-cayman 
    

    index.md 加入

     title: just a test
     description: nothing special 
    

非內建主題: 有/沒有「Use this template」的差別

有「Use this template :一鍵建立全新儲存庫

  • 直接套用他人提供的網站骨架/設定

沒有「Use this template」: 只能用 Fork 或 Clone

Fork

  • 與原作者 repo 有關聯
  • 需要理解 upstream、同步更新

Clone

  • 只下載到本機
  • 還要自己建立 GitHub repo、設定 remote、push

Use this template (UTT)

Engine(引擎,擇一): Ruby Go Node.js

Jekyll(Engine Ruby config _config.yml)


Hugo(Engine Go config config.toml)


Astro(Engine Node.js config astro.config.mjs )


找以下 repo bakery-site-template 作者 cpfong

/ 
README.md
docs/
  _config.yml
  index.md
  products.md
  order.md
  contact.md
  assets/img/

_config.yml

theme: jekyll-theme-minimal
title: 🍞 學生手工烘焙坊
description: 點擊下方連結查看我的作品

index.md

---
layout: default
---
# 歡迎來到我的網頁 🥐

### 快速導覽
* [🍰 查看美味產品](products.html)
* [📝 線上訂購](order.html)
* [📞 聯絡我們](contact.html)

contact.md

---
layout: default
title: 聯絡我們
---
# 聯絡我們的烘焙坊 📞

如果您有任何問題,歡迎透過以下方式聯絡:

* **地址**: 麵包鎮甜點路 123 號
* **電話**: (02) 1234-5678
* **Email**: bakery@example.com

[回首頁](index.html)

order.md

---
layout: default
title: 線上訂購
---
# 線上訂購說明 📝

請填寫以下資訊(目前僅供練習):
1. 產品名稱:
2. 數量:
3. 取貨時間:

*注意:這只是一個練習網頁,目前無法處理實際訂單喔!*

[回首頁](index.html)

products.md

---
layout: default
title: 美味產品
---
# 我們的招牌產品 🥖

這裡有我們每天現做的手工甜點:

### 巧克力可頌 (Chocolate Croissant)
![巧克力可頌](assets/img/choco.jpg)
香脆的外皮包裹著濃郁的巧克力。

### 草莓蛋糕 (Strawberry Cake)
![草莓蛋糕](assets/img/strawberry.jpg)
嚴選當季草莓,每一口都是幸福。

[回首頁](index.html)