TinyIB 技术文档

1. 安装指南

1.1 系统要求

• PHP 4.3+
• GD Image Processing Library（通常默认安装，如果禁用图片上传则不需要）

1.2 安装步骤

1. 进入你希望安装 TinyIB 的目录。
2. 运行以下命令克隆项目：

   git clone git://github.com/tslocum/TinyIB.git ./
   

3. 将 settings.default.php 复制为 settings.php：

   cp settings.default.php settings.php
   

4. 配置 settings.php：
   • 如果需要上传 WebM 文件，确保服务器运行在 Linux 上，并安装 mediainfo 和 ffmpegthumbnailer。
   • 如果需要启用 moderation 功能，确保 TINYIB_DBMODE 设置为 mysql、mysqli 或 pdo，并根据需要设置 TINYIB_REQMOD。
   • 如果使用 ImageMagick 生成缩略图，安装 ImageMagick 并确保 convert 命令可用，然后将 TINYIB_THUMBNAIL 设置为 imagemagick。
5. 设置目录权限：
   • 确保以下目录可写：
     • ./
     • ./src/
     • ./thumb/
     • ./res/
     • ./inc/flatfile/（仅在使用 flatfile 数据库模式时）
6. 在浏览器中访问 imgboard.php，系统将自动创建数据库结构并生成 index.html 文件。

2. 项目使用说明

2.1 基本功能

• 支持上传 GIF、JPG、PNG、SWF 和 WebM 文件。
• 支持嵌入 YouTube、Vimeo 和 SoundCloud 内容。
• 内置简单 CAPTCHA 验证，支持 reCAPTCHA。
• 支持引用链接 >>###。
• 通过密码删除帖子。
• 管理面板：
  • 管理员和 moderator 使用不同的密码。
  • moderator 只能置顶帖子、删除帖子和审核帖子。
  • 管理员可以禁止用户、发布 HTML 内容，并自动升级通过 Git 安装的版本。

2.2 管理与维护

• 登录管理面板：点击 [Manage] 登录。
• 删除帖子：在帖子旁边勾选复选框，滚动到底部点击 Delete。
• 升级：如果通过 Git 安装，运行 git pull 获取最新版本。
• 迁移数据库：TinyIB 支持从 flat file 迁移到 MySQL，迁移过程中无法创建或删除帖子。

3. 项目API使用文档

TinyIB 主要通过 Web 界面进行操作，API 文档较为简单，主要涉及以下几个方面：

3.1 管理面板 API

• 登录：通过 [Manage] 按钮登录管理面板。
• 删除帖子：通过勾选帖子复选框并点击 Delete 按钮删除帖子。
• 审核帖子：管理员可以通过管理面板审核帖子。

3.2 数据库 API

• 数据库模式：支持 mysql、mysqli、pdo 和 flatfile 模式。
• 数据库迁移：支持从 flatfile 迁移到 mysql。

4. 项目安装方式

TinyIB 支持多种安装方式：

4.1 Git 安装

• 运行 git clone git://github.com/tslocum/TinyIB.git ./ 克隆项目。

4.2 手动下载安装

• 从 GitHub 下载 ZIP 文件并解压到服务器目录。

4.3 配置文件

• 复制 settings.default.php 为 settings.php 并进行配置。

4.4 目录权限设置

• 确保 ./、./src/、./thumb/、./res/ 和 ./inc/flatfile/ 目录可写。

通过以上步骤，你可以成功安装并配置 TinyIB，开始使用这个轻量级的图片板脚本。