欢迎访问席宇博客

eleventy-cn-blog使用文档

时间:2023-12-03
分类: 日记
标签: 测试 , 多个标签测试

eleventy-cn-blog是一个开箱即用的静态博客生成器，基于eleventy的静态博客生成器，灵感来自eleventy-base-blog模版，对中文做了一些优化，比如支持中文URL和中文日期格式。支持环保事业,减少用户设备能耗,该项目尽量克制使用js编写，但是由于现实世界和理想之间的巨大落差，有时候不得不添加必要js，如果不需要某些依赖js的功能，可以手动删除相关js不影响整体使用。如果喜欢可以点个star，有使用问题可以提交issues

示例站点 #

xiyu.pro

主要特色功能 #

[x] 开箱即用的 Lighthouse 得分为四百分！
[x] 支持RSS订阅和sitemap生成
[x] 代码高亮
[x] 通过短代码优化图像{ % image % }
[x] json格式的文章数据,你甚至可以将静态博客作为api使用(作者本人已实现静态博客对接微信小程序)
[x] 支持中文url（url本来就支持中文，是11ty内置的url美化插件不支持中文导致的问题，这里直接不使用插件就解决了问题）
[x] 支持窗口内链接预加载（包含4kb的js）
[x] 增加分类
[x] html压缩
[x] View Transitions页面转换的优雅过渡效果(这个api目前是草案阶段,如需使用需更新谷歌浏览器最新版并开启chrome://flags#view-transition-on-navigation,一同期待View Transitions成为标准)
[x] 支持Service Worker,博客可以在无网环境使用（包含少量js）
[x] 首页改为分页形式
[x] 纯前端搜索功能

如何使用 #

更详细的文档可以参考 eleventy eleventy-base-blog

克隆或下载本项目到本地
进入项目目录，运行npm install安装依赖
运行npm run serve启动本地开发服务器
在_posts目录下编写你的博客文章，支持Markdown和Nunjucks两种格式
运行npm run build生成静态网站文件，输出到_site目录
将_site目录下的文件部署到你的服务器或托管平台

未来想要实现的功能 #

基于Valine的评论功能
SEO优化

注意事项 #

1.不要将文章的md文件命名为纯数字/中文/空格，例如1.md，这是因为View Transitions依赖的view-transition-name属性值为纯数字时将为无效值。纯数字的文档名会影响视角过渡效果。后续升级通过修改view-transition-name锚定值解决该问题