【8】如何写出一篇登得上大雅之堂的技术博客

本文是《程序猿叨叨叨》系列文章中的其中一篇,想要了解更多相关的文章,欢迎猛戳蓝字前往阅读。

本文已授权微信公众号 【Android技术经验分享】 发布转载请注明出处://www.greatytc.com/p/edee8c40e5d7

我为什么要写博客?

写博客之前,一定要在心里好好地问自己:我为什么要写博客?我记得自己初入简书是受学长李响同學引导,因其奇佳的段子手天赋引来了诸多粉丝,尤其是《李响同學 #你的包里有什么》一文,让我感觉此文将其个性展现的淋漓尽致,一时兴起,注册了简书账号,期待着自己有一天也可以像他一样,但是时间一天天的过去,我开始陷入沉思:总不能什么事都不做,坐等粉丝呼呼地来关注我吧!于是我绞尽脑汁,掏出我的“满腹经纶”,终于憋出了《闲谈码农群体的新鸟和老菜鸟》这篇文章,但是总感觉缺了点什么,觉得自己只是为了写文章而写文章,无法将自己心里的东西挖掘出来。在后来两年多的时间里,一路跌跌撞撞将博客写下来,渐渐地找到了答案。写博客,尤其是写技术性的博客,请记住一点:我不是为了在我的文章数量上+1而写博客!

文章数

写博客的目的应该是:我在开发过程中遇到了一个问题让我困惑了很久,我查询了网上的资料,结果千篇一律,都没有解决我的问题,最终我通过询问他人、阅读源码、在他人的基础上对问题有了更进了一步的理解,我想把解决方法和他人分享,以免他人遇到相同的问题,继续踩坑,重复制造轮子,所以我要写博客。

写博客前我要准备什么?

明确了写博客的目的后,我们要开始着手准备用来充实博客内容的素材:


  • 图可以包括:效果图、思维导图、示意图 等,若更深一步,可以加入软件工程里的用例图、UML图、静态图、包图、甘特图 等。注意在需要着重讲解或不容易用语言描述的地方一定要加入有意义的图,用以辅助说明。
  • 代码
    代码可分为完整代码和代码片段。完整代码不宜放入文章内容中,应上传代码仓库,并在文章末尾添加代码仓库链接,方便读者访问;代码片段放入文中, 作具体讲解,片段代码可以像下面一样添加:
public class Code {
  // 这里是填写代码的地方,用代码框框起来
}
  • 解决思路
    解决思路是问题从被发现到寻找答案再到被解决的中心思想,是笔者与读者交流解决问题的心路历程的核心,推荐以线性思维贯穿整篇博客。

文章内容如何排版?

正式进入写文章阶段,按照问题的解决思路,相信每一位做好充分准备的笔者都能将文章写得很充实,但是充实并不代表能让读者赏心悦目。人靠衣装,文章也要靠排版给读者带来良好的用户体验。简书对于文本编辑提供了两种编辑器:富文本Markdown 。这里我是比较推荐使用Markdown的,方便排版,便于引导笔者将注意力更多地放在文本内容编辑上而非对文本样式的控制,接下来讲讲内容该如何排版,排版可从以下几点进行深化:

  • 文字
    文字大小、字体需统一,对于需要强调的内容可用粗体斜体 来突出,但是不推荐全文大篇幅的粗体斜体,这样会让文章看起来不整洁,不够大气。

  • 标题
    简书的标题和文章内容是分开的,所以这里的标题是段落的小标题,而非文章主标题。段落的标题需要显眼,让人一目了然,对标题的处理常见的方式为:

    • 加粗、加大字体


      加粗加大的标题
    • 使用引用,为标题整行添加背景
      引用样式的标题
  • 段落
    段落是一个中心思想的集合,段落之间建议空一行,让文章看起来层次分明;一个小结结束后,段落之间可以添加分割线进行小结的划分,但是极不推荐每个段落都用分割线分割,这样会让文章看起来档次很低,有一种随意做笔记,登不上台面的感觉。

  • 代码
    文章中嵌入代码方便读者更好地对问题的解决进行理解。象征性的代码推荐使用截图实现,象征性的代码一般非解决问题过程中直接用到的代码,而是类似于源码,用来说明问题的辅助性代码,如下图:

    象征性代码

    而关键代码推荐在代码框手动输入,这样方便读者对代码进行粘贴复制,同时使用代码框也可以将代码和原文很好地划分开,方便读者阅读。

  • 图片
    图片作为辅助性素材,可以恰到好处地弥补语言不以描述的不足,一般放在描述性文本内容的前面,图片下方亦可添加图片的简单说明,效果更佳。简书图片使用七牛云处理,修改图片链接后的参数,可对图片的大小进行调整,推荐写博客时适当调整图片大小达到布局排版平衡,参数修改如下图,w表示宽度,后面选中的数值表示宽度的像素点:

    修改图片大小参数

  • 转载
    作为对原创最基本的尊重,转载时务必在文章底部或文章开头添加原创文章的链接;为方便读者对问题更加全面的理解,建议笔者在文章中添加自己解决问题时参考的文章链接。

写好博客后做什么?

写好一篇博客后,不要急着发布投稿,先做好以下几点:

  • 检查文章错别字
  • 润色文章语句,使读起来连贯通顺
  • 检查代码格式和字母拼写是否正确
  • 检查链接是否有效

做好以上几点,接下来可以考虑发表并投稿文章,投稿文章时请注意以下两点:

  • 投稿时间
    关注简书的用户大多是在校大学生和在职上班族,他们一天大多数时间都投入上班学习中,唯有在早餐时间午休时间晚上下班后到临睡前 这些时间段是有空浏览简书的,所以建议在这几个时间段投稿自己的文章,而且这些时间段里,文章被收录的处理时间更短,浏览量会更高。

  • 投稿专题
    好马需要有伯乐的赏识,一篇好的文章需要有好的专题环境才能获得更大的关注度。选择专题需要关注专题收录的文章类型订阅人数,合适的文章类型能快速的让读者找到自己文章,而订阅量大的专题可以极大地提高文章的点击量。

写在最后

在浏览简书的时候,我经常可以看到有这么几类文章浏览量和点赞人数非常得多:鸡汤励志文工具推荐文速成效率文高逼格不知所云但云之有理文 。在这里强调一下,我们写技术博客的主要目的是分享自己解决问题的经验,其次是通过写博客来温故或者说是更深一步地理解问题的本质。不论我们写什么文章,重要的是通过 来给自己带来实质性的价值,所以希望大家不要盲目追求点赞量,失去自己写博客的初衷。不忘初心,方得始终!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,122评论 6 505
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,070评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,491评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,636评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,676评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,541评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,292评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,211评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,655评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,846评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,965评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,684评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,295评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,894评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,012评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,126评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,914评论 2 355

推荐阅读更多精彩内容