欢迎使用 Eleventy 杂志主题

项目分享
#Eleventy #博客 #教程
发布于 2026-06-20 2 分钟阅读 506 字

感谢你选择使用这个 Eleventy 杂志主题。它最初的设计理念是打造一个简洁、专注阅读体验的博客系统,同时保持足够的可扩展性,让使用者能够轻松地添加自己的内容和样式。

主题特性

这个主题包含了许多实用的功能,开箱即用:

  • 三栏布局:左侧为作者信息与导航,中间为主内容区,右侧为目录与站点统计
  • 响应式设计:桌面端三栏、平板端两栏、移动端单栏自动适配
  • 深色模式:支持手动切换与跟随系统偏好自动切换
  • 客户端搜索:基于 Fuse.js 的模糊搜索,无需后端服务
  • PWA 支持:可离线访问,提供接近原生应用的阅读体验
  • 评论集成:预留了 Giscus 和 Twikoo 两种评论系统的配置接口

快速开始

要开始使用这个主题,你只需要完成以下几个步骤:

  1. 修改 _data/site.json 中的站点基本信息(标题、描述、URL 等)
  2. 修改 _data/author.json 中的作者信息(姓名、邮箱、社交链接等)
  3. _posts/ 目录下添加你的文章
  4. 运行 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 字段,这有助于提升列表页的浏览体验和搜索结果的准确性。

写在最后

一个好的博客主题应当像一张干净的书桌——它不会打扰你写作,但会在你需要的时候提供恰到好处的便利。希望这个主题能成为你记录想法、分享知识的好帮手。