Go to file
2023-09-27 18:35:18 +02:00
pages Flesh out Woodpecker CI article 2023-09-27 18:35:18 +02:00
plugins Implement correct fix for issue 27 2023-08-03 16:57:09 +02:00
themes Darken warning background color 2023-07-11 17:37:08 +02:00
.gitignore Modify to ignore any .sass-cache 2022-11-19 20:14:16 +01:00
README.md Add style guide sudo 2023-07-21 13:21:53 +02:00

Style guide

Code blocks

PrismJS is used to provide highlighting when the right programming language name is given

Bash / SH

Shell highlighting uses additional keywords in markdown to set a desired prefix

Available options are [shroot] and [shuser]

Usage:

[shroot]

```
echo hello
```

[/shroot]

To filter outputlines, prepend them with (out).
Don't put a space between the keyword and the output

lsusb -d 0781:55a3 -v | grep bcdUSB
(out)bcdUSB               3.20

Sudo

Although I try to avoid using sudo, in some cases it is quite handy. Examples can be seen on the Nextcloud page, where commands need to be executed as www-data.
Following a post on lemmy, I learned of a cool way to do this with just su

This example copies a file in the web directory, using the user www-data. Command blocks using this style should be prefixed with # using [shroot]

[shroot]

```
su -s /bin/sh -c 'cp /var/www/html/html1 /var/www/html/html2' www-data
```

[/shroot]

Variables / Fill your own

Values that should be replaced by the reader are generally represented this way:
[VALUE]