文本 link
Ren’Py内涵多种方式用于显示文本。 say
和 menu 语句就会用到文本显示。 用户接口通常都包含文本，显示时使用 text， textbutton，
和 label screen语言语句。这些screen语句加上其他的函数，可以创建 Text() 文本组件，并在界面上展示出来。
文本组件用于管理显示给用户的文本内容。文本组件按以下顺序执行行为：
转化文本。
在文本中内插数据
使用样式和文本标签将文本样式化。
给样式化后的文本布局。
将文本内容绘制到界面上。
本节内容讨论在Ren’Py中处理文本显示问题的过程。
转义字符 link
对Ren’Py来说，有3个特殊字符能控制文本显示。创作者需要注意，这3个字符的写法不要让引擎产生曲解。
- (反斜杠)
反斜杠用于Ren’Py字符串中的字符转义。一些常见的转义符号如下：
- \” (反斜杠双引号)
两端用双引号标识的字符串中含有一个双引号。
- \’ (反斜杠单引号)
两端用单引号标识的字符串中含有一个单引号。
- \ (双引号空格)
在Ren’Py字符串中含有一个额外的空格。默认情况下，Ren’Py脚本会将一段连续的空白转为一个空格字符。
- \n (反斜杠-字符n)
文本含有一个换行符。
- \\ (反斜杠-反斜杠)
文本含有一个反斜杠字符。
- \% (反斜杠-百分号)
文本中包含一个百分号字符。 也可以写作 %%。 两种写法都会显示为一个百分号。
- [ (左方括号)
左方括号用于转义在文本中内插的值。如果要在文本中包含左方括号，需要写两个左方括号 ——
[[。- { (左花括号)
左花括号用于转义文本标签(tag)。如果要在文本中包含左花括号，需要写两个左花括号 ——
{{。- 【 (左方头凹形括号)
左方头凹形括号用于引入Ruby/片假名文本。若要在文本中直接显示左方头凹形括号，需要写两个连续的方头凹形括号
【【。
内插数值 link
Ren’Py支持在文本字符串中内插数值。例如，假设用户名字存储在 playername 变量中，我们可以写这样一行对话：
g "欢迎来到猫耳协会， [playername] ！"
Ren’Py会按以下顺序搜索变量：
在某个界面中时，搜索界面本地变量。
搜索
interpolate命名空间的变量。搜索全局变量。
Ren’Py并不限制只允许内插简单变量值，也支持合法的Python表达式。以下写法也是可以的：
g "我姓 [player.names[0]]。"
显示数值之前可以先进行格式化。下面的例子显示的是一个保留小数点后两位的浮点数：
g "我百分之 [100.0 * points / max_points:.2] 喜欢你！"
Ren’Py字符串的数值内插符合 PEP 3101 的字符串格式规范。 Ren’Py字符串内插使用 [ ，因为 { 被用于文本标签(tag)了。
还有，Ren’Py支持!s、!r、!q和!t等转换标记。!q转换标记表示文本标签(tag)内引号已经正确匹配和使用，显示字符串时不会转义为不希望出现的格式。举例：
g "你别想忽悠我， [playername!q] ！"
!t转换标记会转换或计算内插字符串的值：
if points > 5:
$ mood = _("高兴")
else:
$ mood = _("头大")
g "见到你我很 [mood!t] 。"
!i 标识会在字符串中执行一次额外的插值：
define earned_points_info = _("[points]{image=points.png} 赢得点数")
g "我很高兴看到你 [earned_points_info!ti] "
界面语言中会经常用到，详见 常量文本 。
!u 标识强制将(英文)文本转为大写， !l 标识强制将(英文)文本转为小写。
!c 标识将首字母大写。
这些标识可以联用，比如使用 !cl 可以将首字母大写，后面所有文本强制小写。
有几个点需要注意：
标记的使用顺序不会影响最终结果：
!cl与!lc是一样的。各标记前补充感叹号将被忽略，并且依然遵循上一条规则：
!l!c、!c!l和!cl的结果都是一样的。
具体变换遵照以下顺序进行：
r/s(替换字符串)t(多语言)i(循环插值)q(引用)u(将字母大写)l(将字母小写)c(首字母大写)
样式化和文本标签(tag) link
在Ren’Py中，文本有两种方式获取样式(style)信息。第一种是，根据整个文本段落(block)应用的样式获取。请详见 样式系统 及 文本样式特性 部分的内容。
第二种是，通过使用文本标签(tag)。文本标签(tag)可用于一个文本段落(block)中一部分的样式化，也可以用于程序中所有文本段落中一部分的样式化。如果你发现自己在文本的每一行里都应用了同样的文本标签，可以考虑使用样式代替这种做法。
总共有两种文本标签。某些文本标签是自闭合的，而有些文本标签需要成对的闭合标签。当多个成对的闭合标签出现时，闭合顺序必须是后出现的标签先闭合——Ren’Py会拒绝不正确匹配。例如：
# 这行是正确的
"Plain {b}Bold {i}Bold-Italic{/i} Bold{/b} Plain"
# 这行是不正确的，并会引起报错或不正确的画面表现
"Plain {b}Bold {i}Bold-Italic{/b} Italic{/i} Plain"
某些文本标签可以带一个入参。带入参的文本标签后面会带一个等号(=)，后面跟参数值。入参不能含有右花括号(})。入参的含义根据不同的文本标签而不同。
非英语 link
Ren’Py包含英语和很多其他语言的默认字体。考虑到字体库大小问题，Ren’Py没有包含需要渲染的语种，包括中日韩语。如果需要支持那些语言，在项目开头就需要更改使用的字体。
Ren’Py在之后的版本可能会支持世界上绝大多数的语言，而不需要做特别配置。韩语是在各个字之间不带空格书写的语言。Ren’Py有一个特殊模式可以支持带空格的韩语，可以做如下设置启用：
define gui.language = "korean-with-spaces"
这也可以通过修改gui.rpy文件中“unicode”项的默认值实现。
日语在换行方面有许多规则。我们推荐开始先设置为“japanese-normal”，进阶使用“japanese-loose”或者“japanese-strict”，分别对应换行比较多或者比较少的情况。:
define gui.language = "japanese-loose"
表意文字语言经常含有大量换行。要启用更快但运算量更少的换行算法的话，使用如下配置：
define gui.language = "greedy"
这种更快的换行算法并不一定要启用，除非游戏中需要一次显示海量文本，例如在NVL模式下。
后续也可以使用
renpy.language_tailor() 函数配置换行算法。
垂直文本 link
当配置了 vertical 样式特性，Ren’Py就能生成原生的垂直文本。垂直文本的书写顺序是从上到下，从右往左。
这里有两个文本标签与垂直文本相关。
- horiz link
在垂直文本中包含原生水平文本。
- vert link
在水平文本中包含原生的垂直文本。(该标签不会旋转原生垂直文本内容。)
Note
如果字体中没有包含垂直文本的字符间隔信息，Ren’Py会尝试从水平文本信息自动计算出垂直文本的字符间隔。在不同的Ren’Py版本中，实际的字符间隔可能并不一致。
Ruby文本 link
Ruby文本(较常用来标明假名或者注音)是一种在某个字符或单词上方显示小号文本的文本。以下是几个步骤可以让你的游戏支持Ruby文本。
首先，你必须配置Ruby文本的样式(style)。需要修改以下样式特性：
line_leading或ruby_line_leading特性必须为Ruby文本预留足够的高度。创建一个新的自定义名的样式(style)。该样式的特性，比如
size需要适合Ruby文本。新样式的
yoffset必须额外设置，这是为了将Ruby文本升到一般文本基线之上。无论是在对话还是历史记录中，文本样式的
ruby_style字段都应该被设置为上面新创建的样式。
举例：
style ruby_style is default:
size 12
yoffset -20
style say_dialogue:
ruby_line_leading 12
ruby_style style.ruby_style
style history_text:
ruby_line_leading 12
ruby_style style.ruby_style
(使用 style.style_name 格式指定需要的样式)
完成Ren’Py的相关配置后，我们就可以使用rt和rb文本标签，在脚本中包含Ruby文本了。rt标签用于标识一些字符将被显示为Ruby文本。如果在Ruby文本前面出现了rb标签，Ruby文本会与rb标签内的所有文本中央对齐。如果没有rb标签，Ruby文本会与对应的字符左对齐。
完成Ren’Py的相关配置后，我们有两种方式在脚本中包含Ruby文本。
方头凹型括号。 Ruby文本可以写在一对方头凹型括号(【】)中。全角或半角的竖线符号(｜或|)用来分隔Ruby文本的上半与下半内容。
举例：
e "Ruby 可以用来标识假名(【東｜とう】 【京｜きょう】)。"
e "也可以用来翻译 (【東京｜Tokyo】)."
只有在检测到竖线符号时，才会检测Ruby文本。连续两个左方头凹形括号表示转义。 方头凹形括号中不能包含其他文本标签(tag)。
{rt} 和 {rb} 文本标签。 {rt} 标签用于标识一些字符将以Ruby文本形式显示。 如果在Ruby文本前面出现了 {rb} 标签，Ruby文本会与rb标签内的所有文本居中对齐。如果没有rb标签，Ruby文本会与前一个字符居中对齐。
举例：
e "Ruby 可以用来标识假名(東{rt}とう{/rt} 京{rt}きょう{/rt})。"
e "也可以用来翻译({rb}東京{/rb}{rt}Tokyo{/rt})."
确保Ruby文本不会与其他文本内容重叠是创作者的职责。为了防止这种问题的出现，最好在文本上方多预留一些空间。
字体 link
Ren’Py支持TrueType/OpenType字体和字体集，以及基于图形的字体。
TrueType或OpenType字体会给定字体文件名。那个字体文件必须被放在game文件夹里，或者某个归档文件中。
Ren’Py也支持TrueType/OpenType字体集。一个字体集中定义了多种字体。当我们接入一个字体集时，使用从0开始的字体下标，后面跟@符号和文件名。例如，“0@font.ttc”是字体集font的第一种字体，“1@font.ttc”是字体集font的第二种字体，以此类推。
如果Ren’Py在根目录没有找到某个字体文件，会在 game/fonts 再次搜索。
例如，使用一个名为test.ttf的文件时，Ren’Py会先搜索 game/test.ttf，然后搜索 game/fonts/test.ttf。
字体替换 link
config.font_replacement_map 配置项用于字体map图。字体文件、加粗和斜体会使用map图捆绑为一个组合。这个组合就用指定的斜体效果代替系统自动生成的斜体。
这种替换可以实现将“Deja Vu Sans”版本的斜体换成官方的“oblique”版本。(当然你需要先在网上下载“oblique”字体。)
init python:
config.font_replacement_map["DejaVuSans.ttf", False, True] = ("DejaVuSans-Oblique.ttf", False, False)
完成替换后可以提升斜体文本的感官效果。
字体名称与别名： link
配置项 config.font_name_map 用于建立字体与别名间的对应关系。
字体别名有两个用于：首先，对话中使用的 {font} 文本标签(tag)可以更简短；
其次，可以在文本标签中使用 字体组。
define config.font_name_map["jap"] = "electroharmonix.ttf"
define config.font_name_map["tjap"] = FontGroup().add("OrthodoxHerbertarian.ttf", "A", "Z").add("electroharmonix.ttf", None, None)
label yamato:
e "Sorry, what does {font=jap}Black holes and revelations{/font} mean ?"
y "You pronounce it {font=tjap}Black Holes And Revelations{/font}." # 只用OrthodoxHerbertarian字体的大写字母
(译者注：electroharmonix是从日文中选取了一些假名和符号替换 英文字母 的一套字体。OrthodoxHerbertarian也是一套英文字体。这两种字体都不支持汉字，所以文本内容就不翻译了。)
基于图形的字体 link
通过调用以下字体注册函数之一，可以注册基于图形的字体。注册时，需要指定字体的名称、字号、粗体、斜体和下划线。当所有特性都匹配时，注册后的字体才可以使用。
- renpy.register_bmfont(name=None, size=None, bold=False, italics=False, underline=False, filename=None) link
该函数注册了一个给定明细的BMFont(位图字体)。请注意，字号、粗体、斜体和下划线入参只是询问性质的(用于特性匹配)，并不会改变字体的实际效果。
请查看 BMFont首页 可以找到创建BMFonts的工具。Ren’Py需要filename参数是BMFont文本格式的，其描述了一个32比特字体的信息。alpha通道应该包含字体信息，而红绿蓝颜色通道应该被设置为1。图形文件、字偶距和其他控制信息都可以从BMFont文件中读取。
我们推荐，创建的BMFont中包含拉丁字母和主要的标点符号，并确保在Ren’Py的接口上可以正确渲染。
- name
一个字符串，注册的字体名称。
- size
一个整数，注册字体的字号。
- bold
一个布尔值，标识注册字体是否为粗体。
- italics
一个布尔值，标识注册字体是否为斜体。
- underline
可以忽略的参数。
- filename
包含BMFont控制信息的文件。
- renpy.register_mudgefont(name=None, size=None, bold=False, italics=False, underline=False, filename=None, xml=None, spacewidth=10, default_kern=0, kerns={}) link
该函数注册了一个给定明细的MudgeFont。请注意，字号、粗体、斜体和下划线入参只是询问性质的(用于特性匹配)，并不会改变字体的实际效果。
请查看 MudgeFont首页 可以找到创建BMFonts的工具。Ren’Py假设MudgeFont的xml文件中的字符带都unicode字符数值，并会忽略所有负值。
- name
一个字符串，注册的字体名称。
- size
一个整数，注册字体的字号。
- bold
一个布尔值，标识注册字体是否为粗体。
- italics
一个布尔值，标识注册字体是否为斜体。
- underline
可以忽略的参数。
- filename
一个字符串，表示包含MudgeFont图形的文件。该图形通常是一个TGA文件，也可能是一个PNG或者其他Ren’Py支持的图片格式。
- xml
包含MudgeFont工具生成信息的xml文件。
- spacewidth
表示空格字符的宽度的整数，单位是像素。
- default_kern
字符间距的默认值，单位是像素。
- kerns
两字型字符串中字符间距的值。
- renpy.register_sfont(name=None, size=None, bold=False, italics=False, underline=False, filename=None, spacewidth=10, default_kern=0, kerns={}, charset=u'!"#$%&'()*+, -./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~') link
该函数注册了一个给定明细的SFont。请注意，字号、粗体、斜体和下划线入参只是询问性质的(用于特性匹配)，并不会改变字体的实际效果。
- name
一个字符串，注册的字体名称。
- size
一个整数，注册字体的字号。
- bold
一个布尔值，标识注册字体是否为粗体。
- italics
一个布尔值，标识注册字体是否为斜体。
- underline
可以忽略的参数。
- filename
一个字符串，包含SFont图形的文件名。
- spacewidth
表示空格字符的宽度的整数，单位是像素。
- default_kern
字符间距的默认值，单位是像素。
- kerns
两字型字符串中字符间距的值。
- charset
字体的字符集。这是一个字符串，可以按照字符串中包含的字符顺序在图像文件中找到对应的字符。more的SFont字符集如下：
! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \\ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~
由于BMFont是Ren’Py支持的所有三种图形文字中完成度最高的，所以我们推荐新建项目使用BMFont。一个BMFont的使用样例如下：
init python:
renpy.register_bmfont("bmfont", 22, filename="bmfont.fnt")
define ebf = Character('Eileen', what_font="bmfont", what_size=22)
label demo_bmfont:
ebf "Finally, Ren'Py supports BMFonts."
字体组 link
创建一个多语言游戏时，有时无法找到单一的字体能够包含所有文字并保持创作者想要表现的氛围。 因此，Ren’Py支持将“字体组”的形式，将两种或更多字体合并为一种字体。
创建字体组时，需要创建一个 :class:FontGroup 对象并调用逐次调用 .add 方法。FontGroup对象可以直接当作字体使用。
add方法会查看指定范围内的unicode字符，并采用最先能匹配到的unicode字符范围对应的字体。
举例：
style default:
font FontGroup().add("english.ttf", 0x0020, 0x007f).add("japanese.ttf", 0x0000, 0xffff)
- class FontGroup link
可以将一组字体当作一种字体使用。
- add(font, start, end, target=None, target_increment=False) link
将某个范围内的字符与字体 font 关联。
- start
字符范围起点。可以是一个单字符的字符串，也可以是一个unicode字符对应的整数值。如果该入参为None，使用font入参的字体作为默认值。
- end
字符范围终点。可以是一个单字符的字符串，也可以是一个unicode字符对应的整数值。如果 start 入参为None，该参数值将忽略。
- target
若给定该入参，将根target_increment的值，将指定范围的字符与指定的字体做关联。 可以是一个单字符的字符串，也可以是一个unicode字符对应的整数值。 如果指定的字符已经在添加了关联，则忽略此参数。
- target_increment
若该值为True，[start, end]范围内的字符将映射到[target, target+end-start]范围。 若该值为False，指定范围内的字符直接与目标字符做关联。
当多个
.add()调用中包含同一个字符时，使用第一个包含该字符的add方法中的字体。这个方法会返回FontGroup对象，所以能多个
.add()串联使用。
- remap(cha, target) link
将一个或一组字符重映射为某一个目标字符。
- cha
需要映射的源字符或源字符集。该值可以是一个单字符的字符串，或unicode字符对应的整数值，或前两者的迭代器对象(iterable)。
- target
需要映射的目标字符。该值可以是一个单字符的字符串，或unicode字符对应的整数值。
已经(使用add或remap方法)重映射过的字符将被忽略。如果FontGroup对象没有默认字体，必须指定每一个字符映射或关联关系。
与add方法一样，返回FontGroup对象。
注意，FontGroup类可以使用 config.font_name_map 获取字体，但FontGroup对象只会获取字体路径，
并不会识别配置项中的字体名或别名。
文本组件 link
文本也可以用作一个 可视组件，这意味着你可以在文本上应用各种变换(transform)，可以当作一个图片显示并在界面上移动它的位置。
- renpy.ParameterizedText(style='default', `properties) link
该函数创建一个可视组件对象，可以带一个字符串做为入参，根据入参字符串生成的对象能当作图像显示。常用作预定义的
文本图片的一部分。举例，我们可以这样写：
show text "Hello, World" at truecenter with dissolve pause 1 hide text with dissolve
你可以使用ParameterizedText函数，采用不同的样式特性，直接定义出一些类似的图片。举例，我们可以这样写：
image top_text = ParameterizedText(xalign=0.5, yalign=0.0) label start: show top_text "这段文字显示在界面正中"
- Text(text, slow=None, scope=None, substitute=None, slow_done=None, *, tokenized=False, **properties) link
创建一个可视组件，在界面上显示文本。
- text
在界面上显示的文本内容。该参数可以是一个字符串，或者一个字符串和可视组件的列表。
- slow
决定文本是否缓慢显示，即在界面上逐个显示出每个字符。若为None，缓慢文本模式取决于slow_cps样式特性。否则，是否启用缓慢文本模式由此处参数slow决定。
- scope
若不为None，该值应该是一个字典型数值，提供了额外的作用域(scope)供文本内插(interpolation)的使用。
- substitute
若该值为True，则应用文本内插(interpolation)。若该值为False，不应用文本内插。若该值为None，由
config.new_substitutions控制文本内插表现。- slow_done
若非None，并且启用了慢速文本模式(参见 slow 参数)，该参数应该是一个无参数的函数或可调用对象。 当文本完成显示后调用参数对应的函数或可调用对象。
- tokenized
若为True，text 参数需要是一个token列表而不是一个字符串。token内容参见 定制文本标签 页面。
- **properties
与其他可视组件类似，文本组件可以使用样式特性，包括
mipmap。
文本功能函数 link
- renpy.filter_text_tags(s, allow=None, deny=None) link
返回入参s的一个拷贝，其是文本标签过滤后的结果。allow和deny关键词参数至少需要给出1个。
- allow
允许通过的标签的集。如果某个标签不在该列表中，将会被移除。
- deny
禁止通过的标签的集。如果某个标签不在该列表中，将会保留在字符串中。
- renpy.transform_text(s, function) link
转换字符串s，但保留s的文本标签和内插文本不变。
- function
一个转换函数，将文本进行转换并返回转换后的文本。
init python: def upper(s): return s.upper() $ upper_string = renpy.transform_text("{b}Not Upper{/b}", upper)
慢速文本的顾虑 link
Ren’Py允许创作者或者用于指示某些文本以慢速显示。这种情况下，Ren’Py会将文本渲染至某个纹理(texture)，然后将纹理的矩形区域绘制到界面上。
不幸的是，这意味着字符间的重叠区域渲染后会出现瑕疵。为了尽可能减少这种渲染瑕疵，需要尽可能保证 line_leading 和
line_spacing 值足够大，各行之间没有覆盖的区域。如果首行缩进文本，特别是line_spacing为负值的情况，我们需要考虑增大
line_overlap_split 的值。
水平方向的瑕疵也可能由于字偶距原因而挤在一起，不过这不是什么严重的问题，毕竟相邻字符之间显示的时间差不过1帧而已。
对于静态文本来说存在瑕疵不是什么问题，比如菜单等用户界面部分。
文本溢出日志 link
Ren’Py可以记录文本溢出所在区域的日志。要启用文本溢出日志功能的话，需要经过以下步骤：
将
config.debug_text_overflow配置项设为True。运行游戏。
一旦文本显示溢出了可用区域，Ren’Py就会把错误记录在 text_overflow.txt 文件中。
可变字体 link
Ren’Py支持OpenType可变字体。这些字体可能会支持多个axe，比如字重和宽度。 基于这些axe的不同值，同一个字体可以显示出不同的形态。可变字体也可能会对不同axe值的实例直接采用不同名称。 例如，“bold”为名的实力会提供某个字体的粗体版，而“regular”则是某个字体的普通版。
可变字体要求设置 shaper 样式特性为harfbuzz文本渲染器。
设置完成后，instance 特性选择实例名，axis 特性设置各axe的值。
可变字体也可以用在GUI中。例如：
define gui.text_font = "nunito.ttf"
define gui.text_instance = "light"
define gui.text_axis = {"width" : 125}
可以使用“light”型字体，并设置文字宽度。
若不指定实例名，Ren’Py默认使用“regular”显示非加粗文本，使用“bold”显示加粗文本。
有两种文本标签可以用于可变字体。
- instance link
instance标签更改当前使用的字体实例。例如：
"This is {instance=heavy}heavy{/instance} text."instance标签会覆盖axis特性。
- axis link
axis标签会修改一个或多个axe的值。例如：
"This is {axis:width=125}wide{/axis} text."axis标签可以多层嵌套组合使用。
“This is {axis:width=125}{axis:weight=200}wide and bold{/axis}{/axis} text.”
标签内参数赋值时，等号右边的数会被当作浮点型数值处理。
若要获取某个字体的实例和axe信息，可以调用 renpy.variable_font_info() 函数。
该函数设计为从控制台调用。使用时，先用Shift+O打开控制台，然后输入：
renpy.variable_font_info("nunito.ttf")
就能在控制台看到nunito.ttf字体信息了。
- renpy.variable_font_info(font) link
返回某个可变字体的信息。若字体不是可变字体则返回None。
- font
字体文件名。
返回对象具有下列字段：
- instance
该字段是一个字典。字典的键(key)分别是该字体的所有实例名。(例如，“light”、“regular”、“bold”或“heavy”。) 字典的各个值可以忽略。
- axis
该字段是一个字典，表示字体中各axe与下列字段的映射关系：
- minimum
axis的最小值。
- default
axis的默认值。
- maximum
axis的最大值。
该函数返回对象和对象中的数据不能修改。
只有Ren’Py的显示部分完成初始化之后才能调用该函数。 该函数被设计成通过控制台调用，并以人类能阅读的形式打印返回结果。