Special symbols in HyperLite

Additional charactreres that must be escaped when you use HyperLite

The HyperLite language has an even simpler syntax than HyperCode. But for that, it was necessary to use a larger number of characters for formatting markup. Consequently, the list of characters that, if used in their normal functions (not formatting), will need to be escaped is larger. See which characters these are and under what conditions they need to be escaped.

The HyperLite language uses more special characters for text formatting markup. If the post you are creating or editing has the "Use HyperLite syntax" option enabled, there are other characters that require the escape sequence.

The way to escape these characters is the same as the others already described in Special Symbols, that is, typing a backslash \ immediately before the character to be escaped. This tells HyperFluxCMS that the following character should be treated as the character itself, and not as a markup symbol.

Normally, escaping a character is only mandatory in conditions where it could be confused with a markup character.

Inline markup characters

Inline markup characters are those that can be used to format from a single character on a line to an entire text snippet containing several paragraphs.

They are: *, /, ^, ~, _, and |.

An example is the asterisk *, which, in HyperLite syntax, is used to mark a part of the text in bold. But for that, it must follow some conditions, such as being at the beginning of a line or before a word, or closing a previously opened bold markup.
In other conditions, it is normally treated as a regular character, and in these cases escaping is not necessary.

For example, the asterisk * is only considered a markup symbol when:

• it is the first character of the page; or
• it is the first character of a line; or
• it comes right after a space or tab;
• it is the last character of the page and there is an active bold start markup; or
• it is the last character of a line and there is an active bold start markup; or
• it comes right before a space or tab and there is an active bold start markup;

In these cases, if you want the asterisk to be understood as part of the text, and not as the start or end mark of bold text, you need to insert \ before it. Otherwise, it will be understood as the start or end of bold text.

This is *bold* text;

This is \*surrounded by asterisks\* without bold because the '*' is escaped with \.

In other cases, using the escape sequence is not mandatory. But it is accepted and recommended.

For example, the expression 2*3*2=12 is text with an asterisk but Hyperflux does not consider the asterisk as bold markup because it does not meet the requirements. In this case, it is surrounded by characters that are not spaces, separators, or other markers. But it CAN also be written as 2\*3\*2=12 and the displayed result will also be 2*3*2=12.

Line markup characters

Line markup characters are those that indicate that the line they start has some special markup meaning. They are only considered if they are the first characters of a line.

They are #, ;, and .. You will only need to escape them if a line happens to start with one of them and you want them to appear as they are, instead of being considered text formatting markup.

Object markup characters

Object markup characters are those that indicate the markup of an object, which can be an image or a link. They are only considered if they are the first characters of a line or if they come right after a space.

It is the at sign (@) followed by a letter that can be U, X, L, A, or I, uppercase or lowercase.

For example, @i:logo.jpg indicates an object of type image ("i").

If your text uses the @ character somewhere at the beginning of a line or after a space and you want to display it as a common character, rather than indicating an object, the '@' must be escaped, preceded by '\', like this: "\@".

Summary

It may seem confusing at first, but you will understand better as you use HyperFluxCMS and study the structure of the HyperLite language.