mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-11-16 23:04:50 +00:00
18 lines
1.0 KiB
Plaintext
18 lines
1.0 KiB
Plaintext
created: 20150105133800000
|
|
modified: 20150124181306000
|
|
title: Railroad Diagrams
|
|
|
|
<<.def "Railroad diagrams">>, sometimes called <<.def "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 in ~TiddlyWiki's documentation are generated with the [[Railroad Plugin]].
|