D&D Spelldeck项目使用指南

D&D Spelldeck项目使用指南

dnd-spelldeck A Python program for generating LaTeX code that will generate a nice looking deck of cards with Dungeons and Dragons 5e spells on them. 项目地址: https://gitcode.com/gh_mirrors/dn/dnd-spelldeck

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

D&D Spelldeck项目是一个用于生成Dungeons and Dragons 5e（龙与地下城第五版）法术卡片的Python程序。该程序能生成LaTeX代码，使得用户能够创建一个包含所有法术及其关键信息的卡片堆，以便在游戏中快速查找和使用。生成的卡片设计得美观且易于打印，尺寸与“万智牌”游戏卡相当，可以方便地放入标准卡牌套。

主要编程语言为Python，用于处理和生成LaTeX代码。最终，需要使用LaTeX编译器来编译生成的LaTeX文件，输出成可打印的法术卡片。

2. 新手使用项目时需要注意的3个问题及解决步骤

问题一：生成的LaTeX代码如何编译成卡片？

解决步骤：

1. 确保你的计算机上安装了LaTeX编译器，如XeLaTeX。
2. 使用编译器编译cards.tex文件，这将生成单独的卡片页面，每页对应一个法术。

   $ latexmk -xelatex -cd tex/cards.tex
   

3. 然后编译printable.tex文件，它会将所有卡片排列在一页上，方便打印和剪裁。

   $ latexmk -xelatex -cd tex/printable.tex
   

4. 根据需要调整printable.tex文件中的纸张尺寸和其他设置，以适应你的打印环境。

问题二：如何筛选特定类别的法术？

解决步骤：

1. 运行generate.py程序时，你可以通过添加参数-c后跟法术类别来筛选特定类别的法术。例如，要筛选出所有吟游诗人（bard）和战士（fighter）的法术，可以使用：

   $ ./generate.py -c bard -c fighter > tex/spells.tex
   

2. 你也可以按级别筛选法术，通过-l参数后跟级别范围。例如，要筛选0到2级和5到7级的所有法术，可以使用：

   $ ./generate.py -l 0 -l 2 -l 5-7 > tex/spells.tex
   

3. 确保筛选参数正确无误，以避免生成无效的LaTeX代码。

问题三：如何更改卡片的字体和样式？

解决步骤：

1. D&D Spelldeck项目建议使用 Wizards of the Coast 公司为玩家手册使用的字体——Mrs Eaves。如果你使用XeLaTeX编译器，它会尝试默认使用该字体。
2. 若要更改字体，你需要修改cards.tex和printable.tex文件中的相关设置，指定正确的字体文件路径和名称。
3. 如果你不使用A4纸，还需修改printable.tex文件中的纸张尺寸设置，以匹配你所使用的纸张格式。

以上步骤能帮助新手用户顺利开始使用D&D Spelldeck项目，创建属于自己的D&D法术卡片。在使用过程中，务必参考项目的README文件获取更详细的安装和使用指南。

dnd-spelldeck A Python program for generating LaTeX code that will generate a nice looking deck of cards with Dungeons and Dragons 5e spells on them. 项目地址: https://gitcode.com/gh_mirrors/dn/dnd-spelldeck