【博客】个人独立博客站点在写博客的时候应该注意什么？
个人独立博客站点在写博客的时候应该注意什么？
这个问题是我对技术类个人博客写作时的纯主观见解，各位就图一乐看看，谢谢。
1.把读者当作第一次看相关技术文章
这一点其实很难做到，包括我在本站写的很多博客都并没有做到这一点。
所谓把读者当作第一次看相关技术文章，举个例子：你写了一篇部署某某docker容器的教程，那么理应在博客中涉及如何在Linux主机上安装docker的教程部分。
这个安装docker的教程部分可以直接添加至文章内，或者单独写一篇文章，把链接放在该文开头。
这样做有什么好处？除了让别人能点击链接看你的站点里面的另外一篇文章，更重要的是保证读者在看你这篇文章的时候，不需要去额外搜索其他的东西。
之前在WSL安装CENTOS8的博客中我就吐槽过这个问题。我找到的资料原文作者图文不对应，用着win11的电脑写着win10的步骤（步骤是错的），整个设置和开启wsl功能的过程也没有贴截图，很让人无语。
对于使用windows系统比较熟练，知道怎么找设置选项的读者来说，这并不是神马大问题。但是对于很多刚入门编程学习的小白来说，图文不对只会让人感到困惑，最终还是得去搜其他资料，找怎么在win11里面开启wsl。
而原博主只需要多花30秒把那个win10的步骤改成win11的，就能节省读者去搜索另外一篇博客的时间。
同理，如果我想使用minio这个项目，发现最好的部署方式是docker部署，但我的主机上没有docker，此时我就得搜索两篇博客
- 如何在linux上安装docker；
- 如何在docker里面安装minio；
但实际查询资料的时候，以我个人为例，我都是先搜到第二个问题，再回过头去搜第一个问题的。如果我搜到的第二个问题的博客里面，作者引用或者介绍了如何安装docker的方式，那么我就不需要去额外搜索第一个问题了，这便是给读者节省了时间。
2.减少博客里面的图片数量
这个是根据不同类型的博客而言的， 对于很多教程类博客而言，图片/步骤截图是不可或缺的。
但是对于Linux类、代码编程类的博客而言，完全可以用代码块来替代图片。比如简单测试程序的运行结果，完全没必要截图，而是可以直接用代码块展示结果。在一些情况下可以做到整篇博客完全不需要截图。
下面就是一个示例，我希望给读者展示docker -v命令的结果。这个结果是linux下的命令行输出，完全可以直接拷贝过来以代码块的形式展示，而不是以截图的形式。不过以截图的方式展示总好过不展示
1 | ❯ docker -v |
减少图片数量的好处：
- 用户加载博客的时间缩短；
- 图床冗余图片减少，维护压力减轻；
- 博客“失效”概率降低；
所谓博客“失效”，就是有些教程博客中的图片不见或者加载不出来了，直接导致这篇博客废掉了。如果博客中图片数量较少，一些设置的步骤有文字的描述，这样对博客有效性的影响就更低，博客内容失效的概率也就降低了。
而如果一篇教程类博客强依赖于截图，但后续又因为其他的一些原因导致图片无法加载，而文章中又没有对设置选项做出正确的文字说明，读者就会犯难，最终只能通过博主描述的上下文去猜测这张不见的图片里面到底是什么内容，阅读体验大大降低，最终浪费了时间。
3.避免豆腐块
这其实是从学生阶段学到的东西，即写任何长段文字的时候都应该分点分段。
有些文章一上去整个豆腐块扒在那里，没有分段，看的巨难受。更有甚者连标点都没几个，实在是无语。
4.拒绝半途而废
有些博文非常奇怪啊，写到一半戛然而止，非常怀疑是爬虫没有把后半部分爬出来……
这里必须要吐槽一下国内几乎所有的公共博客平台，都没有做任何反爬虫上传的机制，一篇文章百度一下能在n个平台上看到一模一样的，而且都不是同一个作者上传的（这篇博客的原作者是谁已经是个未解之谜了），有时候还会出现最早的那篇博客里面图片失效了，爬虫爬出来的图片还在的离谱情况。
5.说清楚版本号
环境部署、程序安装等等教程的时候，一定要在博客里面写清楚你当前使用的系统的版本号，很多时候一些不兼容问题就是版本号对不上导致的。
有版本号，至少能给对方提供一个解题的思路，可以去确认一下自己使用的版本号和博主的是否一致，是否会有兼容问题。
解决这个问题更好的方式是提供完整的结果输出，详见下一点。
6.写明结果、注明来源
写明结果
最简单的一个例子，leetcode的一篇题解博客，你应该给出leetcode通过的截图。我就遇到过题解博客里面，思路啪啪啪一顿输出，结果最终的代码复制粘贴到leetcode都没办法通过的。
代码没办法通过，可能是leetcode更改了测试用例，也有可能是题目要求有变化。如果你在文章里面贴了leetcode通过截图，读者就不会把问题怀疑到你身上。但如果没有，我就得吐槽一下：“怎么有人代码都没办法通过，还好意思发题解的啊？”
命令运行结果、程序安装预期结果、程序运行预期结果、OJ题解的leetcode通过截图等等，都是结果的一部分。
写明结果，避免误会，有头有尾才能令人信服。
注明来源
依旧是以leetcode题解为例，总有人写题解的时候，不告诉你这是leetcode的第几题，也没有leetcode链接，整篇题解只有leetcode的题目描述或者题目名字（有的甚至连这两个都没有）。
这就会导致读者想去练习一下这道题目的时候，还得去搜一下这道题在leetcode上有没有；有的话，究竟是第几题；leetcode的题目描述和你这篇题解里面写的是不是一样的，等等问题，突出一个恼火。
博客作者只用几秒种从地址栏复制一下题号、题目链接到博客里面，就能节省读者的大量时间。可总有那么多博主忽略了这一点，让我在搜资料的时候总是想把他们都从我的搜索引擎里面排除掉。
虽然现在搜索引擎有AI辅助搜索功能了，但该功能尚在不太可用的阶段，希望后续人工智能技术的发展能帮助大家更好、更快、正确的检索我们想要的内容吧。
7.尽量使用规范的markdown语法
并不是所有的博客主题都支持自动解析markdown中贴出来的连接，所以，如果你的博客中包含其他http链接，请一定按照规范的md语法，使用[]()将这个链接括起来，而不是直接贴一个链接。特别是链接中有空格的情况，如果直接贴出来，即便是带自动解析功能的平台，也有可能无法解析出这个链接。
如果链接解析失败，博客里的链接就无法直接点击，用户需要手动选中才能跳转到链接网页，会带来麻烦。
错误做法
1 | https://musnow.blog.csdn.net/ |
正确做法
1 | [https://musnow.blog.csdn.net/](https://musnow.blog.csdn.net/) |
The end
暂时就想到这么多，后续能想到其他的再来补充。
如果你发现本站的某些教程类博客没有满足本文我自己描述的内容，可以直接贴在评论区打我的脸，我会在看到后及时优化博客内容。PS：本文内容仅对本站2023年以后的博客生效，2023年之前我写的博客也是很烂的😭。
爱发电
