这是我的第一篇博客,是一次新的尝试。这几天我查找了网上的经验,也浏览了一些跟“软件工程”相关或其他内容的博客,想要分享一些我对于写个人技术博客的心得体会,一是提醒自己,二也是希望能够提供给需要的读者一些帮助与启发。
1. 界面的排版
- 标题和板块
首先,作为技术博客的标题要做到言简意赅。这篇博客的主题,要介绍的内容应该要在标题直接点明。
其次,一篇博客要注意分板块,如果整篇博客都是大段文字那作为读者来说很难保持精力去阅读。而且分板块,那就得要让读者知道你哪个板块是干什么的。适当的将文章按照内容分成不同的板块更有助于引导读者阅读或者理解。
- 代码的排版
作为程序员,博客的内容中大多都会包含所介绍内容的代码。其实代码只要提供关键的代码,或是将代码拆分入博客的几个板块,分段给出比较好。如果要给出完整代码,那可以在文章的末尾添加完整代码的地址,既不会破坏博客的流畅性,也能给提供给需要的读者。
因为若是你的博客被别人点进浏览,那大多是对你的标题吸引。这些读者也都是对这篇博客的主题有所了解的人,把整段代码全部贴上对这些读者其实没有必要,而且也和之前说的博客不分板块一样,读者很少有精力去看长段的代码。而将代码放入不同的板块中,更适合自己去解释代码,也读者也更有兴趣。
2. 博客的内容
博客的内容是整篇博客的核心,如果内容不够优秀,那再好的排版和标题也都是付之东流了。
- 个人技术博客的内容应该尽量是自己的切身体会,在软件开发过程中遇到的问题都是非常珍贵的,再好的修辞有时也比不上自己真情实感的流露。
- 关于博客中要介绍的问题,应该要简洁明了,要让读者一眼就明白和读懂问题。问题可以写一个大标题,解决的步骤可以分为的小标题是文章条理清晰。
- 比起单纯的文字说明,配上图片更为直观。
- 篇幅要适中,500-1000,过长的篇幅会打消读者的兴趣。
3. 每次写完要及时反思
语言的流畅,描述问题的清晰程度,这些问题都不是一簇而就的,是需要一次次的积累而慢慢成长起来的。我看过一些博客主们以前写的和现在写的博客还是有很大的差别的。每次写完之后反思,才能将一件事更通俗易懂的分享给别人。