前语

缘由

一切源于酷爱

说出来自己都感动了,差点就信了。真正原因是参加了【掘金】的启航计划,活动期间有三篇文章被引荐到主页即可取得奖品。本狗秉承瞎猫碰到死耗子的决计,终究如愿蹭了一波福利。自此有些自豪膨胀,特来写一篇文章压压惊,以本狗实践写作流程为例,共享一下自己的写作套路与心得,更希望能以此激起广大博友的写作热情


首要目标

完成5大要点

  1. 怎样构思一篇成型的文章
  2. 把握博客文章写作的一般流程
  3. 怎样美化调优文章格局
  4. 了解写作博客常用的辅助东西
  5. 把握各大博客渠道的发布约束

水图

秀一波实体奖品

掘金编织袋 + click午睡枕 + 稀土掘金who cares 系列咖啡杯 + 优质创作证书实体证书

【干货】如何写一篇还算凑活的博客文章


猜你喜欢

文章引荐

【事故】记一次意外把公司项目放到GitHub并被fork,怎样运用DMCA下架政策保障隐私 【项目实战】SpringBoot+uniapp+uview2打造一个企业黑红名单吐槽小程序 【ChatGPT】手摸手,带你玩转ChatGPT 【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中项目接结构图
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497261-37a8843e7a71fb9.png)
想了解上图模块分层办法的同学,能够参阅[《还不会SpringBoot项目模块分层?来这手把手教你》](https://blog.csdn.net/baidu_25986059/article/details/128739849)
#### 生成到Apifox接口文档图
 在这里刺进图片描绘(https://img-blog.csdnimg.cn/1684e21db4784cdab5bfe0164ea9d8a8.png)
### ‍试用人群	
#### 1. 像本狗相同【偷闲】不愿意收拾接口文档
#### 2. 学习新颖文档生成及管理办法
******
]()

2.【正文】大模块

此模块解说此文章的要点,依据实践情况进行合理过程拆分,引领读者思维并进,按需解说所论述内容

【干货】如何写一篇还算凑活的博客文章

如本狗的Apifox Helper插件内容介绍,简单分为4步,经过怎样装置,再到怎样装备,最后实操测验,展示终究效果。此模块因人因项目而异,句子通畅通俗易懂解析即可。如下是本狗的一篇markdown的文章,供我们参阅,【Apifox Helper】主动生成接口文档,IDEA+Apifox懒人必备

![图片转存失利,建议将图片保存下来直接上传
        ##  正文

####  1.在IDEA装置【Apifox Helper】插件
> 点击File=>Settings,找到Plugins,输入 **Apifox Helper**,点击装置,然后等候成功后**重启IDEA**,必定重启才会收效!!!
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497268-8598d7c8a4e2104.png)
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497273-167fcb97122a939.png)
> Tips: 你能够挑选**同步到 Apifox 项目中,也能够直接导出 markdown 文档**。假如是同步到 Apifox 项目,你还需求下载或注册 [Apifox 软件](https://www.apifox.cn/),并检查下面【Apifox Helper】的装备规则。假如不需求则只需求在项目中找到需求生成文档的Controller,右键后Export Markdown,直接导出**apifox-api.md**到对应目录。
 在这里刺进图片描绘(https://img-blog.csdnimg.cn/bb4669b70f3e47959f9c37653d96353b.png)
> 翻开apifox-api.md文件检查
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497278-2673728a6f2649c.png)
******
####   2.修正【Apifox Helper】对应装备
> 点击File=>Settings=>Other Settings,找到 **ApifoxHelper**
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497283-7467be129f74182.png)
 ##### 1. Apifox服务器地址
 > https://api.apifox.cn
 ##### 2. API拜访令牌
> 翻开Apifox软件,点击左侧【头像】,点击【账号设置】,找到API拜访令牌
 在这里刺进图片描绘(https://img-blog.csdnimg.cn/0348be242df84f46836a7eedc21ce61a.png)
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497289-38a6726e20647d4.png)
******
> 点击新建令牌,填写名称及有效期,本狗填写名称为【IDEA专用】,有效期为【无限期】,点击【保存并生成令牌】
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497294-e21fda074533bee.png)
******
> 仿制令牌到IDEA中【Apifox Helper】装备项的API拜访令牌
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497300-e14b4988d366128.png)
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497305-dbc305636e38a07.png)
 ##### 3. 模块项目ID装备
> 翻开Apifox软件,新建项目,本狗项目名为【bkb】,并确认
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497310-28698e582db5d20.png)
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497315-7b609f976001521.png)
******
> 进入项目【bkb】,点击【项目设置】,点击【基本设置】,仿制项目ID
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497321-a39dde5e6ac8cdf.png)
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497327-57cd4d175b99918.png)
******
> 将上述仿制的【ProjectID】到IDEA中【Apifox Helper】装备【模块项目ID装备】,我的ModuleName为【bkb-boot-controller】,所以结构是bkb-boot-controller:xxxxx,点击【OK】
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497332-3d80981466d242f.png)
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497337-c117e6f49a80e1d.png)
******
####   3.生成文档
> 右击【bkb-boot-controller】模块,点击 【Upload to Apifox】,等候完成即可
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497342-40c6a67c4d28a1c.png)
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497347-b88223bf2d412fa.png)
******
####   4.检查Apifox中主动生成的文档
> 必定要点击下Apifox软件右上角的改写!
> 必定要点击下Apifox软件右上角的改写!
> 必定要点击下Apifox软件右上角的改写!
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497352-044d1ee4cc9732c.png)
> 检查效果,大功告成,之后便可为所欲为了
 在这里刺进图片描绘(https://www.6hu.cc/wp-content/uploads/2023/04/1681497358-151592f016eff09.png)
******
]()

3.【总结】大模块

此模块以归纳为主,总览全文,总结为主。如下是本狗的一篇markdown的文章,供我们参阅,【SpringBoot】还不会SpringBoot项目模块分层?来这手把手教你

【干货】如何写一篇还算凑活的博客文章


辅助东西

1.emoji常用图标库

funletu.com/emoji/

文章中有许多当地运用了emoji图标表情,此网站仿制即用

【干货】如何写一篇还算凑活的博客文章

2.Markdown排版利器

md.aclickall.com/

经过此东西可将单调的markdown文件美化,转变成对应精巧的HTML页面,模板样式可选,并支持代码自定义

【干货】如何写一篇还算凑活的博客文章

3.封面图选材网站

www.pexels.com/zh-cn

经过此东西可选取封面图,终究重要的是免费且图片科技感十足

【干货】如何写一篇还算凑活的博客文章


干流博客渠道

共享一下本狗平时发布的博客渠道

1.csdn

blog.csdn.net/

2.稀土掘金

/

3.博客园

www.cnblogs.com/

4.51CTO

home.51cto.com/

5.segmentfault思否

segmentfault.com/

总结

本文经过程序员视点出发,介绍了写作博客的整体思路及流程。以本狗实践写作为基础,向我们介绍了一般写作的套路。以上过程仅是本人的一点拙见,希望能给我们一点帮助。

【干货】如何写一篇还算凑活的博客文章

JavaDog 狗屋地址
个人博客 blog.javadog.net
大众号 mp.weixin.qq.com/s/_vgnXoQ8F…
CSDN blog.csdn.net/baidu_25986…
掘金 /user/217229…
知乎 www.zhihu.com/people/Java…
简书 www.jianshu.com/u/1ff9c6bdb…
gitee gitee.com/javadog-net
GitHub github.com/javadog-net
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。