6 - Appendix A - Character Encoding

6.1 - Character Set

aa_macro processes, and uses, the English language based ASCII character set. In particular, the one-byte length codes from 0x0A to 0x7F. Characters outside the ASCII character set can (must) be represented by constructs within the generated output, such as &#code; in HTML.

For instance, the HTML code for the checkmark character is ✓ so one might proceed as follows:

  • Define a style that provides the checkmark: [gstyle cm ✓]
  • Use that style where needed: {cm}
  • Resulting in: ✓

ASCII is a compatible subset of UTF-8.

6.2 - Line Encoding

aa_macro Considers an end-of-line to be a single 0x0A (line feed) character, in conformance with linux and OS X / MacOS text content conventions. In particular, output suppression of newlines flagged with two trailing spaces will fail if an 0x0A is preceded by an 0x0D (return) character.

Note: Newlines are only significant to aa_macro in the sense that they can be generated as part of the output consequent to their being present in the input, and in that they are available as an escape code, [nl]. aa_macro does not require newlines.


You can also address any need to generate CR/LF terminated output using the  [translate]  and  [cmap]  built-ins, by replacing the 10th character generated by  [cmap]  with a CR/LF pair, then translating your content accordingly.
Keyboard Navigation
, Previous Page . Next Page t TOC i Index

Valid HTML 4.01 Loose

This manual was generated with wtfm
wtfm uses aa_macro and SqLite
aa_macro uses python 2.7