张鑫旭12年技术写作经验分享直播内容总结

2,267 阅读7分钟

张鑫旭大大在2月15号直播分享了他十二年写作经验,当天正好赶上疫情被抓去测核酸,时隔两天还是急忙补上了这一课。讲的是真的非常好,特此边听边记录讲解的要点并加上了自己的一些理解,希望对自己对大家在技术文章创作上有所帮助

直播讲师:张鑫旭

讲师介绍:阅文集团前端技术专家,同时也是鑫空间鑫生活博主,十几年来一直笔耕不缀,创作了接近800篇前端技术原创文章,并著有书籍《CSS世界》《CSS选择器世界》和《CSS新世界》,在与用户体验相关的前端领域有较多的研究心得。

直播回放地址

关于文章选题

为什么会想不到分享的东西呢?

原因一:总想搞波大的

  • 要牛逼
  • 要稀缺
  • 要精致
  • 要干货

原因二:害怕失败带来的不安全感而不自信

  • 要是内容不行
  • 要是版式糟糕
  • 要是暴露我是菜鸟
  • 我会不会社死

1.当然,做技术的人性格上都会带上一点完美主义,比如前端er们应该饱受过UI的摧残:这个间距小了一丢丢,这个字体颜色深了一点点等等等等,经历多了就养成了一丝不苟的精神(笑)

2.我个人写作的心里历程:这写的不严谨怎么办?感觉自己写不出花样,写的像抄别人的怎么办?会不会被喷?这排版会不会太丑?要不要请教下UI小姐姐?(好像挺不错)

如何解决?

应该想的是我有什么

  • 我是谁
  • 我的精力多少
  • 我的水平如何
  • 我的优势是什么
  • 我的突破口在哪里

个人觉得写文章是一个梳理自己所掌握能力的过程,所以一定先要对自己有一个全面的认知。

然后根据所要撰写的内容查缺补漏,甚至于锦上添花

每个人都是不同的个体,不太可能写出完全一样的风格的文章,所以大胆地用自己的想法去创作,创作完成后我觉得会对个人产生良好的正向激励

写作选题

  1. 新特性、新方法的介绍

    推荐网站 Can I use,一个专门对前端 API 做兼容性测试的网站,有非常多的新特性,可以找一些常人不知道的 API 写一写用法,原理什么的

  2. 自认为厉害的小技巧、小创造

  3. 原理剖析、深入理解

  4. 技术方案汇总

  5. 棘手问题解决经验分享

  6. 优秀框架、项目、工具的体验指南

第1、4、6点是比较适合新人的选题

一些建议

选题与自己学习相关

  • 写作是学习的辅助手段
  • 容易坚持,就算没人看,自己收获了成长

不要写雷同内容

  • 同一个知识点从不同点切入

迷茫的时候写写个人故事、感悟与困惑

  • 技能寻找答案,又能获得访问

1.我经常在工作中学习新知识,因为进公司较早,对经手的项目都有主要负责权,所以经常会往项目里塞一些我正在学习的新知识甚至新框架,这样工作学习两不误,成长飞快

2.作为初学者都需要养成记笔记的习惯,就像人生的第四大错觉:我收藏了=我会了,又多了人生的第五大错觉:我记了笔记=我也能写出这样的文章。记得多了,到自己来还是能划拉两下子的

3.没错,这篇文章就是我在迷茫中才想着要写出来的

关于内容结构

你写作的目的是什么?

如果是功利写作

为了升职加薪,为了换工作,为了出名

重点突出

一眼扫去知道你在讲什么

  • 讲结论的结论先行
  • 讲交互的效果先行
  • 罗列知识的目录清晰

有闭环有递进

完整的故事化表达

  • 背景,思考,尝试,困难,解决与结果
  • 困难分1,2,3,解决后又出现了什么新问题

写技术文章要避免像写论文一样,技术文章需要的是活跃的表述能力,不仅能吸引他人阅读,更能展现个人解决问题的能力,这样更容易收获面试官的青睐

如果是日常写作

为了学习与自我成长,个人展现

遵循自己内心

不要搞花里胡哨的套路,想怎么写就怎么写

案例一:开篇1000字碎碎念 获取元素CSS值之getComputedStyle方法熟悉

案例二:微信对话体 我们一起学习CSS image-set()

案例三:同人小说包装 客栈说书:CSS遮罩CSS3 mask/masks详细介绍

总结

如果你拥有足够的习作自由

多些真诚,少些套路

真心想分享的心比什么乱七八糟的技巧都管用

关于语言表达

技术文章的语言表达,什么是最重要的?

  • 简介的语句?X
  • 华丽的辞藻?X
  • 高效的段子?X

最重要的应该是换位思考的能力

image.png

什么是换位思考

  • 如果我是小白,这些术语懂吗?

  • 如果我是读者,好理解吗?

    是不是用个耳熟能详的东西类比下?

    是不是代码要简化下,加上注释?

    是不是这里应该放个图?

    是不是这里应该加个演示?

展现真实的自己

鑫旭大佬的观点:

除了是工作汇报、团队账号这样的严肃场景,否则一定是融入了个人情感的文章更有价值

这点很有感触,平常关注的公众号,或者博主,技术不一定是特别牛逼的,但文章都是写的比较生动有趣,引经据典(不是),让人有阅读下去的吸引力。如果文章不生动那还不如直接去看官方文档API

那么如何展示真实的自己呢?

  • 例如:

    我遇到了什么样的问题?我是怎么思考的?我又是怎么解决的?

  • 又例如:

    我觉得这个技术如何?我不太喜欢某某设计?我的建议是什么?

  • 你是什么样的人,就使用什么样的风格

    我话痨,喜欢扯东扯西,你就这么干,想到什么讲什么

    我御宅族,挺好,文章可以体现各种宅元素

    我喜欢晒自己,那文章配图就多多展现

    我是穷酸小透明,过得不如意,文章就不必强颜欢笑,透露出忧郁挺好

  • 保持一致的风格和特色

    不要这篇嘻嘻哈哈,那篇文章干干巴巴

    • 糟糕的风格好于毫无风格
    • 让别人记住你,提高影响力
    • 是防盗版的手段之一

关于文章质量

文章质量很重要

10篇水文不如1篇高质量文章

除了内容本身质量以外,提高文章质量的一些技巧:

配图和演示

一例胜千图,一图胜前言

示例:CSS 实现多行文本“展开收起” - 掘金

image.png

对每一句话负责

出现了不确信的结论,一定要自己验证一遍

示例:

在桌面端document.scrollingElement就是document.documentElement

在移动端documenet.scrollingElement就是document.body

试了下第一个是对的

第二个 Android 和 IOS 都要考虑,限于环境有限,就交给评论区啦

追寻内心而不是热门

文章质量和访问量并不正相关

示例:

面试技巧,N个特性汇总这样的文章容易高赞!

但,这些文章作者我一个都没记住

我在掘金发了两篇文章,一个自己写的关于原型链的,没有多少阅读量也没有赞,一个汇总移动端开发的内容确实阅读量高,赞也多(相对于0来说),赞虽多,却没有自己写的对自己的提升大,因为汇总的都是别人的成果

总结

  1. 关于文章选题

    与学习相关、不同切入点、感悟与困惑

  1. 关于内容结构

    重点突出、闭环与递进、整成

  1. 关于语言表达

    换位思考、展示自我、保持风格

  1. 关于文章质量

    配图与实例、对结论负责、追寻内心