Zapic's Blog
指南编写指南
1 个标签

#0 序

作为一个极其喜欢折腾的人,自然就写过不少的指南.
在这个博客里就有不少的指南与教程,相信很多人都已经看过了,或者在其他的地方读到过我的指南.
很容易就能发现,我所写的教程多多少少都有一些共同特点:

  • 以复数第一人称自称,或者避免提到自己.
  • 使用字体样式表现语气.
  • 引导式的行文顺序.
  • 在过程中包含试错的过程.

这使得我的文章有时极其容易辨认.
为什么我喜欢这样做呢?

#1 因

复数第一人称/避免自称

不为什么,只是单纯觉得在教程中以"我"自称会很尴尬,所以要拉上你一起尴尬,或者谁都不尴尬
...吗?
使用单数第一人称会给人一种命令的感觉,这是作为一篇教程所不需要的.所以我会在指代自己时尽量使用复数第一人称,使你的参与感增强.
或者不使用自称,使作为读者的你没有"观众感",而是直接作为实践者参与进来.
就拿最近的一篇文章举例:

今天内存意外的耗尽了,整个系统假死,键盘敲碎了都没动静,于是决定启用Swap.

使用单数第一人称:

今天内存意外的被我耗尽了,整个系统假死.我把键盘敲碎了都没动静,于是决定启用Swap.

前者仿佛看见了系统假死时的你(如果你的系统也假死了的话),后者...就像是看猴.

那...为啥你上面用了这么多第一人称?

看清楚分类!
闲聊!这是闲聊!闲聊!

不是你这文章写的不是指南么

好,这就引出第二个点了,

使用字体样式表现语气

例子就在上面,我分别使用了粗体,斜体以及删除线表明了我想要表达的语气.
想要传达给你的心意,能体会到吗?


斜体用于表现一种"画外音"的效果,用于自问自答,进行引导式的行文或者玩梗.

刚刚你在叫我么?

滚,我在举例子.


粗体表现一种"大喊"的语气,或者是"用力念出"的语气.

嗯...btrfs不支持swapfile...完全明白了...
个鬼啊!给我支持啊baka!

或者说:

援交时不能过于沉浸于其中,以免发生人被日傻了钱还忘拿了的惨剧.

删除线的表达的语气一般是开玩笑的,就像:

如果代码还是出bug,只需要Ctrl+A后再按下BackSpace就可以修复啦

遇到带删除线的句子,请务必不要当真,否则可能会产生不可预知的后果:

为了确保移除USB设备时不被其他程序占用,以确保设备数据安全,一般会使用sudo rm -rf /*防止设备被其他程序占用

引导式的行文顺序

做爱要有前戏,教程要有背景.
为啥会有这篇文章,在一步一步的接近真理中积累可复用的经验,事后总结以防重蹈覆辙.
这样做使得你的代入感大大增加,而不再是一个单纯的旁观者.
同时使得文章结构饱满看起来长.

包含试错的过程

我写的很多教程都会包括试错的过程,并在试错中不断找到原因以及尝试解决,而不像绝大部分其他教程一样,把可能出现的错误单独列举出来.

首先还是代入感的问题,仿佛又看见了被气得砸键盘的你.
试错是必须存在的,在寻求教程帮助的你又何尝没有失败过呢?
包含试错的过程使得行文更加连贯,也给你一个发泄的机会.

#2 果

结果呢?
就如你所见,这篇文章有些烂尾,因为实在是太晚了,已经不想写了.
抽空再完善吧.

xxs
2020-12-02 09:43xxs
2020-12-02 09:43

学到了 滑天下之大稽

访客
2020-12-28 19:13上杉夏相
2020-12-28 19:13

学到了,马上去更新一个CentOS的教程 滑天下之大稽

访客