☰
sk5s 自主學習Time

第3天 2021/09/29

Jump to Section

javascript、nodejs、npm使用練習，試寫簡單網站，紀錄於Hugo，github pages、gitlab pages、heroku、vercel 架設靜態網站並綁定已購買之網域

心得

今天的排定進度是要練習javascript和nodejs，之前已經練習做了alsoweather天氣網頁應用程式，所以這一節課最後改成建立docsify docs website 練習，docsify 是一個可以讓人簡單建立使用文件的一個工具，只要安裝好之後，所有用markdown寫成的文字檔就可以直接被顯示在網頁上面，本來我想要使用的文件網站工具是vuepress，在經過比較之後，決定改成使用docsify，因為vuepress的設定較複雜，雖然在某些方面vuepress較有優勢，不過docsify就已經符合需求了。最後在一節課之內完成了網頁的部分了，已經上傳到github，網址：https://sk5s.cyou/alsoweather/docs/#/

docsify

docsify logo

docsify

A magical documentation site generator.

pros

  • 無需生成，寫完文檔直接發布
  • 容易使用而且輕量 (壓縮後 ~21kB)
  • 全文搜尋
  • 提供多套主題
  • 豐富的 API
  • 支持 Emoji
  • SPA
  • hash routing
  • addon 簡易安裝

cons

  • SEO不友善
  • 無法直接離線觀看
  • 載入有時較緩慢

vuepress

vuepress logo

VuePress

Vue-powered Static Site Generator

pros

  • 内置的 Markdown 擴展
  • 在 Markdown 中 使用 Vue
  • Vue驅動的自定義主題
  • Plugin
  • SEO友善
  • 靜態網頁
  • SPA

cons

  • Vue-powered 較複雜
  • 要生成靜態網頁
  • 較難設定
  • 需安裝多個依賴套件
  • 容易出錯
  • alsoweather docsify docs website