Triv - Advanced reference

Advanced reference

Element statments

Element statement

An element statement may be with or without content:

element:

Single element statement with expanded content

Content may be expanded or condensed:

element:
  content

Single element statement with condensed content

element: content

Single element statement with condensed content literal

Multiple lines of content may be be written as a literal or as default content:

element: """
content
"""

Single element statement with condensed multiple lines of default content

element: line 1
  line 2

Multiple element statements

Multiple elements may be individual statements or a single expression:

a:
  b:
    c:
      content

Multi-element expression statement

a:b:c: content

More types of element statements

Optional features of an element

Optional features are of the form:

name#id.class1.class2.class3[attributes]?:

"id" - the value of the id attribute
"class" - class membership
"attributes" - a list of attributes, with spaces as usual
"?" (postfix) - a single symbol character, intended for XML

Please refer to the XML Authoring Guide for more suggestions relevant to XML.

Attribute string

a[href="#picture"]:
img#picture[src='.']/

Alternative, block-wise open delimeter

An element needing the colon character (:) within the element name may utilize the pipe character (|) the same way instead.

Please refer to the XML Authoring Guide for more suggestions relevant to XML. ns:a|b|c| content

Default element

If an element name is not specified, the element is a default element.

Only an element with a colon character (:) as the primary, array-wise open delimeter may be a default element.

The default name of a default element is assumed to be div.

:

Model element

The first element with a present but empty attribute string is a model element.

Only an element with a colon character (:) as the primary, array-wise open delimeter may be a model element.

The model element determines the name for any remaining default element.

:
p[]:
:

Fully self-closing element

A self-closer for an element requires an attribute string, even if empty, and two consecutive trailing forward slash characters (//).

hr[]//

Void self-closing element

A self-closer with a single trailing forward slash character (/) outputs an element with no trailing forward slash.

hr[]/

Sections & optional features

Section

A section is a titled portion of a document.

[Title]
content

Optional section features are of the form:

[Title]# heading/section property & attributes

"#" (id mark) - sets the value of the "id" property to the title and removes the heading unless specified
"heading" - the heading element name, default: div
"section" - the section element name, default: h1
"property" - the property name for the value to be the title, or ID if specified
"attributes" - a list of attributes, with spaces as usual

Section with ID

[The Title]#

Section with custom heading element name

[The Title] h5

Section with no heading, id, or title property

[-]/ul

Section with custom section element name

[The Title] /article

Section with custom ID property name

[The Title]# / name

Section with custom title property name

[The Title] / title

Section with attributes

[The Title] & style="display:inline-block"

Sections, placement

Section and single recent section closer

A section closer closes the most recently open section.

html:
  body:
[Title]
content
[]
    footer:

Sections and multiple recent section closer

Extra square brackets in a section closer are for closing multiple recently open sections.

html:
  body:
[A]
[.B.]
[..C..]
[[[]]]
    footer:

Sections and section reset

A single section closer with a trailing asterisk character (*) is a section reset for closing all sections.

html:
  body:
[A]
[.B.]
[..C..]
[]*
    footer:

Section placement

If no other section is open, a section is placed in the most recently open element that has no content (content literal, condensed content, or default content).

html:
  body:
    header: content
[Section of body Element]
content

Section placement with leading comments

e.g. comments do not affect section placement.

html:
  body:
    < single line comment
    !!!
    comment literal
    !!!
[Section of body Element]
content

Section placement of a sequential section

If a section is open, any new section (of the same level indicator) is placed in the same element.

html:
  body:
[A1 of body Element]
b1:
[A2 of body Element]
b2:

Section placement with leading closed section

Closed sections do not affect section placement.

html:
  body:
[A1 of body Element]
[]
[A2 of body Element]

Descending sections

A section is placed within another section by level indicator.

A smaller section level is indicated by extra dots around the title.

[A]
[.B.]
[..C..]

Ascending sections

A larger section level is indicated by extra square brackets around the title.

[[[A]]]
[[B]]
[C]

Literals

Common literal

Standard element processing is ignored in any literal.

The toggle and text of a literal must not be on the same line.

"""
a:
  b:
    c:
"""

Native elements in a common literal

Native HTML or any other text is possible between tripled double-quotes:

"""
<a><b>content</b></a>
"""

Convenience literal

The close tag of a native HTML element can be shortened between tripled single-quotes:

a: '''
<b>content</>
'''

Publication literal

Native HTML is transformed into regular text between tripled backquotes:

```
<br>
```

Expanded common literal

Literals placed within an element may be expanded or condensed:

a:
  """
  content
"""

Condensed common literal

a: """
content
"""

Non-justified common literal

Literals placed within a section may be non-justified or justified:

[A]
"""
content
  """
      < has space characters

Justified common literal

[A]
"""
content
"""

True literal

The special case of the justified condensed common literal is known as the true literal.

No additional spacing or indentation is added to the the literal's content. No transformation of the content text occurs either.

The true literal is necessary for XML authoring, but may be appropriate for e.g. textarea and pre preformatted text.

[A]
b: """
content
"""

Comments

Single-line comment

A single line of text is commented with a leading left angle bracket (<).

< comment

Comment literal

Multiple lines of text may be commented with a leading and trailing tripled exclamation mark (!!!).

The behavior of a comment literal is similar to a content literal.

!!!
comment
!!!

Native comment

The native HTML comment is encouraged and necessary when, e.g. midway in a line.

element: content 