# theme

**Repository Path**: wordpress_2/themes

## Basic Information

- **Project Name**: theme
- **Description**: No description available
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-30
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WordPress 主题目录

本目录包含 WordPress 主题文件。当前包含以下主题：

---

## 🎨 自定义主题 (test)

**类型：** 经典主题 (PHP 模板模式)  
**技术栈：** PHP + Tailwind CSS (CDN)  
**兼容性：** WordPress 5.0+

### 主题概述
这是一个基于 PHP 模板模式的经典 WordPress 主题，集成了 Tailwind CSS 进行现代化样式设计。

### 文件结构
```
test/
├── style.css          # 主题信息头文件
├── index.php          # 文章列表模板 (The Loop)
├── single.php         # 单篇文章模板
├── header.php         # 头部模板 (Tailwind + 导航)
├── footer.php         # 底部模板
├── functions.php      # 功能文件 (注册导航菜单)
├── comments.php       # 评论模板
└── readme.md         # 详细开发文档
```

### 核心功能
- ✅ **Tailwind CSS 集成** - 通过 CDN 引入，无需构建步骤
- ✅ **响应式设计** - 适配移动端、平板、桌面端
- ✅ **导航菜单** - 注册「站点主导航」菜单
- ✅ **文章列表** - 使用 WordPress The Loop 实现
- ✅ **评论系统** - 完整的评论模板和表单
- ✅ **单篇文章** - 支持文章导航和评论显示

### 安装使用
1. 将 `test` 文件夹复制到 `wp-content/themes/` 目录
2. 后台 → 外观 → 主题 → 激活「测试主题」
3. 外观 → 菜单 → 创建导航菜单

### 开发文档
详细说明请查看：[test/readme.md](test/readme.md)

---

## 🚀 区块主题 (block)

**类型：** 区块主题 (Block Theme)  
**技术栈：** HTML + theme.json + 全站编辑  
**兼容性：** WordPress 6.0+

### 主题概述
这是一个符合 WordPress 区块主题规范的现代化主题，支持全站编辑功能，参考了官方 Twenty Twenty-Three、Twenty Twenty-Four 和 Twenty Twenty-Five 主题的最佳实践。

### 文件结构
```
block/
├── style.css              # 主题信息头文件
├── theme.json             # 主题配置 (颜色、字体、布局)
├── templates/             # 模板文件
│   ├── index.html        # 首页模板 (3列文章网格)
│   ├── single.html       # 单篇文章模板
│   └── page.html         # 页面模板
├── parts/                 # 模板部件
│   ├── header.html       # 头部部件
│   └── footer.html       # 底部部件
├── patterns/              # 可重复使用的模式
│   └── posts-grid.php    # 文章网格布局模式
└── README.md             # 完整开发文档
```

### 核心功能
- ✅ **全站编辑** - 支持 WordPress 全站编辑器
- ✅ **3列网格布局** - 响应式文章列表
- ✅ **预设系统** - 使用 theme.json 定义颜色和字体
- ✅ **模板部件** - 可编辑的头部和底部
- ✅ **模式支持** - 可重复使用的布局组件
- ✅ **区块语法** - 符合官方规范的标准语法

### 安装使用
1. 将 `block` 文件夹复制到 `wp-content/themes/` 目录
2. 后台 → 外观 → 主题 → 激活「自定义主题」
3. 外观 → 编辑器 → 自定义布局和样式

### 开发文档
详细说明请查看：[block/README.md](block/README.md)

---

## 📋 主题对比

| 特性 | 经典主题 (test) | 区块主题 (block) |
|------|----------------|-----------------|
| **主题类型** | PHP 模板模式 | 区块主题模式 |
| **WordPress 版本** | 5.0+ | 6.0+ |
| **样式方案** | Tailwind CSS (CDN) | theme.json 预设 |
| **编辑方式** | 代码编辑 | 全站可视化编辑 |
| **学习曲线** | 简单 | 中等 |
| **扩展性** | 高 | 非常高 |
| **适合场景** | 传统开发、快速部署 | 现代化开发、内容管理 |

---

## 🛠️ 开发指南

### 选择主题类型

**选择经典主题 (test) 如果：**
- 需要兼容 WordPress 5.0 以下版本
- 习惯传统的 PHP 模板开发方式
- 项目需要快速上线
- 团队熟悉 Tailwind CSS

**选择区块主题 (block) 如果：**
- 使用 WordPress 6.0+ 版本
- 需要全站编辑功能
- 希望内容编辑更灵活
- 项目需要现代化架构

### 开发建议

1. **经典主题开发**
   - 遵循 WordPress 模板层次结构
   - 使用 `get_header()`、`get_footer()` 等标准函数
   - 在 `functions.php` 中注册主题功能

2. **区块主题开发**
   - 熟悉 theme.json 配置语法
   - 使用标准的区块 HTML 注释
   - 利用模板部件和模式提高复用性
   - 测试在不同屏幕尺寸下的显示效果

### 调试技巧

1. **启用调试模式**
   ```php
   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);
   ```

2. **检查主题错误**
   - 查看 WordPress 调试日志
   - 检查浏览器控制台错误
   - 验证模板文件语法

---

## 📚 学习资源

### 官方文档
- [WordPress 主题开发手册](https://developer.wordpress.org/themes/)
- [区块主题开发指南](https://developer.wordpress.org/themes/block-themes/)
- [theme.json 参考](https://developer.wordpress.org/themes/advanced-topics/theme-json/)

### 参考主题
- [Twenty Twenty-Three](twentytwentythree/) - 首个官方区块主题
- [Twenty Twenty-Four](twentytwentyfour/) - 设计系统主题
- [Twenty Twenty-Five](twentytwentyfive/) - 最新区块主题

---

## 🤝 贡献指南

欢迎提交 Pull Request 或 Issue 来改进这些主题：

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

---

## 📄 许可证

所有主题均采用 GPL v2 或更高版本许可证。

---

## 📞 技术支持

如有问题或建议，请：
1. 查看对应主题的详细文档
2. 检查 WordPress 官方文档
3. 在 GitHub/Gitee 提交 Issue

---

*最后更新：2024年*  
*维护者：WordPress 开发团队*