git.haldean.org ubik / c0a8283
correct the spec on ..code::ubik format Haldean Brown 6 years ago
1 changed file(s) with 13 addition(s) and 7 deletion(s). Raw diff Collapse all Expand all
8181 else (or just unset entirely). You can also use a quoted literal block,
8282 although you'll end up with the quoting character inside the result.
8383
84 To avoid a dependency on an entire reST parser, we place a small
85 constraint on the specific syntax of the directive line. The code
86 directives must start on their own line and match the following regular
87 expression, with whitespace appearing at any point in the line:
84 To avoid a dependency on an entire reST parser, we actually identify
85 things that are not proper reST when looking for the ..code:: marker.
86 The code directives must start on their own line and match the following
87 string, with whitespace appearing at any point in the line:
8888
8989 ..code::ubik
9090
9191 The code must start on a new line after the directive, and all lines are
92 taken until a line with no indentation is found again. This is slightly
93 less flexible than the reST spec usually allows you to be, but it
94 simplifies the implementation of the weave operation significantly.
92 taken until a line with no indentation is found again. This is more
93 permissive than the reST spec, but it simplifies the implementation of
94 the weave operation significantly. The following markers are all valid:
95
96 .. code :: ubik
97 . . c o d e : : u b i k
98 . .code: :ubik
99 ..code::ubi k
100