# 如何使用 GitHub Pages 以及 Sphinx 套件建立個人網頁

```{toctree}
:hidden:
:maxdepth: 1

foundation
skeleton
note
```

## GitHub Pages

GitHub Pages 是 GitHub 提供的免費靜態網站託管服務，讓您可以直接從 GitHub 儲存庫建立和發布網站。

這篇文章的目的是使用 GitHub Pages 作為平台但用 Sphinx 產生靜態的 html/css 。

## Sphinx

Sphinx 是一個功能強大的文件生成工具，最初為 Python 文件而開發，現在廣泛用於建立各種技術文件和網站。

這篇文章的目的是要講解如何使用 Sphinx 套件製作個人網頁的內容。 Sphinx 預設是使用 `.rst` 來產生 html ，但是可以搭配其它外掛套件讓 Sphinx 可以支援 `markdown` 格式。這個 Project 主要是使用 markdown 格式。

## 目錄

1. [基礎環境設定](./foundation.md)
2. [網站架構](./skeleton.md)
3. [常用語法與 Documents](./note.md)