记录你的学习编码之旅

入门

撰写你的第一篇文章

在 Dev.to 上撰写文章

推广你的文章

下一步是什么？

作为一个职业轨迹因自己的写作而改变的人，我想我会分享我在软件开发主题写作中学到的智慧，并提供一些具体的方法来开始使用我最喜欢的技术博客平台：dev.to。

本文将教您：

• 为什么我推荐 dev.to 平台
• 写什么（以及写的频率）
• 如何使用 dev.to 撰写和发布你的第一篇作品
• 如何以有意义的方式推广你的作品

让我们开始吧！

注：本文应Tech Elevator学员的要求撰写。虽然这些内容与所有人息息相关，但其中一些内容更适合训练营学员或正在寻找第一份工作的人。

入门

为何写作？

作为新开发人员，有许多令人信服的理由来记录您的旅程：

• 它可以帮助你保持动力
• 它可以帮助其他人从你的经验中学习
• 它能打造你作为开发者和社区成员的“品牌”
• 它可以吸引那些愿意与你合作的招聘合作伙伴和第三方的注意
• 它可以迫使你学习新事物
• 人们的反应可以让你学到新的东西
• 你的文章写完后会保留很长时间，甚至在多年后仍能帮助人们

选择平台

我刚开始写技术文章的时候，选择 Medium 作为我的写作平台。当时觉得 Medium 挺合适的——Medium 很出名，编辑器直观易用，而且感觉非常精致。

连续一周，我每天都会在 Medium 上写一篇文章，发布它，然后开始我一天的生活。

但什么也没发生。没人看到我写的东西，考虑到我付出的努力，这真是太遗憾了。

然后，我在 LinkedIn 上联系的社区的一位成员建议我使用 Dev.to，它改变了我以后的写作方式。

Dev.to 是什么？

Dev.to（全称 Dev Together）是一个博客网站，致力于帮助那些想要一起学习编程和新事物的人。与其他平台不同，Dev.to 的领导层致力于共同发展社区，推广和提升成员，并与所有人分享最精彩的内容。

与 Medium 相比，为了让你的文章被阅读，你要么需要已经拥有追随者，要么 Medium 或 Medium 内的其他出版物必须选择推广你的作品。

通过 Dev.to，您可以获得大量社区支持、建议和持续的鼓励 - 此外，如果您的内容质量足够好，还可以偶尔获得免费插件。

Dev.to 是一个免费平台，也是我向新开发博主推荐的首选起点。

创建一个帐户

目前，您可以使用 GitHub 帐户或 Twitter 帐户（或两者皆可）登录 Dev.to。如果您想活跃于在线技术社区，我强烈建议您同时使用这两个帐户。

转到https://dev.to/new开始连接您的帐户并首次登录。

配置您的帐户

拥有帐户后，单击标题中的个人资料并选择“设置”。

从那里开始，我建议在个人资料页面上输入尽可能多的信息 - 特别是位置、Twitter 账号和工作开放状态。

接下来，点击侧边栏中的“UX”。在这里，您可以根据自己的喜好更改网站主题和字体偏好。

请确保您的编辑器版本是“Rich + markdown”，因为这将确保我分享的屏幕截图和说明与您自己的体验相符。

撰写你的第一篇文章

确定何时写作

现在您有了帐户，您需要开始考虑要写什么以及写的频率。

至于频率，我建议一开始就设定为每隔一周或每月发布一篇帖子。如果你是Tech Elevator 的学生，并且正在阅读本指南，那么这一点尤其重要，因为我们为期 14 周的课程安排相当紧凑，你希望在学习期间减少其他安排。

一旦你进入了写文章的流程，如果你想增加频率，那就去做吧，但我的一般建议是每周不要超过两次。

选择一个主题

至于写什么，如果你是一名新开发人员或正在学习编码的人，我建议写下你的历程。

具体来说，你可以写：

• 您独特的背景如何帮助您成为一名程序员
• 对你来说，学习编程最难的部分是什么
• 你学会了哪些“心理技巧”来帮助学习新概念
• 一旦你学习了足够多的知识并积累了足够的技能，你想用技术构建什么
• 旅途中令你沮丧的事情以及你对此采取的措施
• 你正在进行的那个副业
• 您如何看待自己的代码和编程方法随着时间的推移而不断改进
• 您刚刚了解的新库、工具或技术，以及它如何改变您作为新开发人员的思维方式

是的，大多数事情你都可以选择写别人已经写过的内容，但事实证明，这样做也无妨。你可以在自己独特的时间，展现自己独特的声音。

相信我，说出你的想法，有人会发现它很有用。

在 Dev.to 上撰写文章

首先，单击 Dev.to 标题中的大“撰写帖子”按钮。

这将带您进入一个非常小的页面，您可以在其中设置帖子标题、添加一些标签、编写一些内容以及上传一些图像。

选择标题

标题应该简洁明了，能够告诉读者所有他们想要阅读的内容所需的信息。一篇新开发者文章的标题可以是“从技工到代码猿”、“真的吗？JavaScript 真的这么用吗？”，或者“有分号，会旅行”。

享受其中的乐趣，但请记住，写得越多，你就越能学会如何写出吸引人的标题。

选择合适的标签

接下来，为你的文章添加一些标签至关重要。标签本质上是相关内容的集合。这篇文章的标签如下：

• 初学者
• 教程
• 写作
• 职业

寻找入门方法的人可以通过“初学者”或“教程”找到这篇文章，而寻找写作或职业建议的人同样可以找到它。

对于您来说，您使用的标签将在很大程度上取决于您所谈论的技术和您所共享的代码，但我建议最多使用 4 个标签 - 只要它们在您的文章上下文中使用是有意义的。

我建议您查看“标签页面”，查看热门标签列表。这里也是您关注感兴趣的标签的好地方，这样您就可以在 Dev.to 的主页面中查看相关文章。

概述你的文章

接下来，你需要在内容区域添加一些带有不同章节标题的 Markdown 语句来概述你的文章# My Header。## My Sub-Header这有助于你在开始撰写内容之前确定文章的结构和流程。

如果您对 markdown 感到困惑，请查看 Dev.to 侧边栏上的 Markdown 帮助链接，或单击顶部的预览按钮来预览您的文章而不发布它。

有效使用 Markdown

*bold*您还可以使用类似和的markdown**italics**将内容变为粗体和斜体，或者用反引号字符`（大多数键盘上 1 左侧的键）将内容括起来以格式化内联代码// like this。

格式化代码

对于较长的代码片段，您需要使用 Dev.to 的集成代码格式。

一行中连续包含 3 个反引号，然后在其下方粘贴你的代码。最后，用另外 3 个反引号结束。你的 Markdown 代码应该如下所示：

Dev.to 现在将格式化您的代码块：

public class You : Author
{
   public Article Write()
   {
      return new Article("Something Awesome");
   }
}

实际上，你可以获得比这更好的高亮效果。你可以在开头的三个反引号行中使用编程语言语法的简写。例如，我可以在开头的块中输入三个反引号，然后输入 cs，这样就能获得更好的格式。

public class You : Author
{
   public Article Write()
   {
      return new Article("Something Awesome");
   }
}

Dev.to 支持多种类似的语言，但你可能需要猜测该语言的简写。我建议你尝试几种不同的方法，然后预览一下，看看效果是否理想。

包含图像

您经常需要在文章中添加图片。这有助于吸引读者阅读，将文本拆分以提高可读性，并直观地展示诸如项目进展之类的内容。

要添加图片，您需要点击 Dev.to 编辑器顶部的“上传图片”按钮。然后，您可以从您的电脑中选择一张图片并接受。

接下来，Dev.to 将其上传到亚马逊的 S3 存储区域，并使用您刚刚创建的图像的 markdown 填充上传图像按钮旁边的文本框。

点击文本框，它会将内容以 Markdown 语句的形式复制到剪贴板。将该内容粘贴到你的文章中，当你预览时，图像应该能够正确呈现。

需要注意的是，请确保将“Alt Text”更改为描述图像的内容，以提高文章的可访问性。

选择封面图片

我还强烈建议你为你的文章选择一张封面图片。这张图片会显示在 Dev.to 的动态以及任何指向你文章的社交链接中，这对人们是否点击你的文章有很大的影响。

此外，当您真正浏览文章时，它会让您的文章看起来更好。

为此，请滚动到编辑器顶部并选择“添加封面图片”。

为了选择最具元图像，我在本文中使用了撰写本文时的屏幕截图作为封面图像。

很有可能，你有时会找不到合适的图片，在这种情况下，我建议使用Unsplash 的免费图片素材。他们提供的图片选择相当丰富，你通常可以找到一些引人注目、有趣且美观的图片来用作你自己的标题。

完成

现在您已准备好对您的文章进行最终审核并单击“发布”。

恭喜！您刚刚写出了第一篇文章！

但您的旅程尚未结束。

推广你的文章

您的文章的质量取决于您的创作，您确实需要做一些简单的宣传工作才能获得写作的全部效果。

在社交媒体上分享

首先，我建议在 Twitter 和 LinkedIn 上直接链接到你的新文章。这不仅能帮助你现有的联系人找到它并了解你的动态，还能让他们轻松地点赞、评论，以及——最重要的是——分享。

您还可以在社交媒体上使用一些有趣的主题标签，帮助其他人找到您的内容。例如 #LearnToCode、#WomenInTech（如果您正在学习）、#100DaysOfCode（如果您正在接受这项挑战）等标签通常有助于让新博主被发现。

您还可以在 Twitter 上通过@IntegerMan或在 LinkedIn 上向我发送新文章，我很乐意阅读它们。

推荐一条 Dev.to 推文

Dev.to 将主动在 Twitter、LinkedIn 和其他潜在媒体上推广帖子，但给予他们一些推动也会有所帮助。

您可以通过进入刚刚撰写的文章并单击“管理”来执行此操作（只有登录后才能看到此信息）。

从那里，您可以向下滚动到“建议推文”表单。提交推文文本，然后点击“分享推文建议”。

这样做最糟糕的结果就是有人说“不，我想我不会分享这个”，但对于新博主来说，这样做的好处可能是巨大的。

当您在那里时，我还建议您点击帖子的经验级别并将其设置为适当的级别。

下一步是什么？

因此，您现在已经发布了第一篇博客文章，并且成为了一个更新、更大的社区的一部分。

我给你的首要建议是保持活跃。阅读其他人在 Dev.to 上的文章。坚持编码。继续贡献。

在 Twitter 上积极讨论技术。

坚持写作，别人就会继续阅读。如果你写得足够好，篇幅足够长，它就能彻底改变你的职业生涯——甚至能为你带来写作方面的有偿机会、演讲机会、面试机会，甚至是工作机会。