Hello MkDocs

距上次将网站切换成hexo静态框架(Hello hexo),已过半年有余。如你所见,这次又将网站静态框架换成了MkDocs,并使用了Material for MkDocs主题。

经过多年的积累,沉淀。此网站有关安防知识的体系,框架早已完成。网站维护更多的是对旧文章,旧知识内容的更新,而非大量拟写新的内容。因而诸如hexo这样的博客框架已不太适合。

一直在寻找适合展示知识,技术,文档等内容的网站框架。关键能简单明了的展示知识体系,大纲目录,且方便更新。网站在使用hexo框架时,曾考虑使用docsify来单独展示关于安防的基础知识,相关产品技术信息等(现网站的基础知识,及安防知识数据库栏目)。但docsify为前端渲染,打开速度不太理想,且不利于检索。最后找到采用了与docsify类似的MkDocs,并使用了Material for MkDocs主题。

目前网站内容托管于Github,通过Github action自动构建,并部署于VPS(国内)及Netlify(国外)。除了以上提到的基础知识,安防知识数据库等栏目,保留了原本网站的博客形态(采用Material for MkDocs内置的blog插件),因而也保留了原有内容文章的链接地址(将博客作为了网站起始内容)。并独立出视频资料下载两个部分。

  • 博客。原本网站的主体内容,放在起始位置,以便能保持原有文章的链接地址。
  • 基础知识。主要内容为三份关于安防基础知识的文档,曾发布于微信公众号,详见此处关于
  • 安防知识数据库。关于安防产品,知识,技术等信息数据的收集整理。曾考虑采用docsify单独展示,现合并到同一个网站。
  • 资料下载。设想作为安防相关资料,工具,软件等分享的一个栏目。待建设完善中。
  • 视频。设想作为安防产品,功能,效果,技术,demo等视频展示栏目。待建设完善中。

2024.6.11 端午假期后于广州。


评论