?如何寫一篇技術部落格,談談我的看法

Java3y發表於2019-11-25

前言

只有光頭才能變強。

文字已收錄至我的GitHub精選文章,歡迎Stargithub.com/ZhongFuChen…

我一直推崇學技術可以寫技術部落格去沉澱自己的知識,因為知識點實在是太多太多了,通過自己的部落格可以幫助自己快速回顧自己學過的東西。

我最開始的時候也是隻記筆記,認為自己能看得懂就好。但如果想驗證自己是不是懂了,可以寫成技術部落格。在寫技術部落格的過程中肯定會發現:“這個知識點,我好像還有些沒搞懂”。

從梳理/編寫的過程,自己也會成長不少

有不少的小夥伴曾經問過我:

  • “3y你是怎麼記筆記的阿?我一邊看視訊一邊記筆記,顧頭不顧腚的”
  • “你寫的部落格都是怎麼思考的阿?我不會寫部落格”

不會寫技術部落格/筆記

下面來談談我一些觀點(個人/主觀),每個人都有自己的方法論,我的觀點不適用於所有人。

開局一張圖,內容全靠編:

?如何寫一篇技術部落格,談談我的看法

一、如何寫一篇技術部落格

首先,我認為要把自己當做是一個分享者,而讀者是一個小白。然後模擬這個場景:如果你要把你學習到的技術分享給小白,你需要怎麼去做。

按照我的思路,我可能會這樣做:

  • 首先,這項技術是什麼你得先告訴他。
  • 接著,為什麼要學習這項技術,學習了這項技術有什麼好處。有沒有以前的技術跟這個較為相似的,為什麼我不用以前的,而要學新的。(這一步非常非常重要
  • 然後,這項技術的核心用法是什麼,給出一些小案例,讓小白體驗到這項技術。
  • 最後,用這項技術可能會出現什麼問題,官方有沒有提供方案解決,如果沒有,可能的解決方案有哪些。

大白話來說,其實就是:

  • 是什麼
  • 為什麼
  • 怎麼做

一般來說,我會把重點放在 為什麼 ,因為我一直認為學習一門技術一定得知道:為什麼要學

舉個例子,我當初寫【訊息佇列】的思路:

  • 回顧一下什麼是佇列,Java已經支援各種型別的佇列了,跟訊息佇列有什麼不同。
  • 為什麼要用訊息佇列,不用行不行?用訊息佇列的好處有哪些
  • 用了訊息佇列可能會帶來的問題

如果遇到邏輯可能較為複雜,或者認為讀者會看不太懂的時候,可以畫圖來描述一下,這樣整一篇文章看下來就不會太枯燥。

其實吧,我寫文章都是按自己學習時的思路來寫。如果我在學習時中途某個地方卡住了,我就認為可能讀者在學習的時候也會存在同樣的問題。所以,我就把我的理解給記錄下來,如果有必要就畫圖來講解。

我寫了兩百多篇Java技術部落格,有需要的同學可以關注我的GitHub,歡迎一起學習和交流:github.com/ZhongFuChen…

關注我的公眾號,看一下我是怎麼寫技術部落格的

二、文章需要有自己的風格

每個人寫出來的部落格都有自己的風格。

比如說有漫畫型的:

?如何寫一篇技術部落格,談談我的看法

比如說有故事型的:

故事型講解

比如說有騷氣型的:

騷氣型

比如說有純乾貨型的:

純乾貨

說了這麼多,其實我想說的是:寫部落格應該要帶有屬於自己的風格。而不是把網上的資料直接複製貼上就完事了,這樣沒有感情,沒有靈魂。(當然了,如果網上可能的確有寫得很好的,可以這麼做,但不可能整一篇都是相同的嘛)

三、關於排版

一篇好的技術文章,它的排版一般不會差。我認為寫技術文章有幾點可以提高一下閱讀體驗

  1. 整篇文章不要90%都是程式碼,適當減少程式碼,貼關鍵的部分就好了。(完整的程式碼可以上傳到GitHub)
  2. 多分段,技術文章可能就相對枯燥,如果將技術的說明擠在一塊,可能閱讀起來沒那麼好的體驗
  3. 增加圖示說明 or 插入相關的圖片

程式設計師寫文章一般都用Markdown語法了,使用恰當的話,文章的排版自然也不會太差啦。所以還沒用Markdown語法的同學可以趕緊用起來,這玩意特好學,從學到用起來就幾分鐘。

  • 我當時連簡歷都是Markdown語法...

?如何寫一篇技術部落格,談談我的看法

四、關於工具

Markdown編輯器我推薦使用Typora,無論是在Mac還是在Windows上都很好用。使用Markdown就肯定要考慮一個問題:圖床用哪家

無論使用哪家圖都有可能會掛,自己搞個圖床可能會安全一些(相對來說會比較麻煩),我自己是使用掘金的圖床的。而我的文章往往會分發到幾個部落格網站上,像簡書/知乎這種會單獨將圖片上傳到他們的伺服器上。

所以,從我個人的使用角度而言,並不會擔心圖床會掛問題。如果你將文章傳送到一個平臺中,還是得關注一下圖床是否可能失效的問題。

?如何寫一篇技術部落格,談談我的看法

至於你發哪個平臺,我曾經寫過一篇【程式設計師可以選擇哪些平臺寫技術部落格?】,當時的總結:

  • 如果不嫌棄部落格園的風格,可以選擇部落格園。否則建議選擇:掘金/SegmentFault
  • 只想管理自己寫過的文章,選擇:GitHub/GitBook
  • 喜歡折騰:Hexo+GitHub或者WordPress

簡單的流程圖/思維導圖/..可以使用ProcessOn就解決掉了。

最後

有的沒的扯了一些,希望能夠對「有想要寫技術部落格,但無從下手的同學」一些幫助。

本已收錄至我的GitHub精選文章,歡迎Stargithub.com/ZhongFuChen…

樂於輸出乾貨的Java技術公眾號:Java3y。公眾號內有300多篇原創技術文章、海量視訊資源、精美腦圖,關注即可獲取!

轉發到朋友圈是對我最大的支援!

非常感謝人才們能看到這裡,如果這個文章寫得還不錯,覺得「三歪」我有點東西的話 求點贊 求關注️ 求分享? 求留言? 對暖男我來說真的 非常有用!!!

創作不易,各位的支援和認可,就是我創作的最大動力,我們下篇文章見!

相關文章