WaterDrop 主题文档

缘起

"WaterDrop"（水滴）这个名字虽简单，却蕴含深意。在项目命名时，我受到了一些著名开源项目的启发：Java 语言因其创始人喜欢在办公室品味 Java 咖啡而得名，MySQL 和 MariaDB 则分别以作者的两个女儿命名。这种既随性又富有个人色彩的命名方式总是令人印象深刻。

在开发这个主题时，我正沉浸在刘慈欣的《三体 II：黑暗森林》的阅读中。这部作品以其宏大的想象力，对人性、文明、历史和哲学的深刻探讨，给我留下了难忘的印象。最初我曾考虑用"黑暗森林"或"森林"作为主题名，但担心这会让人联想到"黑色科技风"或"绿色丛林风"的视觉风格。最终，我选择了"水滴"这个看似普通却蕴含无限可能的名字。就像三体中的水滴一样，它外表简约，却蕴藏着惊人的潜力。

主题理念

WaterDrop 是一款注重简约与实用性的写作主题，专为技术文章、心得体会及产品文档而设计。我们秉持"实用性胜过华丽外表"的理念，现在和未来都将避免添加那些仅具装饰性而无实际用途的花哨组件。对于需要一个理想平台来展示产品文档或分享技术心得的开发者而言，WaterDrop 将是不二之选！

核心特性

• 响应式设计：完美适配手机、平板、电脑等多种设备

• 丰富组件：

• 公告栏

• 轮播图

• 热门文章

• 最新评论

• 分类导航

• 3D 旋转标签云

• 优质体验：

• PJAX 无刷新加载

• GitHub 风格的内容渲染

• 自定义文章封面

• 广告位集成

• emoji 表情评论

功能特点

• 兼容 LZStat 插件，支持：

• 文章点赞统计

• 访问量统计

• 自定义排序（基于时间、点赞数、访问量、权重）

• 侧边栏文章列表支持多种排序方式

• 内置多个实用页面模板：

• 友情链接

• 文章归档

• 作品展示

安装指南

1. 获取主题：

• 从 GitHub 下载 WaterDrop 主题压缩包

• 解压并重命名文件夹为 WaterDrop

• 将文件夹放置于 /usr/themes/ 目录下

• 确保 index.php 位于 WaterDrop 文件夹根目录

2. 启用主题：

• 登录博客后台

• 进入 控制台 -> 外观

• 找到并选择 WaterDrop

• 点击 启用

使用指南

1. 友情链接

使用友情链接页面模板时，按以下格式添加链接：

markdownCopy- ![站点名称1](站点图标1) [站点名称1](跳转链接1)- ![站点名称2](站点图标2) [站点名称2](跳转链接2)

2. 文章归档

选择文章归档页面模板后，无需填写任何内容，保持文本区域为空即可。

3. 作品列表

使用作品列表模板时，按以下格式添加作品：

markdownCopy- 作品标题1- 作品链接地址1- 作品封面图片地址1- 作品描述1- 作品标题2- 作品链接地址2- 作品封面图片地址2- 作品描述2

注意事项：

• 严格遵守顺序：标题、链接、图片、描述

• 描述段落需要缩进 4 个空格

• 描述支持 HTML 标签

4. 插件依赖

• LZStat 插件：提供点赞统计、访问量统计及热门文章展示功能（可选）

5. 补充说明

5.1 侧边栏配置

• 显示最新评论：在 设置 -> 评论 中配置评论列表数目

• 显示文章榜单：在 设置 -> 阅读 中配置文章列表数目

5.2 文章封面机制

封面图优先级：

1. 手动指定的封面

2. 文章第一张图片

3. 主题设置中的默认封面

4. 主题内置的 post-default-cover.png

这种机制不仅确保了文章列表的视觉统一，也在一定程度上缓解了图床服务不稳定带来的体验问题。当然，如果对稳定性要求极高，建议使用本地图片或付费图床服务。