【干貨】如何寫一篇還算湊活的博客文章
1. 如何構思一篇成型的文章
2. 掌握博客文章寫作的一般流程
3. 如何美化或調優文章格式
4. 了解寫作博客常用的輔助工具
5. 掌握各大博客平臺的發布限制
前言
??緣由
一切源于熱愛
說出來自己都感動了，差點就信了。真正起因是參加了【掘金】的啟航計劃，活動期間有三篇文章被推薦到首頁即可獲得獎品。本狗秉承瞎貓碰到死耗子的決心，最終如愿蹭了一波福利。自此有些驕傲膨脹，特來寫一篇文章壓壓驚，以本狗實際寫作流程為例，分享一下自己的寫作套路與心得，更希望能以此激發廣大博友的寫作熱情。
??主要目標
實現5大重點
-
如何構思一篇成型的文章
-
掌握博客文章寫作的一般流程
-
如何美化或調優文章格式
-
了解寫作博客常用的輔助工具
-
掌握各大博客平臺的發布限制
??水圖
秀一波實體獎品
掘金編織袋 + click午睡枕 + 稀土掘金who cares 系列咖啡杯 + 優質創作證書實體證書
??猜你喜歡
文章推薦
【事故】記一次意外把公司項目放到GitHub并被fork，如何使用DMCA下架政策保障隱私
【項目實戰】SpringBoot+uniapp+uview2打造一個企業黑紅名單吐槽小程序
【ChatGPT】SpringBoot+uniapp+uview2對接OpenAI，帶你開發玩轉ChatGPT
【模塊分層】還不會SpringBoot項目模塊分層？來這手把手教你！
正文
??寫作前置問題
為什么寫？在哪寫？怎么寫？ 通過三個問題進行剖析
1??.為什么要寫博客？
鑒于本狗多年經驗分析，大致分為以下幾種情況
1. 知識積累，自我總結型 ??
通過自我反思，自我總結，將自己開發過程中遇到的問題進行收集整理，記錄以作后用
2. 技術大佬，炫技分享型 ??
像各大博客論壇中的博客之星，開發經驗的沉淀積累，大廠履歷的工作分析。將自己的經驗及履歷總結，分享以指導后輩
3. 技術引流，廣告推廣型 ??
通過技術博客進行流量引入，使用付費文章或者廣告形式植入，在分享的同時，盡可能的引流變現。
2??.把博客寫在哪里？
1. 本地存儲
?優點：寫作靈活，無敏感詞限制
?缺點：分享方式單一，容易丟失
2. 主流技術博客平臺
?優點：分享靈活，SEO優化好
?缺點：敏感詞限制，平臺有各自推薦算法，需保證持續更新
3. 個人博客網站
?優點：分享靈活，無敏感詞限制，有自己的招牌
?缺點：SEO優化及數據分析需自己處理
3??.怎么寫博客?
1. 梳理知識架構
整理技術內容，如寫一篇SpringBoot技術文章，則需要梳理知識點，讓看文章的人或者自己通讀起來順暢，讓讀者有一個大致的思維概念
2. 選擇展現形式
寫作特點因人而異，有的是詼諧漫畫寫作形式，有的是科技感文字配圖，有的是搞笑搞怪的諧音梗。選擇因人而異，表達本意，能吸引讀者即可
3. 突出重點目標
標明目標或重點內容，讓讀者有側重點
4. 組織表達語句
一百個人有一百個哈姆雷特，需要將自己理解消化的知識點轉化成通俗易懂的大白話，合理輸出
5. 總結歸納整理
善于總結歸納，將整篇內容揉碎，篩除精華
??大佬們別著急劃走，磨刀不誤砍柴工，下面才是重點?。?！
??具體實操
梳理完前面問題之后，我們心里就有了大致的草圖，以步驟下為本狗實際寫作流程，可選擇參考
1.【前言】大模塊
前言模塊總覽
【緣由】
介紹寫作緣由，一個開篇引入，言簡意賅，詼諧描述即可
【閱讀時長】
本文閱讀時長預估，可以根據文章字數估計出大概閱讀時間，讓讀者通過時間有個文章長短概念
【前置條件】
有些文章講解可能需要前置條件，如介紹SpringBoot+uniapp實操項目，前提必須告知用戶需要準備如IDEA/HBuilderX等開發工具，提醒讀者做好準備
【主要目標】
目標前置，將本文主要目標著重標識
【水圖】
再細致的文字也不如圖片吸引人，沒圖還說個JB啊，圖片加文字更有代入感
其余可根據個人喜好，梳理明確即可，如下是本狗的一篇markdown的文章，供大家參考，【Apifox Helper】自動生成接口文檔，IDEA+Apifox懶人必備
## 前言
### ??緣由
#### 接口文檔對接爽，整理起來真費腦
對于**整理API文檔**，本狗秉承偷懶為上的原則，想找一種**在IDEA中直接生成文檔**的方法。**Apifox Helper**絕絕子，只需要在**IDEA中下載插件**，無腦配置后，**文檔自動生成到Apifox**，美完美解決。并且**顏值及方便程度**絕比Swagger和postman好太多。
### ??本文閱讀時長
#### 約10分鐘
### ??前置條件
#### 1. IDEA開發工具
#### 2. Apifox(不必要)
### ??主要目標
#### 一秒生成接口文檔
### ??水圖
#### IDEA中項目接結構圖
想了解上圖模塊分層方法的同學，可以參考[《還不會SpringBoot項目模塊分層？來這手把手教你》](https://blog.csdn.net/baidu_25986059/article/details/128739849)
#### 生成到Apifox接口文檔圖
### ?????試用人群
#### 1. 像本狗一樣【偷懶】不愿意整理接口文檔
#### 2. 學習新穎文檔生成及管理方式
******
2.【正文】大模塊
此模塊講解此文章的重點，根據實際情況進行合理步驟拆分，引領讀者思想并進，按需講解所闡述內容
如本狗的Apifox Helper插件內容介紹，簡單分為4步，通過如何安裝，再到如何配置，最后實操測試，展示最終結果。此模塊因人因項目而異，語句通順通俗易懂解析即可。如下是本狗的一篇markdown的文章，供大家參考，【Apifox Helper】自動生成接口文檔，IDEA+Apifox懶人必備
## 正文
#### ??1.在IDEA安裝【Apifox Helper】插件
> 點擊File=>Settings，找到Plugins,輸入 **Apifox Helper**，點擊安裝，然后等待成功后**重啟IDEA**,一定重啟才會生效?。?！
> ??Tips: 你可以選擇**同步到 Apifox 項目中，也可以直接導出 markdown 文檔**。如果是同步到 Apifox 項目，你還需要下載或注冊 [Apifox 軟件](https://www.apifox.cn/)，并查看下面【Apifox Helper】的配置規則。如果不需要則只需要在項目中找到需要生成文檔的Controller，右鍵后Export Markdown,直接導出**apifox-api.md**到對應目錄。
> 打開apifox-api.md文件查看
******
#### ??2.修改【Apifox Helper】對應配置
> 點擊File=>Settings=>Other Settings，找到 **ApifoxHelper**
##### 1. Apifox服務器地址
> https://api.apifox.cn
##### 2. API訪問令牌
> 打開Apifox軟件，點擊左側【頭像】，點擊【賬號設置】，找到API訪問令牌
******
> 點擊新建令牌，填寫名稱及有效期，本狗填寫名稱為【IDEA專用】，有效期為【無限期】，點擊【保存并生成令牌】
******
> 復制令牌到IDEA中【Apifox Helper】配置項的API訪問令牌
##### 3. 模塊項目ID配置
> 打開Apifox軟件，新建項目，本狗項目名為【bkb】,并確認
******
> 進入項目【bkb】，點擊【項目設置】，點擊【基本設置】，復制項目ID
******
> 將上述復制的【ProjectID】到IDEA中【Apifox Helper】配置【模塊項目ID配置】，我的ModuleName為【bkb-boot-controller】，所以結構是bkb-boot-controller:xxxxx,點擊【OK】
******
#### ??3.生成文檔
> 右擊【bkb-boot-controller】模塊，點擊 【Upload to Apifox】，等待完成即可
******
#### ??4.查看Apifox中自動生成的文檔
> 一定要點擊下Apifox軟件右上角的刷新！
> 一定要點擊下Apifox軟件右上角的刷新！
> 一定要點擊下Apifox軟件右上角的刷新！
> 查看成果，大功告成，之后便可為所欲為了
******
3.【總結】大模塊
此模塊以概括為主，總覽全文，總結為主。如下是本狗的一篇markdown的文章，供大家參考，【SpringBoot】還不會SpringBoot項目模塊分層？來這手把手教你
??輔助工具
1.emoji常用圖標庫
文章中有很多地方使用了emoji圖標表情，此網站復制即用
2.Markdown排版利器
通過此工具可將單調的markdown文件美化，轉變成對應精美的HTML頁面，模板樣式可選，并支持代碼自定義
3.封面圖取材網站
通過此工具可選取封面圖，最終重要的是免費且圖片科技感十足
??主流博客平臺
分享一下本狗平時發布的博客平臺
1.csdn
2.稀土掘金
3.博客園
http://www.otorinolaringoiatradellepiane.com/
4.51CTO
5.segmentfault思否
總結
本文通過程序員角度出發，介紹了寫作博客的整體思路及流程。以本狗實際寫作為基礎，向大家介紹了一般寫作的套路。以上步驟僅是本人的一點拙見，希望能給大家一點幫助。
| JavaDog| 狗屋地址 |
| :----?? :----: |
| 個人博客 | https://blog.javadog.net |
| 公眾號 | https://mp.weixin.qq.com/s/_vgnXoQ8FSobD3OfRAf5gw |
| CSDN | https://blog.csdn.net/baidu_25986059 |
| 掘金 | https://juejin.cn/user/2172290706716775|
| 知乎 | https://www.zhihu.com/people/JavaDog |
| 簡書| https://www.jianshu.com/u/1ff9c6bdb916 |
| gitee|https://gitee.com/javadog-net |
| GitHub|https://github.com/javadog-net|
posted on 2023-03-31 14:49 JavaDog程序狗 閱讀(353) 評論(4) 編輯 收藏 舉報
