本文旨在列出博客内容所需遵守的基本语言规范、文风要求以及内容安全注意事项,帮助站长撰写合规、易懂并独具风格的文章,也为后续智能体执行内容检查操作时提供规则参考。
博客与 Markdown
博客文章采用 Markdown 格式编写,遵循基本的 Commonmark、GFM、OFM 规范。两篇示例文章如下:
每一篇 Markdown 文章的 Front-matter 中,冒号之后必须要有空格,否则 Hexo 生成内容时会报错。
在 Hexo 博客中,Markdown 文件分为「页面 Page」和「文章 Post」
成文指导
博客中发布的文章更适合于写经验类文章(技术共享、步骤演示),并具有实践性、可重复性。
Hexo 写的文章是要公布到互联网的,一篇文章写成之后一般不再频繁改动。而课程笔记和私人灵感更适合交给另外的本地库。
本站中,时间的表达习惯为行内代码 ` 加上日期数字。日期数字格式为「yyMMdd」纯数字无分隔格式。
260218。博客文章中尽可能不出现错别字、语病。
文章语气不要过于自谦、短处不要外露。
不要让读者留下「流汗黄豆」的表情
比如,一篇文章中不要写太多这种话「由于博主本人经验不足…」「因为我也不是搞前端的,所以请大家…」。因为认真看你文章的读者一般是搜索很多篇类似文章在寻找解决方法,几句过谦的话容易劝退访客。作为教程提供者的你既然已经将文章写出来了,不如大方一点,并欢迎访客提出的疑问及报错信息。如果水平真不够,不理他就是了。
文章语气要和读者、友链站长保持平等与尊重。
一些我认为可以优化的称呼
「友链用户」这个词有点不妥,显得关系不太平等。
「用户」这种说法如同没有把对方当为独立主体,而是当作自己的站点用户那样。
文章管理
由于网站使用双链笔记软件进行内容管理,所以网站里的文章风格不可避免带有一点「数字花园」特色:
- 🌿 站内文章内链时常出现,数量足够多时甚至出现专为索引产生的文章。站内文章索引文章示例
- 🌻 文章在很长时间内会持续完善,当内容过多时会解耦产生新文章。站内文章文章解耦示例
- 🍂 过期文章会被标注并保留,也可能复活。违规文章放草稿箱雪藏。站内文章过期文章示例 违规文章示例
文章内容如过期,需要将文章移动到过期分类。并做好以下事情:
- 更换文章封面图为统一的封面
- 使用 Callouts 块标注过期原因以及过期时间。
关于数字花园的理解
关于「数字花园」概念好像每个人的理解都有一点点的不同?我认为我的网站应该还是介于传统博客与主流数字花园概念之间:
- ➿ 本站是既有时间线、又隐含拓扑结构的博客网站。
- 🥜 本站的文章是生长的,是可分裂的。它包含思考的过程,因此会有点痕迹感。
- 🔓 本站的文章是全公开的。私有部分会存在另外的仓库里单独管理。
- 💃 本站文章是写给自己看的,也是写给他人看的,会考虑读者感受。
- 📦 文章发表时已有一定的完成度。半成品一般不会出现在网站中,它会躺在草稿箱中。
- ⚒️ 文章的综合属性更重,强调实践性和可复现性。
关于公开库和私有库的有机结合方式我目前还在探索当中,如果成功的话就应该真是「数字花园」了吧。
内容安全审查
内容红黄线
文章禁止出现与以下主题相关的内容:
- 政治、血腥、暴力、黄赌毒等法律不允许的内容。
- 医疗、商业内容。
似乎每年管局都会至少审核一次网站。除非网站包含敏感内容,才把你加急处理。
文章中不得教授以下主题:
- 访问国外网络环境。
- 使用国外非备案大模型。
此外,根据经验和教训,OpenAI,大模型,Tokens,API 等相关内容为敏感内容,需谨慎处理。
外网链接安全
谨慎在主页或文章提供外部链接,毕竟你无法保证链接现在或以后是否违规。
目前使用 Hexo 第三方插件以及自写 Waline 评论系统插件加入中间页以规避直链风险。
友链安全性要实时管控,评论区久远链接记得删除。
过期的要求
Plantuml 插件:编写 Plantuml 代码块时必须加上 @startuml @enduml 否则报错。
