文本样式101 - SQwatermark/Patchouli-wiki-zh_cn GitHub Wiki

在整个手册说明中，你可以找到一些可以被 "添加样式（formatted）" 的对象。帕秋莉手册提供了一个文本格式系统，允许你用一些样式代码编写富文本。

样式代码可以在一个实时游戏内编辑器中测试（主页的铅笔图标）。继续阅读，找到你需要的。

• $() - 清除所有当前使用的样式
• $(br) - 添加一个换行符
• $(br2) - 添加两个换行符（或者一个新的段落，如果你想的话）
• $(li) - 为无序列表创建列表元素（译注：这一行就是一个无序列表的列表元素，以黑色圆点开头）
  • 你还可以用 $(li2)，$(li3)，诸如此类，来表示嵌套列表。
• $(#rrggbb) - 十六进制颜色代码（例如，$(#ff0000) 会让文本变成红色）
  • $(#rgb) 也是可以的（例如，$(#f00) 也会让文本变成红色）
• $(0-f) - Minecraft 颜色代码（例如，$(6) 会让文本变成金色)
• $(k/l/m/n/o) - Minecraft 样式代码（例如，$(o) 会让文本变成斜体)
• $(l:entryid) - 内部链接，把 entryid 换成某个章节的 id 就可以创建一个可点击的链接！
• $(l:entryid#anchorname) - 内部链接，和上一条相同，但是指向一个指定的页面。目标页面必须有一个 "anchor" 字段，设置成特定的锚的名字。
• $(l:http://...) - 外部链接，和前面两条类似，但是当点击时，打开一条网页。
• $(/l) - 结束当前链接但是保留样式（$()也结束链接）
• $(playername) - 插入玩家名
• $(k:...) - 插入键位绑定（keybind）对应的按键名。阅读下面的内容，了解如何获取键位绑定名。
• $(t:...) - 让省略号的内容变成这个样式后面的文本的悬停工具提示（tooltip）（译注：工具提示不再使用这里列出的样式，而是和原版工具提示使用相同的样式）
• $(/t) - 结束当前工具提示但是保留样式（$()也结束工具提示）
• $(c:/command here) - 点击时让玩家向服务器发送一条命令。可使用原版 /trigger 指令，计分项（scoreboard objectives），和 mcfunctions。必须 以斜杠开头。
• $(/c) - 结束当前指令但是保留样式（$() 也结束指令）

**使用 $(k:...)：

要找到一个键位绑定（keybind）的名字，用一个文本编辑器打开整合包实例中的 options.txt 文件（在 /mods、/config 这些文件夹的同级目录下），然后浏览以 "key_" 开头的值，直到找到一个看起来像你需要的（它们是模组使用的内部名）。

例如你想要显示 F5（切换视角）按键。你需要找到 key_key.togglePerspective:63，然后复制这一行并进行如下操作：

• 删除开头的 "key_"，和结尾的 ":N"（N 是结尾的任何数字）
• 如果这个名字现在以 "key." 开头，你也可以移除它。
• 现在你得到了要写进 $(k:...) 的名字。在这个案例中，你需要写 $(k:togglePerspective)，它在手册中就会被替换成 F5，或任何玩家将其设置成的按键。

默认提供了一些宏（macros）。如果你写了左边的东西，它会自动转变为右边的东西。

• $(obf) -> $(k)
• $(bold) -> $(l)
• $(strike) -> $(m)
• $(italic) -> $(o)
• $(italics) -> $(o)
• $(list -> $(li
  • （右圆括号的缺失是为了让你可以使用 $(list2)，$(list3)，诸如此类）
• $(reset) -> $()
• $(clear) -> $()
• $(2br) -> $(br2)
• $(p) -> $(br2)
• /$ -> $()
• <br> -> $(br)
• $(nocolor) -&gt; $(0)
• $(item) -&gt; $(#b0b)
• $(thing) -&gt; $(#490)

推荐分别使用 $(item) 和 $(thing) 作为高亮物品和概念（concepts）的统一颜色。

单本手册可以创建它们的自定义宏（macro）。这些宏只适用于定义它们的手册。手册定义的宏会覆盖默认的，比方说你可以将 $(item) 绑定为你想要的其他颜色。

要创建自定义宏，只需要在 book.json 文件（阅读手册 JSON 格式获取更多信息）中添加 "macro" 键，按照如下格式填写：

"macros": {
	"key1": "value1",
	"key2": "value2"
}

键是要被替换的文本，值是用于替换的文本。例如：

"macros": {
	"$(potato)": "$(#F00)POTATO SALAD$()"
}

如果你这么写，当你输入 $(potato) 时，将会以红色文本显示 "POTATO SALAD"。

没有规定左侧必需包含标准的 $(...) 格式，所以你可以设置任何你想要的格式，就像下面展示的：

"macros": {
	"<b>": "$(l)",
	"<i>": "$(o)",
	"</>": "$()"
}