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

GitHub Pages#

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

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

Sphinx#

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

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

目錄#

  1. 基礎環境設定

  2. 網站架構

  3. 常用語法與 Documents