STxT: El Libro

Un lenguaje para la web

Capítulo 4: Documentos sin namespace

Creo que ya ha quedado claro como son los documentos sin namespace. Ejemplo:

Receta: Receta de macarrones
    Descripción:
        :Esta es la descripción de la recta de macarrones.
        :Bla, bla, bla
        :Bla, bla, bla
    Comensales: 3
    Dificultad: fácil
    Ingredientes:
        Ingrediente: (100g) Tomate
        Ingrediente: (240g) Macarrones
    Pasos:
        Paso: (1) Hacer sofrito
        Paso: (2) Hervir macarrones
        Paso: (3) Juntar macarrones con sofrito y servir

Vamos a profundizar un poco más.

Codificación

Codificación UTF-8 Siempre

Fin. Es una buena regla y estoy muy contento con ella. Hoy en día es la codificación más aceptable, más universal, y más implementada. No creo que esto cambie en los próximos años.

Identificadores

Los Identificadores son CASE-INSENSITIVE

Se permiten espacios en los nombres.
¿Por qué no? ¿Para parecer informáticos?
Los tiempos están cambiando :-D

Caracteres de escape

No existen caracteres de escape

Creo que es lo mejor que he oído en mucho tiempo. No existen caracteres de escape porque no son necesarios. Debido a la estructura no son necesarios.

Comentarios

Todos los informáticos saben qué son los comentarios en cualquier lenguaje. Por si hay algún neófito explicaré que los comentarios son texto que sólo están ahí para comentar o añadir alguna observación, pero no influyen en el documento en sí.

En STxT son comentarios todas las líneas que empiezan por el carácter #

Los comentarios no tienen que tener ningún tipo de formato, es texto libre que el autor del documento puede incluir. Además, no tiene que estar situado en ningún sitio concreto del documento. Cualquier línea que empiece por # será tratada como comentario, y no será tenida en cuenta ni en programas ni en comunicaciones.

Ejemplo:

Receta: Receta de macarrones
# (1) Esto es un comentario
# (2) Esto también es un comentario
    # (3) Esto también es un comentario
    Descripción:
        :Esta es la descripción de la recta de macarrones.
        :Bla, bla, bla
    # (4) Esto es un comentario    
        :Bla, bla, bla
        # (5) esto NO es un comentario
    Comensales: 3
    Dificultad: fácil
    Ingredientes:
        Ingrediente: (100g) Tomate
        Ingrediente: (240g) Macarrones
    Pasos:
        Paso: (1) Hacer sofrito
        Paso: (2) Hervir macarrones
        Paso: (3) Juntar macarrones con sofrito y servir

Aquí cabe señalar que (1),(2),(3) y (4) son comentarios, mientras que (5) no lo es, ya que está dentro del texto identado.

Nodos e identación

Antes hemos dicho que un documento STxT es un conjunto de nodos anidados. La identación es muy similar a otros lenguajes, y se pueden usar tabuladores o espacios.

4 espacios equivalen a un tabulador Es mejor no mezclar documentos con tabuladores y espacios

Nodos multilínea

Estos nodos permiten tener textos completos en varias líneas. En documentos con namespace serán equivalentes a nodos tipo TEXT. Se construyen con líneas que empiezan por :, pero sin una etiqueta previa. Ejemplo:

Receta: Receta de macarrones
    Descripción:
        :Esta es la descripción de la recta de macarrones.
        :Bla, bla, bla
        :Bla, bla, bla
    Comensales: 3
    Dificultad: fácil
    Ingredientes:
        Ingrediente: (100g) Tomate
        Ingrediente: (240g) Macarrones
    Pasos:
        Paso: (1) Hacer sofrito
        Paso: (2) Hervir macarrones
        Paso: (3) Juntar macarrones con sofrito y servir

Acabamos de ver que el nodo Descripción es un nodo MULTILINE.

(Prefix) Central (Sufix)

Aunque no forma parte del lenguaje, es una práctica habitual que campos simples se estructuren con (prefix) central (sufix). Pueden aparecer las 3 o sólo 1 o 2 de ellas. Ejemplo:

Receta: Receta de macarrones
    Descripción:
        :Esta es la descripción de la recta de macarrones.
        :Bla, bla, bla
        :Bla, bla, bla
    Comensales: 3
    Dificultad: fácil
    Ingredientes:
        Ingrediente: (100g) Tomate
        Ingrediente: (240g) Macarrones
    Pasos:
        Paso: (1) Hacer sofrito
        Paso: (2) Hervir macarrones
        Paso: (3) Juntar macarrones con sofrito y servir
Usamos cookies para mejorar su experiencia de uso y ofrecer contenidos adaptados a sus intereses Entendido! Más información