欢迎使用 Eleventy 杂志主题
感谢你选择使用这个 Eleventy 杂志主题。它最初的设计理念是打造一个简洁、专注阅读体验的博客系统,同时保持足够的可扩展性,让使用者能够轻松地添加自己的内容和样式。
主题特性
这个主题包含了许多实用的功能,开箱即用:
- 三栏布局:左侧为作者信息与导航,中间为主内容区,右侧为目录与站点统计
- 响应式设计:桌面端三栏、平板端两栏、移动端单栏自动适配
- 深色模式:支持手动切换与跟随系统偏好自动切换
- 客户端搜索:基于 Fuse.js 的模糊搜索,无需后端服务
- PWA 支持:可离线访问,提供接近原生应用的阅读体验
- 评论集成:预留了 Giscus 和 Twikoo 两种评论系统的配置接口
快速开始
要开始使用这个主题,你只需要完成以下几个步骤:
- 修改
_data/site.json中的站点基本信息(标题、描述、URL 等) - 修改
_data/author.json中的作者信息(姓名、邮箱、社交链接等) - 在
_posts/目录下添加你的文章 - 运行
npm run dev启动本地开发服务器
自定义配置
所有全局配置都集中在 _data/ 目录下,便于统一管理:
site.json— 站点标题、URL、分页设置等author.json— 作者姓名、头像、邮箱、社交链接nav.json— 主导航菜单项comments.json— 评论系统配置taxonomy.js— 分类与标签的 URL 安全映射
写作格式
文章采用标准的 Markdown 格式,顶部需要包含 YAML Front Matter:
---
title: 文章标题
date: 2026-06-20T00:00:00.000Z
categories:
- 技术笔记
tags:
- 教程
- 前端
excerpt: 这是一段文章摘要,会显示在列表页和搜索结果中。
---
建议你为每篇文章填写 excerpt 字段,这有助于提升列表页的浏览体验和搜索结果的准确性。
写在最后
一个好的博客主题应当像一张干净的书桌——它不会打扰你写作,但会在你需要的时候提供恰到好处的便利。希望这个主题能成为你记录想法、分享知识的好帮手。