Como quebro uma string em várias linhas?

No YAML, eu tenho uma string que é muito longa. Eu quero manter isso dentro da visualização de 80 colunas (mais ou menos) do meu editor, então eu gostaria de quebrar a string. Qual é a sintaxe para isso?

Em outras palavras, eu tenho o seguinte:

Key: 'this is my very very very very very very long string'

e eu gostaria de ter isso (ou algo nesse sentido):

Key: 'this is my very very very ' +
     'long string'

Eu gostaria de usar aspas como acima, para não precisar escapar de nada dentro da string.

Usando o estilo dobrado yaml, cada quebra de linha é substituída por um espaço. A indentação em cada linha será ignorada. Uma quebra de linha será inserida no final.

Key: >
  This is a very long sentence
  that spans several lines in the YAML
  but which will be rendered as a string
  with only a single carriage return appended to the end.

http://symfony.com/doc/current/components/yaml/yaml_format.html

Você pode usar o "indicador de mastigação de bloco" para eliminar a quebra de linha à direita, da seguinte maneira:

Key: >-
  This is a very long sentence
  that spans several lines in the YAML
  but which will be rendered as a string
  with NO carriage returns.

Existem outras ferramentas de controle disponíveis também (para controlar o recuo, por exemplo).

Veja https://yaml-multiline.info/

Existem 5 6 NINE (ou 63 *, dependendo de como você conta) maneiras diferentes de escrever strings de várias linhas no YAML.

TL; DR

• Geralmente você deseja >:

  key: >
    Your long
    string here.
  

• Se você deseja que as quebras de linha sejam preservadas como \nna seqüência de caracteres (por exemplo, descontos incorporados com parágrafos), use |.

  key: |
    ### Heading
  
    * Bullet
    * Points
  

• Use >-ou |-não, se você não quiser que uma quebra de linha seja anexada ao final.

• Se você precisar dividir linhas no meio das palavras ou digitar literalmente quebras de linha como \n, use aspas duplas:

  key: "Antidisestab\
   lishmentarianism.\n\nGet on it."
  

• YAML é louco.

Bloquear estilos escalares ( >, |)

Isso permite caracteres como \e "sem escapar e adiciona uma nova linha ( \n) ao final da sua string.

> O estilo dobrado remove as novas linhas da cadeia (mas adiciona uma no final e converte as novas linhas em simples):

Key: >
  this is my very very very
  long string

→ this is my very very very long string\n

| O estilo literal transforma cada nova linha da string em uma nova linha literal e adiciona uma no final:

Key: |
  this is my very very very 
  long string

→ this is my very very very\nlong string\n

Aqui está a definição oficial do YAML Spec 1.2

O conteúdo escalar pode ser escrito em notação de bloco, usando um estilo literal (indicado por "|"), onde todas as quebras de linha são significativas. Como alternativa, eles podem ser escritos com o estilo dobrado (indicado por ">"), em que cada quebra de linha é dobrada em um espaço, a menos que termine uma linha vazia ou mais recuada.

Estilos de bloco com indicador mastigando bloco ( >-, |-, >+, |+)

Você pode controlar o manuseio da nova linha final na string e de qualquer linha em branco à direita ( \n\n) adicionando um caractere indicador de chomping de bloco :

• >, |: "clip": mantenha o avanço da linha, remova as linhas em branco à direita.
• >-, |-: "strip": remova a alimentação da linha, remova as linhas em branco à direita.
• >+, |+: "keep": mantém o avanço da linha, continua seguindo linhas em branco.

"Flow" escalares estilos ( , ", ')

Eles têm escape limitado e constroem uma cadeia de caracteres de linha única sem novos caracteres de linha. Eles podem começar na mesma linha que a chave ou com novas linhas adicionais primeiro.

estilo simples (sem escape, sem#ou:combinações, limites para o primeiro caractere):

Key: this is my very very very 
  long string

estilo de aspas duplas (\e"deve ser escapado por\, novas linhas podem ser inseridas com uma\nsequêncialiteral, linhas podem ser concatenadas sem espaços com final\):

Key: "this is my very very \"very\" loooo\
  ng string.\n\nLove, YAML."

→ "this is my very very \"very\" loooong string.\n\nLove, YAML."

estilo de aspas simples (literal'deve ser duplicado, sem caracteres especiais, possivelmente útil para expressar cadeias começando com aspas duplas):

Key: 'this is my very very "very"
  long string, isn''t it.'

→ "this is my very very \"very\" long string, isn't it."

Sumário

Nesta tabela, _significa space character. \nsignifica "caractere de nova linha" ( \nem JavaScript), exceto a linha "novas linhas em linha", onde significa literalmente uma barra invertida e um n).

                      >     |            "     '     >-     >+     |-     |+
-------------------------|------|-----|-----|-----|------|------|------|------  
Trailing spaces   | Kept | Kept |     |     |     | Kept | Kept | Kept | Kept
Single newline => | _    | \n   | _   | _   | _   | _    |  _   | \n   | \n
Double newline => | \n   | \n\n | \n  | \n  | \n  | \n   |  \n  | \n\n | \n\n
Final newline  => | \n   | \n   |     |     |     |      |  \n  |      | \n
Final dbl nl's => |      |      |     |     |     |      | Kept |      | Kept  
In-line newlines  | No   | No   | No  | \n  | No  | No   | No   | No   | No
Spaceless newlines| No   | No   | No  | \   | No  | No   | No   | No   | No 
Single quote      | '    | '    | '   | '   | ''  | '    | '    | '    | '
Double quote      | "    | "    | "   | \"  | "   | "    | "    | "    | "
Backslash         | \    | \    | \   | \\  | \   | \    | \    | \    | \
" #", ": "        | Ok   | Ok   | No  | Ok  | Ok  | Ok   | Ok   | Ok   | Ok
Can start on same | No   | No   | Yes | Yes | Yes | No   | No   | No   | No
line as key       |

Exemplos

Observe os espaços à direita na linha antes de "espaços".

- >
  very "long"
  'string' with

  paragraph gap, \n and        
  spaces.
- | 
  very "long"
  'string' with

  paragraph gap, \n and        
  spaces.
- very "long"
  'string' with

  paragraph gap, \n and        
  spaces.
- "very \"long\"
  'string' with

  paragraph gap, \n and        
  s\
  p\
  a\
  c\
  e\
  s."
- 'very "long"
  ''string'' with

  paragraph gap, \n and        
  spaces.'
- >- 
  very "long"
  'string' with

  paragraph gap, \n and        
  spaces.

[
  "very \"long\" 'string' with\nparagraph gap, \\n and         spaces.\n", 
  "very \"long\"\n'string' with\n\nparagraph gap, \\n and        \nspaces.\n", 
  "very \"long\" 'string' with\nparagraph gap, \\n and spaces.", 
  "very \"long\" 'string' with\nparagraph gap, \n and spaces.", 
  "very \"long\" 'string' with\nparagraph gap, \\n and spaces.", 
  "very \"long\" 'string' with\nparagraph gap, \\n and         spaces."
]

Estilos de bloco com indicadores de indentação

Caso as opções acima não sejam suficientes, você pode adicionar um " indicador de indentação de bloco " (após o indicador de chomping de bloco, se você tiver um):

- >8
        My long string
        starts over here
- |+1
 This one
 starts here

Termo aditivo

Se você inserir espaços extras no início das não-primeiras linhas no estilo Dobrado, eles serão mantidos, com uma nova linha de bônus. Isso não acontece com os estilos de fluxo:

- >
    my long
      string
- my long
    string

→ ["my long\n string\n", "my long string"]

Eu não posso nem.

*2 estilos de bloco, cada um com 2 possíveis indicadores de chomping de bloco (ou nenhum) e com 9 possíveis indicadores de recuo (ou nenhum), 1 estilo simples e 2 estilos entre aspas: 2 x (2 + 1) x (9 + 1) + 1 + 2 = 63

Algumas dessas informações também foram resumidas aqui .

Para preservar novas linhas| , use , por exemplo:

|
  This is a very long sentence
  that spans several lines in the YAML
  but which will be rendered as a string
  with newlines preserved.

é traduzido para "Esta é uma frase muito longa‌ \ n que abrange várias linhas no YAML‌ \ n, mas que será renderizada como uma string‌ \ n com novas linhas preservadas. \ n "

1. Notação de bloco (simples, estilo de fluxo, escalar): as novas linhas se tornam espaços e novas linhas extras após a remoção do bloco

---
# Note: It has 1 new line after the string
content:
    Arbitrary free text
    over multiple lines stopping
    after indentation changes...

...

JSON equivalente

{
 "content": "Arbitrary free text over multiple lines stopping after indentation changes..."
}

2. Escalar em blocos literais: um escalar em blocos literais | incluirá as novas linhas e os espaços à direita. mas remove extra

novas linhas após o bloco.

---
# After string we have 2 spaces and 2 new lines
content1: |
 Arbitrary free text
 over "multiple lines" stopping
 after indentation changes...  


...

JSON equivalente

{
 "content1": "Arbitrary free text\nover \"multiple lines\" stopping\nafter indentation changes...  \n"
}

3. + indicador com Escalar literal de bloco: mantenha novas linhas extras após o bloco

---
# After string we have 2 new lines
plain: |+
 This unquoted scalar
 spans many lines.


...

JSON equivalente

{
 "plain": "This unquoted scalar\nspans many lines.\n\n\n"
}

4. - indicador com Literal Block Scalar: - significa que a nova linha no final da string é removida.

---
# After string we have 2 new lines
plain: |-
 This unquoted scalar
 spans many lines.


...

JSON equivalente

{
 "plain": "This unquoted scalar\nspans many lines."
}

5. Escalada de bloco dobrado (>):

dobrará novas linhas em espaços e removerá novas linhas adicionais após o bloco.

---
folded_newlines: >
 this is really a
 single line of text
 despite appearances


...

JSON equivalente

{
 "fold_newlines": "this is really a single line of text despite appearances\n"
}

para mais você pode visitar meu blog

Você pode não acreditar, mas o YAML também pode executar chaves de várias linhas:

?
 >
 multi
 line
 key
:
  value

Para concatenar linhas longas sem espaço em branco , use aspas duplas e escape das novas linhas com barras invertidas:

key: "Loremipsumdolorsitamet,consecteturadipiscingelit,seddoeiusmodtemp\
  orincididuntutlaboreetdoloremagnaaliqua."

(Obrigado @Tobia)

Caso você esteja usando YAML e Twig para traduções no Symfony e queira usar traduções de várias linhas em Javascript, um retorno de carro será adicionado logo após a tradução. Portanto, mesmo o seguinte código:

var javascriptVariable = "{{- 'key'|trans -}}";

Qual possui a seguinte tradução yml:

key: >
    This is a
    multi line 
    translation.

Ainda resultará no seguinte código em html:

var javascriptVariable = "This is a multi line translation.
";

Portanto, o sinal de menos no Twig não resolve isso. A solução é adicionar este sinal de menos após o yml maior que:

key: >-
    This is a
    multi line 
    translation.

Terá o resultado adequado, tradução de várias linhas em uma linha no Twig:

var javascriptVariable = "This is a multi line translation.";

Para situações em que a string pode conter espaços ou não, prefiro aspas duplas e continuação de linha com barras invertidas:

key: "String \
  with long c\
  ontent"

Mas observe a armadilha do caso de uma linha de continuação começar com um espaço, ela precisa ser escapada (porque será removida em outro lugar):

key: "String\
  \ with lon\
  g content"

Se a string contém quebras de linha, isso precisa ser escrito em estilo C \n.

Veja também esta pergunta .

Nenhuma das soluções acima funcionou para mim, em um arquivo YAML dentro de um projeto Jekyll. Depois de tentar muitas opções, percebi que uma injeção de HTML também <br>poderia funcionar, pois no final tudo é renderizado em HTML:

nome: | em uma vila de La Mancha, <br>cujo nome não <br>quero lembrar.

Pelo menos funciona para mim. Não faço ideia dos problemas associados a essa abordagem.