普特莫斯维基 (Purtmars Wikipedia 📖)

“TLocale 使用文档”的版本间的差异

来自Purtmars Wikipedia —— 普特莫斯维基
(建立内容为“{{:Watermark}} 本文指所有由 TabooLib 创建的 '''i18n''' 语言文件。”的新页面)
 
 
(未显示同一用户的9个中间版本)
第1行: 第1行:
{{:Watermark}}
+
{{:TabooLib Watermark}}
 
本文指所有由 [[TabooLib]] 创建的 '''i18n''' 语言文件。
 
本文指所有由 [[TabooLib]] 创建的 '''i18n''' 语言文件。
 +
 +
= 中心配置文件 =
 +
位于 '''plugins/TabooLib/settings.yml'''。<br>
 +
只有在该配置文件下添加特定的语言文件加载顺序,才会在插件中生效。或由插件本身代理这个节点。
 +
<syntaxhighlight lang="yaml" line="line">
 +
# 语言文件相关设置
 +
LOCALE:
 +
  # 加载语言文件的顺序
 +
  PRIORITY:
 +
    - zh_CN
 +
    - en_US
 +
    # 若要增加西班牙语,则在该节点下添加对应语言代码即可。
 +
    - es_ES
 +
  # 语言文件名称替换
 +
  TRANSFER:
 +
    zh_hans_cn: zh_CN
 +
    zh_hant_cn: zh_TW
 +
    en_ca: en_US
 +
    en_au: en_US
 +
    en_gb: en_US
 +
    en_nz: en_US
 +
  # 默认是否启用语言文件中 PlaceholderAPI 的替换功能
 +
  # 关闭可提升性能
 +
  # 如果需要开启仍然可以在语言文件中加入 papi: true
 +
  USE_PAPI: false
 +
  # 默认是否启用语言文件中 Kether 的替换功能
 +
  # 关闭可提升性能
 +
  # 如果需要开启仍然可以在语言文件中加入 kether: true
 +
  USE_KETHER: false
 +
</syntaxhighlight>
 +
 +
= 书写规范 =
 +
任何节点均可使用单独的 '''TLocale''' 对象,或 '''TLocale''' 对象列表。
 +
<syntaxhighlight lang="yaml" line="line">
 +
language: 'Hello World!'
 +
language:
 +
  ==: TEXT
 +
  text: 'Hello World!'
 +
language:
 +
  - ==: TEXT
 +
    text: 'message %player_name%'
 +
    papi: true
 +
  - ==: ACTION
 +
    text: 'message {{ player name }}'
 +
    Kether: true
 +
</syntaxhighlight>
 +
 +
<div style="margin-top: -20px"></div>
 +
== 音效 ==
 +
<syntaxhighlight lang="yaml" line="line">
 +
language:
 +
  ==: SOUND
 +
  sound: BLOCK_ANVIL_BREAK-1-1
 +
</syntaxhighlight>
 +
 +
<div style="margin-top: -20px"></div>
 +
== 标题 ==
 +
<syntaxhighlight lang="yaml" line="line">
 +
language:
 +
  ==: TITLE
 +
  title: '大标题信息'
 +
  subtitle: '小标题信息(可省略)'
 +
  fadein: 0
 +
  fadeout: 0
 +
  stay: 0
 +
</syntaxhighlight>
 +
 +
<div style="margin-top: -20px"></div>
 +
 +
== 血条 ==
 +
<syntaxhighlight lang="yaml" line="line">
 +
language:
 +
  ==: BAR
 +
  text: 'BossBar 信息'
 +
  color: BLUE
 +
  style: NOTCHED_20
 +
  # 进度百分比
 +
  progress: 1.0
 +
  # 持续时间
 +
  timeout: 20
 +
</syntaxhighlight>
 +
 +
<div style="margin-top: -20px"></div>
 +
== 超文本 ==
 +
<syntaxhighlight lang="yaml" line="line">
 +
language:
 +
  ==: JSON
 +
  text: '超<文本@node1>信息'
 +
  args:
 +
    node1:
 +
      url: '鼠标点击打开链接'
 +
      hover: '鼠标悬停显示内容'
 +
      suggest: '鼠标点击补全内容'
 +
      command: '鼠标点击执行命令'
 +
      insertion: 'SHIFT + 鼠标点击复制内容'
 +
</syntaxhighlight>
 +
 +
<div style="margin-top: -20px"></div>
 +
== 动作栏 ==
 +
<syntaxhighlight lang="yaml" line="line">
 +
language:
 +
  ==: ACTION
 +
  text: '动作栏信息'
 +
</syntaxhighlight>

2021年6月9日 (三) 21:01的最新版本

本文指所有由 TabooLib 创建的 i18n 语言文件。

中心配置文件

位于 plugins/TabooLib/settings.yml
只有在该配置文件下添加特定的语言文件加载顺序,才会在插件中生效。或由插件本身代理这个节点。

 1 # 语言文件相关设置
 2 LOCALE:
 3   # 加载语言文件的顺序
 4   PRIORITY:
 5     - zh_CN
 6     - en_US
 7     # 若要增加西班牙语,则在该节点下添加对应语言代码即可。
 8     - es_ES
 9   # 语言文件名称替换
10   TRANSFER:
11     zh_hans_cn: zh_CN
12     zh_hant_cn: zh_TW
13     en_ca: en_US
14     en_au: en_US
15     en_gb: en_US
16     en_nz: en_US
17   # 默认是否启用语言文件中 PlaceholderAPI 的替换功能
18   # 关闭可提升性能
19   # 如果需要开启仍然可以在语言文件中加入 papi: true
20   USE_PAPI: false
21   # 默认是否启用语言文件中 Kether 的替换功能
22   # 关闭可提升性能
23   # 如果需要开启仍然可以在语言文件中加入 kether: true
24   USE_KETHER: false

书写规范

任何节点均可使用单独的 TLocale 对象,或 TLocale 对象列表。

 1 language: 'Hello World!'
 2 language:
 3   ==: TEXT
 4   text: 'Hello World!'
 5 language:
 6   - ==: TEXT
 7     text: 'message %player_name%'
 8     papi: true
 9   - ==: ACTION
10     text: 'message {{ player name }}'
11     Kether: true

音效

1 language:
2   ==: SOUND
3   sound: BLOCK_ANVIL_BREAK-1-1

标题

1 language:
2   ==: TITLE
3   title: '大标题信息'
4   subtitle: '小标题信息(可省略)'
5   fadein: 0
6   fadeout: 0
7   stay: 0

血条

1 language:
2   ==: BAR
3   text: 'BossBar 信息'
4   color: BLUE
5   style: NOTCHED_20
6   # 进度百分比
7   progress: 1.0
8   # 持续时间
9   timeout: 20

超文本

 1 language:
 2   ==: JSON
 3   text: '超<文本@node1>信息'
 4   args:
 5     node1:
 6       url: '鼠标点击打开链接'
 7       hover: '鼠标悬停显示内容'
 8       suggest: '鼠标点击补全内容'
 9       command: '鼠标点击执行命令'
10       insertion: 'SHIFT + 鼠标点击复制内容'

动作栏

1 language:
2   ==: ACTION
3   text: '动作栏信息'