w2wiki 项目常见问题解决方案

w2wiki 项目常见问题解决方案

项目基础介绍

w2wiki 是一个基于 PHP 开发的轻量级、自托管的网页版 wiki 系统。它允许用户通过 Markdown 语法创建和编辑笔记，并支持通过双括号 [[like this]] 进行内部链接。w2wiki 的特点包括：

• 便携性和可扩展性：使用 PHP 编写，便于在各种环境中部署和扩展。
• Markdown 语法：支持 Markdown 语法，方便用户进行格式化编辑。
• 自适应界面：在 iPhone 等移动设备上具有良好的显示效果。
• 文件系统存储：使用文件系统存储数据，无需数据库。
• 支持图片上传：允许用户上传图片并嵌入到笔记中。

新手使用注意事项及解决方案

1. PHP 环境配置问题

问题描述：新手在部署 w2wiki 时，可能会遇到 PHP 环境配置不正确的问题，导致项目无法正常运行。

解决步骤：

1. 检查 PHP 版本：确保服务器上安装的 PHP 版本符合 w2wiki 的要求（通常为 PHP 5.6 及以上版本）。
2. 启用必要的 PHP 扩展：确保启用了 mbstring 和 gd 扩展，这些扩展是 w2wiki 正常运行所必需的。
3. 配置文件权限：确保 w2wiki 目录及其子目录的权限设置正确，通常需要设置为 755 或 775。

2. 文件系统权限问题

问题描述：由于文件系统权限设置不当，导致无法保存或上传文件。

解决步骤：

1. 检查目录权限：确保 uploads 目录及其子目录的权限设置为 777，以便 PHP 能够写入文件。
2. 检查文件权限：确保所有用户生成的文件（如笔记文件和上传的图片）的权限设置为 644 或 664。
3. 使用 FTP 工具：如果通过 FTP 上传文件，确保使用正确的用户和权限设置。

3. 内部链接失效问题

问题描述：新手在使用 w2wiki 时，可能会遇到内部链接（如 [[like this]]）无法正常跳转的问题。

解决步骤：

1. 检查链接格式：确保内部链接的格式正确，即使用双括号 [[like this]] 包裹目标笔记的标题。
2. 检查目标笔记是否存在：确保目标笔记已经存在，并且标题拼写正确。
3. 清理缓存：有时浏览器缓存可能导致链接无法正常跳转，尝试清理浏览器缓存或使用无痕模式访问。

通过以上步骤，新手用户可以更好地解决在使用 w2wiki 项目时遇到的常见问题，确保项目的顺利部署和使用。