文本格式化|Text Formatting
当然,您可以在 Chapbook 的 Twine 段落中输入文本,它会按预期显示。但对于其他类型的格式设置,例如粗体或斜体,Chapbook 遵循一种名为 Markdown 的流行标记语言的语法。
“标记语言”这个术语听起来可能很复杂,但实际上它只是一套在纯文本中表示格式的约定。例如,要使文本的某部分在显示时变为斜体,您需要在它周围键入星号,*就像这样*。
如果你从未使用过 Markdown,请尝试在阅读本节时使用 dingus。这是一个名字有趣的在线游乐场,不仅能让你快速查看文本的渲染效果,还附带一份速查表,总结了可供你使用的不同格式。但请记住,Chapbook 提供了一些超出标准 Markdown 集的额外格式选项。
斜体和粗体|Italics and Boldface
要将短语设为斜体,请在其前后键入 * 或 _(单个下划线)。1
| 输入 | 显示 |
|---|---|
_非传统_ 品味 |
非传统 品味 |
*非传统*品味 |
非传统品味 |
(王洛木:由于英语是用空格来分隔单词,但中文是连起来的,所以要使用下划线作为斜体标记的话,要在前后使用空格。选择哪种方案只取决于您的喜好与排版。)
要使短语变为粗体,请在它前后输入 ** 或 __(两个下划线)。
| 输入 | 显示 |
|---|---|
__非传统__ 品味 |
非传统 品味 |
**非传统**品味 |
非传统品味 |
只要在单次使用中保持一致的话,无论使用星号还是下划线都无关紧要,并且您可以在文本中混合使用它们。
| 输入 | 显示 |
|---|---|
**“我要 _杀_ 了你,”** 她嘶声说道。 |
“我要 杀 了你,” 她嘶声说道。 |
带下划线的文本|Underlined text
在网页上通常避免使用带下划线的文本,因为下划线作为一种惯例用于标记超链接文本,而且在许多情况下,使用斜体文本比使用下划线更可取。2然而,如果您想要为纯文本添加下划线,可以通过在其周围写入 <span style="text-decoration:underline"> 和 </span> 来实现。
(还有一个 <u> 的 HTML 标签,最初是表示下划线的信号,并且在许多网络浏览器中仍然如此。但它的含义已经变为“以某种方式注释的文本”;例如,因为拼写错误而加下划线。)
| 输入 | 显示 |
|---|---|
这不是一个<span style="text-decoration:underline">链接</span>,但感觉它应该是。 |
这不是一个链接,但感觉它应该是。 |
等宽字体|Monospaced Type
要将文本设置为等宽字体,像这样,请在文本前后键入反引号(`)。
| 输入 | 显示 |
|---|---|
`Beep boop,` HAL 评论道。 |
Beep boop, HAL 评论道。 |
小型大写字母|Small Caps
如果您想将某些文本设置为小型大写字母,请在文本前后键入 ~~(两个波浪号)。
If you'd like to set some text in small caps, type ~~ (two tildes) around it.
| 输入 | 显示 |
|---|---|
门上方挂着一个~~NO TRESPASSING~~(禁止入内)的标牌。 |
门上方挂着一个 NO TRESPASSING(禁止入内)的标牌。 |
这一约定虽非原始 Markdown 规范的一部分,但与其他一些 Markdown 方言相冲突,后者使用 ~~ 表示删除线文本,就像这样。要实现此效果,请在文本前后键入 <del> 和 </del>:
| 输入 | 显示 |
|---|---|
页面底部,几乎完全被政府审查员的笔迹所覆盖,正是你之前见过的那个代号:<del>S-5900</del>。 |
页面底部,几乎完全被政府审查员的笔迹所覆盖,正是你之前见过的那个代号: |
换行|Line Breaks
如果您想插入单行换行,请在行末留两个空格,或在行末放置一个反斜杠(\)。
| 输入 | 显示 |
|---|---|
在最后一个“不”之后,总会出现一个“是”\而那个“是”,正是未来世界所依存的基石。 | 在最后一个“不”之后,总会出现一个“是” 而那个“是”,正是未来世界所依存的基石。 |
章节分隔|Section Breaks
出版界有时会使用一种惯例来表示新场景或新思路,即用一系列星号分隔文本,如下所示:
漫长的一天过后,我几乎立刻就睡着了。
* * *
第二天早上并不比前一天好。
要在文本中添加分节符,请单独在一行输入 ***(三个星号)。
列表|Lists
要创建项目符号列表(或者用网络术语来说,无序列表),请在新行开头输入 *、- 或 +。使用哪个字符并不重要,但您需要在每个列表中保持一致。
| 输入 | 显示 |
|---|---|
* 红色* 绿色* 蓝色 |
|
要创建编号列表(也称为有序列表),请以数字和句点开头每一行,或者仅使用 #。您使用的编号实际上并不重要——即使两个项目都以 2. 开头,列表仍将正确编号。
| 输入 | 显示 |
|---|---|
# 红色# 绿色# 蓝色 |
|
1. 红色2. 绿色3. 蓝色 |
|
为何要特意格式化编号列表?就像在文字处理软件中那样,使用这种格式会使每个项目都得到恰当的缩进,从而让每个项目的第二行文本出现在起始编号的右侧。
忽略格式化字符|Ignoring Formatting Characters
有时您会希望按原样使用被 Markdown 格式化标记占用的字符,那么最简单的方法是在它们前面加上 \(反斜杠)。
| 已输入 | 显示 |
|---|---|
\*\* 请立即退出 \*\* |
** 请立即退出 ** |
其他自定义样式|Other Custom Styling
您也可以直接将 HTML 代码输入段落中,无需额外代码包裹。输入的内容将完全按照您键入的方式显示。不过,Chapbook 用于渲染 Markdown 的库在处理 HTML 时有时会不一致。它总是会让 HTML 标签原样通过,但这些标签内的内容是被解释为 Markdown 还是 HTML,可能取决于具体情况。遗憾的是,测试这一点的最佳方法是进行实验。
引用块的行为可能出乎您的意料|Blockquotes Don't Behave As You Might Expect
Chapbook 的格式化方式与标准 Markdown 在显示块引用时有所不同——块引用是指一段较长的文本,通常包含多个段落,通过缩进表示其不属于正文内容。Markdown 使用行首的 > 符号来标识块引用。然而,Chapbook 中的 > 符号被用于标记分叉文本。若需显示块引用,请使用 <blockquote> 和 </blockquote> 标签包裹相应内容。
| 输入 | 显示 |
|---|---|
<blockquote>叫我 Ishmael。几年前——具体多久不必细说——当时我囊中羞涩,岸上又没什么特别能引起我兴趣的事,便想着不如出海航行一阵,去看看这世界的水域部分。</blockquote> |
叫我 Ishmael。几年前——具体多久不必细说——当时我囊中羞涩,岸上又没什么特别能引起我兴趣的事,便想着不如出海航行一阵,去看看这世界的水域部分。 |
1. 用下划线表示斜体背后有一段复杂的历史;它们类似于下划线,而后者或多或少是作为打字机无法将单词斜体化的变通方法而被发明的。 ↩
2. 事实上,下划线最初是一种校对惯例,用于告知排版员将文本设为斜体。 ↩