@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
Diviner: Improve documentation for remarkup code blocks
Summary:
Improve remarkup reference documentation.
* Added a heading for `Code Blocks`
* Added a sentence mentioning the ##```lang## syntax which was added in {T15481}
Test Plan:
* Run `bin/diviner generate` to regen diviner docs.
* Check out the code blocks section of [[/book/phorge/article/remarkup/#code-blocks|Remarkup Reference]]
Reviewers: valerio.bozzolan, O1 Blessed Committers
Reviewed By: valerio.bozzolan, O1 Blessed Committers
Subscribers: tobiaswiese, Matthew, Cigaryno
Differential Revision: https://we.phorge.it/D25547
+6
+6
src/docs/user/userguide/remarkup.diviner
+6
src/docs/user/userguide/remarkup.diviner
···
196
196
- [X] Preheat oven to 450 degrees.
197
197
- [ ] Zest 35 lemons.
198
198
199
+
Code Blocks
200
+
===========
201
+
199
202
Make **code blocks** by indenting two spaces:
200
203
201
204
f(x, y);
···
210
213
lang=text
211
214
lang=html
212
215
<a href="#">...</a>
216
+
217
+
When using fenced code blocks (triple backticks) you can simply append the
218
+
language right after the backticks, like this: ##```html##
213
219
214
220
This will highlight the block using a highlighter for that language, if one is
215
221
available (in most cases, this means you need to configure Pygments):