`

写blog注意的小细节

阅读更多

    写blog也有一年多了,不能说笔者blog或者技术多好,但是在如何写blog上却是有笔者的一些见解。无论各位是新手,还是技术大牛,都会写一些blog来记录自己的经历。都有自己的写作风格,以下只是笔者个人观点。

    1.别人写过的blog,请不要再写了。如今,我们在查找资料的时候大多是借用搜索引擎,搜索引擎做的很好,但它有时也不能把所有相同的内容过滤掉。所以当我们google某个内容的时候,有时第一页显示出来的内容都是一样的。要么是不同的人写的; 要么是一个人写的一份,在几个不同的blog网站上贴出来。笔者个人很不喜欢这样的行为。幻想一下,当各位去搜某个内容的时候,半天都是相同的内容,各位看官的心情如何呢?我们发的每一篇文章要有质量(不要抬杠啦,笔者的blog质量不高啦),而不是要在乎自己发表blog的数量。而如果各位同时维护着几个不同的blog,不觉的累吗?那干脆自己做个blog站点好啦,凭你的技术不算难吧?

    2.不要翻译guide。原因如下:某些技术的文章,都会对应一个cn的guide,如果没有,各位大可考虑和官方联系一下,建立一个中文的guide文档的站点,或者贡献你的力量。另外,如果一个技术人,连一篇英文文档都读不懂的话,那只能说他只是一个coder。这话没有任何瞧不起其他程序员的意思,笔者也是程序员,但是程序员要去自学,要去查文档,而不是墨守城规。文档还是官方的好,因为总感觉翻译过来的文档已经变味了。

    3.整理写作的逻辑思维,先干什么,再干什么,中间可能出现什么问题。这时候程序员就像是一名老师,不单单要教会别人技术,而且要告诉别人你思考问题的思路。阅读的人,觉得你的思路好,可以兼容学习;觉得不好,大可不去学。有则改之,无则加冕。

    4.优化你的代码结构。我很讨厌去某些网站上去看文章,因为这些网站上的blog没有采用markdown。这也是我为什么选择iteye来写blog,看中的就是markdown。同事在xx网上写blog,通通没有采用markdown,我问为什么,有的说,没提供;有的说,有,不好使。总归是没有。看了有些博主的文章。代码之间连换行都没有,这样的文章如果是博主自己看,可能会明白。如果是别人呢?也能明白,只不过费点力罢了。

    5.不要罗列内容。有人喜欢把blog作为自己记录自己成长点滴的地方。我们应该鼓励,但罗列学习的内容是没有意义的。比如今天学习了javasript,学习了它的string,有xx方法;学习了array, 有yy方法。这有什么意义呢?方便别人查api吗?这个官方api我觉得比你写的好。个人认为,blog的内容应该是自己学习的感想,感悟,学习的方法。

    6.不要翻译api。貌似和前面的说的相似。但是这样的情况也很多。通篇在说某个对象的下面的函数,拜托,这些内容官方api上是有的。如果你想写的话,你可以写某个接口的深入剖析啊。实在想写的话,就写一个学习笔记好了。

     你是笔者,也是读者。总之,你写的blog,要让自己成为第一个读者,自己能够看着舒服。

 

6
2
分享到:
评论
15 楼 zhangfortune 2014-01-17  
u010036143 写道
u010036143 写道
犀利的一XXX啊...


但是吧,我也觉得你说的别人写过的就不要再写了有点偏了。

如果作者是在用心在写,那么对知识的巩固是很有帮助的啊,也可以让作者对所记录知识的认识有个提升。

但如果真是那种全篇照抄,或者大段粘贴的,确实没啥用...我想二哥也是这个意思吧

你是???
14 楼 zhangfortune 2014-01-17  
frank-liu 写道
对于别人写过的blog这个,我认为针对同样或者类似的问题如果自己有去深入思考并且有自己的见解和看法的话,也可以写。关键是要有自己的东西。

我举双手赞同。
13 楼 frank-liu 2014-01-17  
对于别人写过的blog这个,我认为针对同样或者类似的问题如果自己有去深入思考并且有自己的见解和看法的话,也可以写。关键是要有自己的东西。
12 楼 u010036143 2014-01-16  
u010036143 写道
犀利的一XXX啊...


但是吧,我也觉得你说的别人写过的就不要再写了有点偏了。

如果作者是在用心在写,那么对知识的巩固是很有帮助的啊,也可以让作者对所记录知识的认识有个提升。

但如果真是那种全篇照抄,或者大段粘贴的,确实没啥用...我想二哥也是这个意思吧
11 楼 u010036143 2014-01-16  
犀利的一XXX啊...
10 楼 zhangfortune 2014-01-16  
SwordShadow 写道
iteye支持markdown吗?没发现
哦,我说错了,就是对代码展示比较好的地方。
9 楼 zhangfortune 2014-01-16  
小网客 写道
挺好的,看看我的博客 看看有什么建议没?
建议谈不上,互相交流吧。
8 楼 zhangfortune 2014-01-16  
white_crucifix 写道
有些相同的内容是被一些网站爬过去的

哎呀,对对,我怎么忘了这一点了。但是卧想爬Iteye,他拒绝了,卧以为其他网站也会拒绝呢。多谢提醒,多谢提醒。
7 楼 SwordShadow 2014-01-16  
iteye支持markdown吗?没发现
6 楼 小网客 2014-01-16  
挺好的,看看我的博客 看看有什么建议没?
5 楼 white_crucifix 2014-01-16  
有些相同的内容是被一些网站爬过去的
4 楼 zhangfortune 2014-01-16  
leighton11 写道
楼主说的有点偏见,首先写博客对普通开发人员来说,是可以巩固自己的学习和总结提升的,就算看到同样的技术别人写过,自己写一遍也是很不错的学习方式,借鉴别人的后然后写一篇适合自己理解的文章也是很正常的。
你说的不是没有道理,但是你可以去查看一下,有多少这样人写的blog是用心写的?很明显的复制粘贴嘛。
3 楼 leighton11 2014-01-16  
楼主说的有点偏见,首先写博客对普通开发人员来说,是可以巩固自己的学习和总结提升的,就算看到同样的技术别人写过,自己写一遍也是很不错的学习方式,借鉴别人的后然后写一篇适合自己理解的文章也是很正常的。
2 楼 zhangfortune 2014-01-15  
qijie29896 写道
发自肺腑  源于实践  不求既往  但愿开来

总结的漂亮。
1 楼 qijie29896 2014-01-15  
发自肺腑  源于实践  不求既往  但愿开来

相关推荐

    关于webservice的一些细节注意

    NULL 博文链接:https://jiony.iteye.com/blog/785993

    微信小程序-小程序开源项目–影讯

    > 这里主要记录一下博主开发中遇到的一些问题,很多都是一些细节,开发中多注意一点。 js代码的引入 > 引入模块化的js代码使用的是相对目录,../类似于cd ..返回上一层目录 var netUtils = requ

    基于小波变换的模糊图像融合算法matlab仿真

    1.版本:matlab2022A,包含仿真操作录像,操作录像使用windows media player播放。 2.领域:模糊图像融合 ...5.注意事项:注意MATLAB左侧当前文件夹路径,必须是程序所在文件夹位置,具体可以参考视频录。

    (修正版)用Eclipse3.2+MyEclipse5.5M1+axis2_1.1.1+tomcat5.5 开发Web Services

    网上博客的文章很多存在一些小错误。 细节问题没做好。 现在我把自己的操作成功的实例重新演练一遍,基本跟大家啊网上参考的一致,请注意every setp 。我的习惯,先写一个文章大纲: 软件配置。 构建Web ...

    使用嘉立创EDA设计的GD32F103C8T6最小系统原理图及PCB.zip

    详解BOM表+C0603封装绘制流程+元件封装其它注意点总结+原理图转到PCB流程3.网络表概念解读+板框绘制4.模块化布局5.布线铺铜设计规则设置6.布线铺铜实战及细节详解7.DRC设计规则检查+优化与丝印调整+打样与PCB生产...

    wordpress在lighttpd下的重写规则及注意细节

    wordpress博客是一个开源博客程序,也是使用人数最多的.静态化的处理需要使用静态插件来达到很多空间是不需要插件来静态化的,重写url规则就开源达到静态化的处理了,感兴趣可以祥看本

    Drools7_PDF教程

    注意啦 注意啦 最新的教程已经更新 地址是https://blog.csdn.net/u013115157/article/details/64123846 有兴趣的朋友可以去博客中看看 1. 内容更加全面,更多细节,更多知识点全部在新版本中有所体现,并且会附上小...

    基于LabVIEW的信号合成与分解程序(传感器与测技术课程)

    注意,程序只是提供了功能,具体实现参看FFT的推导(https://blog.csdn.net/jaz/article/details/122575504)。 2程序采用了生产者消费者、状态机的结构,以及通过事件结构进行交互,适合labview的学习。 3系统中...

    C#调用Lightingchart实现三维测井质量交互检查MouCrossPlot3D.rar

    注意:这是小工具,直接使用,具体代码开发细节如下: 采用C#调用LightingChart控件实现,具体开发关键记录参考链接: http://blog.sciencenet.cn/home.php?mod=space&uid=244606&do=blog&id=1242834

    django-angular-blog:一个带有 django-rest-framework 和 angularjs 的博客应用

    django-angular-blog 一个带有 django-rest-framework 和 angularjs 的博客应用程序。 注意:如果您收到此错误: “导入错误:无法导入设置‘blog.settings’(是否在 sys.path 上?):没有名为 local_setting 的...

    将博客迁移至docker纪实

    由于五一前的这周工作需求不是很多,便趁着这个机会将博客迁移到了docker中,虽说网上docker相关文章有很多,第一次实践的我还是遇到了一些小问题,现在便来总结一下。 在这里我要推荐的是docker_practice(本站地址...

    SeaFormer实战:使用SeaFormer实现图像分类任务

    设计了一种具有压缩轴向和细节增强的注意力模块,使其能够更好的在移动端应用。 通过这篇文章能让你学到: 如何使用数据增强,包括transforms的增强、CutOut、MixUp、CutMix等增强手段? 如何实现SeaFormer模型实现...

    python装饰器-限制函数调用次数的方法(10s调用一次)

    这是博主最近一家大公司的面试题,写一个装饰器,限制函数每10s调用一次。当时是笔试的,只写了大概的代码,回来后温习了python装饰器的基础知识,把代码写完了...不带参数的装饰器需要注意的一些细节 1. 关于装饰器函

    基于java的博客系统毕业设计源码.zip

    提供的源码资源涵盖了安卓应用、小程序、Python应用和Java应用等多个领域,每个领域都包含了丰富的实例和项目。这些源码都是基于各自平台的最新技术和标准编写,确保了在对应环境下能够无缝运行。同时,源码中配备了...

    qt创建带窗口的dll库,并测试效果

    前言,看到网上很多相关的帖子,但是有些小细节介绍的不够详细,所以想写一篇入手篇,以供新手参考;另外注意,如果增加了资源文件,需要qmake一下,否则可能会构建失败; 详细说明:...

    《招聘一个靠谱的iOS》面试题参考答案(上).md

    还有,注意中英文间用一个半角空格隔开,排版会漂亮很多,简历承载的不仅是内容,还有细节和态度,上面这些点往往都反映着面试者的代码风格、做事的认真程度。当然,简历写的很漂亮但面聊之后发现啥都不会的也有,...

    基于MFC的多功能学生成绩管理系统.zip

    然后,一些小细节我就不说了,相信开发学生成绩管理系统的你也已经大致了解了MFC的基本概念。有一个特殊的点,我希望大家做实验前可以注意:就是在属性那里把Unicode改成多字节,否则,你会在实验中遇到各种各样的令...

    kafka学习文档

    关亍 kafka 的实现细节,返主要就是讲 design 的部分:《细节上》、《细节下》 关亍 kafka 开収环境,scala 环境的搭建:《开収环境搭建》 数据生产者,producer 的用法:《producer 的用法》、《producer 使用注意...

Global site tag (gtag.js) - Google Analytics