Hi, It's Me! Irina Lu

wenjia lu

Wenjia's Tech Blog

GET IN TOUCH

Contact Info description

怎么写好技术文章 -- 知乎live

技术文章 - 问答部分还没看完~干货满满

有满满套路

类型

阐述问题 解决问题

翻译类

系列教程

怎么算好

内容-能读懂

抓住问题本质,做出最精准定义。

任何复杂事情其实是简单事情错综复杂交织在一起组成的。 因此想要搞懂问题要先学会拆分。

拆分前要先去除无关紧要的东西

理解背景知识

  • 具体分析 (如,看源码)
  • 抽象总结 (归纳)

尽量能考虑到对方的理解水平,不要用术语,或者准备背景知识。

联系现实生活中的映射

借鉴高质量英文文章或者大牛文章去理解问题

思路 ⭐️

引言

先给个定义告诉读者你在写什么技术。还要给出为啥要被创造出来和目的。

然后介绍怎么使用。实现原理,运行原理

技术的弊端和不足。

注意事项、自己遇到的坑。

总结

注意过渡。

结构

使用方法,实现原理,运行原理详细写。

注意事项 或者一些定义 可以粗略写。

样式

文字主要以小段落小段落 因为现代人看到大块的文字会有些抵触

层级 html heading h1- h6

强调内容 加粗

编程中的方法名 路径突出

代码高亮!!!!

不建议过长,尤其要避免横向过长导致的水平滚动线。

可以通过拆分 或者 换行 解决。

怎么确定主题

选题很重要! 会影响阅读量。

授人以渔 或 受人以渔

1.读者需求导向

新的技术, 热门技术。技术系列专题。鸡汤类大家都爱读。

2.个人研究为导向

技术细节。编程基础。通过文章提升自己水平,完善自己技术体系。

套路-撰写的阶段

1 研究阶段 (碎片化时间)

将某项技术拆分成点。(比如见思路篇)

用零碎时间去研究这些点。

2 书写阶段 (连续时间)

图文输出。

平台

现成的。

自己搭的。(作者就是自己搭的静态网站)

推荐 hexo, 原则是支持markdown的 (嘿嘿)

前期流量会特别小,像个孤岛。

不过长期就还好。

更新频率

不一定。

可以每周更新。

Q & A

写作风格

Q:文章怎么吸引人 ?

A:可以选流行的主题,不过不建议太标题党。

Q:从无到有的介绍还是直接讲要害 ?

A:大而全的文章 不如 小而精的文章。

Q:一定需要规规矩矩写吗,写成感悟式样的行吗 ?

A:只要能清楚的讲清楚事情,让读者能够明白问题就行。

Q:读书笔记类文章,怎么写才能不和原书重合 ?

A:文化背景不同,可以把栗子替换成周围人更贴近的例子。

提取文章的重点。

写作提升在积累中思考

Q:技术文章写的像文档,怎么办 ?

A:可以对文章结构进行细分。行文中做好承上启下的过渡。

Q: 为啥看的很多,仍然写不好 ?

A:看是不够的,还要思考、咀嚼、写。

Q:平时怎么积累 ?

A:多思考。多提一些问题。解决这个问题当前方法有什么优缺点,有什么更好的方法吗。

理解一些运行和实现原理,而不仅仅是使用。多看,不懂的地方可以记录下来。

Q:怎么解决一个问题 ?

A:最重要的是确定问题的本质。然后通过debug 或者 关键日志 去了解过程。 在然后遇到问题去搜索。

Q:表达复杂技术知识有啥技巧 ?

A: 自己去把这个复杂事情弄明白。然后举通俗易懂的例子。

学会利用社会曝光 - 写作小组

Q:写完后如何与读者达成良好的沟通 ?

A:能明明白白讲给别人,别人能听懂。

发布前:建立文章 review 小组,与小组人员交流。

发布后:开启评论功能,能让读者留言。

Q:怎么防止写着写着跑题 ?

A:写之前可以列提纲。每个板块写完后可以进行检查。全文写完再检查。过几天可以再看 或者找别人来看。

Q: 怎么坚持啊 ?

A:可以发朋友圈。

时间规划 - 要学会拆分结构

Q:怎么解决与工作时间的冲突 ?

A:对文章切分。研究阶段利用好碎片时间,写作阶段周末。

Q: 是先学还是先写文章 ?

A:这是一个悖论。 就像先产出还是先涨工资。

其实可以先写,比如理解了 60% 的程度, 在写的过程中就说不定掌握了剩下的 40%。

原创

Q:哪些要标原创和转载 ?

A:翻译的话要标出原作者并且获得授权。如果参考了别人的文章,需要把链接写出来。