mdView 文档
欢迎使用 mdView 文档系统
👁7 次阅读·📖约 4 分钟

常见问题

本文档收集了使用 mdView 文档系统时常见的问题和解决方案。

常见问题

Q: 如何添加新文档?

方法一:手动添加

  • docs/ 目录下创建新的 .md 文件
  • 登录后台管理(/admin
  • 在「文档管理」中点击「同步文件系统」
  • 方法二:后台创建

    登录后台管理,在「文档管理」中创建新文档,系统会自动同步。

    Q: 文档无法显示怎么办?

  • 检查文件路径:确保文档文件存在于 docs/ 目录下
  • 检查文件编码:确保文件使用 UTF-8 编码(无 BOM)
  • 检查 Markdown 语法:确保 Markdown 格式正确
  • 同步文档树:登录后台 → 文档管理 → 同步文件系统
  • Q: 如何修改文档内容?

  • 直接编辑文件:使用文本编辑器直接修改 docs/ 目录下的 .md 文件,然后后台同步
  • 后台编辑:登录后台管理,在「文档管理」中点击编辑按钮
  • Q: 如何设置不同的角色权限?

  • 登录后台管理(/admin
  • 点击「角色管理」
  • 选择要修改的角色,点击「编辑」
  • 在权限分配中勾选或取消相应的权限
  • Q: 忘记管理员密码怎么办?

    由于密码使用 bcrypt 加密存储,无法直接找回。解决方法:

  • 使用 PHP 命令行重置密码:
  • php -r "echo password_hash('新密码', PASSWORD_BCRYPT);"
    
  • 将生成的哈希值更新到 data/mdview.dbusers 表中
  • 或删除 data/mdview.db 文件,重新访问系统会自动重建数据库和默认账户
  • 使用默认账户 admin/admin123 登录后修改密码
  • Q: 文档目录没有更新怎么办?

  • 登录后台管理(/admin
  • 点击「文档管理」
  • 点击「同步文件系统」按钮
  • 系统会重新扫描 docs/ 目录并更新文档树
  • Q: 如何开启调试模式?

    查看 PHP 错误信息:

    # 在项目根目录创建临时测试脚本
    php -r "phpinfo();" | grep -i error
    

    或修改 index.php 顶部添加:

    ini_set('display_errors', '1');
    error_reporting(E_ALL);
    

    Q: 页面加载缓慢怎么办?

  • 使用静态化部署:将文档编译为静态 HTML,参考「静态化部署」文档
  • 优化图片:压缩文档中的图片大小
  • 启用 Web 服务器缓存:配置静态文件缓存
  • Q: 如何备份数据?

  • 备份 data/mdview.db(SQLite 模式)或导出 MySQL/SQL Server 数据库
  • 备份 docs/ 目录(所有 Markdown 文档)
  • 建议使用版本控制(如 Git)管理 docs/ 目录内容
  • Q: 如何迁移到新服务器?

  • 将整个项目目录复制到新服务器
  • 确保新服务器满足 PHP >= 7.4 且已安装对应数据库的 PDO 扩展
  • 配置 Web 服务器指向项目目录
  • 确保 data/ 目录有写入权限
  • 技术支持

    如果您遇到的问题不在上述列表中,可以:

  • 查看日志:检查 data/static-build.log 或服务器错误日志
  • 检查配置:确保 PHP 扩展 (pdo_sqlite / pdo_mysql / pdo_sqlsrv, json, session, mbstring) 已启用
  • 查看 PHP 错误:在 index.php 顶部临时启用 display_errors
  • 反馈建议

    欢迎提供反馈和建议,帮助我们改进 mdView 文档系统。

  • 功能建议:请在后台管理的「系统设置」中提交反馈
  • Bug 报告:请提供详细的错误信息和复现步骤