文档格式
。 格式类似于大多数使用的风格 维基百科,它被设计成可以理解为纯文本, 在HTML转换。
\N代表换行
在测试数据换行
)。
*** Settings ***
Documentation First line.\n\nSecond paragraph, this time\nwith multiple lines.
Metadata Example Value\nin two lines
。 在实践中这 意味着上面的例子也可以写成如下。
*** Settings ***
Documentation
... First line.
...
... Second paragraph, this time
... with multiple lines.
Metadata
... Example
... Value
... in two lines
和列是狭窄的。 不同的方法来分离 文档说明在下面的例子中,所有测试用例 有相同的两个文档。
*** Test Cases ***
Example 1
[Documentation] First line\n Second line in multiple parts
No Operation
Example 2
[Documentation] First line
... Second line in multiple parts
No Operation
Example 3
[Documentation] First line\n
... Second line in\
... multiple parts
No Operation
文档在测试库
与库文件正常换行就足够了 例子如下关键字的文档会产生相同的结果 测试套件的文档在前一节中。
def example_keyword():
"""First line.
Second paragraph, this time
with multiple lines.
"""
pass
段落
2.7.2从机器人框架,所有常规的文本格式化的HTML 文档表示为段落。 在实践中,行分开 由一个换行符将结合在一个段落是否无关 手动或自动添加换行符。 多个段落可以分离 用一个空行(即两个换行),也表、列表和其他 特殊格式化块后面的部分中讨论一个段落结束。
例如,下面的测试套件或资源文件文档:
*** Settings ***
Documentation
... First paragraph has only one line.
...
... Second paragraph, this time created
... with multiple lines.
将在HTML格式为:
第一段只有一行。
第二段,这次创建多个行。
请注意
结合段落,但在 他们没有文件中所示的日志和报告。
内联样式
。
。 结果是等宽的文本与浅灰色背景。 支持代码 风格是新的2.8.6机器人框架。
可以,所有内联样式 跨越到多个行。
| 无格式 | 格式化 |
|---|---|
| *大胆的* | 大胆的 |
| _italic_ | 斜体 |
| _ * _ *粗斜体 | 粗斜体 |
| “代码” | 代码 |
| *大胆的*,然后_italic_最后“一些代码' ' | 大胆的 一些代码 |
| 行*。 | 。 |
url
成图像。
url链接的自动转换是适用于所有数据 在日志和报告,但创建图像做只是为了测试套件, 测试用例和关键字的文档,测试套件的元数据。
定制的链接和图片
。 周围的方括号和管道的性格 各部分之间在所有情况下都是强制性的。
与文本内容
可见文本:
[file.html|this file] -> <a href="file.html">this file</a> [http://host|that host] -> <a href="http://host">that host</a>
与图像内容
它可以是文本或图像:
[robot.html|robot.png] -> <a href="robot.html"><img src="robot.png"></a> [image.jpg|thumb.jpg] -> <a href="image.jpg"><img src="thumb.jpg"></a>
图片和标题文本
标题文本显示鼠标时结束了吗 图像:
[robot.jpeg|Robot rocks!] -> <img src="robot.jpeg" title="Robot rocks!">
标题
的数量 等号表示的标题:
= First section = == Subsection == Some text. == Second subsection == More text. = Second section = You probably got the idea.
注意,只有三个标题支持水平和之间的空间 等号和标题文本是强制性的。
表
。 表 细胞也可以包含链接和格式如粗体和斜体:
| =A= | =B= | = C = | | _1_ | Hello | world! | | _2_ | Hi |
创建的表总是有一个薄的边界和正常文本左对齐。 标题单元格中的文本是大胆和集中。 空细胞自动 添加行同样长。 例如,上面的例子 在HTML这样的格式:
| 一个 | B | C |
|---|---|---|
| 1 | 你好 | 世界 |
| 2 | 嗨 |
请注意
支持表头2.8.2机器人框架中的一个新特性。
列表
列表是由开始与一个连字符和空间(“-”)。 列表项 可以分成多行缩进继续与一个或多个行吗 空间。 一条线,不从”——“开始,不缩进列表结束:
Example: - a list item - second list item is continued This is outside the list.
上面的HTML文档格式是这样的:
例子:
- 列表项
- 第二个列表项是继续
这是在名单之外。
请注意
从结合线 段落,所以最终的结果是相似的。 支持分裂 在第2.7.4列表项添加到多个行。
6.4.9预格式化的文本
从机器人Framework 2.7开始,可以嵌入块 预格式化的文本文档。 格式化块是由 线用“|”开始,一个又一个空间被强制管性格 除了否则空行。 “|”开始序列将被删除 从生成的HTML,但所有其他的空格是保留。
在下面的文档,中间的两个线形成一个格式化 转换为HTML时块:
Doc before block: | inside block | some additional whitespace After block.
上面的文档格式是这样的:
医生之前:
inside block some additional whitespace
块之后。
。 上面的例子就这样写:
Doc before block: | inside block | \ \ \ some \ \ additional whitespace After block.
水平标尺
标签)可以单独的大 从对方的部分,它们可以由三个或三个以上 连字符就行:
Some text here. --- More text...
上面的文档格式是这样的:
一些文本。
更多的文本…
时间格式
。
时间数量
时间总是可以作为一个普通的数字,在这种情况下 解释是秒。 整数和浮点数 工作,可以使用实数或字符串 含有数值。
时间随着时间的字符串
马上是清楚的。
前缀指定负 次了。 可用的时间说明符是:
- 天,天,d
- 小时,小时,h
- 分钟,分钟,分钟,分钟,m
- 秒,第二,秒秒,s
- 毫秒,毫秒,米尔斯女士
例子:
1 min 30 secs 1.5 minutes 90 s 1 day 2 hours 3 minutes 4 seconds 5 milliseconds 1d 2h 3m 4s 5ms - 10 seconds
时间为“定时器”字符串
前缀。 例如,计时器和时间字符串值是相同的:
| 计时器 | 时间的字符串 |
|---|---|
| 00:00:01 | 1秒 |
| 01:02:03 | 1小时2分钟3秒 |
| 1:00:00 | 1小时 |
| 100:00:00 | 100小时 |
| 00:02 | 2秒 |
| 42:00 | 42分钟 |
| 00:01:02.003 | 1分钟2秒3毫秒 |
| 00:01.5 | 1.5秒 |
| 01:02.345 | - 1分2秒345毫秒 |
布尔参数
。
论点是错误的。
*** Keywords ***
True examples
Should Be Equal ${x} ${y} Custom error values=True # Strings are generally true.
Should Be Equal ${x} ${y} Custom error values=yes # Same as the above.
Should Be Equal ${x} ${y} Custom error values=${TRUE} # Python `True` is true.
Should Be Equal ${x} ${y} Custom error values=${42} # Numbers other than 0 are true.
False examples
Should Be Equal ${x} ${y} Custom error values=False # String `false` is false.
Should Be Equal ${x} ${y} Custom error values=no # Also string `no` is false.
Should Be Equal ${x} ${y} Custom error values=${EMPTY} # Empty string is false.
Should Be Equal ${x} ${y} Custom error values=${FALSE} # Python `False` is false.
Should Be Equal ${x} ${y} Custom error values=no values # Special false string in this context.
,是真的。
内部API
。