-
Notifications
You must be signed in to change notification settings - Fork 0
DescribeGrammar decorators
Decorators basically are some text enclosed in curly brackets - { and }. Decorators are used to add different kind of data to items - weather it is additional text or instruction to change the color of the item or add a particular icon image. Decorators can either be simple ones, consisting of just a key, or complex ones, consisting of a key and a value, delimited by a pipe symbol |.
A list of decorators and instructions for their use follows. However, in the Describe language grammar, a decorator is just some text in curly brackets. What a particular decorator will do is implemented in the particular translator, and if users are developing their own translators, they are free to implement their own decorators.
-
empty
{empty}
The empty entry decorator is a simple decorator used to create empty entries. Those empty entries essentially act as new lines in lists. This decorator cannot be applied on an item that is a head of a production. -
comment
{comment}
The comment decorator is a simple decorator used to make an entry green and italicized. -
nlcomment
{nlcomment}
The nlcomment decorator is the same as the comment decorator, but adds an empty entry before the decorated entry, if the decorated entry is not the first in the list. -
color
{color|VALUE}
The color decorator is a complex one, and is used for setting the fore-color of the text of the item it is applied to. VALUE is any CSS compatible color - either in the hex notation #1234AA or a named color like limegreen. -
bgcolor
{bgcolor|VALUE}
The bgcolor decorator is a complex one, and is used for setting the back-color of the text of the item it is applied to. VALUE is any CSS compatible color - either in the hex notation #1234AA or a named color like limegreen. -
bold
{bold}
The bold decorator is a simple decorator used to make an entry bold. -
italic
{italic}
The italic decorator is a simple decorator used to make an entry italicized. -
underline
{underline}
The underline decorator is a simple decorator used to make an entry underlined. -
striked
{striked}
The striked decorator is a simple decorator used to add the strike-through CSS effect to an entry. -
style
{style|VALUE}
The style decorator is a complex decorator used with HTML translators to provide CSS for an entry. Value is a valid CSS string that goes in the style attribute of some item like<li>or<span>. -
custom
{custom|NAME}
The custom decorator is a way to add a user defined decorator. How this is handled depends on the translator implementing it. -
custom
{custom|NAME|VALUE}
The custom decorator is a way to add a user defined decorator with a value. How this is handled depends on the translator implementing it. -
*enlist
{enlist|VALUE}*EXPERIMENTAL
The enlist decorator is the list-creating aka placement decorator. It puts an entry in a sibling list. For exampleentry {enlist | refs}will create a sibling listrefsand put the entry in it.entry {enlist | legend}will create a sibling listlegendand put the entry in it. -
*shorter
{shorter-1|TEXT}*EXPERIMENTAL
The shorter decorator is a content-provider. It provides a shorter version of the entry, so that when the display is too small to display an entry, it does not get cut off, but the shorter version is used instead. There are up to 5 levels available to the user, withshorter-1being the longest or the least-shortened text andshorter-5being the most shortened. -
*shortest
{shortest-1|TEXT}*EXPERIMENTAL
The same asshorterbut in reverse order. There are up to 5 levels available to the user, withshortest-1being the shortest or the most-shortened text andshortest-5being the least shortened.
Using decorators:

Using decorators (added comments):

Home
Grammar How To
Compiler How To
CLI Compiler - How to
CLI Compiler - How to - help
CLI Compiler - How to - parse-file
CLI Compiler - How to - parse-folder
CLI Compiler - How to - encrypt-file
CLI Compiler - How to - decrypt-file
CLI Compiler - How to - recrypt-file
CLI Compiler - How to - encrypt-folder
CLI Compiler - How to - decrypt-folder
CLI Compiler - How to - recrypt-folder
API Compiler - How to
API Compiler - How to - Example 1
API Compiler - How to - Example 2
API Compiler - How to - Example 3
API Compiler - How to - Example 4
API Compiler - How to - Example 5
AWS Compiler - How to
AWS technical overview
API gateway configuration
output - low
output - medium
output - high
output - themes
Grammar - Lists
Grammar - Comments
Grammar - Links
Grammar - Decorators
Grammar - Tags
Grammar - More on Tags
Grammar - Directives
Grammar - Dot Notation
Grammar - Tildes
Grammar - Files
Deprecated - Slash Notation
Deprecated - Delimiter Mode
Describe Basics - v0.6
Describe Tags - v0.7
Describe Links - v0.8
Describe Decorators - v0.9
Describe Lines - v1.0
Describe Doubles - v1.1