Pf2eTools

pf2etools

• 主站点： https：//pf2etools.com（推荐）
• 镜子1： https：//pf2oo.ls
• 镜子2： https：//pf2e.tools

dev域中可用实时开发分支。

加入我们的Discord服务器！

帮助和支持

请参阅我们的Wiki以获取安装指南。对于其他所有内容，我们在Discord Server上回答了各种常见问题解答，此外，我们可以直接提问！

开发人员注意

开发人员注意

数据源和版本控制

仅将“官方”（即Paizo发布）数据包含在网站中。其他任何内容都应添加到自制存储库中。

优先考虑原始。旨在提供原始数据的1：1副本。显而易见的错别字（例如，生物statblocks中的数学错误）可以由维护者酌情纠正。

旨在使用最新版本的任何已发表材料。足够不同（并且与社区利益相关）的较旧版本可以转移到自制存储库。

目标JavaScript版本

靶向ES6是最初的意图，但是更现代的功能早就涉足代码了。因此，如果在Chrome和Firefox中都可以作为标准品（最好是在版本中至少可以追溯到至少几个月），并且不会流血，则可以合理地证明使用它是合理的。与所有事物一样，使用常识。

样式指南

代码

• 在空间上使用标签。

CSS

• 应在可能的情况下使用BEM（“块元素修饰符”）命名策略。

数据/文字

• 格式化JSON匹配JavaScript的JSON.stringify的默认输出（使用标记的选项卡），即每个括号一条线，每个值一行。但是，应从其他JSON文件（即存储在data/generated ）中编程生成的JSON文件进行缩小。

• 当数据中的“标记”引用（例如{@creature goblin} ）时，以下规则应用：

  • 仅旨在作为参考的标签引用。例如，您在You gain one cantrip of your choice from the wizard spell list ，而将向导班Together, a group of seven powerful wizards sought to contain the demon 。一种是对机械类别的引用，仅仅是“向导”一词的随意使用。
  • 同样，切勿在quote -Type块中标记任何内容。即使报价直接提到了一个特定的生物，我们也可以假设该报价是从宇宙/角度来看的，例如（例如）statblocks不存在，因此应省略标签以保持报价的风味。
  • 在来自源的数据中，避免引用该来源出版后打印的源的内容。

JSON清洗

JSON清洁和样式指南的一部分也是自动化的，可以使用npm run clean-jsons应用。此外，此清理脚本也是自动运行的，作为npm run build的一部分。

尾逗号

要删除JSON中的尾随逗号：

查找： (.*?)(,)(:?s*]|s*})

替换： $1$3

角色更换

• '应该替换为'
• “和”应替换"
• — （EM DASH）应替换为u2014 （em Dash的Unicode）
• –应替换为u2013 （unicode for En Dash）
• −应替换为u2212 （减去标志的Unicode）
• •除非有问题的JSON尚未由入门人覆盖，否则不应使用，IE应编码为列表
• 允许的唯一Unicode逃生序列是u2014 ， u2013和u2212 ;所有其他字符（除非上面指出）应作为IS存储

破折号大会

• - （连字符）仅应用于连字符，例如60-foot和18th-level
• u2014应用于括号仪表板对，或标记空表行。
• u2013应用于连接数值范围，例如1-5应成为1u20135 。
• 在处罚的情况下，应将u2212用于单位减号。例如， "You have a -5 penalty to..."应该成为"You have a u22125 penalty to..." 。
• u2014的任何一侧的任何空格都应删除

测量惯例

• 形容词：连字符和措施单位的全名，例如，龙在60-foot line呼出酸
• 名词：应使用度量单位的空间和简短名称（包括尾随期），例如blindsight 60 ft. ， darkvision 120 ft.
• 时间：斜线， / ，两侧都没有空间，然后是大写的时间单位，例如2/Turn ， 3/Day

骰子大会

骰子应写入[X]dY[ <+|-|×> Z] ，即在骰子和操作员之间的空间以及操作员和修饰符之间的空间。 2d6格式的一些示例是： d6或2d6 + 1 。

项目名称的约定

项目名称应为标题案例，除了括号中的单位外，应该是句子案例。容器（例如(vial) ）将容器（例如（VIAL））指定为单位的项目。

鼠标/键盘事件

避免使用绑定的Alt修饰事件，因为这些事件在MACOS或各种Linux口味下不可用。结合移位/CTRL修饰事件是首选。

开发服务器

确保您安装了所有内容（ npm install ）并构建（ npm run build ）以具有功能齐全的站点。运行npm run serve:dev启动在http://localhost:8080/index.html上为项目文件提供服务的本地开发服务器。

JSON模式

存储库包含test/schema-template/schema.json中数据文件的JSON架构。该模式目前正在进行中。

有关如何使用模式的详细信息，根据您使用的设置来与仓库一起使用。

Visual Studio代码

要将JSON模式与Visual Studio Code一起使用，请转到设置并找到JSON: Schemas设置。建议您仅为本地工作区添加此配置。

 "json.schemas" : [
	{
		"fileMatch" : [
			" data/**/*.json "
		],
		"url" : " ./test/schema-template/schema.json "
	}
]

版本颠簸

do npm run version-bump -- [OPTION] ，其中[OPTION]是以下之一：

• major递增主要版本（ 1.2.3将成为2.0.0 ）
• minor次要版本（ 1.2.3将成为1.3.0 ）
• 补充补丁版本（ 1.2.3将成为1.2.4 ）的patch
• 版本号（例如1.2.3 ）

它将首先运行测试，如果测试失败，则将无法增加版本。然后，它将自动替换需要替换的文件中的版本，使用消息chore(version): bump并创建标签（以v1.2.3的形式）创建提交。通过执行npm config set git-tag-version false可以轻松禁用此功能。

执照

该项目是根据MIT许可证的条款获得许可的。