HCCD开源项目常见问题解决方案

HCCD开源项目常见问题解决方案

hccd HCCD - HTML+CSS Card Designer 项目地址: https://gitcode.com/gh_mirrors/hc/hccd

1. 项目基础介绍

HCCD（HTML+CSS Card Designer）是一个开源项目，旨在自动化地从CSV（Excel）文件创建游戏卡片，通过简单的HTML和CSS代码实现。该项目主要使用Java语言开发，并且依赖于Java环境运行。

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

问题一：如何运行HCCD项目？

问题描述： 新手用户不知道如何启动和运行HCCD。

解决步骤：

1. 确保已安装Java环境。
2. 下载并解压最新版本的HCCD release（通常为hccd-binary.zip文件）。
3. 双击解压后的Hccd.jar文件以启动应用程序。
4. 在HCCD中，打开examples/example-full目录下的character.html文件。
5. 运行后，会自动生成一个新的文件character-GENERATED.html，其中包含了生成的卡片。

问题二：如何编辑和更新卡片布局？

问题描述： 用户想要修改卡片的布局和样式，但不清楚如何操作。

解决步骤：

1. 修改character.html文件来调整单张卡片的布局。确保在div标签中使用了card类，并且变量使用了mustache语法（例如[[myVariable]]）。
2. 修改character.css文件来调整卡片的样式。注意使用物理单位（如毫米、点）而非像素来定义打印尺寸。
3. 修改对应的character.csv文件来更新卡片数据。确保CSV文件的第一行是表头，包含HTML文件中定义的变量名。
4. 保存文件后，HCCD会自动检测变更并重新生成卡片。

问题三：如何解决无法打开或显示错误的问题？

问题描述： 用户尝试打开HCCD或编辑文件时遇到错误。

解决步骤：

1. 确认所有文件（HTML、CSS、CSV）和图片都位于同一目录下，并且文件名相同（仅扩展名不同）。
2. 检查文件名是否正确无误，没有使用不支持的字符。
3. 如果遇到Java环境问题，重新安装或更新Java环境。
4. 确认没有其他程序占用HCCD所需的端口。
5. 如果问题仍然存在，查看HCCD项目的README文件或GitHub issues页面，寻找类似问题的解决方案或提交新的issue请求帮助。

hccd HCCD - HTML+CSS Card Designer 项目地址: https://gitcode.com/gh_mirrors/hc/hccd