1
0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2025-08-12 09:44:24 +02:00

Some fixes

- Updated to latest EN version (with respective translation)
- Fixed some pt-BR typos
- Fixed indentations to be equal to the original EN version
This commit is contained in:
dannyloxavier
2022-03-28 12:25:28 -03:00
committed by GitHub
parent 3a425f8cf3
commit 0f6e59d349

View File

@@ -2,6 +2,7 @@
language: yaml language: yaml
contributors: contributors:
- ["Leigh Brenecki", "https://github.com/adambrenecki"] - ["Leigh Brenecki", "https://github.com/adambrenecki"]
- [Suhas SG, 'https://github.com/jargnar']
translators: translators:
- ["Rodrigo Russo", "https://github.com/rodrigozrusso"] - ["Rodrigo Russo", "https://github.com/rodrigozrusso"]
filename: learnyaml-pt.yaml filename: learnyaml-pt.yaml
@@ -14,6 +15,8 @@ legível por seres humanos.
É um superconjunto de JSON, com a adição de identação e quebras de linhas sintaticamente significativas, como Python. Ao contrário de Python, entretanto, YAML não permite o caracter literal tab para identação. É um superconjunto de JSON, com a adição de identação e quebras de linhas sintaticamente significativas, como Python. Ao contrário de Python, entretanto, YAML não permite o caracter literal tab para identação.
```yaml ```yaml
--- # início do documento
# Comentários em YAML são como este. # Comentários em YAML são como este.
################### ###################
@@ -30,8 +33,12 @@ boleano: true
valor_nulo: null valor_nulo: null
chave com espaco: valor chave com espaco: valor
# Observe que strings não precisam de aspas. Porém, elas podem ter. # Observe que strings não precisam de aspas. Porém, elas podem ter.
porem: "Uma string, entre aspas." porem: 'Uma string, entre aspas.'
"Chaves podem estar entre aspas tambem.": "É útil se você quiser colocar um ':' na sua chave." 'Chaves podem estar entre aspas tambem.': "É útil se você quiser colocar um ':' na sua chave."
aspas simples: 'possuem ''um'' padrão de escape'
aspas duplas: "possuem vários: \", \0, \t, \u263A, \x0d\x0a == \r\n, e mais."
# Caracteres UTF-8/16/32 precisam ser codificados
Superscript dois: \u00B2
# Seqüências de várias linhas podem ser escritas como um 'bloco literal' (utilizando |), # Seqüências de várias linhas podem ser escritas como um 'bloco literal' (utilizando |),
# ou em um 'bloco compacto' (utilizando '>'). # ou em um 'bloco compacto' (utilizando '>').
@@ -39,7 +46,7 @@ bloco_literal: |
Todo esse bloco de texto será o valor da chave 'bloco_literal', Todo esse bloco de texto será o valor da chave 'bloco_literal',
preservando a quebra de com linhas. preservando a quebra de com linhas.
O literal continua até de-dented, e a primeira identação é O literal continua até 'des-indentar', e a primeira identação é
removida. removida.
Quaisquer linhas que são 'mais identadas' mantém o resto de suas identações - Quaisquer linhas que são 'mais identadas' mantém o resto de suas identações -
@@ -73,8 +80,12 @@ um_mapa_aninhado:
que tem várias linhas que tem várias linhas
: e este é o seu valor : e este é o seu valor
# também permite tipos de coleção de chaves, mas muitas linguagens de programação # YAML também permite o mapeamento entre sequências com a sintaxe chave complexa
# vão reclamar. # Alguns analisadores de linguagem de programação podem reclamar
# Um exemplo
? - Manchester United
- Real Madrid
: [2001-01-01, 2002-02-02]
# Sequências (equivalente a listas ou arrays) semelhante a isso: # Sequências (equivalente a listas ou arrays) semelhante a isso:
uma_sequencia: uma_sequencia:
@@ -87,26 +98,52 @@ uma_sequencia:
- -
- Esta é uma sequencia - Esta é uma sequencia
- dentro de outra sequencia - dentro de outra sequencia
- - - Indicadores de sequência aninhadas
- podem ser recolhidas
# Como YAML é um super conjunto de JSON, você também pode escrever mapas JSON de estilo e # Como YAML é um super conjunto de JSON, você também pode escrever mapas JSON de estilo e
# sequencias: # sequências:
mapa_json: {"chave": "valor"} mapa_json: {"chave": "valor"}
json_seq: [3, 2, 1, "decolar"] json_seq: [3, 2, 1, "decolar"]
e aspas são opcionais: {chave: [3, 2, 1, decolar]}
########################## ###########################
# RECURSOS EXTRA DO YAML # # RECURSOS EXTRAS DO YAML #
########################## ###########################
# YAML também tem um recurso útil chamado "âncoras", que permitem que você facilmente duplique # YAML também tem um recurso útil chamado "âncoras", que permitem que você facilmente duplique
# conteúdo em seu documento. Ambas estas chaves terão o mesmo valor: # conteúdo em seu documento. Ambas estas chaves terão o mesmo valor:
conteudo_ancora: & nome_ancora Essa string irá aparecer como o valor de duas chaves. conteudo_ancora: &nome_ancora Essa string irá aparecer como o valor de duas chaves.
outra_ancora: * nome_ancora outra_ancora: *nome_ancora
# Âncoras podem ser usadas para dubplicar/herdar propriedades
base: &base
name: Todos possuem o mesmo nome
# O regexp << é chamado Mesclar o Tipo Chave Independente-de-Idioma. É usado para
# indicar que todas as chaves de um ou mais mapas específicos devam ser inseridos
# no mapa atual.
foo:
<<: *base
age: 10
bar:
<<: *base
age: 20
# foo and bar would also have name: Everyone has same name
# YAML também tem tags, que você pode usar para declarar explicitamente os tipos. # YAML também tem tags, que você pode usar para declarar explicitamente os tipos.
string_explicita: !! str 0,5 string_explicita: !!str 0.5
# Alguns analisadores implementam tags específicas de linguagem, como este para Python de # Alguns analisadores implementam tags específicas de linguagem, como este para Python de
# Tipo de número complexo. # Tipo de número complexo.
numero_complexo_em_python: !! python / complex 1 + 2j numero_complexo_em_python: !!python/complex 1+2j
# Podemos utilizar chaves YAML complexas com tags específicas de linguagem
? !!python/tuple [5, 7]
: Fifty Seven
# Seria {(5, 7): 'Fifty Seven'} em Python
#################### ####################
# YAML TIPOS EXTRA # # YAML TIPOS EXTRA #
@@ -114,9 +151,9 @@ numero_complexo_em_python: !! python / complex 1 + 2j
# Strings e números não são os únicos que escalares YAML pode entender. # Strings e números não são os únicos que escalares YAML pode entender.
# Data e 'data e hora' literais no formato ISO também são analisados. # Data e 'data e hora' literais no formato ISO também são analisados.
datetime: 2001-12-15T02: 59: 43.1Z datetime: 2001-12-15T02:59:43.1Z
datetime_com_espacos 2001/12/14: 21: 59: 43.10 -5 datetime_com_espaços: 2001-12-14 21:59:43.10 -5
Data: 2002/12/14 date: 2002-12-14
# A tag !!binary indica que a string é na verdade um base64-encoded (codificado) # A tag !!binary indica que a string é na verdade um base64-encoded (codificado)
# representação de um blob binário. # representação de um blob binário.
@@ -127,14 +164,21 @@ gif_file: !!binary |
AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs= AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs=
# YAML também tem um tipo de conjunto, o que se parece com isso: # YAML também tem um tipo de conjunto, o que se parece com isso:
set: conjunto:
? item1 ? item1
? item2 ? item2
? item3 ? item3
ou: {item1, item2, item3}
# Como Python, são apenas conjuntos de mapas com valors nulos; o acima é equivalente a: # Como Python, são apenas conjuntos de mapas com valors nulos; o acima é equivalente a:
set2: conjunto2:
item1: nulo item1: null
item2: nulo item2: null
item3: nulo item3: null
... # fim do documento
``` ```
### Mais Recursos
+ [Site Oficial do YAML](https://yaml.org/)
+ [Validador YAML Online](http://www.yamllint.com/)