info/learnxinyminutes-docs
1
0
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2025-08-12 09:44:24 +02:00
Code Issues Releases Wiki Activity

Some fixes

Browse Source 
- 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
1 changed files with 97 additions and 53 deletions
Download Patch File Download Diff File Expand all files Collapse all files

150
pt-br/yaml-pt.html.markdown
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,28 +33,32 @@ 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 '>').
bloco_literal: | 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 -
estas linhas serão identadas com 4 espaços. estas linhas serão identadas com 4 espaços.
estilo_compacto: > estilo_compacto: >
Todo esse bloco de texto será o valor de 'estilo_compacto', mas esta Todo esse bloco de texto será o valor de 'estilo_compacto', mas esta
vez, todas as novas linhas serão substituídas com espaço simples. vez, todas as novas linhas serão substituídas com espaço simples.
Linhas em branco, como acima, são convertidas em um carater de nova linha. Linhas em branco, como acima, são convertidas em um carater de nova linha.
Linhas 'mais-indentadas' mantém suas novas linhas também - Linhas 'mais-indentadas' mantém suas novas linhas também -
este texto irá aparecer em duas linhas. este texto irá aparecer em duas linhas.
#################### ####################
# TIPOS DE COLEÇÃO # # TIPOS DE COLEÇÃO #
@@ -59,54 +66,84 @@ estilo_compacto: >
# Texto aninhado é conseguido através de identação. # Texto aninhado é conseguido através de identação.
um_mapa_aninhado: um_mapa_aninhado:
chave: valor chave: valor
outra_chave: Outro valor outra_chave: Outro valor
outro_mapa_aninhado: outro_mapa_aninhado:
ola: ola ola: ola
# Mapas não tem que ter chaves com string. # Mapas não tem que ter chaves com string.
0.25: uma chave com valor flutuante 0.25: uma chave com valor flutuante
# As chaves podem ser também objetos multi linhas, utilizando ? para indicar o começo de uma chave. # As chaves podem ser também objetos multi linhas, utilizando ? para indicar o começo de uma chave.
? | ? |
Esta é uma chave Esta é uma chave
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:
- Item 1 - Item 1
- Item 2 - Item 2
- 0.5 # sequencias podem conter tipos diferentes. - 0.5 # sequencias podem conter tipos diferentes.
- Item 4 - Item 4
- chave: valor - chave: valor
outra_chave: outro_valor outra_chave: outro_valor
- -
- 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,27 +151,34 @@ 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.
gif_file: !!binary | gif_file: !!binary |
R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5 R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5
OTk6enp56enmlpaWNjY6Ojo4SEhP/++f/++f/++f/++f/++f/++f/++f/++f/+ OTk6enp56enmlpaWNjY6Ojo4SEhP/++f/++f/++f/++f/++f/++f/++f/++f/+
+f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC +f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC
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/)