【亲测免费】 InteractiveHtmlBom 安装和配置指南

1. 项目基础介绍和主要编程语言

项目基础介绍

InteractiveHtmlBom 是一个用于 KiCad、EasyEDA、Eagle、Fusion360 和 Allegro PCB 设计器的插件，能够生成交互式的 HTML 格式的 BOM（Bill of Materials，物料清单）。该插件允许用户通过可视化的方式快速查找和定位 PCB 板上的元件，特别适用于手工焊接原型时快速定位元件位置。

主要编程语言

该项目主要使用 Python 语言进行开发，同时也使用了 JavaScript、CSS 和 HTML 等前端技术来生成和展示交互式的 BOM 页面。

2. 项目使用的关键技术和框架

关键技术

• Python: 用于读取 PCB 数据并生成 BOM 页面。
• JavaScript: 用于实现 BOM 页面的交互功能，如元件高亮、排序等。
• HTML/CSS: 用于生成和美化 BOM 页面。

框架

• Pcbnew Python API: 用于读取 KiCad 的 PCB 数据。
• Split.js: 用于 BOM 页面的布局分割。
• PEP.js: 用于 BOM 页面的交互功能。
• lz-string.js: 用于压缩和解压缩 BOM 数据。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

1. 安装 Python: 确保你的系统上已经安装了 Python 3.x。如果没有安装，可以从 Python 官方网站 下载并安装。
2. 安装 Git: 用于从 GitHub 克隆项目代码。如果没有安装，可以从 Git 官方网站 下载并安装。
3. 安装 KiCad: 如果你使用的是 KiCad，确保已经安装了最新版本的 KiCad。

详细安装步骤

步骤 1: 克隆项目代码

打开终端或命令提示符，运行以下命令克隆项目代码：

git clone https://github.com/openscopeproject/InteractiveHtmlBom.git

步骤 2: 进入项目目录

克隆完成后，进入项目目录：

cd InteractiveHtmlBom

步骤 3: 安装依赖

项目可能依赖一些 Python 库，可以通过以下命令安装这些依赖：

pip install -r requirements.txt

步骤 4: 配置 KiCad

如果你使用的是 KiCad，需要将插件配置到 KiCad 中：

1. 打开 KiCad。
2. 进入 首选项 -> 插件和内容管理器。
3. 点击 安装插件，选择 从文件安装。
4. 导航到 InteractiveHtmlBom 目录，选择 InteractiveHtmlBom.py 文件进行安装。

步骤 5: 生成 BOM

在 KiCad 中打开你的 PCB 项目，然后运行插件生成 BOM：

1. 打开 PCB 编辑器。
2. 进入 工具 -> 外部插件 -> InteractiveHtmlBom。
3. 插件将自动生成一个 HTML 文件，你可以在浏览器中打开该文件查看交互式的 BOM。

注意事项

• 如果你使用的是其他 PCB 设计工具（如 EasyEDA、Eagle 等），请参考项目的 Wiki 页面获取相应的安装和配置指南。
• 生成的 HTML 文件是自包含的，不需要互联网连接即可工作，可以将其打包到你的项目文档中或托管在任何网站上。

通过以上步骤，你应该能够成功安装和配置 InteractiveHtmlBom 插件，并生成交互式的 BOM 页面。