我正在参与掘金创作者训练营第6期,点击了解活动详情
前言
哈喽,大家好!我是静Yu。作为一名掘金“新人”,希望可以在掘金得到更好地发展,希望能提升自己,也希望自己能写出更好的文章帮助他人。所以我报名了掘金创作者训练营的活动,官方大大很贴心的还为我们请来了专业的老师来进行直播讲课。主讲老师是王晔倞老师,是【头哥侃码】公众号的作者,看了老师的主播之后学到了很多,所以写了这篇文章作为总结。王老师直播的主题是如何避免技术写作过于的枯燥乏味?总结完这篇文章,希望自己在未来能写出更好的文章,也希望看了这篇文章的小伙伴有所收获,让自己的文章更加有吸引力。
如何让你的文章在开头就充满风趣与自信?
我们都知道,程序员写的技术文不像哪些网络小说,内容丰富,情节跌宕起伏,而且本身技术文章就比较难理解,所以读起来就比较枯燥乏味。所以写一篇好的文章才能吸引更多的读者,才能给人留下深刻的印象。
王老师讲解内容:
- 简单精炼
一个文字的开头就像是文章的“灵魂”,一个好的开头才能使读者有阅读下去的欲望。关于计算机领域的技术文,我们习惯性的在开头会进行自我介绍。在自我介绍的时候,一定要简单精炼,不要像报户口一样,今年多少岁了,家住在哪,工作多少年了,在哪工作过。 - 自我调侃
在自我介绍的时候学会自我调侃,王老师举例的时候说自己的名字,自己叫做王yeliang,不是叫做王huajing。自我调侃就会使得自我介绍不会显得那么生硬,让人更容易接受。 - 平稳过渡
开头也要学会平稳过渡,比如现在互联网行业整体比较“冷”,不景气,我们可以不直接说,可以从最近天气一直下雨,阴雨连连引入,就像我们高中写作文一样,自然一点。
我自己的观点:
王老师讲解的非常好,但是我也有自己的一些小小的观点,大家可以借鉴参考。就是在开头自我介绍的时候,可以写一写我们的成就和能力。这里的成就可不是让你炫富的,不是我又几套房有几辆车;而是写一下我们的技术本领和在写作方面取得的成就。比如,我之前也写过这种形式:
❤️作者:静Yu
🧡CSDN全栈优质创作者、华为云享专家、阿里云社区博客专家,前端知识交流社区创建者
💛公众号【程序员静Yu】
因为我自己实在不才,也就只能写这么一点点。很多技术大佬完全可以写写自己在哪工作,加入了什么组织,团队。但是不要像写一个段落,罗列一大堆,就像我这种大方简介,简单介绍一下就挺好的。
如何在写作过程中利用故事片段传递技术经验?
王老师讲解内容:
- 讲故事
可以以一个简单的小故事引入我们要讲述的内容 - 自问自答
采用自问自答的形式,对技术内容进行阐述,让你更容器理解。
小A:这节课我们学习一下伪类。
小媛:什么是伪类?
小A:这个知识点有点抽象,伪类指给当前整个html代码已经存在的元素模拟添加一个类样式来实现一种效果。
小媛:果然很抽象,这不是跟之前的类样式一样吗?
小A:这两者还是有一点区别的,例如我们想使body主体内容中的第一个p标签颜色为红,那么我们就可以这样写代码。
- 够真实
程序员写的技术文,很多时候也是我们平时开发的经验或者是踩过的坑,都是我们亲身体验到的。所以我们在写文章的时候,一定要真实。千万不要胡编乱造,只有最真实的才能引发共鸣,才能让阅读者学到更多的东西。我相信一直吹牛,没有实在内容的文章是不会有人喜欢看的。
我自己的观点:
1.文章脉络要清晰
写文章一定要思路清晰,脉络明确,只有一步一步的写下去才能使你的更加易懂。不然你东一块西一块,会是你的文章很乱,让人摸不着头脑。
2.代码要分块
程序员嘛,文章中肯定会出现很多代码,在文章中贴代码的时候一定要分段介绍,千万不要贴在一块,不然很难有读下去的欲望。
例如:
此段是css样式设置部分,对宽度和高度进行设置,背景颜色为黑色,display设置为块级元素。
<style>
#container{
width: 330px;
margin: 10px auto;
}
#container div{
width: 100px;
height: 100px;
margin: 0 5px;
background-color: black;
display: inline-block;
}
</style>
此段代码是js代码设置,先获取<div>
块下的子节点,一共四个<div>
,然后再获取button
标签,
点击事件:返回标签之间的HTML如果是将黑色div变成红色,将<div>
的backgroundColor
属性设置为红色,反之同理。
function cli()
{
if (btn.innerHTML === '将黑色div变成红色'){
for (var i = 0; i < 4; i++) {
divs[i].style.backgroundColor = "red";
}
btn.innerHTML = "将红色div变成黑色";
}
else {
for (var i = 0; i < 4; i++) {
divs[i].style.backgroundColor = "black";
}
btn.innerHTML = "将黑色div变成红色";
}
}
我觉得好过将所有代码放在一起。
如何使用名诗浪语在结尾呈现精彩?
王老师讲解内容:
一篇好的文章不仅需要一个好的开头,也需要一个好的结尾。王老师讲到的用名诗浪语来结尾,让人牢记在心。比如王老师自己写的一篇文章主题为:从纯技术到技术管理,那些跌宕起伏的转型经历中结尾写到。岁月跌宕起伏,人生不能预知,季节悄然行走,经历,好比无数朵平凡的烟火组成,每一朵都有它的精彩,遥遥相望。
用这样的方式结尾,使文章显得更加优美、含蓄,睿智大气。
总结
你觉得什么样的技术文章更受大家欢迎呢?
看完充满自信的故事后,能拿起就用,并牢记于心的。
看了王老师的直播之后,学到了很多,文章中也有我自己的一些想法,也不知道正确与否,每个人有每个人的写作特点。吸取别人的长处,弥补自己的短处呗!希望每个小伙伴都可以写出好的文章,加油!