加载中...

拖了几个月_我终于把这个博客开源了

  • 2025-11-14
  • Web开发
  • 博客 网站开发
  • --

我的博客站代码开源了

我的博客站从8月份上线(https://maplezz.com),到现在已经3个月了。今天我终于把整个项目的代码放到Github上开源了,项目名叫MapleBlog,地址是:https://github.com/maplezzzzzz/MapleBlog

github

这事儿,其实拖了很久。这个博客上线后,我陆陆续续写了一些介绍的文章(我的Liquid Glass主题博客改版上线了),然后有好多朋友过来问我要开源地址。但是

没有

最开始,我的想法就是做一个自用的轻量级静态博客站,满足自己使用的需求就行了。所以什么项目结构、代码规范都比较随意,完全没办法拿出去开源啊。

截图

为什么要开源

最直接的原因,被好几个朋友索要代码了。很多人喜欢我这个博客的风格,甚至有人已经开始自己动手仿站。

我觉得我应该做点什么,如果大家喜欢它,那我就放出来让大家用好了,反正不是什么商业机密。如果能有志同道合的朋友一起优化,说不定能让它越来越好。

另外,我之前没有开源过任何项目,这次也算是迈出第一步了,这个项目来源于开源,所以还是让他回归开源好了。

简单介绍一下MapleBlog

这是一个基于 Astro 的静态网站生成器,目标是三个词:够用、好看、轻量。基础功能该有的都有:内容管理、评论功能、友链管理、RSS、深色模式、响应式页面等。

功能

网站内容使用Markdown文件维护,这方面类似于Hexo等。页面结构干净,组件易懂,只需要前端技术栈就能上手。

Liquid Glass液态玻璃样式使用了liquid-glass-effect-macos开源项目,虽然玻璃效果不是特别逼真,但是好在简单,性能也可以接受。

截图

而且为了页面性能,已经砍掉了大部分区域的玻璃样式,只保留了头部和底部区域,还有一些按钮样式。

这个项目我是基于开源项目Astrogon开发的,一半自己手写,一半让AI辅助,所以代码还是有点凌乱的。发布之前我稍微“整理”了一下,其实就是把一些硬编码改成配置项,删删减减一些冗余代码。

然后补充了一些说明文档、示例文章、README文件等,尽量让大家能看得懂吧。

文档

其实开源版本跟我的线上版本还有一些区别,我的线上版本用到了Supabase服务,比如阅读量、点赞量、友链存储等都用到了。

Supabase

但是我觉得这跟网站的纯静态理念相悖,所以在开源版本中我把这些接口都去掉了,尽量少的依赖外部服务。

如何运行

克隆仓库:

git clone https://github.com/maplezzzzzz/MapleBlog.git

安装依赖:

npm install

本地运行:

npm run dev

然后浏览器打开: http://localhost:4321/

如果想发布上线,就运行:

npm run build 

编译得到dist/ 目录,然后放到 Vercel、Netlify 或你自己的静态服务器即可。

总结

既然开源了,就别客气。喜欢就点个Star,有问题可以提,有想法也可以发出来,咱们一起讨论。

这个项目后续我也会抽时间不定期的维护,虽然不是什么高大上的项目,但是只要有人喜欢它,我觉得就值了。

Maple
Maple
© 2025 by Maplezz 本文基于 CC BY-NC-SA 4.0 许可 CC 协议 必须注明创作者 仅允许将作品用于非商业用途 改编作品必须遵循相同条款进行共享 最后更新:2025/11/14