软件开发人员致力于设计、编码、测试和交付我们每天使用的软件。不管开发人员的专长是什么,他们对很多事情都很了解——这也就意味着他们应该分享这些知识。

作为开发者,将我们所学到的知识通过发布文章和创建视频内容的形式分享出去,是一个很棒的方式。你可以拥有自己的博客,也可以为专栏撰稿。不管是哪种,你都可以遵循特定的流程来好好创作。

本文将介绍博客写作的基础知识,以帮助开发者撰写出色的文章。

TL;DR

以下高度总结了大部分要点。但是,我们将更详细地讨论一些现实生活中的经验以及学习如何写博客。请继续往下看。

高质量的内容写作是一个过程,它需要:

👉 计划

👉 研究内容

👉 审核

👉 发布时间

👉 最重要的,写作的意图

为产出高质量的内容花一些时间是值得的,不要着急。

— Tapas Adhikary (@tapasadhikary) 2021.04.03

了解你的目的

intent

当我们开始做某事时,都需要一个目的,以及继续做它的动力。我们行动背后的意图和动机,因人而异。你需要找到你的意图或目的,能够解释为什么你要开始创建一个博客或分享内容。

在大多数情况下,简单的答案可能是激情。很有道理!它也可能是一种商业策略,或者你想教别人。也许你想持续学习——不管你是因为什么原因开始写作,都很棒。

作为一个开发者,我们一直在学习新东西。记住我们所学的每一部分知识几乎是不可能的。当我们记录那些教训和信息时,这些知识也就可以被重用了。

这就是为什么写一篇关于你最近学到的东西的文章,是一个很好的主意,这就是一个好的意图。

💡 小提示: 创建一个私人 GitHub 仓库,以及一个 markdown 文件。当你遇到新事物时,在这个文件中添加注释(如果需要的话还可以加代码)。

这个文件的内容将作为你今后文章的优秀资源。出于这个目的,我在维护一个名为 TIL_2021.md 的文件(记录了我 2021 年学到的东西)。

当决定写博客时,我打算通过分享知识来学习。如果你想深入学习一些东西,请开始教别人。写博客就是一个很棒的方式。

找到你的动机

motivation

拥有动机可以创造奇迹,但是没有它就很难继续做下去。作为内容创作者,最大的动力无疑是听到读者的反馈。积极的反馈和建设性的批评总是可以帮助你改进创造的内容。

但是有个问题,刚开始,很少有人会给你反馈。如果你是一个个人博主,失望的概率会很高。因此,拥有自我激励,对维持和继续你的工作是很有帮助的。

记住——不要放弃,保持动力。作为开发人员,你有很多东西要学习、分享和撰写。

💡 小提示: 如果你想以开发者的身份开始写博客,开发者社区有助于你保持联系、保持动力。有很多极其精彩的社区,如 HashnodeDev.toCodenewbieHackernoonfreeCodeCampGirlsWhoCode等,还有很多。

做好你的研究

research

研究是关键。内容决定一切。

对博客来说,内容为王。作为开发者,我们有各种各样的想法、解决问题的步骤,以及想要掌握的新知识。但是最重要的是能把它们转化为优质的内容。通常,花时间把你的话题彻底研究明白,是很有必要的。

现在我来举一个关于内容研究的例子。假设你用链表解决了一个问题,而且是你第一次使用,你非常激动,想把学到的分享出来,以下是需要考虑的点:

  • 你需要大致理解链表以及已经被解决的问题的上下文
  • 你需要理解链表的优缺点
  • 你需要创建几个例子来演示如何用好它
  • 你需要确保清楚地解释了你解决问题的方法,这样读者才能在他们自己的案例中使用

💡 小提示: 一旦明白了你需要知道什么,你就可以从任何完备的资源中进行学习。你可以在 GoogleQuoraReddit 等上面进行搜索。Stackoverflow 同样也是一个优秀的平台,你可以用它来检索你的话题。

确保在取得进步时记下所学的内容,这些笔记最终将转化成你要撰写和发布的文章。

规划你的内容结构

plan

一旦完成了内容研究,下一步就是规划文章的结构。如果你的文章结构不完整而且混乱,那么再好的内容也会被读者忽略。

以下是一些小提示,帮助你用一种可读的方式来构建文章内容:

  • 文章标题: 一个引人注目的标题可以吸引很多读者来访问你的文章。不管怎样,人们很难忽视阅读文章的标题。保持标题悦耳易记,能提升文章的流量。
  • 封面图片: 一张相关的封面图片使得文章更加具有吸引力。当你在社交媒体上分享文章时,一张创意十足的封面将吸引你的读者。
  • 简介: 这部分高度概括了你的文章内容。它可以是第一段,也可以是一个 Tl;DR,用以解释你打算在文章中介绍的内容。
  • 段落标题和子标题: 你应该将内容分解成几个关联的子话题。为了达到这个目的,创建几个部分,并提供与之相关的标题和子标题。例如,在这篇文章中,我创建了多个部分,给每个部分配上了标题,如了解你的目的找到你的动机等。
  • 图形: “一张图片胜过千言万语”,因此请考虑用一些图表、图片等来支持你的内容。
  • 总结: 最后的总结部分,可帮助你的读者回顾到目前为止他们从文章中学到的东西。同样,对于有些读者,再次过来收集内容时,只要通过快速阅览总结部分就可以了,这很有帮助。
  • 重要的链接: 你可能希望以一个参考链接的列表来结束文章,以供读者进一步阅读。你也可以在这一部分列出你以前发布的文章的链接。

💡 小提示:尝试在你的文章中使用一个统一的内容结构,这样你的读者会习惯它,然后会发现很容易理解。

写作工具

Tools

创造优质内容很花时间。你可以使用一些免费可用的工具,使自己成为一个多产和高效的内容创造者。这里有一些你可能觉得有用的工具,

⚒️ Notion:这个工具可以帮助你以高效的方式管理个人和专业的工作代办事项。任何时候产生一篇文章的想法或者你解决了一个有趣的问题,在这个工具中创建一项任务。你可以轻松排序,安排时间,分配任务。

image-29

⚒️ Grammarly:如果你跟我一样,是一个非英语母语者,有时可能会对语言的语法规则不够熟悉。

在这种情况下,像 Grammarly 这样的工具在各个方面扮演拯救者。它检查语法和拼写错误,建议对复杂句子重新措辞,纠正被动语态为主动语态,等等。你可以先使用试用版本,之后根据你的使用情况来升级到付费版。

image-30

⚒️ Hemingway Editor:这是另一个优秀的工具,用于协助你进行英语写作。如果你愿意,可以和 Grammarly 结合使用。副词、主动/被动语态,以及复杂的单词和短语,这些如果使用不当,它都能指出,这一点我很喜欢。

image-31

⚒️ Canva:Canva 是进行设计、艺术和释放创造力的工具。在没有任何 Canva 经验的情况下,你依然可以用它来创建封面图像、文章图形、动画 gif 等。它慷慨的免费计划足以让你开始使用。

image-32

⚒️ Pixteller:这是用于创建封面图像、图形等的另一个工具。

image-33

⚒️ ShareX:它是一款超酷的生产力工具,用于截屏、制作动画图片、文件共享等。

image-34

⚒️ OBS Studio:这是一个免费的开源视频录制和流媒体工具。你可能会疑惑,为什么我写博客需要它?

有时,你可能想要创建一段视频,上传到 YouTube 或 Vimeo,并从你的文章中链接到该视频。你可以使用 OBS Studio 创建优质视频,它有很多自定义选项。

image-35

⚒️ SERP 片段生成器:SERP(搜索引擎结果页)是我们在 Google 或 Bing 等搜索引擎输入查询后看到的页面。SERP 片段生成器可帮助你在发布文章之前确定合适的标题和元描述。

请参阅下图以找出限制范围内的标题和描述,以正确显示搜索结果。

serpsim_snapshot-1

进行大量审核

reading

你写了一些东西,在发布或分享之前,需要检查错误并审核你的文章。检查,确保你的内容已经准备好进行发布。通常,你应该检查:

  • 拼写错误
  • 语法错误
  • 格式问题
  • 标点符号
  • 准确性
  • 语言一致性

在校对和审核方面,有一句名言可以激发灵感:

“我发现修改你自己的作品的最好方法是假装它是别人写的,然后把它撕掉。” - Don Roff

发布你的文章

publish

如果在审核之后,你对文章很满意,接下来一步自然就是发布它。你可能希望将其安排在一周中的特定日期进行发布,或者你想立即发布——这取决于你自己。

一般而言,最好是在你准备好文章时就发布。同样,你不应该赶着最后期限去匆忙发布。

💡 小提示: 发布你的文章必须是整个计划的一部分。如果你需要在一个特定日期发布文章,那就要你逆向规划相应的内容。千万不要为了匆忙发布,而妥协文章内容的质量。

在社交媒体分享你的文章

socialize

社交媒体是一个极其强大的工具。作为博主,你应该积极利用它。

如果你希望文章尽可能多地吸引潜在读者,发表文章可能还不够。因此,在各种社交媒体平台上分享你的文章是个好主意。

你应该分享文章的链接到以下几个平台:

还有一些平台,单独分享链接并不会有什么效果。你可以创建适合主题的封面照片或图表,然后把它和链接上传到像 InstagramPinterest 这样的地方,记得使用正确的主题标签。

💡 小提示:分享博客链接时,请确保你遵守了每个社交媒体平台各自的规则。如果不这么做,你的账号可能会被标记或者被禁掉。

还有另一种令人兴奋的方式来分享你的内容,那就是交叉发布它。如果允许的话,你可以在其他博客平台上重新发布你的文章。例如,一篇发布在 Hashnode 平台上的文章,可以重新发布在 Dev.to 平台上,反之亦然。

💡 小提示: 交叉发布文章时,你可以在原始文章的链接上设置 Canonical URL。这种方式告诉像谷歌这样的搜索引擎,哪个是原始的副本,同时消除重复的内容。

优秀的博客平台

paltform

好了,现在我们已经知道了如何写一篇文章并进行分享,以便他人可以阅读。接下来我们来了解一些你可以开始入门的博客平台。

以下是一些平台,你可以开始在上面写博客,进而成为社区的一份子。

很多专栏和组织会雇佣并支付报酬给内容创作者。作为一个开发者博主,这可能会带来很多自由职业的机会,你会因为分享你的内容而获得报酬。你还可以为开源文档和其他项目做出贡献。

总结

总结来说,

  • 作为一个开发者,写博客作为一项业余活动,是可以管理的,并不会影响你的工作输出。
  • 你已经解决的问题,以及你在 Google、Quora 和 Stackoverflow 上的搜索,很可能成为你的写作灵感来源。
  • 在开始写文章之前,确定你的目标。背后的意图可以是琐碎的,也可以是很重要的——无论哪种都可以。
  • 保持动力。
  • 使用合适的工具,使你成为一个多产的作者。
  • 规划内容结构,审核你的文章,然后发布它们。
  • 使用社交媒体工具来分享你的文章。
  • 有一些很棒的博客平台,尝试一下,成为开发者社区的一份子。
  • 保持学习,保持写作,以及保持分享。

在我们结束之前……

我希望这篇指南可以帮助你创作更多好文章。

让我们保持联系。你在可以在 推特 (@tapasadhikary) 上面找到我,请随时关注。

你也许还会喜欢以下文章:

原文:Technical Blogging Basics – How to Write Articles as a Developer,作者:TAPAS ADHIKARY