README

请不要就 vichan 问题联系 Fredrick Brennan。

截至 2022 年 8 月 29 日，它支持 PHP8.1。

关于

vichan 是一个免费、轻量级、快速、高度可配置且用户友好的图板软件包。它用 PHP 编写，依赖项很少。

一些文档可以在我们的 wiki 上找到。（欢迎贡献）

历史

vichan 是（现已停用的）Tinyboard 的分支，一个优秀的图板软件包，在此基础上积极开发并添加了许多功能和改进。

维护者时间线

1. @perdedora 和 @RealAngeleno - 2023-现在。
2. 由 @basedgentoo、@kuz-sysadmin 和 @RealAngeleno 领导的开发委员会。（2023 - 2023）
3. @h00j (2021 - ???)
4. @ctrlcctrlv (2017 - 2021)
5. @czaks (2014 - 2017)（vichan 分支的作者）
6. @savetheinternet (2010 - 2014)（Tinyboard 的创建者）

要求

1. PHP >= 7.4
2. MySQL/MariaDB 服务器
3. mbstring
4. PHP GD
5. PHP PDO
6. 类 Unix 系统，最好是 FreeBSD 或 GNU/Linux

我们努力确保 vichan 与所有主要 Web 服务器兼容。vichan 不包含 Apache .htaccess 文件，也不需要它。

推荐

1. MySQL/MariaDB 服务器 >= 5.5.3
2. ImageMagick（首选命令行 ImageMagick 或 GraphicsMagick）。
3. APCu（PHP 缓存）、Memcached 或 Redis

贡献

您可以通过以下方式为 vichan 做贡献：

• 开发补丁/改进/翻译，并使用 GitHub 提交拉取请求
• 提供反馈和建议
• 编写/编辑文档

安装

1. 使用以下命令获取最新开发版本：

   git clone git://github.com/vichan-devel/vichan.git
   

2. 在目录内运行 composer install

3. 在您的网页浏览器中导航到 install.php 并按照提示操作。

4. vichan 现已安装。使用默认用户名和密码组合（admin / password）登录到 mod.php。

请记住更改管理员账户密码。

参见： 配置基础。

升级

要从 Tinyboard 或 vichan 的任何版本升级

如果您使用了 git，则运行 git pull 以更新您的文件，或者备份您的 inc/instance-config.php，然后替换所有文件（不要删除图板等），最后放回 inc/instance-config.php 并最终运行 install.php。

要从 Kusaba X 图板迁移，请使用 http://github.com/vichan-devel/Tinyboard-Migration

演示

使用 Vichan 最新的版本进行演示。

1. PHP 8.1
2. MySQL 5.7
3. KeyDB 6.2.1 (Redis)
4. NGINX 1.14.0

支持

vichan 仍然是测试软件 -- 肯定会有错误。如果您发现错误，请报告。

CLI 工具

有一些基于Tinyboard-Tools的命令行界面工具。这些工具需要从Unix shell账户（SSH等）启动。它们位于tools/目录中。

实际上，您不需要这些工具来运行图像论坛，它们主要是针对高级用户的。您无法从共享主机账户（即所有免费Web服务器）运行这些工具。

お絵描き

vichan使用wPaint进行お絵描き。然而，在拉取存储库后，您需要使用git的submodule功能单独下载wPaint。请使用以下命令

git submodule init
git submodule update

要启用お絵描き，将js/wpaint.js中列出的所有脚本添加到您的instance-config.php中。

WebM支持

有关启用webm的信息，请参阅inc/lib/webm/README.md。

vichan API

默认情况下，vichan提供了一个与4chan兼容的JSON API。有关文档，请参阅：https://github.com/vichan-devel/vichan-API/。

许可

请参阅LICENSE.md。