Code highlighting in QuickieDox is handled with Prism.
Prism supports highlighting for several syntaxes but only the following have been compiled into QuickieDox.
markup (html, svg, xml, mathml, ssml, atom, rss,) | css | clike |
javascript, js | bash, sh, shell | dart |
go | js-templates | kotlin, kt, kts |
perl | php | python, py |
jsx, tsx | regex | swift |
typeScript, ts, tsconfig | wasm |
By default line numbers are disabled when displaying code snippets in QuickieDox. This can be enabled by setting DISPLAY_LINE_NUMBERS
to true
in the .env
file or display_line_numbers
to true
in the config.php
file. It is possible to enable line numbers for individual code snippets using inline attributes. For example.
```js
{.line-numbers}
setTheme = () => {
let theme = window.localStorage.getItem('theme') || 'dark';
document.body.classList.add(theme);
}
```
The above code snippet will be displayed with line numbers.
Code blocks can be defined either by using the backtick (`) or tilde (~) characters. You will also need to append the language the snippet is in to enable Prism properly perform its highlighting as shown in the examples below:
```js
console.log('hello world'):
```
~~~js
console.log('hello world'):
~~~
It is possible to highlight specific lines in a code snippet. This can be achieved by using inline attributes.
{.line-numbers data-line="1,3,5"}
```js
highlightThisPageInNav = () => {
let this_page = (((location.href).split('/')).slice(-1)[0].split('#'))[0];
document.querySelectorAll('nav li a').forEach((el) => {
if (el.getAttribute('href').includes(this_page)) {
el.classList.add('selected');
}
});
}
```
From the above example we are instructing Prism to highlight lines 1, 3 and 5. It is also possible to highlight a range of lines.
{data-line="1-3, 5-10"}
```js
highlightThisPageInNav = () => {
let this_page = (((location.href).split('/')).slice(-1)[0].split('#'))[0];
document.querySelectorAll('nav li a').forEach((el) => {
if (el.getAttribute('href').includes(this_page)) {
el.classList.add('selected');
}
});
}
```
There are times when you just need to highlight code inline instead of an entire block of code. For example, you want to highlight a configuration variable. Again, QuickieDox uses inline attributes to achieve this. Let’s look at an example:
You can simply run `composer install`{.inline} to pull in packages
You can simply run composer install
to pull in packages
You can enable line numbers for all code blocks in your project by setting DISPLAY_LINE_NUMBERS=true
in the .env
file.
In This Document