ITEM

网址导航型的 Typecho 主题

演示站点 »

项目说明 · 快速开始 · 问题反馈

🎉 项目说明

✨ Hugo 版现已推出：hugo-theme-item

在编程语言中，"item" 这个单词常用来代表一个元素、一个选项
希望这个主题能够承载更多的 "item"，链接每一个选项~

---

🛠️ 快速开始

通过 Vercel 托管需要添加一个 MySQL 集成，如 TiDB、PlanetScale，参考: Vercel 托管 Typecho

本地部署

这是一个 Typecho 主题，因此你必须要先安装 Typecho 才能使用它，同时还需要满足以下条件:

• php 7.4+
• MySQL 8+

1. 获取主题文件 克隆仓库源码或下载最新 Releases，

   git clone https://github.com/fordes123/ITEM.git

2. 将主题文件重名为 ITEM 并移动至 Typecho 根目录usr/themes 文件夹中
3. 在 Typecho 管理面板中选择更换外观并启用主题

本地开发

安装 Docker 以及 Docker Compose 后，在项目根目录下执行以下命令：

cd .docker
docker compose up -d

打开浏览器即可访问 http://localhost:80，账号: dev，密码: 12345678

(该配置仅用于开发和测试，请勿直接用于生产环境)

---

配置说明

文章配置

文章类型 为 网址导航 时，点击图标前往详情，点击其他位置直接跳转至对应url；文章类型 为 普通文章 时， 代表站内文章，点击会前往文章页，所以普通文章无需跳转链接

分类配置

分类略缩名表示对应图标名称，可用图标可在 FontAwesome 5 图标库中浏览；
(例: FontAwesome 图标类名为 <i class="fas fa-vihara"></i> 那么对应略缩名应为 vihara)

搜索引擎配置

配置格式为 JSON，其中 icon 为 FontAwesome 5 图标， 需要使用 完整类名。 示例如下：

[
  {
    "name": "谷歌",
    "url": "https://www.google.com/search?q=",
    "icon": "fab fa-google"
  },
  {
    "name": "Github",
    "url": "https://github.com/search?q=",
    "icon": "fab fa-github"
  }
]

工具直达配置

配置格式为 JSON，结构类似 搜索引擎配置，增加了 background 控制背景色，填写 css 格式的颜色值即可。 示例如下：

[
  {
    "name": "热榜速览",
    "url": "https://www.hsmy.fun",
    "icon": "fas fa-fire",
    "background": "linear-gradient(45deg, #97b3ff, #2f66ff)"
  },
  {
    "name": "地图",
    "url": "https://ditu.amap.com/",
    "icon": "fas fa-fire",
    "background": "red"
  },
  {
    "name": "微信文件助手",
    "url": "https://filehelper.weixin.qq.com",
    "icon": "fab fa-weixin",
    "background": "#1ba784"
  }
]

---

💬 问题反馈

Issues - https://github.com/fordes123/ITEM/issues

博客 - https://fordes.dev

---

📃 开源许可

基于 GNU General Public License v3.0 协议开源.