@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
Fix syntax in Remarkup Code Blocks docs
Summary:
Render the mentioned "two spaces" and "three backticks" to make examples understandable.
Fixes Q198
Test Plan:
* Go to http://phorge.localhost/reference/remarkup/#code-blocks
* Go to http://phorge.localhost/book/phorge/article/remarkup/#code-blocks
Reviewers: O1 Blessed Committers, mainframe98
Reviewed By: O1 Blessed Committers, mainframe98
Subscribers: avivey, tobiaswiese, valerio.bozzolan, Matthew, Cigaryno
Differential Revision: https://we.phorge.it/D26270
+14
-8
+7
-4
src/applications/reference/src/controller/RemarkupReferenceController.php
+7
-4
src/applications/reference/src/controller/RemarkupReferenceController.php
···
208
208
209
209
Make **code blocks** by indenting two spaces:
210
210
211
-
f(x, y);
211
+
` f(x, y);`
212
212
213
213
You can also use three backticks to enclose the code block:
214
214
215
-
```f(x, y);
216
-
g(f);```
215
+
lang=text
216
+
```
217
+
f(x, y);
218
+
g(f);
219
+
```
217
220
218
221
You can specify a language for syntax highlighting with `lang=xxx`:
219
222
···
221
224
lang=html
222
225
<a href="#">...</a>
223
226
224
-
When using fenced code blocks (triple backticks) you can simply append the
227
+
When using fenced code blocks (triple backticks) you can append the
225
228
language right after the backticks, like this: ##```html##
226
229
227
230
This will highlight the block using a highlighter for that language, if one is
+7
-4
src/docs/user/userguide/remarkup.diviner
+7
-4
src/docs/user/userguide/remarkup.diviner
···
201
201
202
202
Make **code blocks** by indenting two spaces:
203
203
204
-
f(x, y);
204
+
` f(x, y);`
205
205
206
206
You can also use three backticks to enclose the code block:
207
207
208
-
```f(x, y);
209
-
g(f);```
208
+
lang=text
209
+
```
210
+
f(x, y);
211
+
g(f);
212
+
```
210
213
211
214
You can specify a language for syntax highlighting with `lang=xxx`:
212
215
···
214
217
lang=html
215
218
<a href="#">...</a>
216
219
217
-
When using fenced code blocks (triple backticks) you can simply append the
220
+
When using fenced code blocks (triple backticks) you can append the
218
221
language right after the backticks, like this: ##```html##
219
222
220
223
This will highlight the block using a highlighter for that language, if one is