Nulo/qmk_firmware
1
0
Fork 0
Code Releases Activity

Add terminal examples to doc best practices

Browse source
This commit is contained in:
skullY 2017-07-08 22:39:17 -07:00
parent 5810bb67e4
commit 4c7c7747a3
1 changed files with 38 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

38
docs/documentation_best_practices.md
View file

@ -22,6 +22,14 @@ Your page should generally have multiple "H1" headings. Only H1 and H2 headings
You can have styled hint blocks drawn around text to draw attention to it. You can have styled hint blocks drawn around text to draw attention to it.
```
{% hint style='info' %}
This uses `hint style='info'`
{% endhint %}
```
### Examples:
{% hint style='info' %} {% hint style='info' %}
This uses `hint style='info'` This uses `hint style='info'`
{% endhint %} {% endhint %}
@ -37,3 +45,33 @@ This uses `hint style='danger'`
{% hint style='working' %} {% hint style='working' %}
This uses `hint style='working'` This uses `hint style='working'`
{% endhint %} {% endhint %}
# Styled Terminal Blocks
You can present styled terminal blocks by including special tokens inside your text block.
```
\`\`\`
**[terminal]
**[prompt foo@joe]**[path ~]**[delimiter $ ]**[command ./myscript]
Normal output line. Nothing special here...
But...
You can add some colors. What about a warning message?
**[warning [WARNING] The color depends on the theme. Could look normal too]
What about an error message?
**[error [ERROR] This is not the error you are looking for]
\`\`\`
```
### Example
```
**[terminal]
**[prompt foo@joe]**[path ~]**[delimiter $ ]**[command ./myscript]
Normal output line. Nothing special here...
But...
You can add some colors. What about a warning message?
**[warning [WARNING] The color depends on the theme. Could look normal too]
What about an error message?
**[error [ERROR] This is not the error you are looking for]
```