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 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許可證的條款獲得許可的。