mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-11-30 21:39:57 +00:00
18 lines
997 B
Plaintext
18 lines
997 B
Plaintext
created: 20150105133800000
|
|
modified: 20150105134300000
|
|
title: RailroadDiagrams
|
|
|
|
Railroad diagrams, sometimes called syntax diagrams, are a visual way of explaining the syntax rules of a computer language. Reading one is like reading a public transport map.
|
|
|
|
Each diagram starts on the left and ends on the right. Simply follow any line from the startpoint to the endpoint. All the alternative lines are equally valid. A line will sometimes jump over an item that is optional, or loop back to indicate that an item can be repeated.
|
|
|
|
<$railroad text="""
|
|
start [:optional] {repeated +","} end
|
|
"""/>
|
|
|
|
In the example above, a comma appears between each occurrence of the `repeated` item. The comma path runs from right to left, and can only be reached by first passing through `repeated`.
|
|
|
|
Characters in round boxes are literal, i.e. they denote themselves. A name in a rectangular box denotes a further railroad diagram.
|
|
|
|
The railroad diagrams on this site are generated with the [[Railroad Plugin]].
|