mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-11-22 21:52:31 +03:00
Merge pull request #1680 from rubixware/update-yaml-es
[yaml/es] Update yaml-es content
This commit is contained in:
ven
commit
92ab8df875
@ -4,6 +4,7 @@ lang: es-es
|
||||
filename: learnyaml-es.yaml
|
||||
contributors:
|
||||
- ["Adam Brenecki", "https://github.com/adambrenecki"]
|
||||
- ["Everardo Medina","https://github.com/everblut"]
|
||||
translators:
|
||||
- ["Daniel Zendejas","https://github.com/DanielZendejas"]
|
||||
---
|
||||
@ -14,7 +15,7 @@ leído y escrito por humanos.
|
||||
|
||||
Basa su funcionalidad en JSON, con la adición de líneas nuevas
|
||||
e indentación inspirada en Python. A diferencia de Python, YAML
|
||||
no permite tabs literales.
|
||||
no permite tabulaciones literales.
|
||||
|
||||
```yaml
|
||||
# Los comentarios en YAML se ven así.
|
||||
@ -38,97 +39,177 @@ llave con espacios: valor
|
||||
llave: "Un string, entre comillas."
|
||||
"Las llaves tambien pueden estar entre comillas.": "valor entre comillas"
|
||||
|
||||
# Los strings de líneas múltiples pueden ser escritos
|
||||
# Los strings de líneas múltiples pueden ser escritos
|
||||
# como un 'bloque literal' (usando pipes |)
|
||||
# o como un 'bloque doblado' (usando >)
|
||||
|
||||
bloque_literal: |
|
||||
Este bloque completo de texto será preservado como el valor de la llave
|
||||
'bloque_literal', incluyendo los saltos de línea.
|
||||
|
||||
Se continúa guardando la literal hasta que se cese la indentación.
|
||||
|
||||
Se continúa guardando la literal hasta que se cese la indentación.
|
||||
Cualquier línea que tenga más indentación, mantendrá los espacios dados
|
||||
(por ejemplo, estas líneas se guardarán con cuatro espacios)
|
||||
|
||||
nloque_doblado: >
|
||||
bloque_doblado: >
|
||||
De la misma forma que el valor de 'bloque_literal', todas estas
|
||||
líneas se guardarán como una sola literal, pero en esta ocasión todos los
|
||||
saltos de línea serán reemplazados por espacio.
|
||||
|
||||
Las líneas en blanco, como la anterior, son convertidos a un salto de línea.
|
||||
Las líneas en blanco, como la anterior, son convertidas a un salto de línea.
|
||||
|
||||
Las líneas con mayor indentación guardan sus saltos de línea.
|
||||
Esta literal ocuparán dos líneas.
|
||||
|
||||
########################
|
||||
# TIPOS DE COLECCIONES #
|
||||
########################
|
||||
|
||||
# La indentación se usa para anidar.
|
||||
# La indentación se usa para anidar elementos
|
||||
un_mapa_indentado:
|
||||
llave: valor
|
||||
otra_llave: otro valor
|
||||
otro_mapa_indentado:
|
||||
llave_interna: valor_interno
|
||||
|
||||
# Las llaves de los mapas no deben ser strings necesariamente
|
||||
# Las llaves de los mapas no requieren ser strings necesariamente
|
||||
0.25: una llave numérica
|
||||
|
||||
# Las llaves también pueden ser objetos de multi línea, usando ? para indicar
|
||||
# el inicio de una llave
|
||||
# Las llaves también pueden ser objetos de multiples líneas,
|
||||
# usando ? para indicar el inicio de una llave
|
||||
? |
|
||||
Esto es una llave
|
||||
que tiene múltiples líneas
|
||||
: y este es su valor
|
||||
|
||||
# YAML tambien permite colecciones como llaves, pero muchos lenguajes de
|
||||
########################
|
||||
# TIPOS DE COLECCIONES #
|
||||
########################
|
||||
|
||||
# Las colecciones en YAML usan la indentación para delimitar el alcance
|
||||
# y cada elemento de la colección inicia en su propia línea.
|
||||
# YAML tambien permite colecciones como llaves, pero muchos lenguajes de
|
||||
# programación se quejarán.
|
||||
|
||||
# Las secuencias (equivalentes a listas o arreglos) se ven así:
|
||||
una_secuencia:
|
||||
- Item 1
|
||||
- Item 2
|
||||
- 0.5 # las secuencias pueden tener distintos tipos en su contenido.
|
||||
- Item 4
|
||||
- llave: valor
|
||||
otra_llave: otro_valor
|
||||
- Amarillo
|
||||
- Verde
|
||||
- Azul
|
||||
|
||||
# Se puede usar una secuencia como valor para una llave.
|
||||
secuencia:
|
||||
- Elemento 1
|
||||
- Elemento 2
|
||||
- Elemento 3
|
||||
- Elemento 4
|
||||
|
||||
# Las secuencias pueden contener secuencias como elementos.
|
||||
- [Uno, Dos, Tres]
|
||||
- [Domingo, Lunes, Martes]
|
||||
- [Luna, Marte, Tierra]
|
||||
|
||||
# Las secuencias pueden tener distintos tipos en su contenido.
|
||||
secuencia_combinada:
|
||||
- texto
|
||||
- 5
|
||||
- 0.6
|
||||
- llave: valor # se convierte en un json dentro de la secuencia
|
||||
-
|
||||
- Esta es una secuencia
|
||||
- ...dentro de otra secuencia
|
||||
|
||||
# Dado que todo JSON está incluído dentro de YAML, también puedes escribir
|
||||
# mapas con la sintaxis de JSON y secuencias:
|
||||
mapa_de_json: {"llave": "valor"}
|
||||
secuencia_de_json: [3, 2, 1, "despegue"]
|
||||
# Dado que todo JSON está incluído dentro de YAML, también puedes escribir
|
||||
# mapas con la sintaxis de JSON y secuencias:
|
||||
mapa_de_json_1: {"llave": "valor"}
|
||||
mapa_de_json_2:
|
||||
llave: valor
|
||||
|
||||
# Las secuencias tambien se pueden escribir como un arreglo al estilo JSON
|
||||
secuencia_de_json_1: [3, 2, 1, "despegue"]
|
||||
secuencia_de_json_2:
|
||||
- 3
|
||||
- 2
|
||||
- 1
|
||||
- "despegue"
|
||||
|
||||
# YAML también soporta conjuntos usando el simbolo ?
|
||||
# y se ven de la siguiente forma:
|
||||
set:
|
||||
? item1
|
||||
? item2
|
||||
? item3
|
||||
|
||||
# Se puede usar el tag !!set
|
||||
# Al igual que Python, los conjuntos sólo son mapas con valores nulos.
|
||||
# El ejemplo de arriba es equivalente a:
|
||||
set2:
|
||||
item1: null
|
||||
item2: null
|
||||
item3: null
|
||||
|
||||
##################################
|
||||
# CARACTERÍSTICAS EXTRAS DE YAML #
|
||||
##################################
|
||||
|
||||
# YAML tiene funciones útiles llamadas 'anchors' (anclas), que te permiten
|
||||
# duplicar fácilmente contenido a lo largo de tu documento. En el ejemplo
|
||||
# a continuación, ambas llaves tendrán el mismo valor:
|
||||
contenido_anclado: &nombre_del_ancla Este string será el valor de las llaves
|
||||
otra_ancla: *nombre_del_ancla
|
||||
# YAML usa tres guiones (---) para diferenciar entre directivas
|
||||
# y contenido del documento.
|
||||
# Por otra parte, tres puntos (...) se utilizan para indicar
|
||||
# el final del documento en casos especiales.
|
||||
|
||||
# YAML también tiene tags, que puedes usar para declarar tipos explícitamente.
|
||||
string_explícito: !!str 0.5
|
||||
# Algunos parseadores implementar tags específicas del lenguaje, como el
|
||||
# YAML tiene funciones útiles llamadas 'anchors' (anclas), que te permiten
|
||||
# duplicar fácilmente contenido a lo largo de tu documento.
|
||||
# El ampersand indica la declaración del ancla,
|
||||
declara_ancla: &texto texto de la llave
|
||||
# el asterisco indica el uso de dicha ancla.
|
||||
usa_ancla: *texto # tendrá el valor "texto de la llave"
|
||||
|
||||
################
|
||||
# TAGS EN YAML #
|
||||
################
|
||||
|
||||
# En YAML, los nodos que no tienen un tag obtienen su tipo
|
||||
# según la aplicación que los use, al usar un tag
|
||||
# se pueden declarar tipos explícitamente.
|
||||
string_explicito: !!str 0.5 # !!str para declarar un string
|
||||
integer_explicito: !!int 5 # !!int para declarar un integer
|
||||
float_explicito: !!float 1.2 # !!float para declarar un float
|
||||
conjunto_explicito: !!set # !!set para declarar un conjunto
|
||||
? Uno
|
||||
? Dos
|
||||
? Tres
|
||||
mapa_ordenado_explicito: !!omap # !!omap para declarar un mapa ordenado
|
||||
- Primero: 1
|
||||
- Segundo: 2
|
||||
- Tercero: 3
|
||||
- Cuarto: 4
|
||||
|
||||
# Tags para los numeros enteros
|
||||
llave_canonica: 5222
|
||||
llave_decimal: +5222
|
||||
llave_octal: 010
|
||||
llave_hexadecimal: 0xC
|
||||
|
||||
#Tags para los numeros flotantes
|
||||
llave_canonica: 1.215e+3
|
||||
llave_exponencial: 12.3555e+02
|
||||
llave_fija: 12.15
|
||||
llave_negativa_infinita: -.inf
|
||||
llave_numero_invalido: .NaN
|
||||
|
||||
# Tags para las fechas y horas
|
||||
llave_canonica: 2001-12-15T02:59:43.1Z
|
||||
llave_iso8601: 2001-12-14t21:59:43.10-05:00
|
||||
llave_con_espacios: 2001-12-14 21:59:43.10 -5
|
||||
llave_fecha: 2002-12-14
|
||||
|
||||
# Además existen tags para
|
||||
null: #valor nulo
|
||||
booleans: [ true, false ] # Valores booleanos
|
||||
string: '012345' # Valor en string
|
||||
|
||||
|
||||
# Algunos parseadores implementan tags específicas del lenguaje, como el
|
||||
# que se muestra a continuación, encargado de manejar números complejos en
|
||||
# Python:
|
||||
numero_complejo_python: !!python/complex 1+2j
|
||||
|
||||
########################
|
||||
# TIPOS EXTRAS EN YAML #
|
||||
########################
|
||||
|
||||
# Stirngs y números no son los únicos escalares que YAML puede entener.
|
||||
# YAML también puede parsear fechas en formato ISO .
|
||||
fechaHora: 2001-12-15T02:59:43.1Z
|
||||
fechaHora_con_espacios: 2001-12-14 21:59:43.10 -5
|
||||
fecha: 2002-12-14
|
||||
|
||||
# La tag !!binary indica que un string es, en realidad, un blob
|
||||
# El tag !!binary indica que un string es en realidad un blob
|
||||
# representado en base-64.
|
||||
archivo_gif: !!binary |
|
||||
R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5
|
||||
@ -136,16 +217,10 @@ archivo_gif: !!binary |
|
||||
+f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC
|
||||
AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs=
|
||||
|
||||
# YAML también tiene un tipo set, que se ve de la siguiente forma:
|
||||
set:
|
||||
? item1
|
||||
? item2
|
||||
? item3
|
||||
|
||||
# Al igual que Python, los sets sólo son mapas con valores nulos.
|
||||
# El ejemplo de arriba es equivalente a:
|
||||
set2:
|
||||
item1: null
|
||||
item2: null
|
||||
item3: null
|
||||
```
|
||||
|
||||
### Recursos adicionales
|
||||
|
||||
+ [Sitio oficial de YAML](http://yaml.org/)
|
||||
+ [Parser en línea de de YAML](http://yaml-online-parser.appspot.com/)
|
||||
+ [Validador en línea de YAML](http://codebeautify.org/yaml-validator)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user