STxT: The Book

As a summary of the previous:

• UTF-8 Encoding Always
• Identifiers are CASE-INSENSITIVE
• There are no escape characters
• In STxT, all lines that start with the character # are comments
• 4 spaces are equivalent to one tab

If the : character is inserted, it will simply become part of the text, not considered special. The other text types do not allow multiple lines, so it will have no effect.

Namespace Definition

A namespace is a document without a namespace with the first node called Namespace, which is a structure with all the possible node types, as an example.

Let's look at an example:

Namespace: www.demo.com/document.stxt
    Document:
        Title: (1)
        Sections: (?)
        Description: (1) TEXT
        Document Type: (1) ENUM
            :report
            :article
            :essay
        
    Sections:
        Section: (+) TEXT

A simpler way to define it would have been:

Namespace: www.demo.com/document.stxt
    Document:
        Title: (1)
        Sections: (?)
            Section: (+) TEXT
        Description: (1) TEXT
        Document Type: (1) ENUM
            :report
            :article
            :essay

Finally, a document from the namespace:

Document (www.demo.com/document.stxt):
    Title: First simple document
    Description:
        This is the
        first simple document.
        It has multiple lines
    Document Type: report
    Sections:
        Section: This is a section
        Section:
            This is a section
            with more than one
            line.

Quantity Definition

It is allowed to define the quantity of nodes as follows:

• ?: May or may not appear (maximum 1)
• +: At least one node
• *: Any number of nodes
• num+: num or more nodes
• num-: num or fewer nodes
• num: exactly num nodes

Node Types

The following node types are allowed:

• STRING (Default value)
• TEXT (allows multiline, does not allow child nodes)
• NUMBER: /^(-|+)?\d+(.\d+(e(-|+)?\d+)?/
• BOOLEAN: true | false
• REGEX: valid regex
• ENUM: Valid values are shown in the following multilines
• DATE: YYYY-MM-DD
• TIMESTAMP: ISO_8601
• EMAIL: valid email
• URL: valid url
• HEXADECIMAL (allows multiline, does not allow child nodes)
• BASE64 (allows multiline, does not allow child nodes)
• EMPTY: does not allow content
• INTEGER: (+|-)?\d+
• NATURAL: \d+