learnxinyminutes-docs/es-es/yaml-es.html.markdown

226 lines
6.6 KiB
Markdown
Raw Normal View History

2014-07-30 17:09:18 +00:00
---
2024-10-20 21:46:35 +00:00
language: YAML
2014-08-11 15:13:46 +00:00
lang: es-es
2014-07-30 17:09:18 +00:00
filename: learnyaml-es.yaml
contributors:
2020-02-13 00:08:29 +00:00
- ["Leigh Brenecki", "https://github.com/adambrenecki"]
2015-10-20 00:27:06 +00:00
- ["Everardo Medina","https://github.com/everblut"]
2014-07-30 17:09:18 +00:00
translators:
- ["Daniel Zendejas","https://github.com/DanielZendejas"]
---
Tutorial de YAML en español.
YAML es un lenguaje de serialización de datos diseñado para ser
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
2015-10-20 00:27:06 +00:00
no permite tabulaciones literales.
2014-07-30 17:09:18 +00:00
```yaml
# Los comentarios en YAML se ven así.
###################
# TIPOS ESCALARES #
###################
# Nuestro objeto raíz (el cual es el mismo a lo largo de todo el
# documento) será un mapa, equivalente a un diccionario, hash,
# u objeto en otros lenguajes.
llave: valor
otra_llave: Otro valor
un_valor_numerico: 100
notacion_cientifica: 1e+12
booleano: true
valor_nulo: null
llave con espacios: valor
# Nótese que los strings no deben estar entre comillas, aunqué también es válido.
llave: "Un string, entre comillas."
"Las llaves tambien pueden estar entre comillas.": "valor entre comillas"
2015-10-20 00:27:06 +00:00
# Los strings de líneas múltiples pueden ser escritos
2014-07-30 17:09:18 +00:00
# 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.
2015-10-20 00:27:06 +00:00
Se continúa guardando la literal hasta que se cese la indentación.
2014-07-30 17:09:18 +00:00
Cualquier línea que tenga más indentación, mantendrá los espacios dados
(por ejemplo, estas líneas se guardarán con cuatro espacios)
2015-10-20 00:27:06 +00:00
bloque_doblado: >
2014-07-30 17:09:18 +00:00
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.
2015-10-20 00:27:06 +00:00
Las líneas en blanco, como la anterior, son convertidas a un salto de línea.
2014-07-30 17:09:18 +00:00
Las líneas con mayor indentación guardan sus saltos de línea.
Esta literal ocuparán dos líneas.
2015-10-20 00:27:06 +00:00
# La indentación se usa para anidar elementos
2014-07-30 17:09:18 +00:00
un_mapa_indentado:
llave: valor
otra_llave: otro valor
otro_mapa_indentado:
llave_interna: valor_interno
2015-10-20 00:27:06 +00:00
# Las llaves de los mapas no requieren ser strings necesariamente
2014-07-30 17:09:18 +00:00
0.25: una llave numérica
2015-10-20 00:27:06 +00:00
# Las llaves también pueden ser objetos de multiples líneas,
# usando ? para indicar el inicio de una llave
2014-07-30 17:09:18 +00:00
? |
Esto es una llave
que tiene múltiples líneas
: y este es su valor
2015-10-20 00:27:06 +00:00
########################
# 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
2014-07-30 17:09:18 +00:00
# programación se quejarán.
# Las secuencias (equivalentes a listas o arreglos) se ven así:
2015-10-20 00:27:06 +00:00
- 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
2014-07-30 17:09:18 +00:00
-
- Esta es una secuencia
- ...dentro de otra secuencia
2015-10-20 00:27:06 +00:00
# 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
2014-07-30 17:09:18 +00:00
##################################
# CARACTERÍSTICAS EXTRAS DE YAML #
##################################
2015-10-20 00:27:06 +00:00
# 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.
2014-07-30 17:09:18 +00:00
# YAML tiene funciones útiles llamadas 'anchors' (anclas), que te permiten
2015-10-20 00:27:06 +00:00
# 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
2014-07-30 17:09:18 +00:00
# que se muestra a continuación, encargado de manejar números complejos en
# Python:
numero_complejo_python: !!python/complex 1+2j
2015-10-20 00:27:06 +00:00
# El tag !!binary indica que un string es en realidad un blob
2014-07-30 17:09:18 +00:00
# representado en base-64.
archivo_gif: !!binary |
R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5
OTk6enp56enmlpaWNjY6Ojo4SEhP/++f/++f/++f/++f/++f/++f/++f/++f/+
+f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC
AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs=
```
2015-10-20 00:27:06 +00:00
### 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)