此问题在此处已有答案:
How do I break a string in YAML over multiple lines?(10个答案)
What's the difference between |, > and >- in OpenAPI YAML descriptions?(2个答案)
8天前关闭。
我发现了一些内部的async-api模式,看起来像下面的例子:
schemas:
Example:
type: object
allOf:
- $ref: '#/components/schemas/Foo'
- type: object
properties:
bar:
type: string
description: >-
Some description
>-
在这种情况下是什么意思?我找不到任何关于此的文档。official specification只提到了|
字符,它表示一个多行字符串。
1条答案
按热度按时间yquaqz181#
|
和>
都用于多线字符串。块样式指示符:块样式指示块中的换行符应该如何表现。如果您希望它们保留为换行符,请使用literal样式,由竖线指示(
|
)。如果要将它们替换为空格,请使用folded样式,用右尖括号表示(>
).(要使用折叠样式获得换行符,请通过放入两个换行符来保留空行。具有额外缩进的行也不会折叠。)阻塞咀嚼指示器:chomping指示器控制字符串末尾的换行符应该发生什么。默认值为clip,在字符串末尾放置一个换行符。要删除所有换行符,strip通过在样式指示器后面放置一个减号(
-
)来删除它们。clip和strip都忽略块末尾实际上有多少换行符;要保留,请在样式指示符后添加加号(+
)。源代码,因此您可以很容易地看到这些语法之间的差异:https://yaml-multiline.info/
另请参见How do I break a string in YAML over multiple lines?以获得深入的解释。