Blog

Blog

PHODAL

当我写博客时,我在想什么

当我写博客时,我在想什么

这个标题似乎有点仿村上春树的《当我谈跑步时,我谈些什么》,只是一直听闻这本书,然而没有好好看上几眼。一直不是一个容易专注的人,只是到底有多少人是真正的专注,走路时我们在想些什么?

当自己是一个年轻的程序员(从自己知道自己的职业算得上是程序员)时,自己已经写过一些东西,于是就那样慢慢地写了越来越多的东西。

为何在坚持写作

上面的说法有点扯淡,只是似乎现在是如此。写作是一项有意思的事

  • 获得人们的评论
  • 看看不同的人对于同一个话题会有怎样的看法
  • 找点有意思的东西,你可以向这个世界宣称某某东西是最好的
  • 看看人们都在关心什么

然而对于我来说一开始我只是想试试SEO,SEO是一门艺术。对于用Google Analytics,我们可以

  • 看看不同的人会有怎样的行为。从这个链接跳到首页,再到某个页面,关心下作者在干些什么
  • 看看人们是怎样找到网站的。从关键词、点击去分析,再获取一些有意思的东西,如关键词排名。
  • 看到原来周末的时候大家都很少编程。至少大部分的人是那样的,然后流量就掉了下来,即使是Github也是如此。

当我们有越来越多读者的时候,我们总会想着去给读者写更多的东西。对于一个作者来说,这就是动力的来源。

当我写博客时

写过算是有些博客,而最近正在试着天天去写,出于某种目的,或许是因为PR值的影响,或许是为了激励某个孩子。当我写博客时,我会

  • 试着去表达一些技术上的细节,也会省去一些技术上的细节。
  • 以自己学习的角度去想怎样写可以一步步下来。
  • 加入一点点自己的情感,博客和文档是不一样的。(详细见下文)
  • 编写更简洁的内容,因为技术博客与此文不同的是,技术博客是面向寻找信息的人。

不是写文档

博客与文档不一样的是,我们需要别人来评论,然而文档是不需要有那么多人评论。文档只会教一个人如何进去下一步,博客更多的像是一种交流。加入自己的情感,一开始的时候可以抱怨些在这个解决问题的过程中遇到的坑。 我没有写过文档,不过太部分的文档感觉都是相当严肃的,或者说专业。

让博文更简洁

准确的来说标题是错的,但是没有那么重要。对于一篇以技术为主的博客,简洁的方法和写好技术博客是类似的,以把信息推送给用户为主:

  • 代码。必要的时候贴出代码,会是一种快速有效的方法,工作的时候是为了完成某个任务。
  • 列表。列表可以简明扼要的说明你想要表达的内容。
  • 图表。一张流程图可以说明程序的步骤,一个表格可以作好一个对比。
  • 标题。标题的好处,可以让用户快速定位,让用户找到想要的内容。
  • 链接。一个好的URL对于使用英文的人来说,可以利于SEO,对于中文,使用的人可以判断出文章的专业与否。

让博文看起来专业一点

专业一点,这个说法,有点意义。但是不仅仅在于那几个字上,而在一些细节上

  • 排版。一些小的细节,还有一些缩进。
  • 大小写。对于技术文章来说,大小写所要的表达的意思是不一样的。Python说的是这门语言,而python说的可能是python语言的软件。
  • 语法加亮。在文章的代码有语法加亮是相当重要的,至少看上去会像是你写的,而不是复制的,只是复制的也会有的,但是加亮总是好一点的。

关于我

Github: @phodal     微博:@phodal     知乎:@phodal    

微信公众号(Phodal)

围观我的Github Idea墙, 也许,你会遇到心仪的项目

QQ技术交流群: 321689806
comment

Feeds

RSS / Atom

最近文章

关于作者

Phodal Huang

Engineer, Consultant, Writer, Designer

ThoughtWorks 技术专家

工程师 / 咨询师 / 作家 / 设计学徒

开源深度爱好者

出版有《前端架构:从入门到微前端》、《自己动手设计物联网》、《全栈应用开发:精益实践》

联系我: h@phodal.com

微信公众号: 最新技术分享

标签