教小白使用 docsify,搭建一個賊簡單的所見即所得博客!

語言: CN / TW / HK

作者:小傅哥
博客:https://bugstack.cn

沉澱、分享、成長,讓自己和他人都能有所收穫!😄

一、前言

看我博客挺好,你也想整一個?

有粉絲夥伴問小傅哥,你那博客:https://bugstack.cn 挺好的我也想整一個,面試寫到簡歷上還能加分,也是給自己建設影響力的東西。

不過我沒有自己的域名,也沒有一些雲服務器,還不太會前端的玩意。之後搞的太複雜我又沒有時間維護,那有沒有簡單點的方式,就能搞一個這樣博客呢?


那當然有哇,你傅哥玩過的博客類型那可多了去了,包括:hexo、vuepress、jekyll、docsify等,這些都能滿足你搭建博客的需求。但能滿足小白使用的,我強烈推薦 docsify 這貨簡直是傻白甜都能使用,直接在 GitHub/Gitee 維護一個文檔倉庫,就可以擁有一個漂亮、簡單、好用,易於維護和所見即所得的博客。

為什麼不用 CSDN、掘金、簡書?

當然可以用(擴大影響力),只不過這些都不是原稿存放平台,你的內容輸出需要被隨心所欲的維護和積累,以及將來需要的時候還可以放置到任何一個其他平台。而你寫在 GitHub 倉庫,就是最原始的那一份,其他的都是備份傳播,這樣更有益於你來沉澱、積累和分享。

接下來小傅哥就教你構建這樣一個博客,因為我已經幫你準備好了博客模板,所以在這個過程中,你只要跟着步驟,點點點,就部署完事了。那整吧咱們走起

二、docsify 介紹

docsify 可以快速幫你生成文檔網站。不同於 GitBook、Hexo 的地方是它不會生成靜態的 .html 文件,所有轉換工作都是在運行時。如果你想要開始使用它,只需要創建一個 index.html 就可以開始編寫文檔並直接部署在 GitHub Pages。官網:https://docsify.js.org/#/zh-cn

1. 目錄結構

  • docsify 的目錄結構配置非常簡單,如果你不需要修改的話,只是 md 目錄編寫文檔,在 _sidebar.md 配置文章路徑即可。
  • index.html 用於配置一些網站的基礎信息,包括:網站採集、留言板、地址等。
  • _coverpage.md 用於配置博客首頁的介紹信息和網站Logo等

2. md 説明

三、快速搭建博客

這裏給大家提供 GitHub/Gitee 兩種倉庫來搭建博客,方便有些小白訪問 GitHub 費勁也能用 Gitee 搭建博客。

1. GitHub Page

  • 優點:規範、部署不限制、自由度高、配置域名不收費
  • 缺點:國內訪問速度慢、倉庫不能設置私有

1.1 第一步:Fork

打開 https://github.com/fuzhengwei/fuzhengwei.github.io 點擊 fork 到自己的倉庫。

1.2 第二步:配置

  • 點擊 Setting 進入 General 配置工程名稱頁面。
  • 注意:你必須把 fuzhengwei.github.io 修改為你的名稱 xxx.github.io 這裏的 xxx 就是你的GitHub的名稱,也是 https://github.com/{xxxx} 鏈接後面的名稱,不要修改錯了,否則你就失敗了。

1.3 第三步:開啟

  • 點擊 Setting 進入 Page 頁面
  • 按照上圖修改博客資源空間到 docs 文件夾下,這個步驟是選擇博客空間地址,記得不要配置錯了。

1.4 第四步:訪問

好了,當你在配置後看到已經提醒你 Your site is published at https://fuzhengwei.github.io/ 證明你成功了,你可以訪問自己的博客地址了。PS:這裏要 xuewei 的等一下,因為初始化有一個過程,正在編譯稍後就可以訪問了。

2. Gitee Page

  • 優點:訪問速度快、博客倉庫可以設置私有
  • 缺點:不能配置自己的域名,需要上傳身份信息後才可以使用

2.1 第一步:導入

與使用 GitHub 不同,這裏是在 Gitee 中導入博客倉庫,如下:

2.2 第二步:配置

  • 服務Gitee Pages 進入即可進入配置博客頁面。
  • 不過由於大家基本都是初次使用 Gitee Pages 它會要求你上傳認證信息,一天內審核完成。

2.3 第三步:認證

  • 如果你到了這個頁面,可以提交資料後,第二天再繼續了。

2.4 第四步:開啟

  • 如果以上步驟都完事了,接下來你就可以開啟自己的博客了,同樣會給你一個博客地址,每次上傳新的文章點擊更新即可。

四、總結

程序員,為什麼要寫博客?

我,軟件工程畢業? 上學時覺得,畢了業就是開發工程師,但沒想到工作些年還成了 PPT 工程師。

為啥呢?因為寫代碼只是作為一個程序員的最基本能力,如果還想繼續在這條路上往前走,就需要有;提煉邏輯能力,制定標準手段、落地執行方案,而這一步步的推進都需要,就是將你的思考轉換為可以看得見的內容,無論它是PPT、拓撲圖、流程圖還是思維導圖,總之你需要一個合適的工具來表述你的想法,與溝通者最低成本完成消息傳遞和確認執行。

那麼對於程序員來説,這個代碼之外的能力成長,更好的方式則是編寫博客記錄分享積累沉澱,通過這樣一個過程來不斷的完善自己在內容表述上的能力,以及拓寬和拉伸自己的技術棧體系。

好嘞,現在你也擁有了一個可以像維護代碼倉庫一樣的文檔博客,並且隨着你的學習過程,不斷的完善、補充、沉澱,慢慢你終將會成為一名優秀的碼農大佬。加油!

如果你已經搭建好了,可以在評論區留下你的博客地址哦!