【亲测免费】 amWiki 常见问题解决方案

项目基础介绍

amWiki 是一款由 JavaScript 开发、依赖 Atom 或 Node.js-Npm 的 Markdown 轻量级前端化开源文库系统。amWiki 致力于让用户更简单、更便捷地建设个人和团队文库。它具有以下特点：

• 文档系统采用 Markdown 语法。
• 文档使用 .md 格式保存为本地文件，无需数据库。
• 无需服务端开发，只需支持 HTTP 静态访问的网页空间。
• 一键创建新的文库，自动更新文库导航目录。
• 支持多级目录，支持截图直接粘贴为本地 PNG 并插入当前 Markdown 文档。
• Web 端自适应显示，适合所有平台。
• 支持接口文档自动抓取内容生成简单的 AJAX 测试。
• 无需服务端的全文库标题内容搜索与计分排序。

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

1. 安装 Atom 插件时遇到问题

问题描述：新手在安装 Atom 插件 amWiki 时，可能会遇到插件无法安装或安装后无法正常使用的问题。

解决步骤：

1. 检查 Atom 版本：确保你使用的是最新版本的 Atom 编辑器。如果不是，请前往 Atom 官网 下载并安装最新版本。
2. 使用命令行安装：在命令行中输入以下命令进行安装：

   apm install amWiki
   

   注意：第三字母 W 需要大写。
3. 手动安装：如果命令行安装失败，可以尝试手动安装：
   • 前往 amWiki 版本发布页 下载最新版压缩包。
   • 解压到 C:\Users\Administrator\atom\packages 目录下，并将文件夹名改为 amWiki。
4. 重启 Atom：安装完成后，重启 Atom 编辑器，确保插件生效。

2. 创建新文库时找不到 config.json 文件

问题描述：新手在创建新文库时，可能会找不到 config.json 文件，导致无法创建文库。

解决步骤：

1. 创建项目文件夹：在 Atom 菜单中，选择 File -> Add Project Folder，添加一个项目文件夹。
2. 手动创建 config.json 文件：在项目文件夹下，手动创建一个名为 config.json 的文件。文件内容可以参考以下示例：

   {
     "name": "My Wiki",
     "version": "1.0.0",
     "description": "My personal wiki"
   }
   

3. 使用插件创建文库：在 Atom 菜单中，选择 amWiki轻文库 -> 通过“config.json”创建新文库。插件会根据 config.json 文件自动生成文库。

3. 文库导航目录无法自动更新

问题描述：新手在使用 amWiki 时，可能会发现文库导航目录无法自动更新，导致新添加的文档无法在导航中显示。

解决步骤：

1. 检查文档路径：确保新添加的文档路径正确，并且文档名称符合 Markdown 文件命名规范（通常为 .md 格式）。
2. 手动更新导航：如果自动更新失败，可以尝试手动更新导航目录。在 Atom 菜单中，选择 amWiki轻文库 -> 更新文库导航目录。
3. 检查 config.json 文件：确保 config.json 文件中的配置正确，特别是 name 和 version 字段。
4. 重启 Atom：有时重启 Atom 编辑器可以解决导航目录无法更新的问题。

通过以上步骤，新手可以更好地使用 amWiki 项目，解决常见问题，顺利创建和管理个人或团队文库。