这篇文章主要是用来定一下博文编写的指导方针。
目录
1、内容提要
1.1 问题背景
【文章提要】部分概述博文解决的问题的背景(适用环境)、解决方法以及要达到的目标
临溪羡鱼很久了,在工作中参考过无数大神小仙的博客,受益良多。看到他们收获的赞、从积累的文章中体现出来的个人成长轨迹、以及某一天发现多年前的参考的某个入门教程的博主就是我身边闪耀着光辉的同事的时候,膝盖和麒麟臂都隐隐发痒,于是决定探出头来当众丢人了。
1.2 解决方法
Talk is cheap, show me the code.
在开篇之前撸了一遍写博文攻略,纷纷杂杂。想起多年前泡图书馆时读到的刘未鹏老师的一本书《暗时间》,里面讲到写博客的意义与定位,重温一下便开始写这篇开场白。《为什么你应该(从现在开始就)写博客》
1.3 预期目标
此篇开场白的目标是对博文的风格探索和对博文内容的定位说明,同时让自己梳理清楚想法,做好周全准备,让写博文这件事情更加容易地坚持下去。
短期内达到的目标就是:为博文样式打板,评估单篇博文的消耗时长。
长期目标:当然是不要搬起石头砸自己的脚,出门丢脸丢的太彻底咯!
数字来说话:近一年内(截止2019年4月前)做到每月至少一篇原创博文。
2、博文内容定位
道听途说,CSDN上口水战严重。在此,希望自己在态度上做到以下几点,态度决定了内容的取舍。
- 对无法给出依据凭感觉的争论不参与;
- 以官方文档为依据,读原文;
- 对不了解及尚未理解的地方只言个人思路和考量,明确标注,不误导他人;
- 未经验证和测试的代码及结论不上传;
对这个博客的预期是学习笔记和工作小结。主要是用来曾经花时间研究过的技术中,自己有深入思考的点。
3、风格定义
从多年围观大神博客的经验中总结了一些我所认为的写的好的博客的特点,也是我希望自己写的博客能够努力达到的目标。在此列出:
- 风格稳定
- 目录结构清楚:大纲清楚后,不容易写歪。
- 样式简约,必要情况下才进行配图:节省写博客时间成本
- 重要代码片段示例,提供完整代码链接
- 命名规范,标签清晰:便于搜索和查找
- 中短篇为主,内容分块不累赘,朴述为主,幽默为辅:阅读体验好
维护主题周边内容链接:通常都会有一个同一主题的文章大纲。(进阶级的感觉)
放部分早期入坑程序员之路参考的大神博客的参考链接,他们是榜样:
一去丶二三里 :早期学Qt的 “博导” (博客导师) 之一。
乌托邦2号:同事的博客。
现在看过了特别多其他大神的博客,小仙也决定以他们为目标开始修炼啦!
用陈皓大神的博客来给自己加鸡血。
当然还有我可爱的强迫症男朋友的博客:我学C++、Qt和Java的线下导师以及我的御用架构师。
我们都开始写博客之旅啦!
4、准备工作
- 编写工具使用学习
目前是直接在网站上编写,2018年5月之前希望能够转到vscode上编写,并解决两边markdown格式匹配。 - markdown语法知识学习
目前具备基础用法,此部分属于积累过程,将以博文记录markdown写博文常用的语法。
博文链接 - 博文目录结构定义
暂时按照编程语言分,把近一个月想写的内容列出来,排好时间补充。
5、小结
正在努力把这件事情做下去,努力让事情简单到可以很方便成为习惯,仅此而已。