黑马程序员技术交流社区
标题: 谈谈第一次写博客的感受，以及请教以后怎么写 [打印本页]
作者: 571568202 时间: 2015-8-12 22:57
标题: 谈谈第一次写博客的感受，以及请教以后怎么写
http://blog.csdn.net/hu19931120/article/details/47421231
这是我第一次写的关于java集合博客，上面是地址。写完之后就是感觉好累啊。请提出宝贵意见，写得不好请指正。有几方面请教大家。
1.代码。那个先是代码不会粘，后来用的是CSDN里的Code代码块粘代码的，很好用。谁不会我可以教。黑马里的代码形式弄不出来。
2.字体。再是用多大字体，看着才不别扭，看别人的，有自己感觉，很别扭。标题用多大，小标题，以及正文。
3.格式。我以为博客跟Word文档或者WPS差不多，结果你设置了大小字体，以及空了几个格，下一行就自己变回去以前的格式。或者一保存结果他自己就空格，空行，自己缩进。我写的博客里就有，根本弄不好。 我后来就全选设置字体大小，结果本来第2行的字自己跑到了最后，都乱了。我又重新调顺序。
我感觉WPS我也会用，但是一写博客，就不会了。求指教。
作者: 追梦天涯33 时间: 2015-8-12 22:57
我是在cdsn上发表的注册一个账号,发表博客.
一 从格式上来说:(1) 每篇日记标题前必须加上“黑马程序员”。
(2) Java日记书写规范，请将以下代码复制到每篇日记开始处：
------- <a target="blank">android培训</a>、<a target="blank">java培训</a>、期待与您交流！ ----------
(3) .Net日记书写规范，请将以下代码复制到每篇日记开始处：
------- <a target="blank">Windows Phone 7手机开发</a>、<a target="blank">.Net培训</a>期待与您交流！ ----------
二 内容上说：
采用面向对象的 “可维护、可扩展、可复用、灵活性好” 原则。
“可维护”——我们写博客应该打包归类，就像，博客并不是越长越好，而是“耦合性”越弱越好，就像类一样，并不是越长越好，而是耦合性越低越好，这样既给人一种清新的感觉，而且，试想一下，自己平时看文章是什么状态，有多少次能把长篇大论看完，恐怕只拉了拉下拉箭头就直接关掉的也不在少数吧。
“可扩展”——我这里所说得可扩展，是指博客要扩展，也就是要升华，不能仅仅拘泥也技术而无法自拔，学会扩展性的思维，想想，这种技术能升华出什么思想，每一种技术都是智慧的结晶，当然，编程更是，不是有句话说：“编程不仅仅是门技术，更是门艺术”吗，他必然有它的优越性，把他的思想升华出来，完成扩展功能。
“可复用”——思想上的可复用，无论学什么，其实都可以升华出一些一样的东西，这些东西在以后的学习中会起到很重要的作用，就像总结看书经验一样，基本上所以的书都是第一遍略读，大概知其然，然后如果觉得值得读，在细读第二遍，知其所以然，这就是经验，傻话总是同时踏进同一条河流，其实他缺少的，就是不能“复用经验，复用思想”，我们不要在反反复复的学习中（既是所学的内容不一样）去反反复复去犯同一个错误，而唯一能避免的，就是提炼出来，发表成博客（或者自己留着，嘿嘿，达到目的就好），让这些思想在不断的总结中不断加固，最终达到目的。
“灵活性好”——每一篇博客都要有自己的思想，这种思想是可以复用的，不仅仅是对于以后的学习，既是在生活中也回用到很多，就像大话里面的例子，几乎都是来源于生活，世界上最灵活的莫过于思想，所以，让自己的博客充满灵性，别人才能从你的博客中读出不一样的东西。
只有注入思想的博客才是好的博客，让你的博客活起来吧！！！
三 注意事项:
1. Do not Repeat Documents, link to it 不要重复文档，给出链接就好。重点写自己的心得，体会和总结。对于那些在官方文档中都讲的很清楚的东西就没有必要再进行重复了，给出相应的链接就好了。特别是对于像MSDN这种非常丰富的官方文档，最好不要去重复它的内容，因为你不一定比官方讲的清楚。重点应该放在自己的心得，体会和总结等，这样于自己是真正的总结和积累，能变成经验，于他人也是一种有价值的参考的。
2. 进行全面的总结前面说了不要重复文档，那应该写什么呢？愚认为，应该是自己经过实践之后的总结：
- 文档中没有说明的情况，比如对文档的补充，或者文档有自相矛盾的地方。
3. 必须亲自实践进行验证，确保可靠可行。并附上实例（源码，资源）和运行结果（截图等）4. 要总结与所谈内容相关且有价值的网络资料5. 要列出参考资料，比如官方文档，别人的博客，源码等。这是对别人的尊重，也是对知识的一种尊重。6. 可以参考，可以引用，但不要照搬，不思考式的抄袭。最重要的是要有自己的思考和理解。如果是受他人的博客或代码的启发，最好把关键的句子段落引用出来，然后再写自己的思考和讨论。在文章中再给出原文或出处的链接，这样以显得尊重和专业。
7. 最好能有版本控制信息和修订记录对于代码我们都有版本控制系统来帮助维护修改记录。但对于文档，也建议这样做。对于博客，可能没有（或许我不知道）类似的工具，但可以手动来说明。比如在博客的头部或尾部加上修订历史记录，或者在文章中把后来的修改用其他字体标明，或者用括号或脚注来说明。这样自已日后看起来也很方便，也能看到自己的思考过程和成长过程。
8. Less But Better精深原则讲的越详细越好，范围越小越好，但要深入的讲，正如那句话，十个百分之十不如一个百分之百。如果你不能深入的讲，证明你还没有到写的时候，应试再去学习或者实践，直到你能讲的很清楚，讲的很详细，讲的很深入的时候再来总结和写博客。争取做到一篇文章一个点，这样文章多了就成了网最后变成没有漏洞的面。
9. 突出主题，分清主次，逻辑清楚，层次分明这可能是对于写作的通用要求，说起来容易，但是做起来就比较困难。其实也不难，主要表现在：
- 列表来罗列要讲的东西
- 用标题先简明概括，然后再详细讲解
- 标题与正文用不同的字体样式标识
- 用字体和缩进来标识标题和正文
有没有一种感觉，这好像是在讲编码规范，没错，很早就有人讲过，写文章跟写代码是一样的。所以，作为程序员的我们，可以考虑用写代码的一切，包括习惯，规范来写文章。
10. 写完后多读几遍，进行校改这就好比写完代码后的调试与测试。好代码是改出来的，好文章也是如此。能够一蹴而就的人有，但很少。即使是像鲁迅那样的大作家写文章都还需要修改，都没有一次成型的，更何况我们呢？在写完文章后也视情况对文章进行调试和重构，直到自己读起来感到满意和舒服为止。试想，如果自己写的文章自已都不想看，别人会看吗？我们又不是在写作业，不管好坏老师总会看，而且要仔细的看。要想写出好文章，必须首先让自己认为是好文章。
11. 用通俗易懂的平实的语言，对于专业术语要解释好的技术文章应该都非常容易看懂，即使你对所说的那门科学完全不知。去读一读《Code Complete》等之类的经典书籍的英文原版，你会发现，其实看原版书并不需要多么NB的英语水平，可以不客气的讲上过大学的人应该都能看懂。其实这重点不在你懂不懂英语，而是要看作者能否用最易懂的语言来把事情表达清楚。这确实是一种能力，平常我们所谓的沟通能力，也基本上就在这，看你能否用最简单的语言把事情表达清楚，让另一方听明白。
这里有一些技巧：
- 多用比喻，用大家熟悉的东西来比喻，这是让人最容易理解的一种方式。比如把软件构建比作建房子;把软件架构师比作楼房的设计师等。
- 多用图示，用图解。很多时候一张图能抵上几百字的文字叙述，但还不一定能说明白。给出一张图就什么都明明白白了。
- 图文并茂是讲解的最佳方式，合理的安排图片，再加之文字描述会达到事半功倍的效果。
12. 用事实说话有图有真相，有代码有真相。说完了，讲过了，最好附上真实事例，代码和截图。否则别人可能会质疑，至少我在看到别人只“说”，没“做”的时候会质疑的。
作者: itufo 时间: 2015-8-12 23:13
编辑框上面不是有个：从word粘贴内容么：，你试下这个 应该可以的
作者: leiyingyin 时间: 2015-8-12 23:30
作者: sunsteam 时间: 2015-8-13 00:20
多看看一些大牛的博客学习下可能会容易点 不过我觉得目前阶段有心得体会就好了, 不必那么在意格式吧
作者: 571568202 时间: 2015-8-13 09:38
不行啊，我在CSDN博客里，我点"<>"上面显示“源代码”，点了之后复制代码。我保存之后查看，还是Word格式。黑马里面的"<>"显示"添加代码文字"，不一样啊
作者: songynnm 时间: 2015-8-15 13:31
CSDN里切换到MarkDown编辑器，在点添加代码按钮，将代码粘进去就行了：http://blog.csdn.net/songyanannm
作者: aguang 时间: 2015-8-17 10:26
我也是刚开始写，不知道怎么写好，过来看看，赚些分哈
作者: 信@仰 时间: 2015-8-18 16:17
第一次也不是很会写，主要把学过的知识总结一下.
作者: joeywr 时间: 2015-8-19 13:04
多看大牛的贴，再总结下自己实际经验及多和同行讨论。感觉这样的博客最终都应该会火吧！
作者: tangbinbin 时间: 2015-8-20 19:49
我也不知道怎么写，什么样的形式以及内容，
作者: 杨怀伟 时间: 2015-8-22 02:09
哥们我也在写博客可是两天了一个字也没有写出来，求指教一下啊大神
作者: taoaisheng 时间: 2015-8-23 20:43
我还处于一种赚技术分的过程中，具体的博客还没有写呢，所以很多东西都不懂，就像上面这位朋友所说的怎么样复制代码我也不会，怎么复制代码啊，可以教教我吗？，
作者: 571568202 时间: 2015-8-24 22:41
你就可以看一下别人怎么写的，你就模仿着写，多看几个人的。看他们的格式，布局。java中方法怎么使用，就写自己的理解。如果自己只是理解，但是说不出来，就看看别人的，例如其他人的博客，API等。抄几句应该应然可以，毕竟才刚学，哪有那么多成套的理解。
作者: 571568202 时间: 2015-8-24 23:11
我是在CSDN上写的博客，我一开始在新浪申请的博客都不知道在哪里粘代码，后来在CSDN上能找到，就在CSDN上写的。首先，打开写博客的页面。
第一种方法，在工具栏中，找到"插入代码"的功能图标，点它，有编程语言栏，选择你编程的语言，然后再下面的白框中粘贴你的代码，点确定就行。虽然看着和别人的不一样，没有颜色边框和行数，但是你一发表就自动加上了。
第二种方法，在工具栏中，找到"引入CODE代码片"的功能图标，只有一个白框，不明白怎么回事。就在写博客的页面(就在刚进入CSDN博客的页面也有)，最上面有6个图标，第4 个图标的最下面有"创建代码片"选项，点它，有标签，代码片描述，文件名，代码...粘代码就可以了。点提交代码片，有一个嵌入脚本，复制里面的内容。再回到写博客的页面，点"引入CODE代码片"，在里面复制一下就行。虽然只是一行看不懂的英文，但是一提交就是代码，我用的就是这种，还可以把你的代码存在CSDN代码片里面。
本来想用图片，但是太小，不会弄。这两种方法看着长，你一弄就明白。
还有一个就是"源代码"图标，点它，之后，再粘贴"- ------<a target="blank">Java培训、Android培训、iOS培训、.Net培训</a>、期待与您交流！ -------
"，点一下"可视化编辑"，再回来写博客。
希望对你有帮助。
作者: taoaisheng 时间: 2015-8-25 08:57
谢谢您的帮助，希望我们一起共同努力去创造属于我们的美好明天。
| 欢迎光临 黑马程序员技术交流社区 (http://bbs.itheima.com/) |
黑马程序员IT技术论坛 X3.2 |