跳至主要内容

2 篇文章 含有標籤「SSG」

SSG tag description

檢視所有標籤

用Docusaurus搭配GitHub Pages建置免費個人部落格

· 閱讀時間約 13 分鐘
雷哥
程式技術天守閣站長

先前介紹過一套靜態網站產生器 (Static Site Generator, SSG) — Jekyll,可完美搭配GitHub Pages使用,快速產生個人Blog建置。而今天要介紹另一套高效有趣的靜態網站產生器 — Docusaurus,有著相當可愛的恐龍Logo,他是由Facebook發起的開源專案 (正確說是Meta)。Jekyll使用的是Ruby作為建構基礎,而Docusaurus則是以node.js作為建置核心,若對node.js較為熟悉的朋友則可以快速的上手與使用。

特色

使用支援React的MDX Markdown語法

由於有Facebook的血統在,因此這套SSG很本能的可以與Meta自家技術React作擴充,結合了Markdown語法,算是Docusaurus的一大特點。

這裡所說到的,就是MDX,簡言之就是讓Markdown語法支援JSX,可以在Markdown裡引入元件,並有機會達成React的元件共用的優勢。有關MDX,可參考其官網。這裡就不詳細說明,總之,Docusaurus除了單純撰寫Markdown的文件外,讓如果原本對React技術熟悉的人,可以有機會讓文件多出一些互動功能(例如互動圖表)的可能性。

用Jekyll搭配GitHub Pages來寫Blog

· 閱讀時間約 10 分鐘
雷哥
程式技術天守閣站長

什麼是GitHub Pages

GitHub Pages是GitHub網站透過免費的公開儲存庫(public repository)來建立網頁,並且可輕鬆改變網站主題風格,也可打造專屬的404錯誤頁面,還能使用HTTPS的安全防護 (但如果使用自己申請的domain就要額外自行申請SSL憑證)。簡言之,就是透過GitHub Pages的擴充性,讓原本作為程式碼管控的儲存庫,搖身一變也能成為一個個人網站。GitHub並且貼心的提供了對應的公開網址給使用者,當然若是你有自己申請的網址,還可進行指定,省去了租雲端主機的龐大費用。

image-20210703013051609