本文由突破自己、写作心得、写作技巧和写作辅助工具四部分组成,每个部分都有不同的侧重点。希望阅读完本文之后,能对大家能所有启发或帮助。好的,废话不多说,我们马上进入正题。
突破自己
人最大的敌人是自己
2014 年 阿宝哥 完成了 JavaEE 开发者到 Web 前端开发者角色的转换,也开启了个人博客之旅。时间一晃来到了 2017 年,那一年阿宝哥开始在思否写 Angular 修仙之路专栏,目前该专栏已有 「156」 篇原创文章。其实开始写专栏的时候,也犹豫了好多天。因为始终觉得写专栏是很慎重的一件事情,另外又很担心自己写的文章,质量不够好,不能给读者带来价值或启发,然后被读者 ”吐槽“。
在纠结了很多天之后,阿宝哥最终下定了决心,因为想清楚了自己的初衷。那时候刚好公司项目要从 AngularJS 升级到 Angular 2,所以阿宝哥要重新开始学习 Angular 2 相关的技术。那时国内 Angular 2 的学习资源很少,官方文档主要还是英文的,学习起来相对比较吃力。
在学习过程中自己也走了不少弯路,也遇到了挺多难点,为了让别人少走弯路,同时做好个人的知识沉淀,想清楚自己的初衷之后,阿宝哥迈出了第一步。之后,阿宝哥很用心输出了几篇文章,收到了读者不错的评价。这给阿宝哥很大的鼓励,也就开启了疯狂输出的模式,最终收获了思否两季 Top Writer 和思否年度优秀文章作者。
说来惭愧,后面由于某些原因,Angular 修仙之路专栏 就断更了。直到 2019 年 11 月受到好友 前端自习课 号主 “安总” 的影响,阿宝哥又继续开始写作。他坚持每天不间断发文,截止 2020 年 11 月 29 日,他已经连续更新 792 天,这种毅力和恒心非常人能及,前端的小伙伴们可以多多关注他哟。
2020 年是不平凡的一年,今年阿宝哥也迈出了一大步,写了三本免费的 PDF 电子书。此外,在不断地努力下,掘金等级也从 Lv3 升到了 Lv6,这里衷心感谢掘金老铁和公众号粉丝一直以来的鼓励与支持🌹🌹🌹。
关注「全栈修仙之路」阅读阿宝哥原创的 3 本免费电子书(累计下载近2万)及 50 几篇 “重学TS” 教程。
为什么开篇阿宝哥会讲述如何 “突破自己” 呢?这是因为阿宝哥经常鼓励身边的同事或好友到 掘金、思否 等技术社区写博客,细聊之后发现他们大部分人也有阿宝哥当初写 Angular 修仙之路专栏 的困惑,害怕文章写得不够好,不能给读者带来价值或启发,被读者 “吐槽”。因此,阿宝哥也跟他们分享了自己的写作经历与心得,之后他们中的一些人终于迈出了第一步,开始在技术社区发文了。当然,有点可惜的是,很多人只是迈出了第一步,没有再继续坚持了。
好的,接下来我们步入正题,阿宝哥将分享这几年的写作心得。
写作心得
如何选定主题
如何选定写作主题,相信这对很多小伙伴来说是一个比较头疼的问题。针对这个问题,阿宝哥有以下几个方向供参考:
当然,上面只是列举了一小部分,其他的写作方向,大家可以参考一下技术社区的排行榜或者分析一下你所关注的技术大佬,平时都是写哪些类型的文章。相信一些小伙伴们写简历时,也很头疼不知道写哪些内容。简历上的项目经验,只是介绍用了什么技术栈,开发了什么功能。其实这些内容对面试官来说,并没有多大的参考价值。他们更希望在你的简历中,看到项目中的亮点和难点或者你对项目或团队可量化的贡献度。
那么如何找到项目的 “亮点” 呢?“生活中不是缺少美,而是缺少发现”。同样,在完成项目的某个功能之后,可以多问问自己。比如,这个功能背后的技术,自己掌握了么?有没有其他相关的技术?这项技术还有哪些应用场景?这项技术有没有什么缺点?这个功能还能不能做得更好?等等。当你慢慢养成这种习惯之后,你的写作素材会变得越来越多。然而当你定好写作方向时,接下来该如何开始写作呢?
如何开始写作
当你定好写作方向后,阿宝哥建议你先不急着动手,而是先想好文章的大纲。这里阿宝哥以 “你不知道的 XXX” 系列文章为例,来介绍一下写 Web API 文章的通用大纲:
整个系列文章大纲的结构基本一致,对应的通用大纲如下所示:
- XXX 是什么/ 什么是 XXX
- XXX API 简介
- XXX 应用场景
- XXX 与相关知识点的区别
如果你也想写 Web API 相关的文章,可以试试阿宝哥介绍的通用大纲。那如果写非 Web API 的文章,应该怎么办?针对这种情形,你可以在主流的技术社区搜索相关类型的文章,挑选阅读量和点赞量较多的文章,然后分析一下这些文章的目录结构,进而整理一份适合自己的目录结构。
定好文章的目录结构之后,你就可以开始写作了。接下来,阿宝哥将分享一些写作技巧。
写作技巧
当然除了上述的写作技巧之外,阿宝哥还有以下几个写作建议:
- 写技术文章时,若用到一些重要的概念或技术的话,最好能提前做一些解释;
- 文章中引用的代码,最好能标识一下路径。如果是自己写的可执行代码,最好能运行一下,保证一下代码的正确性和可用性;
- 尽量减少读者的不必要的操作,为引用的内容添加快速链接。比如介绍一些不错的开源项目,不仅仅是给出开源项目的名称,最好还能为每个开源项目添加一个快速链接,避免感兴趣的读者还得手动进行搜索;
- 写文章时,多画图,特别是源码分析的文章,避免贴一大堆代码;不知道怎么画图的话,可以利用搜索引擎,使用相应的关键字进行搜索,然后筛选一些不错的图片进行参考;
- 写完文章后,最好能自己校对 1-2 遍,避免出现过多的错别字,影响读者体验;
- 写完文章后,建议发到主流的技术社区,这样的话,你不仅可以让更多人看到你的文章,还可以收到不同读者的反馈。如果文章对其他人有所帮助的话,你还能得到读者的认可与鼓励,从而让你拥有继续写作的动力。当然如果你写的文章质量都比较高,你还能建立自己的个人品牌,这对以后的发展还是挺有帮助的。
另外,如果你对如何写源码分析的文章感兴趣的话,可以阅读一下 使用这些思路与技巧,我读懂了多个优秀的开源项目 这篇文章。俗话说得好,“工欲善其事,必先利其器”,最后阿宝哥将介绍一些自己常用的写作辅助工具。
写作辅助工具
Markdown 工具
Typora
Typora —— 一款 Markdown 编辑器,可用于写文章和制作 PDF 电子书。
(图片来源:https://typora.io/)
Markdown Nice
Markdown Nice —— 在线 Markdown 排版工具,支持微信公众号、知乎和掘金。
(图片来源:https://mdnice.com/)
绘图工具
drawio
DrawIo —— 一款免费的绘图工具,支持绘制流程图、实体关系图和系统架构图等。
(图片来源:https://www.diagrams.net/)
ProcessOn
ProcessOn —— 在线作图、实时协作,支持流程图、思维导图、原型图、UML、网络拓扑图、组织结构图等。
(图片来源:https://www.processon.com/)
excalidraw
excalidraw —— 虚拟白板,用于绘制手绘的示意图。
(图片来源:https://github.com/excalidraw...)
其实画完图之后,还有一个很重要的环节,即图形配色。好的配色能让你画的图,更高端大气。这里阿宝哥推荐两个在线配色的网站:https://colordrop.io/ 和 https://coolors.co/。
源代码处理
Carbon
Carbon —— 创建并共享源代码的精美图片。
(图片来源:https://carbon.now.sh/)
UML 生成
TypeScript UML Playground —— 在线 TypeScript UML 图生成。
文章封面
当你写完文章之后,如果要发到微信公众号或掘金上,你还需要为你的文章配一张封面。这时你可以考虑使用 创客贴 或 凡科快图 等在线的设计工具,从而利用平台提供的模板来快速设计文章封面。而阿宝哥用得比较多的是从 pixabay 和 pexels 这两个免费的图片素材库挑选封面。
pixabay
Pixabay —— 可免费使用的正版高清图片素材库
(图片来源:https://pixabay.com/zh/)
pexels
Pexels —— 免费和图片和影片库。
(图片来源:https://www.pexels.com/)
上面介绍的工具都是 阿宝哥 在写作过程中常用的辅助工具,如果你有其他不错的工具欢迎给阿宝哥留言。当然如果你在写作时,有遇到问题或困惑的话,也可以随时跟阿宝哥交流哟。
关注「全栈修仙之路」阅读阿宝哥原创的 3 本免费电子书(累计下载近2万)及 8 篇源码分析系列教程。
这么多年下来,个人感觉写作是一个很不错的知识输出方式,通过写作可以让你对输入的知识进行消化和吸收。阿宝哥这几年坚持下来,感觉收获蛮大的。不仅仅是写作能力,思考/总结能力和画图能力都有挺大的提升。希望看完这篇文章之后,还没迈出第一步的小伙伴能给自己定个小目标,勇于突破自己,开始开启你的写作之旅。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。