HTML-Sketchapp-CLI 常见问题解决方案

HTML-Sketchapp-CLI 常见问题解决方案

html-sketchapp-cli Quickly generate Sketch libraries from HTML documents and living style guides, powered by html-sketchapp 项目地址: https://gitcode.com/gh_mirrors/ht/html-sketchapp-cli

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

HTML-Sketchapp-CLI 是一个开源项目，它可以帮助用户快速从 HTML 文档和实时样式指南生成 Sketch 库。这个工具通过 html-sketchapp 和 Puppeteer 实现，能够将带有特定属性的 HTML 元素转换成 Sketch 的 JSON 格式文件，进而导入到 Sketch 设计工具中使用。项目主要使用 JavaScript 编程语言开发。

2. 新手常见问题与解决方案

问题一：项目安装失败

问题描述： 用户尝试全局或本地安装 html-sketchapp-cli 时遇到问题。

解决步骤：

1. 确保您的系统中已安装 Node.js，且版本为最新 "Active LTS" 版本。
2. 使用命令 npm install -g n 安装 Node.js 版本管理工具 n。
3. 通过 n latest 命令升级到最新 LTS 版本的 Node.js。
4. 尝试重新执行安装命令：
   • 全局安装：npm install -g html-sketchapp-cli
   • 项目中安装：npm install --save-dev html-sketchapp-cli

问题二：无法生成 Sketch 文件

问题描述： 运行 html-sketchapp 命令后，没有生成预期的 Sketch JSON 文件。

解决步骤：

1. 检查 HTML 页面中是否已经添加了正确的数据属性（如 data-sketch-symbol）。
2. 确保命令中的 --file 参数指向的 HTML 文件路径正确，且文件格式无误。
3. 检查 --out-dir 参数指定的输出目录是否存在，如果没有，请创建相应的目录。
4. 运行命令时，确保所有需要的参数都已正确提供。

问题三：Sketch 插件未正确安装

问题描述： 用户无法在 Sketch 中导入生成的 JSON 文件。

解决步骤：

1. 确认是否已经安装了 html-sketchapp 的 Sketch 插件。
2. 如果未安装，运行 html-sketchapp install 命令进行安装。
3. 检查 Sketch 插件是否已经启用，可以在 Sketch 的插件菜单中查找 html-sketchapp 插件。
4. 如果插件安装后仍无法使用，尝试重启 Sketch 应用程序。

请注意，上述解决方案是基于项目文档和常见错误情况提出的，具体问题可能需要根据实际情况进一步调试和解决。

html-sketchapp-cli Quickly generate Sketch libraries from HTML documents and living style guides, powered by html-sketchapp 项目地址: https://gitcode.com/gh_mirrors/ht/html-sketchapp-cli