1
0
Fork 0
mirror of https://we.phorge.it/source/phorge.git synced 2024-11-25 16:22:43 +01:00

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
This commit is contained in:
Mukunda Modell 2024-02-29 11:29:12 -06:00
parent 6df26b98c1
commit 32b5139d46

View file

@ -196,6 +196,9 @@ When rendered, this produces:
- [X] Preheat oven to 450 degrees. - [X] Preheat oven to 450 degrees.
- [ ] Zest 35 lemons. - [ ] Zest 35 lemons.
Code Blocks
===========
Make **code blocks** by indenting two spaces: Make **code blocks** by indenting two spaces:
f(x, y); f(x, y);
@ -211,6 +214,9 @@ You can specify a language for syntax highlighting with `lang=xxx`:
lang=html lang=html
<a href="#">...</a> <a href="#">...</a>
When using fenced code blocks (triple backticks) you can simply append the
language right after the backticks, like this: ##```html##
This will highlight the block using a highlighter for that language, if one is This will highlight the block using a highlighter for that language, if one is
available (in most cases, this means you need to configure Pygments): available (in most cases, this means you need to configure Pygments):