Files
ITStudioMainSite/README.md
T
2026-03-04 14:55:15 +08:00

6.9 KiB
Raw Blame History

爱特工作室总站




📖 项目简介

中国海洋大学爱特工作室官方网站 WordPress 主题。这是一个现代化、响应式的主题,支持暗色/亮色模式切换,融合海洋元素与 IT 风格。

主要特性

  • 🎨 现代简洁设计 - IT风格与海洋元素完美融合
  • 🌓 主题切换 - 支持暗色/亮色模式,可根据系统主题自动切换
  • 📱 响应式布局 - 完美适配 PC 端和移动端
  • 🌐 多语言支持 - 支持中文/英文切换
  • 性能优化 - 轻量级设计,加载快速
  • 🎯 自定义内容类型 - 支持公告通知、社团新闻、便民服务独立管理

🚀 快速开始

安装方法

  1. 克隆本仓库到 WordPress 主题目录:
cd wp-content/themes
git clone https://github.com/itstudio-2002/ITStudioMainSite.git
  1. 在 WordPress 后台激活主题:
    • 进入 外观 > 主题
    • 找到 "IT Studio Theme"
    • 点击 激活

主题配置

1. 导航菜单设置

进入 外观 > 菜单,创建主导航菜单并分配到 "Primary Menu" 位置。

推荐菜单结构:

  • 首页
  • 公告通知
  • 博客
  • 便民服务
  • 社团介绍
  • 加入我们

2. 发布公告

主题内置了"公告通知"自定义文章类型:

  1. 进入 Announcement > 新建 Announcement
  2. 填写标题和内容
  3. 发布即可在首页显示

3. 发布新闻

主题内置了"社团新闻"自定义文章类型:

  1. 进入 News > 新建 News
  2. 填写标题和内容
  3. 发布即可在首页显示

4. 新闻公告页权重字段(ACF

新闻公告页右侧“高权重文章”读取 ACF 数值字段 itstudio_weight(数值越大,排序越靠前)。

适用范围:

  • 默认文章(post
  • 公告(announcement
  • 新闻(news

设置步骤:

  1. 安装并启用插件 Advanced Custom Fields (ACF)
  2. 主题会自动注册字段组“内容权重”,字段名为 itstudio_weight(显示名“权重”)。
  3. 编辑文章时在右侧填写“权重”数值(例如 1050100)。
  4. 更新或发布文章。

说明:

  • 当前仅读取 ACF 字段值,不再使用 Gutenberg 的“自定义字段”面板作为权重来源。
  • 未设置 itstudio_weight 的文章按 0 处理。
  • 当高权重文章不足 4 篇时,页面会自动用最新文章补足。

5. 维护便民服务目录

主题内置了“便民服务(service)”内容类型,/services 页面会自动读取并展示。

每条服务信息来源:

  • 图标:文章特色图(Featured Image
  • 名称:服务双语字段(中文名称 / 英文名称)
  • 简介:服务双语字段(中文简介 / 英文简介)
  • 类别:服务分类双语字段(中文名称 / 英文名称)
  • 跳转链接:编辑页中的“服务跳转链接”字段

后台新增步骤:

  1. 进入 便民服务 > 新增便民服务
  2. 在“服务双语与链接”填写:
    • 中文名称 / 英文名称
    • 中文简介 / 英文简介
    • 服务跳转链接
  3. 设置特色图作为服务图标。
  4. 在右侧选择或新建“服务分类”。
  5. 发布后,该服务会自动出现在 /services 页面中。

分类双语设置:

  1. 进入 便民服务 > 服务分类
  2. 新增或编辑分类时,可填写“中文名称”和“英文名称”。
  3. 前台会根据语言切换自动显示对应分类名。

说明:

  • 若未设置“服务跳转链接”,前端会回退到该服务文章自身链接。
  • 若未设置特色图,前端会使用 resources/it_logo_2024.svg 作为默认图标。
  • 新增内容类型后若前台路由未生效,请进入 设置 > 固定链接 点击一次“保存更改”刷新重写规则。

🎨 设计规范

主题色彩

  • 海洋浅蓝色 (#f0f8ff) - 亮色模式背景
  • 海洋深蓝色 (#0a1929) - 暗色模式背景
  • 强调色 (#8e88c7) - 链接、按钮等
  • 中性色 - 灰度系列用于文本和边框

页面结构

  • Header - 左侧 Logo,右侧导航栏、社交图标、主题切换按钮
  • 首页 - 工作室介绍、公告列表、博客列表双栏布局
  • Footer - 友情链接、联系方式、版权信息

📂 文件结构

ITStudioMainSite/
├── assets/
│   ├── css/
│   │   ├── content.css       # 内容页样式
│   │   ├── front-page.css    # 首页样式
│   │   └── services-page.css # 便民服务页样式
│   └── js/
│       ├── theme-toggle.js   # 主题切换功能
│       └── main.js           # 主要 JavaScript
├── resources/
│   ├── it_logo_2024.svg      # 工作室 Logo
│   ├── ouc-logo.svg          # 海大 Logo
│   └── ...
├── style.css                 # WordPress 主题样式表(必需)
├── functions.php             # 主题功能文件
├── index.php                 # 首页模板
├── header.php                # 头部模板
├── footer.php                # 底部模板
├── single.php                # 单篇文章模板
├── page.php                  # 页面模板
├── page-services.php         # 便民服务页面模板
├── archive.php               # 归档页面模板
└── 404.php                   # 404 错误页面

🛠️ 技术栈

  • WordPress - 内容管理系统
  • PHP - 后端开发语言
  • HTML5/CSS3 - 前端标记与样式
  • JavaScript - 前端交互逻辑
  • SVG - 矢量图标和 Logo

🔧 开发指南

本地开发环境

  1. 安装 WordPress 本地开发环境(如 XAMPP、MAMP 等)
  2. 克隆本仓库到 wp-content/themes 目录
  3. 激活主题开始开发

自定义开发

  • 修改 assets/css/main.css 自定义样式
  • 编辑 functions.php 添加新功能
  • 创建新的模板文件扩展功能

📝 使用许可

MIT License - 详见 LICENSE 文件

👥 关于我们

爱特工作室成立于 2002 年,是中国海洋大学信息科学与工程学部领导主持下的技术性团队。

🎯 使命: 发现人才,培养人才,输送人才

🔗 链接:

🤝 贡献

欢迎提交 Issue 和 Pull Request

📄 更新日志

v1.0.0 (2026-02-05)

  • 🎉 初始版本发布
  • 基础主题功能实现
  • 响应式设计完成
  • 主题切换功能
  • 自定义文章类型(公告)